| 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.13 2004/04/30 08:25:38 stuart Exp $ |
3 | # $Header: /var/cvsroot/gentoo-x86/eclass/webapp.eclass,v 1.53 2008/02/22 14:06:05 hollow 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 | # Please do not make modifications to this file without checking with a |
|
|
| 15 | # member of the web-apps herd first! |
|
|
| 16 | # |
|
|
| 17 | # ------------------------------------------------------------------------ |
|
|
| 18 | |
12 | |
| 19 | ECLASS=webapp |
|
|
| 20 | INHERITED="$INHERITED $ECLASS" |
|
|
| 21 | SLOT="${PVR}" |
13 | SLOT="${PVR}" |
| 22 | IUSE="$IUSE vhosts" |
14 | IUSE="vhosts" |
| 23 | DEPEND="$DEPEND >=net-www/webapp-config-1.6" |
15 | DEPEND=">=app-admin/webapp-config-1.50.15" |
|
|
16 | RDEPEND="${DEPEND}" |
| 24 | |
17 | |
| 25 | EXPORT_FUNCTIONS pkg_postinst pkg_setup src_install |
18 | EXPORT_FUNCTIONS pkg_postinst pkg_setup src_install pkg_prerm |
| 26 | |
19 | |
| 27 | # ------------------------------------------------------------------------ |
20 | INSTALL_DIR="/${PN}" |
| 28 | # INTERNAL FUNCTION - USED BY THIS ECLASS ONLY |
21 | IS_UPGRADE=0 |
| 29 | # |
22 | IS_REPLACE=0 |
|
|
23 | |
|
|
24 | INSTALL_CHECK_FILE="installed_by_webapp_eclass" |
|
|
25 | |
|
|
26 | ETC_CONFIG="${ROOT}etc/vhosts/webapp-config" |
|
|
27 | WEBAPP_CONFIG="${ROOT}usr/sbin/webapp-config" |
|
|
28 | WEBAPP_CLEANER="${ROOT}usr/sbin/webapp-cleaner" |
|
|
29 | |
|
|
30 | # ============================================================================== |
|
|
31 | # INTERNAL FUNCTIONS |
|
|
32 | # ============================================================================== |
|
|
33 | |
|
|
34 | # Load the config file /etc/vhosts/webapp-config |
|
|
35 | # Supports both the old bash version, and the new python version |
|
|
36 | webapp_read_config() { |
|
|
37 | debug-print-function $FUNCNAME $* |
|
|
38 | |
|
|
39 | if has_version '>=app-admin/webapp-config-1.50'; then |
|
|
40 | ENVVAR=$(${WEBAPP_CONFIG} --query ${PN} ${PVR}) || die "Could not read settings from webapp-config!" |
|
|
41 | eval ${ENVVAR} |
|
|
42 | else |
|
|
43 | . ${ETC_CONFIG} || die "Unable to read ${ETC_CONFIG}" |
|
|
44 | fi |
|
|
45 | } |
|
|
46 | |
| 30 | # Check whether a specified file exists within the image/ directory |
47 | # Check whether a specified file exists in the given directory (`.' by default) |
| 31 | # or not. |
|
|
| 32 | # |
|
|
| 33 | # @param $1 - file to look for |
|
|
| 34 | # @param $2 - prefix directory to use |
|
|
| 35 | # @return 0 on success, never returns on an error |
|
|
| 36 | # ------------------------------------------------------------------------ |
|
|
| 37 | |
|
|
| 38 | function webapp_checkfileexists () |
48 | webapp_checkfileexists() { |
| 39 | { |
49 | debug-print-function $FUNCNAME $* |
| 40 | local my_prefix |
|
|
| 41 | |
50 | |
| 42 | [ -n "$2" ] && my_prefix="$2/" || my_prefix= |
51 | local my_prefix=${2:+${2}/} |
| 43 | |
52 | |
| 44 | if [ ! -e ${my_prefix}$1 ]; then |
53 | if [[ ! -e "${my_prefix}${1}" ]]; then |
| 45 | msg="ebuild fault: file $1 not found" |
54 | msg="ebuild fault: file '${1}' not found" |
| 46 | eerror "$msg" |
55 | eerror "$msg" |
| 47 | eerror "Please report this as a bug at http://bugs.gentoo.org/" |
56 | eerror "Please report this as a bug at http://bugs.gentoo.org/" |
| 48 | die "$msg" |
57 | die "$msg" |
| 49 | fi |
58 | fi |
| 50 | } |
59 | } |
| 51 | |
60 | |
| 52 | # ------------------------------------------------------------------------ |
61 | webapp_check_installedat() { |
| 53 | # INTERNAL FUNCTION - USED BY THIS ECLASS ONLY |
62 | debug-print-function $FUNCNAME $* |
| 54 | # ------------------------------------------------------------------------ |
63 | ${WEBAPP_CONFIG} --show-installed -h localhost -d "${INSTALL_DIR}" 2> /dev/null |
|
|
64 | } |
| 55 | |
65 | |
| 56 | function webapp_import_config () |
66 | webapp_strip_appdir() { |
| 57 | { |
67 | debug-print-function $FUNCNAME $* |
| 58 | if [ -z "${MY_HTDOCSDIR}" ]; then |
68 | echo "${1#${MY_APPDIR}/}" |
| 59 | . /etc/conf.d/webapp-config |
69 | } |
|
|
70 | |
|
|
71 | webapp_strip_d() { |
|
|
72 | debug-print-function $FUNCNAME $* |
|
|
73 | echo "${1#${D}}" |
|
|
74 | } |
|
|
75 | |
|
|
76 | webapp_strip_cwd() { |
|
|
77 | debug-print-function $FUNCNAME $* |
|
|
78 | echo "${1/#.\///}" |
|
|
79 | } |
|
|
80 | |
|
|
81 | webapp_getinstalltype() { |
|
|
82 | debug-print-function $FUNCNAME $* |
|
|
83 | |
|
|
84 | if ! use vhosts; then |
|
|
85 | local my_output |
|
|
86 | |
|
|
87 | my_output="$(webapp_check_installedat)" |
|
|
88 | |
|
|
89 | if [[ $? -eq 0 ]]; then |
|
|
90 | # something is already installed there |
|
|
91 | # make sure it isn't the same version |
|
|
92 | |
|
|
93 | local my_pn="$(echo ${my_output} | awk '{ print $1 }')" |
|
|
94 | local my_pvr="$(echo ${my_output} | awk '{ print $2 }')" |
|
|
95 | |
|
|
96 | REMOVE_PKG="${my_pn}-${my_pvr}" |
|
|
97 | |
|
|
98 | if [[ "${my_pn}" == "${PN}" ]]; then |
|
|
99 | if [[ "${my_pvr}" != "${PVR}" ]]; then |
|
|
100 | elog "This is an upgrade" |
|
|
101 | IS_UPGRADE=1 |
|
|
102 | else |
|
|
103 | elog "This is a re-installation" |
|
|
104 | IS_REPLACE=1 |
|
|
105 | fi |
|
|
106 | else |
|
|
107 | elog "${my_output} is installed there" |
|
|
108 | fi |
|
|
109 | else |
|
|
110 | elog "This is an installation" |
| 60 | fi |
111 | fi |
| 61 | |
|
|
| 62 | if [ -z "${MY_HTDOCSDIR}" ]; then |
|
|
| 63 | libsh_edie "/etc/conf.d/webapp-config not imported" |
|
|
| 64 | fi |
112 | fi |
| 65 | } |
113 | } |
| 66 | |
114 | |
| 67 | # ------------------------------------------------------------------------ |
115 | # ============================================================================== |
| 68 | # INTERNAL FUNCTION - USED BY THIS ECLASS ONLY |
116 | # PUBLIC FUNCTIONS |
| 69 | # |
117 | # ============================================================================== |
| 70 | # ------------------------------------------------------------------------ |
|
|
| 71 | |
118 | |
| 72 | function webapp_strip_appdir () |
119 | # @FUNCTION: webapp_configfile |
| 73 | { |
120 | # @USAGE: <file> [more files ...] |
| 74 | echo "$1" | sed -e "s|${MY_APPDIR}/||g;" |
121 | # @DESCRIPTION: |
| 75 | } |
122 | # Mark a file config-protected for a web-based application. |
| 76 | |
|
|
| 77 | function webapp_strip_d () |
|
|
| 78 | { |
|
|
| 79 | echo "$1" | sed -e "s|${D}||g;" |
|
|
| 80 | } |
|
|
| 81 | |
|
|
| 82 | function webapp_strip_cwd () |
|
|
| 83 | { |
|
|
| 84 | echo "$1" | sed -e 's|/./|/|g;' |
|
|
| 85 | } |
|
|
| 86 | |
|
|
| 87 | # ------------------------------------------------------------------------ |
|
|
| 88 | # EXPORTED FUNCTION - FOR USE IN EBUILDS |
|
|
| 89 | # |
|
|
| 90 | # Identify a config file for a web-based application. |
|
|
| 91 | # |
|
|
| 92 | # @param $1 - config file |
|
|
| 93 | # ------------------------------------------------------------------------ |
|
|
| 94 | |
|
|
| 95 | function webapp_configfile () |
123 | webapp_configfile() { |
| 96 | { |
124 | debug-print-function $FUNCNAME $* |
|
|
125 | |
|
|
126 | local m="" |
|
|
127 | for m in "$@"; do |
| 97 | webapp_checkfileexists "$1" "$D" |
128 | webapp_checkfileexists "${m}" "${D}" |
| 98 | echo $1 |
129 | |
| 99 | local MY_FILE="`webapp_strip_appdir $1`" |
130 | local MY_FILE="$(webapp_strip_appdir "${m}")" |
| 100 | echo $MY_FILE |
131 | MY_FILE="$(webapp_strip_cwd "${MY_FILE}")" |
| 101 | |
132 | |
| 102 | einfo "(config) $MY_FILE" |
133 | elog "(config) ${MY_FILE}" |
| 103 | echo "$MY_FILE" >> ${D}${WA_CONFIGLIST} |
134 | echo "${MY_FILE}" >> ${D}/${WA_CONFIGLIST} |
|
|
135 | done |
| 104 | } |
136 | } |
| 105 | |
137 | |
| 106 | # ------------------------------------------------------------------------ |
138 | # @FUNCTION: webapp_hook_script |
| 107 | # EXPORTED FUNCTION - FOR USE IN EBUILDS |
139 | # @USAGE: <file> |
| 108 | # |
140 | # @DESCRIPTION: |
|
|
141 | # Install a script that will run after a virtual copy is created, and |
|
|
142 | # before a virtual copy has been removed. |
|
|
143 | webapp_hook_script() { |
|
|
144 | debug-print-function $FUNCNAME $* |
|
|
145 | |
|
|
146 | webapp_checkfileexists "${1}" |
|
|
147 | |
|
|
148 | elog "(hook) ${1}" |
|
|
149 | cp "${1}" "${D}/${MY_HOOKSCRIPTSDIR}/$(basename "${1}")" || die "Unable to install ${1} into ${D}/${MY_HOOKSCRIPTSDIR}/" |
|
|
150 | chmod 555 "${D}/${MY_HOOKSCRIPTSDIR}/$(basename "${1}")" |
|
|
151 | } |
|
|
152 | |
|
|
153 | # @FUNCTION: webapp_postinst_txt |
|
|
154 | # @USAGE: <lang> <file> |
|
|
155 | # @DESCRIPTION: |
| 109 | # Install a text file containing post-installation instructions. |
156 | # Install a text file containing post-installation instructions. |
| 110 | # |
157 | webapp_postinst_txt() { |
| 111 | # @param $1 - language code (use 'en' for now) |
158 | debug-print-function $FUNCNAME $* |
| 112 | # @param $2 - the file to install |
|
|
| 113 | # ------------------------------------------------------------------------ |
|
|
| 114 | |
159 | |
| 115 | function webapp_postinst_txt |
|
|
| 116 | { |
|
|
| 117 | webapp_checkfileexists "$2" |
160 | webapp_checkfileexists "${2}" |
| 118 | |
161 | |
| 119 | einfo "(rtfm) $2 (lang: $1)" |
162 | elog "(info) ${2} (lang: ${1})" |
| 120 | cp "$2" "${D}${MY_APPDIR}/postinst-$1.txt" |
163 | cp "${2}" "${D}/${MY_APPDIR}/postinst-${1}.txt" |
| 121 | } |
164 | } |
| 122 | |
165 | |
| 123 | # ------------------------------------------------------------------------ |
166 | # @FUNCTION: webapp_postupgrade_txt |
| 124 | # EXPORTED FUNCTION - FOR USE IN EBUILDS |
167 | # @USAGE: <lang> <file> |
| 125 | # |
168 | # @DESCRIPTION: |
| 126 | # Identify a script file (usually, but not always PHP or Perl) which is |
169 | # Install a text file containing post-upgrade instructions. |
| 127 | # |
170 | webapp_postupgrade_txt() { |
| 128 | # Files in this list may be modified to #! the required CGI engine when |
171 | debug-print-function $FUNCNAME $* |
| 129 | # installed by webapp-config tool in the future. |
|
|
| 130 | # |
|
|
| 131 | # @param $1 - the cgi engine to use |
|
|
| 132 | # @param $2 - the script file that could run under a cgi-bin |
|
|
| 133 | # |
|
|
| 134 | # ------------------------------------------------------------------------ |
|
|
| 135 | |
172 | |
| 136 | function webapp_runbycgibin () |
|
|
| 137 | { |
|
|
| 138 | webapp_checkfileexists "$2" "$D" |
|
|
| 139 | local MY_FILE="`webapp_strip_appdir $2`" |
|
|
| 140 | MY_FILE="`webapp_strip_cwd $MY_FILE`" |
|
|
| 141 | |
|
|
| 142 | einfo "(cgi-bin) $1 - $MY_FILE" |
|
|
| 143 | echo "$1 $MY_FILE" >> ${D}${WA_RUNBYCGIBINLIST} |
|
|
| 144 | } |
|
|
| 145 | |
|
|
| 146 | # ------------------------------------------------------------------------ |
|
|
| 147 | # EXPORTED FUNCTION - FOR USE IN EBUILDS |
|
|
| 148 | # |
|
|
| 149 | # Identify a file which must be owned by the webserver's user:group |
|
|
| 150 | # settings. |
|
|
| 151 | # |
|
|
| 152 | # The ownership of the file is NOT set until the application is installed |
|
|
| 153 | # using the webapp-config tool. |
|
|
| 154 | # |
|
|
| 155 | # @param $1 - file to be owned by the webserver user:group combo |
|
|
| 156 | # |
|
|
| 157 | # ------------------------------------------------------------------------ |
|
|
| 158 | |
|
|
| 159 | function webapp_serverowned () |
|
|
| 160 | { |
|
|
| 161 | webapp_checkfileexists "$1" "$D" |
|
|
| 162 | local MY_FILE="`webapp_strip_appdir $1`" |
|
|
| 163 | |
|
|
| 164 | einfo "(server owned) $MY_FILE" |
|
|
| 165 | echo "$MY_FILE" >> ${D}${WA_SOLIST} |
|
|
| 166 | } |
|
|
| 167 | |
|
|
| 168 | # ------------------------------------------------------------------------ |
|
|
| 169 | # EXPORTED FUNCTION - FOR USE IN EBUILDS |
|
|
| 170 | # |
|
|
| 171 | # |
|
|
| 172 | # @param $1 - the db engine that the script is for |
|
|
| 173 | # (one of: mysql|postgres) |
|
|
| 174 | # @param $2 - the sql script to be installed |
|
|
| 175 | # @param $3 - the older version of the app that this db script |
|
|
| 176 | # will upgrade from |
|
|
| 177 | # (do not pass this option if your SQL script only creates |
|
|
| 178 | # a new db from scratch) |
|
|
| 179 | # ------------------------------------------------------------------------ |
|
|
| 180 | |
|
|
| 181 | function webapp_sqlscript () |
|
|
| 182 | { |
|
|
| 183 | webapp_checkfileexists "$2" |
173 | webapp_checkfileexists "${2}" |
| 184 | |
174 | |
| 185 | # create the directory where this script will go |
175 | elog "(info) ${2} (lang: ${1})" |
| 186 | # |
176 | cp "${2}" "${D}/${MY_APPDIR}/postupgrade-${1}.txt" |
| 187 | # scripts for specific database engines go into their own subdirectory |
177 | } |
| 188 | # just to keep things readable on the filesystem |
|
|
| 189 | |
178 | |
| 190 | if [ ! -d "${D}${MY_SQLSCRIPTSDIR}/$1" ]; then |
179 | # @FUNCTION: webapp_serverowned |
| 191 | mkdir -p "${D}${MY_SQLSCRIPTSDIR}/$1" || libsh_die "unable to create directory ${D}${MY_SQLSCRIPTSDIR}/$1" |
180 | # @USAGE: [-R] <file> [more files ...] |
| 192 | fi |
181 | # @DESCRIPTION: |
|
|
182 | # Identify a file which must be owned by the webserver's user:group settings. |
|
|
183 | # The ownership of the file is NOT set until the application is installed using |
|
|
184 | # the webapp-config tool. If -R is given directories are handled recursively. |
|
|
185 | webapp_serverowned() { |
|
|
186 | debug-print-function $FUNCNAME $* |
| 193 | |
187 | |
| 194 | # warning: |
188 | local a="" |
|
|
189 | local m="" |
|
|
190 | if [[ "${1}" == "-R" ]]; then |
|
|
191 | shift |
|
|
192 | for m in "$@"; do |
|
|
193 | for a in $(find ${D}/${m}); do |
|
|
194 | a=${a/${D}\/\///} |
|
|
195 | webapp_checkfileexists "${a}" "$D" |
|
|
196 | local MY_FILE="$(webapp_strip_appdir "${a}")" |
|
|
197 | MY_FILE="$(webapp_strip_cwd "${MY_FILE}")" |
|
|
198 | |
|
|
199 | elog "(server owned) ${MY_FILE}" |
|
|
200 | echo "${MY_FILE}" >> "${D}/${WA_SOLIST}" |
|
|
201 | done |
|
|
202 | done |
|
|
203 | else |
|
|
204 | for m in "$@"; do |
|
|
205 | webapp_checkfileexists "${m}" "$D" |
|
|
206 | local MY_FILE="$(webapp_strip_appdir "${m}")" |
|
|
207 | MY_FILE="$(webapp_strip_cwd "${MY_FILE}")" |
|
|
208 | |
|
|
209 | elog "(server owned) ${MY_FILE}" |
|
|
210 | echo "${MY_FILE}" >> "${D}/${WA_SOLIST}" |
|
|
211 | done |
|
|
212 | fi |
|
|
213 | } |
|
|
214 | |
|
|
215 | # @FUNCTION: webapp_server_configfile |
|
|
216 | # @USAGE: <server> <file> [new name] |
|
|
217 | # @DESCRIPTION: |
|
|
218 | # Install a configuration file for the webserver. You need to specify a |
|
|
219 | # webapp-config supported <server>. if no new name is given `basename $2' is |
|
|
220 | # used by default. Note: this function will automagically prepend $1 to the |
|
|
221 | # front of your config file's name. |
|
|
222 | webapp_server_configfile() { |
|
|
223 | debug-print-function $FUNCNAME $* |
|
|
224 | |
|
|
225 | webapp_checkfileexists "${2}" |
|
|
226 | |
|
|
227 | # WARNING: |
| 195 | # |
228 | # |
| 196 | # do NOT change the naming convention used here without changing all |
229 | # do NOT change the naming convention used here without changing all |
| 197 | # the other scripts that also rely upon these names |
230 | # the other scripts that also rely upon these names |
| 198 | |
231 | |
| 199 | # are we dealing with an 'upgrade'-type script? |
232 | local my_file="${1}-${3:-$(basename "${2}")}" |
|
|
233 | |
|
|
234 | elog "(${1}) config file '${my_file}'" |
|
|
235 | cp "${2}" "${D}/${MY_SERVERCONFIGDIR}/${my_file}" |
|
|
236 | } |
|
|
237 | |
|
|
238 | # @FUNCTION: webapp_sqlscript |
|
|
239 | # @USAGE: <db> <file> [version] |
|
|
240 | # @DESCRIPTION: |
|
|
241 | # Install a SQL script that creates/upgrades a database schema for the web |
|
|
242 | # application. Currently supported database engines are mysql and postgres. |
|
|
243 | # If a version is given the script should upgrade the database schema from |
|
|
244 | # the given version to $PVR. |
|
|
245 | webapp_sqlscript() { |
|
|
246 | debug-print-function $FUNCNAME $* |
|
|
247 | |
|
|
248 | webapp_checkfileexists "${2}" |
|
|
249 | |
|
|
250 | if [[ ! -d "${D}/${MY_SQLSCRIPTSDIR}/${1}" ]]; then |
|
|
251 | mkdir -p "${D}/${MY_SQLSCRIPTSDIR}/${1}" || die "unable to create directory ${D}/${MY_SQLSCRIPTSDIR}/${1}" |
|
|
252 | fi |
|
|
253 | |
|
|
254 | # WARNING: |
|
|
255 | # |
|
|
256 | # do NOT change the naming convention used here without changing all |
|
|
257 | # the other scripts that also rely upon these names |
|
|
258 | |
| 200 | if [ -n "$3" ]; then |
259 | if [[ -n "${3}" ]]; then |
| 201 | # yes we are |
|
|
| 202 | einfo "($1) upgrade script from ${PN}-${PVR} to $3" |
260 | elog "(${1}) upgrade script for ${PN}-${3} to ${PVR}" |
| 203 | cp $2 ${D}${MY_SQLSCRIPTSDIR}/$1/${3}_to_${PVR}.sql |
261 | cp "${2}" "${D}${MY_SQLSCRIPTSDIR}/${1}/${3}_to_${PVR}.sql" |
|
|
262 | chmod 600 "${D}${MY_SQLSCRIPTSDIR}/${1}/${3}_to_${PVR}.sql" |
| 204 | else |
263 | else |
| 205 | # no, we are not |
|
|
| 206 | einfo "($1) create script for ${PN}-${PVR}" |
264 | elog "(${1}) create script for ${PN}-${PVR}" |
| 207 | cp $2 ${D}${MY_SQLSCRIPTSDIR}/$1/${PVR}_create.sql |
265 | cp "${2}" "${D}/${MY_SQLSCRIPTSDIR}/${1}/${PVR}_create.sql" |
|
|
266 | chmod 600 "${D}/${MY_SQLSCRIPTSDIR}/${1}/${PVR}_create.sql" |
| 208 | fi |
267 | fi |
| 209 | } |
268 | } |
| 210 | |
269 | |
| 211 | # ------------------------------------------------------------------------ |
270 | # @FUNCTION: webapp_src_preinst |
| 212 | # EXPORTED FUNCTION - call from inside your ebuild's src_install AFTER |
271 | # @DESCRIPTION: |
| 213 | # everything else has run |
272 | # You need to call this function in src_install() BEFORE anything else has run. |
|
|
273 | # For now we just create required webapp-config directories. |
|
|
274 | webapp_src_preinst() { |
|
|
275 | debug-print-function $FUNCNAME $* |
|
|
276 | |
|
|
277 | dodir "${MY_HTDOCSDIR}" |
|
|
278 | dodir "${MY_HOSTROOTDIR}" |
|
|
279 | dodir "${MY_CGIBINDIR}" |
|
|
280 | dodir "${MY_ICONSDIR}" |
|
|
281 | dodir "${MY_ERRORSDIR}" |
|
|
282 | dodir "${MY_SQLSCRIPTSDIR}" |
|
|
283 | dodir "${MY_HOOKSCRIPTSDIR}" |
|
|
284 | dodir "${MY_SERVERCONFIGDIR}" |
|
|
285 | } |
|
|
286 | |
|
|
287 | # ============================================================================== |
|
|
288 | # EXPORTED FUNCTIONS |
|
|
289 | # ============================================================================== |
|
|
290 | |
|
|
291 | # @FUNCTION: webapp_src_install |
|
|
292 | # @DESCRIPTION: |
|
|
293 | # This is the default src_install(). For now, we just make sure that root owns |
|
|
294 | # everything, and that there are no setuid files. |
| 214 | # |
295 | # |
| 215 | # For now, we just make sure that root owns everything, and that there |
296 | # You need to call this function AFTER everything else has run in your custom |
| 216 | # are no setuid files. I'm sure this will change significantly before |
297 | # src_install(). |
| 217 | # the final version! |
|
|
| 218 | # ------------------------------------------------------------------------ |
|
|
| 219 | |
|
|
| 220 | function webapp_src_install () |
298 | webapp_src_install() { |
| 221 | { |
299 | debug-print-function $FUNCNAME $* |
| 222 | chown -R root:root ${D}/ |
300 | |
|
|
301 | chown -R "${VHOST_DEFAULT_UID}:${VHOST_DEFAULT_GID}" "${D}/" |
| 223 | chmod -R u-s ${D}/ |
302 | chmod -R u-s "${D}/" |
| 224 | chmod -R g-s ${D}/ |
303 | chmod -R g-s "${D}/" |
| 225 | |
304 | |
| 226 | keepdir ${MY_PERSISTDIR} |
305 | keepdir "${MY_PERSISTDIR}" |
| 227 | fowners root:root ${MY_PERSISTDIR} |
306 | fowners "root:0" "${MY_PERSISTDIR}" |
| 228 | fperms 755 ${MY_PERSISTDIR} |
307 | fperms 755 "${MY_PERSISTDIR}" |
| 229 | } |
|
|
| 230 | |
308 | |
| 231 | # ------------------------------------------------------------------------ |
309 | # to test whether or not the ebuild has correctly called this function |
| 232 | # EXPORTED FUNCTION - call from inside your ebuild's pkg_config AFTER |
310 | # we add an empty file to the filesystem |
| 233 | # everything else has run |
311 | # |
|
|
312 | # we used to just set a variable in the shell script, but we can |
|
|
313 | # no longer rely on Portage calling both webapp_src_install() and |
|
|
314 | # webapp_pkg_postinst() within the same shell process |
|
|
315 | |
|
|
316 | touch "${D}/${MY_APPDIR}/${INSTALL_CHECK_FILE}" |
|
|
317 | } |
|
|
318 | |
|
|
319 | # @FUNCTION: webapp_pkg_setup |
|
|
320 | # @DESCRIPTION: |
|
|
321 | # The default pkg_setup() for this eclass. This will gather required variables |
|
|
322 | # from webapp-config and check if there is an application installed to |
|
|
323 | # `${ROOT}/var/www/localhost/htdocs/${PN}/' if USE=vhosts is not set. |
| 234 | # |
324 | # |
| 235 | # If 'vhosts' USE flag is not set, auto-install this app |
325 | # You need to call this function BEFORE anything else has run in your custom |
|
|
326 | # pkg_setup(). |
|
|
327 | webapp_pkg_setup() { |
|
|
328 | debug-print-function $FUNCNAME $* |
|
|
329 | |
|
|
330 | # special case - some ebuilds *do* need to overwride the SLOT |
|
|
331 | if [[ "${SLOT}+" != "${PVR}+" && "${WEBAPP_MANUAL_SLOT}" != "yes" ]]; then |
|
|
332 | die "Set WEBAPP_MANUAL_SLOT=\"yes\" if you need to SLOT manually" |
|
|
333 | fi |
|
|
334 | |
|
|
335 | # pull in the shared configuration file |
|
|
336 | G_HOSTNAME="localhost" |
|
|
337 | webapp_read_config |
|
|
338 | |
|
|
339 | # are we installing a webapp-config solution over the top of a |
|
|
340 | # non-webapp-config solution? |
|
|
341 | if ! use vhosts; then |
|
|
342 | local my_dir="${ROOT}${VHOST_ROOT}/${MY_HTDOCSBASE}/${PN}" |
|
|
343 | local my_output |
|
|
344 | |
|
|
345 | if [[ -d "${my_dir}" ]]; then |
|
|
346 | my_output="$(webapp_check_installedat)" |
|
|
347 | |
|
|
348 | if [[ $? -ne 0 ]]; then |
|
|
349 | # okay, whatever is there, it isn't webapp-config-compatible |
|
|
350 | ewarn "You already have something installed in ${my_dir}" |
|
|
351 | ewarn |
|
|
352 | ewarn "Whatever is in ${my_dir}, it's not" |
|
|
353 | ewarn "compatible with webapp-config." |
|
|
354 | ewarn |
|
|
355 | ewarn "This ebuild may be overwriting important files." |
|
|
356 | ewarn |
|
|
357 | elif [[ "$(echo ${my_output} | awk '{ print $1 }')" != "${PN}" ]]; then |
|
|
358 | eerror "${my_dir} contains ${my_output}" |
|
|
359 | eerror "I cannot upgrade that" |
|
|
360 | die "Cannot upgrade contents of ${my_dir}" |
|
|
361 | fi |
|
|
362 | fi |
|
|
363 | fi |
|
|
364 | } |
|
|
365 | |
|
|
366 | # @FUNCTION: webapp_pkg_postinst |
|
|
367 | # @DESCRIPTION: |
|
|
368 | # The default pkg_postinst() for this eclass. This installs the web application to |
|
|
369 | # `${ROOT}/var/www/localhost/htdocs/${PN}/' if USE=vhosts is not set. Otherwise |
|
|
370 | # display a short notice how to install this application with webapp-config. |
| 236 | # |
371 | # |
| 237 | # ------------------------------------------------------------------------ |
372 | # You need to call this function AFTER everything else has run in your custom |
| 238 | |
373 | # pkg_postinst(). |
| 239 | function webapp_pkg_setup () |
|
|
| 240 | { |
|
|
| 241 | # pull in the shared configuration file |
|
|
| 242 | |
|
|
| 243 | . /etc/vhosts/webapp-config || die "Unable to open /etc/vhosts/webapp-config file" |
|
|
| 244 | |
|
|
| 245 | # are we emerging something that is already installed? |
|
|
| 246 | |
|
|
| 247 | if [ -d "${D}${MY_APPROOT}/${MY_APPSUFFIX}" ]; then |
|
|
| 248 | # yes we are |
|
|
| 249 | ewarn "Removing existing copy of ${PN}-${PVR}" |
|
|
| 250 | rm -rf "${D}${MY_APPROOT}/${MY_APPSUFFIX}" |
|
|
| 251 | fi |
|
|
| 252 | } |
|
|
| 253 | |
|
|
| 254 | function webapp_src_preinst () |
|
|
| 255 | { |
|
|
| 256 | # create the directories that we need |
|
|
| 257 | |
|
|
| 258 | dodir ${MY_HTDOCSDIR} |
|
|
| 259 | dodir ${MY_HOSTROOTDIR} |
|
|
| 260 | dodir ${MY_CGIBINDIR} |
|
|
| 261 | dodir ${MY_ICONSDIR} |
|
|
| 262 | dodir ${MY_ERRORSDIR} |
|
|
| 263 | dodir ${MY_SQLSCRIPTSDIR} |
|
|
| 264 | } |
|
|
| 265 | |
|
|
| 266 | function webapp_pkg_postinst () |
374 | webapp_pkg_postinst() { |
| 267 | { |
375 | debug-print-function $FUNCNAME $* |
| 268 | einfo "webapp_pkg_postinst() called" |
|
|
| 269 | |
376 | |
| 270 | # if 'vhosts' is not set in your USE flags, we install a copy of |
377 | webapp_read_config |
| 271 | # this application in /var/www/localhost/htdocs/${PN}/ for you |
|
|
| 272 | |
378 | |
| 273 | |
379 | # sanity checks, to catch bugs in the ebuild |
|
|
380 | if [[ ! -f "${ROOT}${MY_APPDIR}/${INSTALL_CHECK_FILE}" ]]; then |
|
|
381 | eerror |
|
|
382 | eerror "This ebuild did not call webapp_src_install() at the end" |
|
|
383 | eerror "of the src_install() function" |
|
|
384 | eerror |
|
|
385 | eerror "Please log a bug on http://bugs.gentoo.org" |
|
|
386 | eerror |
|
|
387 | eerror "You should use emerge -C to remove this package, as the" |
|
|
388 | eerror "installation is incomplete" |
|
|
389 | eerror |
|
|
390 | die "Ebuild did not call webapp_src_install() - report to http://bugs.gentoo.org" |
|
|
391 | fi |
|
|
392 | |
| 274 | if ! use vhosts ; then |
393 | if ! use vhosts; then |
|
|
394 | echo |
| 275 | einfo "vhosts USE flag not set - auto-installing using webapp-config" |
395 | elog "vhosts USE flag not set - auto-installing using webapp-config" |
|
|
396 | |
|
|
397 | webapp_getinstalltype |
| 276 | |
398 | |
| 277 | G_HOSTNAME="localhost" |
399 | G_HOSTNAME="localhost" |
| 278 | . /etc/vhosts/webapp-config |
|
|
| 279 | |
|
|
| 280 | local my_mode=-I |
400 | local my_mode=-I |
| 281 | local my_dir="/${PN}" |
401 | webapp_read_config |
| 282 | |
402 | |
| 283 | # are we installing afresh - or are we upgrading? |
403 | if [[ "${IS_REPLACE}" == "1" ]]; then |
| 284 | # find out by looking to see what (if anything) is installed |
404 | elog "${PN}-${PVR} is already installed - replacing" |
| 285 | # in there already |
405 | my_mode=-I |
| 286 | |
406 | elif [[ "${IS_UPGRADE}" == "1" ]]; then |
| 287 | my_cmd="/usr/sbin/webapp-config --show-installed -d $my_dir 2> /dev/null" |
407 | elog "${REMOVE_PKG} is already installed - upgrading" |
| 288 | einfo "$my_cmd" |
|
|
| 289 | |
|
|
| 290 | my_output="`/usr/sbin/webapp-config --show-installed -d $my_dir 2> /dev/null`" |
|
|
| 291 | |
|
|
| 292 | # we can't use the exit status from webapp-config |
|
|
| 293 | |
|
|
| 294 | if [ "$?" = "0" ]; then |
|
|
| 295 | |
|
|
| 296 | # something is in there - but the question has to be ... what? |
|
|
| 297 | |
|
|
| 298 | ewarn "$my_output already installed" |
|
|
| 299 | |
|
|
| 300 | if [ "`echo $my_output | awk '{ print $1 }'`" = "${PN}" ]; then |
|
|
| 301 | einfo "$my_output is a copy of ${PN}" |
|
|
| 302 | if [ "`echo $my_output | awk '{ print $2 }'`" = "${PVR}" ]; then |
|
|
| 303 | # this version is already installed |
|
|
| 304 | # we need to remove it first |
|
|
| 305 | |
|
|
| 306 | /usr/sbin/webapp-config -C -d $my_dir |
|
|
| 307 | else |
|
|
| 308 | # we have an older version of whatever it is our ebuild is |
|
|
| 309 | # trying to install ;-) |
|
|
| 310 | # |
|
|
| 311 | # this is the situation we can deal with |
|
|
| 312 | |
|
|
| 313 | einfo "selecting upgrade mode" |
|
|
| 314 | my_mode=-U |
408 | my_mode=-U |
| 315 | fi |
|
|
| 316 | else |
409 | else |
| 317 | # this should never happen - but just in case ... |
410 | elog "${PN}-${PVR} is not installed - using install mode" |
| 318 | # |
411 | fi |
| 319 | # whatever is in that directory, it isn't the application |
|
|
| 320 | # that we are currently trying to install |
|
|
| 321 | # |
|
|
| 322 | # rather than overwrite the contents, we bail with an error |
|
|
| 323 | # instead |
|
|
| 324 | |
412 | |
| 325 | die "$my_output is already installed in $my_dir" |
413 | my_cmd="${WEBAPP_CONFIG} ${my_mode} -h localhost -u root -d ${INSTALL_DIR} ${PN} ${PVR}" |
|
|
414 | elog "Running ${my_cmd}" |
|
|
415 | ${my_cmd} |
|
|
416 | |
|
|
417 | echo |
|
|
418 | local cleaner="${WEBAPP_CLEANER} -p -C ${PN}" |
|
|
419 | einfo "Running ${cleaner}" |
|
|
420 | ${cleaner} |
|
|
421 | else |
|
|
422 | elog |
|
|
423 | elog "The 'vhosts' USE flag is switched ON" |
|
|
424 | elog "This means that Portage will not automatically run webapp-config to" |
|
|
425 | elog "complete the installation." |
|
|
426 | elog |
|
|
427 | elog "To install ${PN}-${PVR} into a virtual host, run the following command:" |
|
|
428 | elog |
|
|
429 | elog " webapp-config -I -h <host> -d ${PN} ${PN} ${PVR}" |
|
|
430 | elog |
|
|
431 | elog "For more details, see the webapp-config(8) man page" |
|
|
432 | fi |
|
|
433 | } |
|
|
434 | |
|
|
435 | # @FUNCTION: webapp_pkg_prerm |
|
|
436 | # @DESCRIPTION: |
|
|
437 | # This is the default pkg_prerm() for this eclass. If USE=vhosts is not set |
|
|
438 | # remove all installed copies of this web application. Otherwise instruct the |
|
|
439 | # user to manually remove those copies. See bug #136959. |
|
|
440 | webapp_pkg_prerm() { |
|
|
441 | debug-print-function $FUNCNAME $* |
|
|
442 | |
|
|
443 | local my_output= |
|
|
444 | my_output="$(${WEBAPP_CONFIG} --list-installs ${PN} ${PVR})" |
|
|
445 | [[ $? -ne 0 ]] && return |
|
|
446 | |
|
|
447 | local x |
|
|
448 | if ! use vhosts; then |
|
|
449 | |
|
|
450 | for x in ${my_output}; do |
|
|
451 | [[ -f ${x}/.webapp ]] && . ${x}/.webapp || ewarn "Cannot find file ${x}/.webapp" |
|
|
452 | if [[ -n "${WEB_HOSTNAME}" && -n "${WEB_INSTALLDIR}" ]]; then |
|
|
453 | ${WEBAPP_CONFIG} -C -h ${WEB_HOSTNAME} -d ${WEB_INSTALLDIR} |
| 326 | fi |
454 | fi |
|
|
455 | done |
| 327 | else |
456 | else |
| 328 | einfo "${PN}-${PVR} is not installed - using install mode" |
457 | |
|
|
458 | ewarn "Don't forget to use webapp-config to remove any copies of" |
|
|
459 | ewarn "${PN}-${PVR} installed in" |
|
|
460 | ewarn |
|
|
461 | |
|
|
462 | for x in ${my_output}; do |
|
|
463 | [[ -f ${x}/.webapp ]] && . ${x}/.webapp || ewarn "Cannot find file ${x}/.webapp" |
|
|
464 | ewarn " ${x}" |
|
|
465 | done |
| 329 | fi |
466 | fi |
| 330 | |
|
|
| 331 | my_cmd="/usr/sbin/webapp-config $my_mode -h localhost -u root -d $my_dir ${PN} ${PVR}" |
|
|
| 332 | einfo "Running $my_cmd" |
|
|
| 333 | $my_cmd |
|
|
| 334 | fi |
|
|
| 335 | |
|
|
| 336 | return 0 |
|
|
| 337 | } |
467 | } |