/[gentoo-x86]/eclass/webapp.eclass
Gentoo

Diff of /eclass/webapp.eclass

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.19 Revision 1.66
1# Copyright 1999-2004 Gentoo Technologies, Inc. 1# Copyright 1999-2006 Gentoo Foundation
2# Distributed under the terms of the GNU General Public License v2 2# Distributed under the terms of the GNU General Public License v2
3# $Header: /var/cvsroot/gentoo-x86/eclass/webapp.eclass,v 1.19 2004/05/22 18:45:13 stuart Exp $ 3# $Header: /var/cvsroot/gentoo-x86/eclass/webapp.eclass,v 1.66 2011/05/19 12:05:13 scarabeus Exp $
4# 4
5# eclass/webapp.eclass 5# @ECLASS: webapp.eclass
6# @MAINTAINER:
7# web-apps@gentoo.org
6# Eclass for installing applications to run under a web server 8# @BLURB: functions for installing applications to run under a web server
7# 9# @DESCRIPTION:
10# The webapp eclass contains functions to handle web applications with
8# Part of the implementation of GLEP #11 11# webapp-config. Part of the implementation of GLEP #11
9#
10# Author(s) Stuart Herbert <stuart@gentoo.org>
11#
12# ------------------------------------------------------------------------
13#
14# The master copy of this eclass is held in Stu's subversion repository.
15#
16# If you make changes to this file and don't tell Stu, chances are that
17# your changes will be overwritten the next time Stu releases a new version
18# of webapp-config.
19#
20# ------------------------------------------------------------------------
21 12
22ECLASS=webapp 13# @ECLASS-VARIABLE: WEBAPP_DEPEND
23INHERITED="$INHERITED $ECLASS" 14# @DESCRIPTION:
15# An ebuild should use WEBAPP_DEPEND if a custom DEPEND needs to be built, most
16# notably in combination with WEBAPP_OPTIONAL.
17WEBAPP_DEPEND=">=app-admin/webapp-config-1.50.15"
18
19# @ECLASS-VARIABLE: WEBAPP_NO_AUTO_INSTALL
20# @DESCRIPTION:
21# An ebuild sets this to `yes' if an automatic installation and/or upgrade is
22# not possible. The ebuild should overwrite pkg_postinst() and explain the
23# reason for this BEFORE calling webapp_pkg_postinst().
24
25# @ECLASS-VARIABLE: WEBAPP_OPTIONAL
26# @DESCRIPTION:
27# An ebuild sets this to `yes' to make webapp support optional, in which case
28# you also need to take care of USE-flags and dependencies.
29
30if [[ "${WEBAPP_OPTIONAL}" != "yes" ]]; then
31 [[ "${WEBAPP_NO_AUTO_INSTALL}" == "yes" ]] || IUSE="vhosts"
24SLOT="${PVR}" 32 SLOT="${PVR}"
25IUSE="$IUSE vhosts" 33 DEPEND="${WEBAPP_DEPEND}"
26DEPEND="$DEPEND >=net-www/webapp-config-1.7 app-portage/gentoolkit" 34 RDEPEND="${DEPEND}"
35fi
27 36
28EXPORT_FUNCTIONS pkg_postinst pkg_setup src_install pkg_prerm 37EXPORT_FUNCTIONS pkg_postinst pkg_setup src_install pkg_prerm
29 38
30INSTALL_DIR="/$PN" 39INSTALL_DIR="/${PN}"
31IS_UPGRADE=0 40IS_UPGRADE=0
32IS_REPLACE=0 41IS_REPLACE=0
33 42
34INSTALL_CHECK_FILE="installed_by_webapp_eclass" 43INSTALL_CHECK_FILE="installed_by_webapp_eclass"
44SETUP_CHECK_FILE="setup_by_webapp_eclass"
35 45
36# ------------------------------------------------------------------------ 46ETC_CONFIG="${ROOT}etc/vhosts/webapp-config"
37# INTERNAL FUNCTION - USED BY THIS ECLASS ONLY 47WEBAPP_CONFIG="${ROOT}usr/sbin/webapp-config"
38# 48WEBAPP_CLEANER="${ROOT}usr/sbin/webapp-cleaner"
49
50# ==============================================================================
51# INTERNAL FUNCTIONS
52# ==============================================================================
53
54# Load the config file /etc/vhosts/webapp-config
55# Supports both the old bash version, and the new python version
56webapp_read_config() {
57 debug-print-function $FUNCNAME $*
58
59 if has_version '>=app-admin/webapp-config-1.50'; then
60 ENVVAR=$(${WEBAPP_CONFIG} --query ${PN} ${PVR}) || die "Could not read settings from webapp-config!"
61 eval ${ENVVAR}
62 else
63 . ${ETC_CONFIG} || die "Unable to read ${ETC_CONFIG}"
64 fi
65}
66
39# Check whether a specified file exists within the image/ directory 67# Check whether a specified file exists in the given directory (`.' by default)
40# or not.
41#
42# @param $1 - file to look for
43# @param $2 - prefix directory to use
44# @return 0 on success, never returns on an error
45# ------------------------------------------------------------------------
46
47function webapp_checkfileexists () 68webapp_checkfileexists() {
48{ 69 debug-print-function $FUNCNAME $*
49 local my_prefix
50 70
51 [ -n "$2" ] && my_prefix="$2/" || my_prefix= 71 local my_prefix=${2:+${2}/}
52 72
53 if [ ! -e ${my_prefix}$1 ]; then 73 if [[ ! -e "${my_prefix}${1}" ]]; then
54 msg="ebuild fault: file $1 not found" 74 msg="ebuild fault: file '${1}' not found"
55 eerror "$msg" 75 eerror "$msg"
56 eerror "Please report this as a bug at http://bugs.gentoo.org/" 76 eerror "Please report this as a bug at http://bugs.gentoo.org/"
57 die "$msg" 77 die "$msg"
58 fi 78 fi
59} 79}
60 80
61# ------------------------------------------------------------------------
62# INTERNAL FUNCTION - USED BY THIS ECLASS ONLY
63# ------------------------------------------------------------------------
64
65function webapp_check_installedat 81webapp_check_installedat() {
66{ 82 debug-print-function $FUNCNAME $*
83 ${WEBAPP_CONFIG} --show-installed -h localhost -d "${INSTALL_DIR}" 2> /dev/null
84}
85
86webapp_strip_appdir() {
87 debug-print-function $FUNCNAME $*
88 echo "${1#${MY_APPDIR}/}"
89}
90
91webapp_strip_d() {
92 debug-print-function $FUNCNAME $*
93 echo "${1#${D}}"
94}
95
96webapp_strip_cwd() {
97 debug-print-function $FUNCNAME $*
98 echo "${1/#.\///}"
99}
100
101webapp_getinstalltype() {
102 debug-print-function $FUNCNAME $*
103
104 if ! has vhosts ${IUSE} || use vhosts; then
105 return
106 fi
107
67 local my_output 108 local my_output
109 my_output="$(webapp_check_installedat)"
68 110
69 /usr/sbin/webapp-config --show-installed -h localhost -d $INSTALL_DIR 2> /dev/null 111 if [[ $? -eq 0 ]]; then
70} 112 # something is already installed there
113 # make sure it isn't the same version
71 114
72# ------------------------------------------------------------------------ 115 local my_pn="$(echo ${my_output} | awk '{ print $1 }')"
73# INTERNAL FUNCTION - USED BY THIS ECLASS ONLY 116 local my_pvr="$(echo ${my_output} | awk '{ print $2 }')"
74# ------------------------------------------------------------------------
75 117
76function webapp_import_config () 118 REMOVE_PKG="${my_pn}-${my_pvr}"
77{ 119
78 if [ -z "${MY_HTDOCSDIR}" ]; then 120 if [[ "${my_pn}" == "${PN}" ]]; then
79 . /etc/conf.d/webapp-config 121 if [[ "${my_pvr}" != "${PVR}" ]]; then
122 elog "This is an upgrade"
123 IS_UPGRADE=1
124 else
125 elog "This is a re-installation"
126 IS_REPLACE=1
127 fi
128 else
129 elog "${my_output} is installed there"
80 fi 130 fi
81 131 else
82 if [ -z "${MY_HTDOCSDIR}" ]; then 132 elog "This is an installation"
83 libsh_edie "/etc/conf.d/webapp-config not imported"
84 fi 133 fi
85} 134}
86 135
87# ------------------------------------------------------------------------ 136# ==============================================================================
88# INTERNAL FUNCTION - USED BY THIS ECLASS ONLY 137# PUBLIC FUNCTIONS
89# 138# ==============================================================================
90# ------------------------------------------------------------------------
91 139
92function webapp_strip_appdir () 140# @FUNCTION: need_httpd
93{ 141# @DESCRIPTION:
94 local my_stripped="$1" 142# Call this function AFTER your ebuilds DEPEND line if any of the available
95 echo "$1" | sed -e "s|${MY_APPDIR}/||g;" 143# webservers are able to run this application.
144need_httpd() {
145 DEPEND="${DEPEND}
146 || ( virtual/httpd-basic virtual/httpd-cgi virtual/httpd-fastcgi )"
96} 147}
97 148
98function webapp_strip_d () 149# @FUNCTION: need_httpd_cgi
99{ 150# @DESCRIPTION:
100 echo "$1" | sed -e "s|${D}||g;" 151# Call this function AFTER your ebuilds DEPEND line if any of the available
152# CGI-capable webservers are able to run this application.
153need_httpd_cgi() {
154 DEPEND="${DEPEND}
155 || ( virtual/httpd-cgi virtual/httpd-fastcgi )"
101} 156}
102 157
103function webapp_strip_cwd () 158# @FUNCTION: need_httpd_fastcgi
104{ 159# @DESCRIPTION:
105 local my_stripped="$1" 160# Call this function AFTER your ebuilds DEPEND line if any of the available
106 echo "$1" | sed -e 's|/./|/|g;' 161# FastCGI-capabale webservers are able to run this application.
162need_httpd_fastcgi() {
163 DEPEND="${DEPEND}
164 virtual/httpd-fastcgi"
107} 165}
108 166
109# ------------------------------------------------------------------------ 167# @FUNCTION: webapp_configfile
110# EXPORTED FUNCTION - FOR USE IN EBUILDS 168# @USAGE: <file> [more files ...]
111# 169# @DESCRIPTION:
112# Identify a config file for a web-based application. 170# Mark a file config-protected for a web-based application.
113#
114# @param $1 - config file
115# ------------------------------------------------------------------------
116
117function webapp_configfile () 171webapp_configfile() {
118{ 172 debug-print-function $FUNCNAME $*
173
174 local m
175 for m in "$@"; do
119 webapp_checkfileexists "$1" "$D" 176 webapp_checkfileexists "${m}" "${D}"
120 echo $1
121 local MY_FILE="`webapp_strip_appdir $1`"
122 echo $MY_FILE
123 177
124 einfo "(config) $MY_FILE" 178 local my_file="$(webapp_strip_appdir "${m}")"
179 my_file="$(webapp_strip_cwd "${my_file}")"
180
181 elog "(config) ${my_file}"
125 echo "$MY_FILE" >> ${D}${WA_CONFIGLIST} 182 echo "${my_file}" >> ${D}/${WA_CONFIGLIST}
183 done
126} 184}
127 185
128# ------------------------------------------------------------------------ 186# @FUNCTION: webapp_hook_script
129# EXPORTED FUNCTION - FOR USE IN EBUILDS 187# @USAGE: <file>
130# 188# @DESCRIPTION:
131# Install a script that will run after a virtual copy is created, and 189# Install a script that will run after a virtual copy is created, and
132# before a virtual copy has been removed 190# before a virtual copy has been removed.
133#
134# @param $1 - the script to run
135# ------------------------------------------------------------------------
136
137function webapp_hook_script () 191webapp_hook_script() {
138{ 192 debug-print-function $FUNCNAME $*
193
139 webapp_checkfileexists "$2" 194 webapp_checkfileexists "${1}"
140 195
141 einfo "(hook) $1" 196 elog "(hook) ${1}"
142 cp "$1" "${D}${MY_HOOKSCRIPTSDIR}/`basename $1`" || die "Unable to install $1 into ${D}${MY_HOOKSCRIPTSDIR}/" 197 cp "${1}" "${D}/${MY_HOOKSCRIPTSDIR}/$(basename "${1}")" || die "Unable to install ${1} into ${D}/${MY_HOOKSCRIPTSDIR}/"
143 chmod 555 "${D}${MY_HOOKSCRIPTSDIR}/`basename $1`" 198 chmod 555 "${D}/${MY_HOOKSCRIPTSDIR}/$(basename "${1}")"
144} 199}
145 200
146# ------------------------------------------------------------------------ 201# @FUNCTION: webapp_postinst_txt
147# EXPORTED FUNCTION - FOR USE IN EBUILDS 202# @USAGE: <lang> <file>
148# 203# @DESCRIPTION:
149# Install a text file containing post-installation instructions. 204# Install a text file containing post-installation instructions.
150# 205webapp_postinst_txt() {
151# @param $1 - language code (use 'en' for now) 206 debug-print-function $FUNCNAME $*
152# @param $2 - the file to install
153# ------------------------------------------------------------------------
154 207
155function webapp_postinst_txt
156{
157 webapp_checkfileexists "$2" 208 webapp_checkfileexists "${2}"
158 209
159 einfo "(rtfm) $2 (lang: $1)" 210 elog "(info) ${2} (lang: ${1})"
160 cp "$2" "${D}${MY_APPDIR}/postinst-$1.txt" 211 cp "${2}" "${D}/${MY_APPDIR}/postinst-${1}.txt"
161} 212}
162 213
163# ------------------------------------------------------------------------ 214# @FUNCTION: webapp_postupgrade_txt
164# EXPORTED FUNCTION - FOR USE IN EBUILDS 215# @USAGE: <lang> <file>
165# 216# @DESCRIPTION:
166# Identify a script file (usually, but not always PHP or Perl) which is 217# Install a text file containing post-upgrade instructions.
167# 218webapp_postupgrade_txt() {
168# Files in this list may be modified to #! the required CGI engine when 219 debug-print-function $FUNCNAME $*
169# installed by webapp-config tool in the future.
170#
171# @param $1 - the cgi engine to use
172# @param $2 - the script file that could run under a cgi-bin
173#
174# ------------------------------------------------------------------------
175 220
176function webapp_runbycgibin ()
177{
178 webapp_checkfileexists "$2" "$D"
179 local MY_FILE="`webapp_strip_appdir $2`"
180 MY_FILE="`webapp_strip_cwd $MY_FILE`"
181
182 einfo "(cgi-bin) $1 - $MY_FILE"
183 echo "$1 $MY_FILE" >> ${D}${WA_RUNBYCGIBINLIST}
184}
185
186# ------------------------------------------------------------------------
187# EXPORTED FUNCTION - FOR USE IN EBUILDS
188#
189# Identify a file which must be owned by the webserver's user:group
190# settings.
191#
192# The ownership of the file is NOT set until the application is installed
193# using the webapp-config tool.
194#
195# @param $1 - file to be owned by the webserver user:group combo
196#
197# ------------------------------------------------------------------------
198
199function webapp_serverowned ()
200{
201 webapp_checkfileexists "$1" "$D"
202 local MY_FILE="`webapp_strip_appdir $1`"
203
204 einfo "(server owned) $MY_FILE"
205 echo "$MY_FILE" >> ${D}${WA_SOLIST}
206}
207
208# ------------------------------------------------------------------------
209# EXPORTED FUNCTION - FOR USE IN EBUILDS
210#
211# @param $1 - the webserver to install the config file for
212# (one of apache1, apache2, cherokee)
213# @param $2 - the config file to install
214# @param $3 - new name for the config file (default is `basename $2`)
215# this is an optional parameter
216#
217# NOTE:
218# this function will automagically prepend $1 to the front of your
219# config file's name
220# ------------------------------------------------------------------------
221
222function webapp_server_config ()
223{
224 webapp_checkfileexists "$2" 221 webapp_checkfileexists "${2}"
225 222
226 # sort out what the name will be of the config file 223 elog "(info) ${2} (lang: ${1})"
224 cp "${2}" "${D}/${MY_APPDIR}/postupgrade-${1}.txt"
225}
227 226
228 local my_file 227# helper for webapp_serverowned()
228_webapp_serverowned() {
229 debug-print-function $FUNCNAME $*
229 230
230 if [ -z "$3" ]; then 231 webapp_checkfileexists "${1}" "${D}"
231 $my_file="$1-`basename $2`" 232 local my_file="$(webapp_strip_appdir "${1}")"
233 my_file="$(webapp_strip_cwd "${my_file}")"
234
235 elog "(server owned) ${my_file}"
236 echo "${my_file}" >> "${D}/${WA_SOLIST}"
237}
238
239# @FUNCTION: webapp_serverowned
240# @USAGE: [-R] <file> [more files ...]
241# @DESCRIPTION:
242# Identify a file which must be owned by the webserver's user:group settings.
243# The ownership of the file is NOT set until the application is installed using
244# the webapp-config tool. If -R is given directories are handled recursively.
245webapp_serverowned() {
246 debug-print-function $FUNCNAME $*
247
248 local a m
249 if [[ "${1}" == "-R" ]]; then
250 shift
251 for m in "$@"; do
252 find "${D}${m}" | while read a; do
253 a=$(webapp_strip_d "${a}")
254 _webapp_serverowned "${a}"
255 done
256 done
232 else 257 else
233 $my_file="$1-$3" 258 for m in "$@"; do
259 _webapp_serverowned "${m}"
260 done
234 fi 261 fi
262}
235 263
236 # warning: 264# @FUNCTION: webapp_server_configfile
265# @USAGE: <server> <file> [new name]
266# @DESCRIPTION:
267# Install a configuration file for the webserver. You need to specify a
268# webapp-config supported <server>. if no new name is given `basename $2' is
269# used by default. Note: this function will automagically prepend $1 to the
270# front of your config file's name.
271webapp_server_configfile() {
272 debug-print-function $FUNCNAME $*
273
274 webapp_checkfileexists "${2}"
275
276 # WARNING:
237 # 277 #
238 # do NOT change the naming convention used here without changing all 278 # do NOT change the naming convention used here without changing all
239 # the other scripts that also rely upon these names 279 # the other scripts that also rely upon these names
240 280
281 local my_file="${1}-${3:-$(basename "${2}")}"
282
241 einfo "($1) config file '$my_file'" 283 elog "(${1}) config file '${my_file}'"
242 cp "$2" "${D}${MY_SERVERCONFIGDIR}/${my_file}" 284 cp "${2}" "${D}/${MY_SERVERCONFIGDIR}/${my_file}"
243} 285}
244 286
245# ------------------------------------------------------------------------ 287# @FUNCTION: webapp_sqlscript
246# EXPORTED FUNCTION - FOR USE IN EBUILDS 288# @USAGE: <db> <file> [version]
247# 289# @DESCRIPTION:
248# @param $1 - the db engine that the script is for 290# Install a SQL script that creates/upgrades a database schema for the web
249# (one of: mysql|postgres) 291# application. Currently supported database engines are mysql and postgres.
250# @param $2 - the sql script to be installed 292# If a version is given the script should upgrade the database schema from
251# @param $3 - the older version of the app that this db script 293# the given version to $PVR.
252# will upgrade from
253# (do not pass this option if your SQL script only creates
254# a new db from scratch)
255# ------------------------------------------------------------------------
256
257function webapp_sqlscript () 294webapp_sqlscript() {
258{ 295 debug-print-function $FUNCNAME $*
296
259 webapp_checkfileexists "$2" 297 webapp_checkfileexists "${2}"
260 298
261 # create the directory where this script will go 299 dodir "${MY_SQLSCRIPTSDIR}/${1}"
262 #
263 # scripts for specific database engines go into their own subdirectory
264 # just to keep things readable on the filesystem
265 300
266 if [ ! -d "${D}${MY_SQLSCRIPTSDIR}/$1" ]; then 301 # WARNING:
267 mkdir -p "${D}${MY_SQLSCRIPTSDIR}/$1" || libsh_die "unable to create directory ${D}${MY_SQLSCRIPTSDIR}/$1"
268 fi
269
270 # warning:
271 # 302 #
272 # do NOT change the naming convention used here without changing all 303 # do NOT change the naming convention used here without changing all
273 # the other scripts that also rely upon these names 304 # the other scripts that also rely upon these names
274 305
275 # are we dealing with an 'upgrade'-type script?
276 if [ -n "$3" ]; then 306 if [[ -n "${3}" ]]; then
277 # yes we are
278 einfo "($1) upgrade script from ${PN}-${PVR} to $3" 307 elog "(${1}) upgrade script for ${PN}-${3} to ${PVR}"
279 cp $2 ${D}${MY_SQLSCRIPTSDIR}/$1/${3}_to_${PVR}.sql 308 cp "${2}" "${D}${MY_SQLSCRIPTSDIR}/${1}/${3}_to_${PVR}.sql"
309 chmod 600 "${D}${MY_SQLSCRIPTSDIR}/${1}/${3}_to_${PVR}.sql"
280 else 310 else
281 # no, we are not
282 einfo "($1) create script for ${PN}-${PVR}" 311 elog "(${1}) create script for ${PN}-${PVR}"
283 cp $2 ${D}${MY_SQLSCRIPTSDIR}/$1/${PVR}_create.sql 312 cp "${2}" "${D}/${MY_SQLSCRIPTSDIR}/${1}/${PVR}_create.sql"
313 chmod 600 "${D}/${MY_SQLSCRIPTSDIR}/${1}/${PVR}_create.sql"
284 fi 314 fi
285} 315}
286 316
287# ------------------------------------------------------------------------ 317# @FUNCTION: webapp_src_preinst
288# EXPORTED FUNCTION - call from inside your ebuild's src_install AFTER 318# @DESCRIPTION:
289# everything else has run 319# You need to call this function in src_install() BEFORE anything else has run.
320# For now we just create required webapp-config directories.
321webapp_src_preinst() {
322 debug-print-function $FUNCNAME $*
323
324 # sanity checks, to catch bugs in the ebuild
325 if [[ ! -f "${T}/${SETUP_CHECK_FILE}" ]]; then
326 eerror
327 eerror "This ebuild did not call webapp_pkg_setup() at the beginning"
328 eerror "of the pkg_setup() function"
329 eerror
330 eerror "Please log a bug on http://bugs.gentoo.org"
331 eerror
332 eerror "You should use emerge -C to remove this package, as the"
333 eerror "installation is incomplete"
334 eerror
335 die "Ebuild did not call webapp_pkg_setup() - report to http://bugs.gentoo.org"
336 fi
337
338 # Hint, see the webapp_read_config() function to find where these are
339 # defined.
340 dodir "${MY_HTDOCSDIR}"
341 dodir "${MY_HOSTROOTDIR}"
342 dodir "${MY_CGIBINDIR}"
343 dodir "${MY_ICONSDIR}"
344 dodir "${MY_ERRORSDIR}"
345 dodir "${MY_SQLSCRIPTSDIR}"
346 dodir "${MY_HOOKSCRIPTSDIR}"
347 dodir "${MY_SERVERCONFIGDIR}"
348}
349
350# ==============================================================================
351# EXPORTED FUNCTIONS
352# ==============================================================================
353
354# @FUNCTION: webapp_pkg_setup
355# @DESCRIPTION:
356# The default pkg_setup() for this eclass. This will gather required variables
357# from webapp-config and check if there is an application installed to
358# `${ROOT}/var/www/localhost/htdocs/${PN}/' if USE=vhosts is not set.
290# 359#
291# For now, we just make sure that root owns everything, and that there 360# You need to call this function BEFORE anything else has run in your custom
292# are no setuid files. I'm sure this will change significantly before 361# pkg_setup().
293# the final version! 362webapp_pkg_setup() {
294# ------------------------------------------------------------------------ 363 debug-print-function $FUNCNAME $*
295 364
365 # to test whether or not the ebuild has correctly called this function
366 # we add an empty file to the filesystem
367 #
368 # we used to just set a variable in the shell script, but we can
369 # no longer rely on Portage calling both webapp_pkg_setup() and
370 # webapp_src_install() within the same shell process
371 touch "${T}/${SETUP_CHECK_FILE}"
372
373 # special case - some ebuilds *do* need to overwride the SLOT
374 if [[ "${SLOT}+" != "${PVR}+" && "${WEBAPP_MANUAL_SLOT}" != "yes" ]]; then
375 die "Set WEBAPP_MANUAL_SLOT=\"yes\" if you need to SLOT manually"
376 fi
377
378 # pull in the shared configuration file
379 G_HOSTNAME="localhost"
380 webapp_read_config
381
382 local my_dir="${ROOT}${VHOST_ROOT}/${MY_HTDOCSBASE}/${PN}"
383
384 # if USE=vhosts is enabled OR no application is installed we're done here
385 if ! has vhosts ${IUSE} || use vhosts || [[ ! -d "${my_dir}" ]]; then
386 return
387 fi
388
389 local my_output
390 my_output="$(webapp_check_installedat)"
391
392 if [[ $? -ne 0 ]]; then
393 # okay, whatever is there, it isn't webapp-config-compatible
394 echo
395 ewarn
396 ewarn "You already have something installed in ${my_dir}"
397 ewarn
398 ewarn "Whatever is in ${my_dir}, it's not"
399 ewarn "compatible with webapp-config."
400 ewarn
401 ewarn "This ebuild may be overwriting important files."
402 ewarn
403 echo
404 ebeep 10
405 elif [[ "$(echo ${my_output} | awk '{ print $1 }')" != "${PN}" ]]; then
406 echo
407 eerror "You already have ${my_output} installed in ${my_dir}"
408 eerror
409 eerror "I cannot upgrade a different application"
410 eerror
411 echo
412 die "Cannot upgrade contents of ${my_dir}"
413 fi
414
415}
416
417# @FUNCTION: webapp_src_install
418# @DESCRIPTION:
419# This is the default src_install(). For now, we just make sure that root owns
420# everything, and that there are no setuid files.
421#
422# You need to call this function AFTER everything else has run in your custom
423# src_install().
296function webapp_src_install () 424webapp_src_install() {
297{ 425 debug-print-function $FUNCNAME $*
298 chown -R ${VHOST_DEFAULT_UID}:${VHOST_DEFAULT_GID} ${D}/
299 chmod -R u-s ${D}/
300 chmod -R g-s ${D}/
301
302 keepdir ${MY_PERSISTDIR}
303 fowners root:root ${MY_PERSISTDIR}
304 fperms 755 ${MY_PERSISTDIR}
305 426
306 # to test whether or not the ebuild has correctly called this function 427 # to test whether or not the ebuild has correctly called this function
307 # we add an empty file to the filesystem 428 # we add an empty file to the filesystem
308 # 429 #
309 # we used to just set a variable in the shell script, but we can 430 # we used to just set a variable in the shell script, but we can
310 # no longer rely on Portage calling both webapp_src_install() and 431 # no longer rely on Portage calling both webapp_src_install() and
311 # webapp_pkg_postinst() within the same shell process 432 # webapp_pkg_postinst() within the same shell process
312
313 touch ${D}/${MY_APPDIR}/${INSTALL_CHECK_FILE} 433 touch "${D}/${MY_APPDIR}/${INSTALL_CHECK_FILE}"
314}
315 434
316# ------------------------------------------------------------------------ 435 chown -R "${VHOST_DEFAULT_UID}:${VHOST_DEFAULT_GID}" "${D}/"
317# EXPORTED FUNCTION - call from inside your ebuild's pkg_config AFTER 436 chmod -R u-s "${D}/"
318# everything else has run 437 chmod -R g-s "${D}/"
438
439 keepdir "${MY_PERSISTDIR}"
440 fowners "root:0" "${MY_PERSISTDIR}"
441 fperms 755 "${MY_PERSISTDIR}"
442}
443
444# @FUNCTION: webapp_pkg_postinst
445# @DESCRIPTION:
446# The default pkg_postinst() for this eclass. This installs the web application to
447# `${ROOT}/var/www/localhost/htdocs/${PN}/' if USE=vhosts is not set. Otherwise
448# display a short notice how to install this application with webapp-config.
319# 449#
320# If 'vhosts' USE flag is not set, auto-install this app 450# You need to call this function AFTER everything else has run in your custom
321# 451# pkg_postinst().
322# ------------------------------------------------------------------------ 452webapp_pkg_postinst() {
453 debug-print-function $FUNCNAME $*
323 454
324function webapp_pkg_setup () 455 webapp_read_config
325{
326 # add sanity checks here
327 456
328 if [ "$SLOT+" != "${PVR}+" ]; then 457 # sanity checks, to catch bugs in the ebuild
329 die "ebuild sets SLOT, overrides webapp.eclass" 458 if [[ ! -f "${ROOT}${MY_APPDIR}/${INSTALL_CHECK_FILE}" ]]; then
459 eerror
460 eerror "This ebuild did not call webapp_src_install() at the end"
461 eerror "of the src_install() function"
462 eerror
463 eerror "Please log a bug on http://bugs.gentoo.org"
464 eerror
465 eerror "You should use emerge -C to remove this package, as the"
466 eerror "installation is incomplete"
467 eerror
468 die "Ebuild did not call webapp_src_install() - report to http://bugs.gentoo.org"
330 fi 469 fi
331 470
332 # pull in the shared configuration file 471 if has vhosts ${IUSE}; then
472 if ! use vhosts; then
473 echo
474 elog "vhosts USE flag not set - auto-installing using webapp-config"
333 475
334 G_HOSTNAME="localhost" 476 G_HOSTNAME="localhost"
335 . /etc/vhosts/webapp-config || die "Unable to open /etc/vhosts/webapp-config file" 477 webapp_read_config
336 478
337 # are we installing a webapp-config solution over the top of a 479 local my_mode=-I
338 # non-webapp-config solution? 480 webapp_getinstalltype
339 481
340 if ! use vhosts ; then 482 if [[ "${IS_REPLACE}" == "1" ]]; then
341 local my_dir="$VHOST_ROOT/$MY_HTDOCSBASE/$PN" 483 elog "${PN}-${PVR} is already installed - replacing"
342 local my_output 484 my_mode=-I
343 485 elif [[ "${IS_UPGRADE}" == "1" ]]; then
344 if [ -d "$my_dir" ] ; then 486 elog "${REMOVE_PKG} is already installed - upgrading"
345 einfo "You already have something installed in $my_dir" 487 my_mode=-U
346 einfo "Are you trying to install over the top of something I cannot upgrade?"
347
348 my_output="`webapp_check_installedat`"
349
350 if [ "$?" != "0" ]; then
351
352 # okay, whatever is there, it isn't webapp-config-compatible
353 ewarn
354 ewarn "Whatever is in $my_dir, it's not"
355 ewarn "compatible with webapp-config."
356 ewarn
357
358 my_output="`qpkg -nc -v -f $my_dir`"
359 if [ -n "$my_output" ]; then
360 eerror "Please remove $my_output and re-emerge."
361 else
362 eerror "Please remove the contents of $my_dir, and then re-emerge."
363 fi
364 die "Cannot upgrade contents of $my_dir"
365 elif [ "`echo $my_output | awk '{ print $1 }'`" != "$PN" ]; then
366 eerror "$my_dir contains $my_output"
367 eerror "I cannot upgrade that"
368 die "Cannot upgrade contents of $my_dir"
369 else 488 else
370 einfo 489 elog "${PN}-${PVR} is not installed - using install mode"
371 einfo "I can upgrade the contents of $my_dir"
372 einfo
373 fi 490 fi
491
492 my_cmd="${WEBAPP_CONFIG} ${my_mode} -h localhost -u root -d ${INSTALL_DIR} ${PN} ${PVR}"
493 elog "Running ${my_cmd}"
494 ${my_cmd}
495
496 echo
497 local cleaner="${WEBAPP_CLEANER} -p -C ${PN}"
498 einfo "Running ${cleaner}"
499 ${cleaner}
500 else
501 elog
502 elog "The 'vhosts' USE flag is switched ON"
503 elog "This means that Portage will not automatically run webapp-config to"
504 elog "complete the installation."
505 elog
506 elog "To install ${PN}-${PVR} into a virtual host, run the following command:"
507 elog
508 elog " webapp-config -I -h <host> -d ${PN} ${PN} ${PVR}"
509 elog
510 elog "For more details, see the webapp-config(8) man page"
374 fi 511 fi
512 else
513 elog
514 elog "This ebuild does not support the 'vhosts' USE flag."
515 elog "This means that Portage will not automatically run webapp-config to"
516 elog "complete the installation."
517 elog
518 elog "To install ${PN}-${PVR} into a virtual host, run the following command:"
519 elog
520 elog " webapp-config -I -h <host> -d ${PN} ${PN} ${PVR}"
521 elog
522 elog "For more details, see the webapp-config(8) man page"
375 fi 523 fi
376} 524}
377 525
378function webapp_someunusedfunction () 526# @FUNCTION: webapp_pkg_prerm
379{ 527# @DESCRIPTION:
380 # are we emerging something that is already installed? 528# This is the default pkg_prerm() for this eclass. If USE=vhosts is not set
529# remove all installed copies of this web application. Otherwise instruct the
530# user to manually remove those copies. See bug #136959.
531webapp_pkg_prerm() {
532 debug-print-function $FUNCNAME $*
381 533
382 if [ -d "${D}${MY_APPROOT}/${MY_APPSUFFIX}" ]; then
383 # yes we are
384 ewarn "Removing existing copy of ${PN}-${PVR}"
385 rm -rf "${D}${MY_APPROOT}/${MY_APPSUFFIX}"
386 fi
387}
388
389function webapp_getinstalltype ()
390{
391 # or are we upgrading?
392
393 if ! use vhosts ; then
394 # we only run webapp-config if vhosts USE flag is not set
395
396 local my_output 534 local my_output=
535 my_output="$(${WEBAPP_CONFIG} --list-installs ${PN} ${PVR})"
536 [[ $? -ne 0 ]] && return
397 537
398 my_output="`webapp_check_installedat`" 538 local x
399 539 if has vhosts ${IUSE} && ! use vhosts; then
400 if [ "$?" = "0" ] ; then 540 echo "${my_output}" | while read x; do
401 # something is already installed there 541 if [[ -f "${x}"/.webapp ]]; then
402 # 542 . "${x}"/.webapp
403 # make sure it isn't the same version 543 if [[ -n "${WEB_HOSTNAME}" && -n "${WEB_INSTALLDIR}" ]]; then
404 544 ${WEBAPP_CONFIG} -C -h ${WEB_HOSTNAME} -d ${WEB_INSTALLDIR}
405 local my_pn="`echo $my_output | awk '{ print $1 }'`"
406 local my_pvr="`echo $my_output | awk '{ print $2 }'`"
407
408 REMOVE_PKG="${my_pn}-${my_pvr}"
409
410 if [ "$my_pn" == "$PN" ]; then
411 if [ "$my_pvr" != "$PVR" ]; then
412 einfo "This is an upgrade"
413 IS_UPGRADE=1
414 else
415 einfo "This is a re-installation"
416 IS_REPLACE=1
417 fi 545 fi
418 else 546 else
419 einfo "$my_ouptut is installed there" 547 ewarn "Cannot find file ${x}/.webapp"
420 fi 548 fi
421 else 549 done
422 einfo "This is an installation" 550 elif [[ "${my_output}" != "" ]]; then
423 fi
424 fi
425}
426
427function webapp_src_preinst ()
428{
429 # create the directories that we need
430
431 dodir ${MY_HTDOCSDIR}
432 dodir ${MY_HOSTROOTDIR}
433 dodir ${MY_CGIBINDIR}
434 dodir ${MY_ICONSDIR}
435 dodir ${MY_ERRORSDIR}
436 dodir ${MY_SQLSCRIPTSDIR}
437}
438
439function webapp_pkg_postinst ()
440{
441 # sanity checks, to catch bugs in the ebuild
442
443 if [ ! -f ${MY_APPDIR}/${INSTALL_CHECK_FILE} ]; then
444 eerror
445 eerror "This ebuild did not call webapp_src_install() at the end"
446 eerror "of the src_install() function"
447 eerror
448 eerror "Please log a bug on http://bugs.gentoo.org"
449 eerror
450 eerror "You should use emerge -C to remove this package, as the"
451 eerror "installation is incomplete"
452 eerror
453 die "Ebuild did not call webapp_src_install() - report to http://bugs.gentoo.org"
454 fi
455
456 # if 'vhosts' is not set in your USE flags, we install a copy of
457 # this application in /var/www/localhost/htdocs/${PN}/ for you
458
459 if ! use vhosts ; then
460 echo 551 echo
461 einfo "vhosts USE flag not set - auto-installing using webapp-config" 552 ewarn
462
463 webapp_getinstalltype
464
465 G_HOSTNAME="localhost"
466 . /etc/vhosts/webapp-config
467
468 local my_mode=-I
469
470 if [ "$IS_REPLACE" = "1" ]; then
471 einfo "${PN}-${PVR} is already installed - replacing"
472 /usr/sbin/webapp-config -C -d "$INSTALL_DIR"
473 elif [ "$IS_UPGRADE" = "1" ]; then
474 einfo "$REMOVE_PKG is already installed - upgrading"
475 my_mode=-U
476 else
477 einfo "${PN}-${PVR} is not installed - using install mode"
478 fi
479
480 my_cmd="/usr/sbin/webapp-config $my_mode -h localhost -u root -d $INSTALL_DIR ${PN} ${PVR}"
481 einfo "Running $my_cmd"
482 $my_cmd
483
484 # remove the old version
485 #
486 # why do we do this? well ...
487 #
488 # normally, emerge -u installs a new version and then removes the
489 # old version. however, if the new version goes into a different
490 # slot to the old version, then the old version gets left behind
491 #
492 # if USE=-vhosts, then we want to remove the old version, because
493 # the user is relying on portage to do the magical thing for it
494
495 if [ "$IS_UPGRADE" = "1" ] ; then
496 einfo "Removing old version $REMOVE_PKG"
497
498 emerge -C $CATEGORY/$REMOVE_PKG
499 fi
500 else
501 # vhosts flag is on
502 #
503 # let's tell the administrator what to do next
504
505 einfo
506 einfo "The 'vhosts' USE flag is switched ON"
507 einfo "This means that Portage will not automatically run webapp-config to"
508 einfo "complete the installation."
509 einfo
510 einfo "To install $PN-$PVR into a virtual host, run the following command:"
511 einfo
512 einfo " webapp-config -I -h <host> -d $PN $PN $PVR"
513 einfo
514 einfo "For more details, see the webapp-config(8) man page"
515 fi
516
517 return 0
518}
519
520function webapp_pkg_prerm ()
521{
522 # remove any virtual installs that there are
523
524 local my_output
525 local x
526
527 my_output="`webapp-config --list-installs $PN $PVR`"
528
529 if [ "$?" != "0" ]; then
530 return
531 fi
532
533 # the changes to IFS here are necessary to ensure that we can cope
534 # with directories that contain spaces in the file names
535
536 # OLD_IFS="$IFS"
537 # IFS=" "
538
539 for x in $my_output ; do
540 # IFS="$OLD_IFS"
541
542 [ -f $x/.webapp ] && . $x/.webapp || ewarn "Cannot find file $x/.webapp"
543
544 if [ -z "WEB_HOSTNAME" -o -z "WEB_INSTALLDIR" ]; then
545 ewarn "Don't forget to use webapp-config to remove the copy of" 553 ewarn "Don't forget to use webapp-config to remove any copies of"
546 ewarn "${PN}-${PVR} installed in" 554 ewarn "${PN}-${PVR} installed in"
547 ewarn 555 ewarn
556
557 echo "${my_output}" | while read x; do
558 if [[ -f "${x}"/.webapp ]]; then
548 ewarn " $x" 559 ewarn " ${x}"
560 else
561 ewarn "Cannot find file ${x}/.webapp"
562 fi
563 done
564
549 ewarn 565 ewarn
550 else 566 echo
551 # we have enough information to remove the virtual copy ourself
552
553 webapp-config -C -h ${WEB_HOSTNAME} -d ${WEB_INSTALLDIR}
554
555 # if the removal fails - we carry on anyway!
556 fi 567 fi
557 # IFS=" "
558 done
559
560 # IFS="$OLD_IFS"
561} 568}

Legend:
Removed from v.1.19  
changed lines
  Added in v.1.66

  ViewVC Help
Powered by ViewVC 1.1.20