Webapp-config

General

• webapp-config is a Gentoo only tool to allow a single web applications to be correctly installed into multiple virtual hosts. This is nice as it allows the code to remain on a standard, Portage managed place while you can easily deploy your web applications into production.

• Currently the way it works is by creating a directory corresponding to the application inside the specified virtual host. By default it will be installed in /var/www/<virtual_host_name>/htdocs; you can configure that by editing /etc/vhosts/webapp-config. I use the following convention:

vhost_root="/srv/${vhost_subdomain_2}.${vhost_subdomain_1}/"
vhost_htdocs_insecure="./"

• In /etc/vhosts/webapp-config, you need to have a vhost_hostname variable that can conform to a fully qualified domain, eg localhost won't work. Put something like "elvanor.net" there.

• The only problem is that webapp-config always creates icons, error, and cgi-bin directories in the virtual host directory if they are not there. I would prefer that not to happen.

Installing

• Typical installation:

webapp-config -I -h shoopz.com -d wordpress wordpress 2.7.1

Updating

• Warning: emerge --depclean will remove *installed* versions of a webapp package if a newer one has been already merged! Thus update all your web-applications before running emerge --depclean.

• When you need to update a web application, use the -U switch, eg:

webapp-config -U -h elvanor.net -d phpmyadmin phpmyadmin 2.11.5

• If you use a directory different that the application name, don't forget to change that. However note that by convention that should not happen.

webapp-config -U -h www.elvanor.net -d www/mediawiki mediawiki 1.13.3

Cleaning

• The application webapp-cleaner can be used to remove old versions of an webapp package.