WEBAPP\-CONFIG

SETTINGS

vhost_root

Directory which holds the htdocs directory for your website.

By default, all websites are /var/www/fqdn, where fqdn is the full hostname of the website (e.g. www.gentoo.org). If you are putting your websites somewhere else, you must update vhost_root to suit.

You can use the value of vhost_hostname in your definition of vhost_root.

vhost_hostname

Default value when webapp-config's -h switch hasn't been used.

By default, this is set to the full hostname of your computer. If this hasn't been set correctly, then this is set to localhost instead.

vhost_subdomain_{1,2,3...}

The value of vhost_hostname is splitted at each dot and the resulting domain name parts are stored in sequentially numbered vhost_subdomain_N variables (e.g. www.test.org results in vhost_subdomain_1=org, vhost_subdomain_2=test, etc.).

You may not set these variables yourself since they are generated internally by webapp-config. But you can use them within the configuration file. So if you want to have fine grained control over the location the web applications get installed, you can set vhost_root="/var/www/${vhost_subdomain_1}/${vhost_subdomain_2}/${vhost_subdomain_3}"

vhost_server

Default value when webapp-config's -s switch hasn't been used.

By default, this is set to apache, which is the webserver that most people use.

vhost_server_uid

Overiding parameter for the server-dependant hardcoded uid which specifies the user to own all files and directories that are server-owned.

Warning: webapp-config's -s switch does not overide this parameter.

By default, this is disabled.

This can be either the name of a user or their numerical user id.

vhost_server_gid

Overiding parameter for the server-dependant hardcoded gid which specifies the group to own all files and directories that are server-owned.

Warning: webapp-config's -s switch does not overide this parameter.

By default, this is disabled.

This can be either the name of a group or their numerical group id.

vhost_config_uid

Default value when webapp-config's -u switch hasn't been used.

By default, this is set to the username of the user who is running webapp-config. At the time of writing, webapp-config only works for the root user, because only the root user is allowed to change the ownership of files and directories on disk.

This can be either the name of a user or their numerical user id.

vhost_config_gid

Default value when webapp-config's -g switch hasn't been used.

By default, this is set to the primary group of the user who is running webapp-config.

This can be either the name of a group or their numerical group id.

vhost_config_virtual_files

Default value when webapp-config's --virtual-files switch hasn't been used.

By default, files which can be shared are hardlinked in. The virtual install does not get a local copy of the file, which normally prevents the web server or non-root users from editing the file.

vhost_default_uid

Default user to own all files and directories that aren't server-owned or config-owned.

vhost_default_gid

Default group to own all files and directories that aren't server-owned or config-owned.

vhost_htdocs_insecure, vhost_htdocs_secure

Default values for the basename of the DocumentRoot.

webapp-config installs into vhost_root/vhost_htdocs_insecure by default. If you use the --secure switch, webapp-config installs into vhost_root/vhost_htdocs_secure instead.

vhost_perms_serverowned_dir, vhost_perms_serverowned_file

Default filesystem permissions for directories and files that are installed as 'server-owned'.

vhost_perms_configowned_dir, vhost_perms_configowned_file

Default filesystem permissions for directories and files that are installed as 'config-owned'.

vhost_perms_defaultowned_dir

Default filesystem permissions for directories that are installed as 'default-owned'. Note that it is not possible to install files that are 'default-owned'.

vhost_perms_virtual_dir, vhost_perms_virtual_file

Default filesystem permissions for directories and files that are installed as 'virtual'.

vhost_perms_installdir

Default filesystem permissions for the directory that webapp-config installs the package into.

SEE ALSO

webapp.eclass(5), webapp-config(8)

webapp-config is based on the design for an installer for web-based applications first defined in m[blue]GLEP #11m[][1] for the Gentoo Linux project.  

AUTHORS

Stuart Herbert <stuart@gentoo.org>, <stuart@gnqs.org>

Author.

Renat Lumpau <rl03@gentoo.org>

Author.

Gunnar Wrobel <php@gunnarwrobel.de>

Author.

Devan Franchini <twitch153@gentoo.org>

Author.

COPYRIGHT

NOTES

1.

GLEP #11

http://www.gentoo.org/proj/en/glep/glep-0011.html

Index

NAME

SYNOPSIS

DESCRIPTION

SETTINGS

SEE ALSO

AUTHORS

COPYRIGHT

NOTES