/[gentoo]/xml/htdocs/proj/en/glep/glep-0011.txt
Gentoo

Diff of /xml/htdocs/proj/en/glep/glep-0011.txt

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

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

Legend:
Removed from v.1.2  
changed lines
  Added in v.1.5

  ViewVC Help
Powered by ViewVC 1.1.20