table of contents
A2ENCONF(8) | System Manager's Manual | A2ENCONF(8) |
NAME¶
a2enconf, a2disconf - enable or disable an apache2 configuration file
SYNOPSIS¶
a2enconf [-q|--quiet] [-m|--maintmode] [ configuration ]
a2disconf [-q|--quiet] [-m|--maintmode] [-p|--purge] [ configuration ]
DESCRIPTION¶
This manual page documents briefly the a2enconf and a2disconf commands.
a2enconf is a script that enables the specified configuration file within the apache2 configuration. It does this by creating symlinks within /etc/apache2/conf-enabled. Likewise, a2disconf disables a specific configuration part by removing those symlinks. It is not an error to enable a configuration which is already enabled, or to disable one which is already disabled.
Note that many configuration file may have a dependency to specific modules. Unlike module dependencies, these are not resolved automatically. Configuration fragments stored in the conf-available directory are considered non-essential or being installed and manged by reverse dependencies (e.g. web scripts).
OPTIONS¶
- -q, --quiet
- Don't show informative messages.
- -m, --maintmode
- Enables the maintainer mode, that is the program invocation is effectuated automatically by a maintainer script. This switch should not be used by end users.
- -p, --purge
- When disabling a module, purge all traces of the module in the internal state data base.
EXIT STATUS¶
a2enconf and a2disconf exit with status 0 if all configurations are processed successfully, 1 if errors occur, 2 if an invalid option was used.
EXAMPLES¶
a2disconf charset
Enables Apache security directives stored in the security configuration files, and disables the charset configuration.
ENVIRONMENT¶
The following environment variables may be specified.
- dir_suffix
- Distinguish different instances of apache2. Suffixes /etc/apache2 to build a new APACHE_CONFDIR
- APACHE_CONFDIR
- Override the entire configuraation directory (/etc/apache2$dir_suffix)
- APACHE_ENVVARS
- Override the default envvars file (/etc/apache2$dir_suffix/envvars)
- APACHE_{MODS,CONF,SITES}_AVAIL
- Override the path to the directory holding the available snippets for modules, configuration and sites.
- APACHE_{MODS,CONF,SITES}_ENABLED
- Override the path to the directory holding the enabled snippets for modules, configuration and sites. For example, in a multi-instance setup, you can set dir_suffix=-myinstance and override APACHE_MODS_AVAIL back to /etc/apache2/mods-available to have a single store of snippets for all instances
- APACHE_STATE_DIRECTORY
- Override the path to the state directory (/var/lib/apache2)
FILES¶
- /etc/apache2/conf-available
- Directory with files giving information on available configuration files.
- /etc/apache2/conf-enabled
- Directory with links to the files in conf-available for enabled configuration files.
SEE ALSO¶
apache2ctl(8), a2enmod(8), a2dismod(8), a2ensite(8), a2dissite(8).
AUTHOR¶
This manual page was written by Arno Toell <debian@toell.net> for the Debian GNU/Linux distribution, as it is a Debian-specific script with the package.
14 February 2012 |