/[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.6
1GLEP: 11 1GLEP: 11
2Title: Web Application Installation 2Title: Web Application Installation
3Version: $Revision: 1.2 $ 3Version: $Revision: 1.6 $
4Last-Modified: $Date: 2003/08/12 17:02:43 $ 4Last-Modified: $Date: 2006/09/04 03:12:43 $
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: Final
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, 3-Sep-2006
13
14Status
15======
16
17As of 2006-09-03 the webapp eclass has existed for some time.
12 18
13Credits 19Credits
14======= 20=======
15 21
16Based on comments posted to gentoo-dev mailing list [#WebAppPost1]_ 22Based on comments posted to gentoo-dev mailing list [#WebAppPost1]_
212 218
2133.2 VHost Configuration Tool 2193.2 VHost Configuration Tool
214'''''''''''''''''''''''''''' 220''''''''''''''''''''''''''''
215 221
216To assist administration of multiple virtual hosts a "VHost Configuration Tool" 222To assist administration of multiple virtual hosts a "VHost Configuration Tool"
217needs to be developed and implemented. Initial discussion regarding the VHost 223needs 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. 224Config tool and proposed usage can be found at http://article.gmane.org/gmane.linux.gentoo.devel/10874.
219 225
220It's the job of the VHost Config toolset to make a local instance of the web 226It's the job of the VHost Config toolset to make a local instance of the web
221application run under a specific web server. 227application run under a specific web server.
222 228
223The VHost Configuration Utility will need to be a seperate package, maintained by Gentoo. 229The VHost Configuration Utility will need to be a seperate package, maintained by Gentoo.
230
224Apache .ebuilds will require the VHost Config tool as a dependency (DEPEND). 231Web Server .ebuilds will require the VHost Config tool as a dependency (DEPEND).
225 232
226`Bug #26293`_ will be used to track the initial progress of the VHost 233`Bug #26293`_ will be used to track the initial progress of the VHost
227Configuration Tool. 234Configuration Tool.
228 235
229.. _Bug #26293: http://bugs.gentoo.org/show_bug.cgi?id=26293 236.. _Bug #26293: http://bugs.gentoo.org/show_bug.cgi?id=26293
236 - HUP web server so it reads in the new config without stopping. 243 - HUP web server so it reads in the new config without stopping.
237 244
238Initially the VHost Config tool should provide support for the Apache web 245Initially the VHost Config tool should provide support for the Apache web
239server. As the tool matures support for other web servers can be added. 246server. As the tool matures support for other web servers can be added.
240 247
2414.1 Single Host Installation 2483.3 Single Host Installation
242'''''''''''''''''''''''''''' 249''''''''''''''''''''''''''''
243 250
244For single host installations the .ebuild will make the required 251For single host installations the .ebuild will make the required
245configurations changes and symlinks using the VHost Config tool to ensure 252configurations changes and symlinks using the VHost Config tool to ensure
246that the web application is available to be served from:: 253that the web application is available to be served from::
248 /var/www/localhost/htdocs/${PF}/ 255 /var/www/localhost/htdocs/${PF}/
249 256
250In this case it may be feasible for the VHost Config tool to simply symlink the 257In this case it may be feasible for the VHost Config tool to simply symlink the
251directories from /usr/share/webapps/${PF}/ as is appropriate. 258directories from /usr/share/webapps/${PF}/ as is appropriate.
252 259
2534.2 Virtual Host Installation 2603.4 Virtual Host Installation
254''''''''''''''''''''''''''''' 261'''''''''''''''''''''''''''''
255 262
256For installations that support multiple virtual hosts the .ebuild will 263For installations that support multiple virtual hosts the .ebuild will
257install the web application into the default location and then leave configuration 264install the web application into the default location and then leave configuration
258to the user through the VHost Config tool. 265to the user through the VHost Config tool.
259 266
260In this case the web application files will be copied from 267In this case the web application files will be copied from
261/usr/share/webapps/${PF}/ to /var/www/<FQDN>/ by the VHost Config tool. 268/usr/share/webapps/${PF}/ to /var/www/<FQDN>/ by the VHost Config tool.
262 269
2634.3 Configuration Files 2703.5 Configuration Files
264''''''''''''''''''''''' 271'''''''''''''''''''''''
265 272
266As stated above web application *site default* configuration files are to be 273As stated above web application *site default* configuration files are to be
267installed into:: 274installed into::
268 275
269 /etc/webapps/${PF}/ 276 /etc/webapps/${PF}/
270 277
271The files in this directory are then copied (not symlinked!) by the VHost 278The 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. 279Config tool to the Document Root for each instance of the app that is installed.
273 280
274This will require the VHost Config toolset to emulate Portage's CONFIG_PROTECT 281This will require the VHost Config toolset to emulate Portage's CONFIG_PROTECT
275behaviour for the web applications. 282behaviour for the web applications.
276 283
2775. Application Permissions 2844. Application Permissions
278-------------------------- 285--------------------------
279 286
280Installing web applications and giving the web server ownership of the files 287Installing web applications and giving the web server ownership of the files
281is a security risk. This can possibly lead to application configuration 288is a security risk. This can possibly lead to application configuration
282files being accessed by unwanted third parties. 289files being accessed by unwanted third parties.
310 317
311Copyright 318Copyright
312========= 319=========
313 320
314This document has been placed in the public domain. 321This document has been placed in the public domain.
315

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

  ViewVC Help
Powered by ViewVC 1.1.20