237 lines
		
	
	
		
			7.9 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
		
		
			
		
	
	
			237 lines
		
	
	
		
			7.9 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
| 
								 | 
							
								# /etc/vhosts/webapp-config
							 | 
						||
| 
								 | 
							
								#       Some default variables that are shared between the
							 | 
						||
| 
								 | 
							
								#       webapp-config utility, and the webapp eclass
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								#       Part of the Gentoo Linux distribution
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# Copyright (c) 1999-2007 Authors
							 | 
						||
| 
								 | 
							
								#       Released under v2 of the GNU GPL
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# Author(s)     Stuart Herbert
							 | 
						||
| 
								 | 
							
								#               Renat Lumpau   <rl03@gentoo.org>
							 | 
						||
| 
								 | 
							
								#               Gunnar Wrobel  <wrobel@gentoo.org>
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# ========================================================================
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								# ========================================================================
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# USER-EDITABLE SETTINGS
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# Feel free to edit these settings to suit your local needs
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# ========================================================================
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								# vhost_root is the directory where virtual host websites are added
							 | 
						||
| 
								 | 
							
								# so, if your server is hosting (say)
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								#   www.gentoo.org
							 | 
						||
| 
								 | 
							
								#   bugs.gentoo.org
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# then the htdocs directory for each of these would be
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								#   /var/www/www.gentoo.org/htdocs
							 | 
						||
| 
								 | 
							
								#   /var/www/bugs.gentoo.org/htdocs
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# Change this setting *only* if you need your websites installed in
							 | 
						||
| 
								 | 
							
								# a different physical location
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# If you prefer to use Gentoo's optional support for the /srv service
							 | 
						||
| 
								 | 
							
								# home file hierarchy, uncomment the second version of vhost_root
							 | 
						||
| 
								 | 
							
								# (this should have been done for you if you installed webapp-config
							 | 
						||
| 
								 | 
							
								# with the srvdir USE flag enabled)
							 | 
						||
| 
								 | 
							
								# If you want to have fine grained control over the location the web
							 | 
						||
| 
								 | 
							
								# applications get installed, you can use the third setting
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								vhost_root="/var/www/${vhost_hostname}"
							 | 
						||
| 
								 | 
							
								#vhost_root="/srv/${vhost_hostname}/www"
							 | 
						||
| 
								 | 
							
								#vhost_root="/var/www/${vhost_subdomain_1}/${vhost_subdomain_2}/${vhost_subdomain_3}"
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								# some web applications need to know what host they are serving up pages
							 | 
						||
| 
								 | 
							
								# for.  this information is configured when the application is installed
							 | 
						||
| 
								 | 
							
								# by the webapp-config script
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# changing this value *after* the application has been installed has
							 | 
						||
| 
								 | 
							
								# no effect!!
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# you can override this setting by using the -h switch to webapp-config
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# IMPORTANT: If you comment this setting and provide no explicit hostname
							 | 
						||
| 
								 | 
							
								# with the command line -h switch, webapp-config will try to determine
							 | 
						||
| 
								 | 
							
								# the fully qualified domain name by itself
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								vhost_hostname="localhost"
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								# what web server are you using?
							 | 
						||
| 
								 | 
							
								# your choices are:
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# apache
							 | 
						||
| 
								 | 
							
								# lighttpd
							 | 
						||
| 
								 | 
							
								# cherokee
							 | 
						||
| 
								 | 
							
								# nginx
							 | 
						||
| 
								 | 
							
								# gatling
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# you can override this setting by using the -s switch to webapp-config
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								vhost_server="apache"
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								# which user should own config files?
							 | 
						||
| 
								 | 
							
								# the default is the user currently running webapp-config (which is 
							 | 
						||
| 
								 | 
							
								# normally the root user). You may either use the numerical uid or the 
							 | 
						||
| 
								 | 
							
								# user name. The internal default is "0" to accomodate for BSD style 
							 | 
						||
| 
								 | 
							
								# systems.
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# you can override this setting by using the -u switch to webapp-config
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								#vhost_config_uid="root"
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								# which group should own config files?
							 | 
						||
| 
								 | 
							
								# the default is the group of the user currently running webapp-config
							 | 
						||
| 
								 | 
							
								# (which is normally the root group). You may either use the numerical
							 | 
						||
| 
								 | 
							
								# gid or the group name. The internal default is "0" to accomodate for 
							 | 
						||
| 
								 | 
							
								# BSD style systems.
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# you can override this setting by using the -g switch to webapp-config
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								#vhost_config_gid="root"
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								# what type of shared directories should be created?
							 | 
						||
| 
								 | 
							
								# the default is 'default-owned', which means that each install of the app
							 | 
						||
| 
								 | 
							
								# gets a copy of the directory 
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# permitted values are: server-owned, config-owned, default-owned
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# you can override this setting by using the --default-dirs switch to
							 | 
						||
| 
								 | 
							
								# webapp-config
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								vhost_config_default_dirs="default-owned"
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								# what type of shared files should be created?
							 | 
						||
| 
								 | 
							
								# the default is 'virtual', which means that each install of the app
							 | 
						||
| 
								 | 
							
								# does NOT get a unique copy of the files
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# permitted values are: server-owned, config-owned, virtual
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# you can override this setting by using the --virtual-files switch to
							 | 
						||
| 
								 | 
							
								# webapp-config
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								vhost_config_virtual_files="virtual"
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								# where should drop-in config files for webservers go?
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# these files will be called <server>-<app>.conf.  They are quite rare,
							 | 
						||
