| 1 | GLEP: 11 |
1 | GLEP: 11 |
| 2 | Title: Web Application Installation |
2 | Title: Web Application Installation |
| 3 | Version: $Revision: 1.2 $ |
3 | Version: $Revision: 1.3 $ |
| 4 | Last-Modified: $Date: 2003/08/12 17:02:43 $ |
4 | Last-Modified: $Date: 2003/08/13 08:43:18 $ |
| 5 | Author: Troy Dack <tad@gentoo.org> |
5 | Author: Troy Dack <tad@gentoo.org> |
| 6 | Discussions-To: gentoo-dev@gentoo.org |
6 | Discussions-To: gentoo-dev@gentoo.org |
| 7 | Status: Draft |
7 | Status: Draft |
| 8 | Type: Standards Track |
8 | Type: Standards Track |
| 9 | Content-Type: text/x-rst |
9 | Content-Type: text/x-rst |
| 10 | Created: 02 August 2003 |
10 | Created: 02 August 2003 |
| … | |
… | |
| 212 | |
212 | |
| 213 | 3.2 VHost Configuration Tool |
213 | 3.2 VHost Configuration Tool |
| 214 | '''''''''''''''''''''''''''' |
214 | '''''''''''''''''''''''''''' |
| 215 | |
215 | |
| 216 | To assist administration of multiple virtual hosts a "VHost Configuration Tool" |
216 | To assist administration of multiple virtual hosts a "VHost Configuration Tool" |
| 217 | needs to be developed and implemented. Initial discussion regarding the VHost |
217 | needs to be developed and implemented. Initial discussion regarding the VHost |
| 218 | Config tool and proposed usage can be found at http://article.gmane.org/gmane.linux.gentoo.devel/10874. |
218 | Config tool and proposed usage can be found at http://article.gmane.org/gmane.linux.gentoo.devel/10874. |
| 219 | |
219 | |
| 220 | It's the job of the VHost Config toolset to make a local instance of the web |
220 | It's the job of the VHost Config toolset to make a local instance of the web |
| 221 | application run under a specific web server. |
221 | application run under a specific web server. |
| 222 | |
222 | |
| 223 | The VHost Configuration Utility will need to be a seperate package, maintained by Gentoo. |
223 | The VHost Configuration Utility will need to be a seperate package, maintained by Gentoo. |
|
|
224 | |
| 224 | Apache .ebuilds will require the VHost Config tool as a dependency (DEPEND). |
225 | Web Server .ebuilds will require the VHost Config tool as a dependency (DEPEND). |
| 225 | |
226 | |
| 226 | `Bug #26293`_ will be used to track the initial progress of the VHost |
227 | `Bug #26293`_ will be used to track the initial progress of the VHost |
| 227 | Configuration Tool. |
228 | Configuration Tool. |
| 228 | |
229 | |
| 229 | .. _Bug #26293: http://bugs.gentoo.org/show_bug.cgi?id=26293 |
230 | .. _Bug #26293: http://bugs.gentoo.org/show_bug.cgi?id=26293 |
| … | |
… | |
| 236 | - HUP web server so it reads in the new config without stopping. |
237 | - HUP web server so it reads in the new config without stopping. |
| 237 | |
238 | |
| 238 | Initially the VHost Config tool should provide support for the Apache web |
239 | Initially the VHost Config tool should provide support for the Apache web |
| 239 | server. As the tool matures support for other web servers can be added. |
240 | server. As the tool matures support for other web servers can be added. |
| 240 | |
241 | |
| 241 | 4.1 Single Host Installation |
242 | 3.3 Single Host Installation |
| 242 | '''''''''''''''''''''''''''' |
243 | '''''''''''''''''''''''''''' |
| 243 | |
244 | |
| 244 | For single host installations the .ebuild will make the required |
245 | For single host installations the .ebuild will make the required |
| 245 | configurations changes and symlinks using the VHost Config tool to ensure |
246 | configurations changes and symlinks using the VHost Config tool to ensure |
| 246 | that the web application is available to be served from:: |
247 | that the web application is available to be served from:: |
| … | |
… | |
| 248 | /var/www/localhost/htdocs/${PF}/ |
249 | /var/www/localhost/htdocs/${PF}/ |
| 249 | |
250 | |
| 250 | In this case it may be feasible for the VHost Config tool to simply symlink the |
251 | In this case it may be feasible for the VHost Config tool to simply symlink the |
| 251 | directories from /usr/share/webapps/${PF}/ as is appropriate. |
252 | directories from /usr/share/webapps/${PF}/ as is appropriate. |
| 252 | |
253 | |
| 253 | 4.2 Virtual Host Installation |
254 | 3.4 Virtual Host Installation |
| 254 | ''''''''''''''''''''''''''''' |
255 | ''''''''''''''''''''''''''''' |
| 255 | |
256 | |
| 256 | For installations that support multiple virtual hosts the .ebuild will |
257 | For installations that support multiple virtual hosts the .ebuild will |
| 257 | install the web application into the default location and then leave configuration |
258 | install the web application into the default location and then leave configuration |
| 258 | to the user through the VHost Config tool. |
259 | to the user through the VHost Config tool. |
| 259 | |
260 | |
| 260 | In this case the web application files will be copied from |
261 | In this case the web application files will be copied from |
| 261 | /usr/share/webapps/${PF}/ to /var/www/<FQDN>/ by the VHost Config tool. |
262 | /usr/share/webapps/${PF}/ to /var/www/<FQDN>/ by the VHost Config tool. |
| 262 | |
263 | |
| 263 | 4.3 Configuration Files |
264 | 3.5 Configuration Files |
| 264 | ''''''''''''''''''''''' |
265 | ''''''''''''''''''''''' |
| 265 | |
266 | |
| 266 | As stated above web application *site default* configuration files are to be |
267 | As stated above web application *site default* configuration files are to be |
| 267 | installed into:: |
268 | installed into:: |
| 268 | |
269 | |
| 269 | /etc/webapps/${PF}/ |
270 | /etc/webapps/${PF}/ |
| 270 | |
271 | |
| 271 | The files in this directory are then copied (not symlinked!) by the VHost |
272 | The files in this directory are then copied (not symlinked!) by the VHost |
| 272 | Config tool to the Document Root for each instance of the app that is installed. |
273 | Config tool to the Document Root for each instance of the app that is installed. |
| 273 | |
274 | |
| 274 | This will require the VHost Config toolset to emulate Portage's CONFIG_PROTECT |
275 | This will require the VHost Config toolset to emulate Portage's CONFIG_PROTECT |
| 275 | behaviour for the web applications. |
276 | behaviour for the web applications. |
| 276 | |
277 | |
| 277 | 5. Application Permissions |
278 | 4. Application Permissions |
| 278 | -------------------------- |
279 | -------------------------- |
| 279 | |
280 | |
| 280 | Installing web applications and giving the web server ownership of the files |
281 | Installing web applications and giving the web server ownership of the files |
| 281 | is a security risk. This can possibly lead to application configuration |
282 | is a security risk. This can possibly lead to application configuration |
| 282 | files being accessed by unwanted third parties. |
283 | files being accessed by unwanted third parties. |
| … | |
… | |
| 310 | |
311 | |
| 311 | Copyright |
312 | Copyright |
| 312 | ========= |
313 | ========= |
| 313 | |
314 | |
| 314 | This document has been placed in the public domain. |
315 | This document has been placed in the public domain. |
| 315 | |
|
|