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

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

  ViewVC Help
Powered by ViewVC 1.1.20