| 
								 | 
							
								# but are needed from time to time by the odd application or two
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								vhost_config_dir="${vhost_root}/conf"
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								# which user & group should own the files by default?
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# the default is for files to be owned by the superuser root, so that
							 | 
						||
| 
								 | 
							
								# they cannot be tampered with by other users
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# this setting affects the files and directories installed by the ebuild,
							 | 
						||
| 
								 | 
							
								# and it affects some directories created by webapp-config.  It does not
							 | 
						||
| 
								 | 
							
								# affect any of the files installed by webapp-config at this time.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								vhost_default_uid="root"
							 | 
						||
| 
								 | 
							
								vhost_default_gid="root"
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								# what type of links do you want to use?
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# starting with webapp-config v1.10, the default behaviour is to attempt
							 | 
						||
| 
								 | 
							
								# to hardlink a file from /usr/share/webapps/* first.  If the hardlink
							 | 
						||
| 
								 | 
							
								# fails (normally because /usr and /var | /srv are on different filesystems)
							 | 
						||
| 
								 | 
							
								# webapp-config will fall back to making a physical copy of the file
							 | 
						||
| 
								 | 
							
								# instead
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# NOTE:
							 | 
						||
| 
								 | 
							
								#   we have moved to hardlinks because not all web-based packages work
							 | 
						||
| 
								 | 
							
								#   when their files are symlinked in
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								#   please do not raise bugs about packages that do not work when
							 | 
						||
| 
								 | 
							
								#   symlinked
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# vhost_link_type="soft"
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								# what are the names of your document directories?
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# by default, your website lives in /var/www/<hostname>/htdocs.  If you
							 | 
						||
| 
								 | 
							
								# run webapp-config with the --secure switch, your website instead lives
							 | 
						||
| 
								 | 
							
								# in /var/www/<hostname>/htdocs-secure.
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# you can change the default names of 'htdocs' and 'htdocs-secure' by
							 | 
						||
| 
								 | 
							
								# editing these two variables
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								vhost_htdocs_insecure="htdocs"
							 | 
						||
| 
								 | 
							
								vhost_htdocs_secure="htdocs-secure"
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								# what permissions do you want the files to have?
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# by default, webapp-config installs directories and files with these
							 | 
						||
| 
								 | 
							
								# permissions.  You can change them here to comply with your local
							 | 
						||
| 
								 | 
							
								# security policies.
							 | 
						||
| 
								 | 
							
								# You need to specify octal values ("0nnn") or you can use the encoding
							 | 
						||
| 
								 | 
							
								# used by chmod ("[ugoa]{1,3}[+-=]{rwx]{1,3}" elements as a comma 
							 | 
						||
| 
								 | 
							
								# seperated list)
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								vhost_perms_serverowned_dir="0775"
							 | 
						||
| 
								 | 
							
								vhost_perms_serverowned_file="0664"
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								vhost_perms_configowned_dir="0755"
							 | 
						||
| 
								 | 
							
								vhost_perms_configowned_file="0644"
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								vhost_perms_defaultowned_dir="0755"
							 | 
						||
| 
								 | 
							
								vhost_perms_virtualowned_file="o-w"
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								vhost_perms_installdir="0755"
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								# Allow specifying absolute path names using the -d option?
							 | 
						||
| 
								 | 
							
								allow_absolute="no"
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								# Supported package managers: portage, paludis
							 | 
						||
| 
								 | 
							
								package_manager="portage"
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								# ========================================================================
							 | 
						||
| 
								 | 
							
								# END OF USER-EDITABLE SETTINGS
							 | 
						||
| 
								 | 
							
								# ========================================================================
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								# ========================================================================
							 | 
						||
| 
								 | 
							
								# EDIT THE VARIABLES BELOW THIS LINE AT YOUR OWN RISK
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# These variables are used by the webapp.eclass component of Portage,
							 | 
						||
| 
								 | 
							
								# and by /usr/sbin/webapp-config.
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# If you break your Gentoo installation by changing these settings, then
							 | 
						||
| 
								 | 
							
								# re-emerge the webapps-config package to restore the default values
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# When webapp-config is upgraded, it may add to and/or change the value of
							 | 
						||
| 
								 | 
							
								# variables listed here.  If you do not merge in these changes, you will
							 | 
						||
| 
								 | 
							
								# probably find that webapp-config will break in horrible ways.
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# etc-update is NOT optional ;-)
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# ========================================================================
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								# which version of webapp-config is this file for?
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# we have a problem when users upgrade webapp-config.  It turns out that
							 | 
						||
| 
								 | 
							
								# they don't explicitly upgrade webapp-config ... instead, webapp-config
							 | 
						||
| 
								 | 
							
								# gets because it is a dependency for a web-based package.
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# unfortunately, this means that any changes to this config file do not
							 | 
						||
| 
								 | 
							
								# get installed (through etc-update or equivalent) until after the web-
							 | 
						||
| 
								 | 
							
								# based package has been installed.  We end up trying to install the
							 | 
						||
| 
								 | 
							
								# package using a partial install of webapp-config
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# how can we work around this?
							 | 
						||
| 
								 | 
							
								#
							 | 
						||
| 
								 | 
							
								# the only way to work around this is to put some sort of version-control
							 | 
						||
| 
								 | 
							
								# marker in this config file.  webapp-config and this file must agree on
							 | 
						||
| 
								 | 
							
								# what this marker is, otherwise webapp-config will refuse to work
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								WA_CONF_VERSION="7"
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								# ========================================================================
							 | 
						||
| 
								 | 
							
								# END OF CONFIG FILE
							 | 
						||
| 
								 | 
							
								# ========================================================================
							 |