Annotation of doc/install/linux/sles-suse/sysconfig_apache2, revision 1.3

1.1       raeburn     1: ## Path:	Network/WWW/Apache2
                      2: ## Description:	Configuration for Apache 2
                      3: 
                      4: ## Type:	string
                      5: ## Default:	""
                      6: ## ServiceRestart: apache2
                      7: #
                      8: # Here you can name files, separated by spaces, that should be Include'd from 
                      9: # httpd.conf. 
                     10: #
                     11: # This allows you to add e.g. VirtualHost statements without touching 
                     12: # /etc/apache2/httpd.conf itself, which makes upgrading easier. 
                     13: #
                     14: APACHE_CONF_INCLUDE_FILES=""
                     15: 
                     16: ## Type:	string
                     17: ## Default:	""
                     18: ## ServiceRestart: apache2
                     19: #
                     20: # Here you can name directories, separated by spaces, that should be Include'd 
                     21: # from httpd.conf. 
                     22: #
                     23: # All files contained in these directories will be recursively included by apache.
                     24: # If a pattern like *.conf is appended, apache will use it.
                     25: #
                     26: # Examples: "/etc/apache2/my_conf/"
                     27: #           "/etc/apache2/virtual_hosts/*.conf"
                     28: #           "local/*.conf /srv/www/virtual/"
                     29: #
                     30: APACHE_CONF_INCLUDE_DIRS=""
                     31: 
                     32: ## Type:	string
                     33: ## Default:	"actions alias auth_basic authz_host authn_file authz_groupfile authz_default authz_user autoindex cgi dir env expires include log_config mime negotiation setenvif ssl suexec userdir php5"
                     34: ## ServiceRestart: apache2
                     35: #
                     36: # [It might look silly to not simply edit httpd.conf for the LoadModule statements.
                     37: # However, since the LoadModule statements might need an absolute path to the modules,
                     38: # switching between MPMs can be quite a hassle. It's easier to just give the names here.]
                     39: #
                     40: # * list of all modules shipped with the base distribution: 
                     41: #
                     42: #    actions alias asis auth_basic auth_digest authn_alias authn_anon
                     43: #    authn_dbd authn_dbm authn_default authn_file authnz_ldap authz_dbm
                     44: #    authz_default authz_groupfile authz_host authz_owner authz_user
                     45: #    autoindex bucketeer cache case_filter case_filter_in cern_meta cgi
                     46: #    charset_lite dav dav_fs dav_lock dbd deflate dir disk_cache dumpio
                     47: #    echo env expires ext_filter file_cache filter headers ident imagemap
                     48: #    include info ldap log_config log_forensic logio mem_cache mime mime_magic
                     49: #    negotiation optional_fn_export optional_fn_import optional_hook_export
                     50: #    optional_hook_import proxy proxy_ajp proxy_balancer proxy_connect
                     51: #    proxy_ftp proxy_http rewrite setenvif speling ssl status suexec unique_id
                     52: #    userdir usertrack version vhost_alias 
                     53: #
                     54: #   see http://httpd.apache.org/docs-2.2/mod/ !
                     55: #
                     56: # * It pays to use IfDefine statements... like
                     57: #    <IfModule mod_xyz.c>
                     58: #        ....
                     59: #    </IfModule>
                     60: #
                     61: # * In the APACHE_MODULES variable, you can use mod_xyz or just xyz syntax.
                     62: #   You may also name an absolute path if you like.
                     63: #
                     64: # * NOTE ON MOD_SSL: before you can enable this module, you need a server certificate. 
                     65: #   A test certificate can be created by entering 
                     66: #   'cd /usr/share/doc/packages/apache2; ./certificate.sh' as root.
                     67: #   Also, you need to set the ServerName inside the <VirtualHost _default_:443> 
                     68: #   block to the fully qualified domain name (see /etc/HOSTNAME).
                     69: #
                     70: # * if your server certificate is protected by a passphrase you should increase the
                     71: #   APACHE_START_TIMEOUT (see above)
                     72: #
                     73: # * modules listed here will be ignored if they are not installed
                     74: #
                     75: #
                     76: # EXAMPLES:
                     77: #
                     78: # fairly minimal
                     79: # APACHE_MODULES="authz_host alias auth dir log_config mime setenvif"
                     80: #
                     81: # apache's default installation
                     82: # APACHE_MODULES="authz_host actions alias asis auth autoindex cgi dir imap include log_config mime negotiation setenvif status userdir"
                     83: # your settings
                     84: 
                     85: 
1.2       raeburn    86: APACHE_MODULES="actions alias auth_basic authn_file authz_host authz_groupfile authz_default authz_user authn_dbm autoindex cgi dav dav_fs dav_lock dir env expires headers include ldap log_config mime negotiation perl rewrite setenvif ssl status userdir"
1.1       raeburn    87: 
                     88: 
                     89: ## Type:	string
                     90: ## Default:	""
                     91: ## ServiceRestart: apache2
                     92: #
                     93: # Additional server flags:
                     94: #
                     95: # Put here any server flags ("Defines") that you want to hand over to 
                     96: # httpd at start time, or other command line flags.
                     97: #
                     98: # Background: Any directives within an <IfDefine flag>...</IfDefine>
                     99: #             section are only processed if the flag is defined.
                    100: #             This allows to write configuration which is active only in a
                    101: #             special cases, like during server maintenance, or for testing
                    102: #             something temporarily.
                    103: #
                    104: # Notably, to enable SSL support, 'SSL' needs to be added here.
                    105: # To enable the server-status, 'STATUS' needs to be added here.
                    106: #
                    107: # It does not matter if you write flag1, -D flag1 or -Dflag1.
                    108: # Multiple flags can be given as "-D flag1 -D flag2" or simply "flag1 flag2".
                    109: #
                    110: # Specifying such flags here is equivalent to giving them on the commandline.
                    111: # (e.g. via rcapache2 start -DReverseProxy)
                    112: #
                    113: # Example:
                    114: #      "SSL STATUS AWSTATS SVN_VIEWCVS no_subversion_today"
                    115: #
                    116: APACHE_SERVER_FLAGS="-D SSL"
                    117: 
                    118: ## Type:	string
                    119: ## Default:	""
                    120: ## ServiceRestart: apache2
                    121: #
                    122: # Which config file do you want to use?
                    123: # (if not set, /etc/apache2/httpd.conf is used.)
                    124: # It is unusual to need to use this setting.
                    125: #
                    126: APACHE_HTTPD_CONF=""
                    127: 
                    128: ## Type:	list(prefork,worker)
                    129: ## Default:	""
                    130: ## ServiceRestart: apache2
                    131: #
                    132: # MPM (multi-processing module) to use.
                    133: #
                    134: # Needed to determine with which MPM apache will run, as well as
                    135: # against which header files modules will be built. 
                    136: #
                    137: # If not set, the system will simply pick one of the installed MPMs.
                    138: #
                    139: # The implementation of the logic is in /usr/share/apache2/find_mpm,
                    140: # a script which can be used standalone as well if needed.
                    141: #
1.3     ! raeburn   142: APACHE_MPM="prefork"
1.1       raeburn   143: 
                    144: ## Type:	string
                    145: ## Default:	""
                    146: ## ServiceReload: apache2
                    147: #
                    148: # email address of the server administrator (ServerAdmin directive)
                    149: # This address is added to the server's responses if APACHE_SERVERSIGNATURE 
                    150: # is set to "email". 
                    151: #
                    152: # If empty ("") it defaults to webmaster@$FQHOSTNAME, where FQHOSTNAME is
                    153: # taken from /etc/HOSTNAME. 
                    154: #
                    155: # Note that ServerAdmin directives inside VirtualHost statements are not
                    156: # changed, even not the one in the stock SSL virtual host block. 
                    157: #
                    158: APACHE_SERVERADMIN=""
                    159: 
                    160: ## Type:	string
                    161: ## Default:	""
                    162: ## ServiceReload: apache2
                    163: #
                    164: # ServerName gives the name and port that the server uses to identify itself.
                    165: # This can often be determined automatically, but we recommend you specify
                    166: # it explicitly to prevent problems during startup.
                    167: #
                    168: # If this is not set to valid DNS name for your host, server-generated
                    169: # redirections will not work.  See also the UseCanonicalName directive.
                    170: #
                    171: # If your host doesn't have a registered DNS name, enter its IP address here.
                    172: # You will have to access it by its address anyway, and this will make 
                    173: # redirections work in a sensible way.
                    174: #
1.3     ! raeburn   175: APACHE_SERVERNAME=""
1.1       raeburn   176: 
                    177: ## Type:	integer
                    178: ## Default:	2
                    179: #
                    180: # timeout during server startup (seconds)
                    181: # after this time, the start script decides wether the httpd process started without error.
                    182: #
                    183: # Increase it, if you use mod_ssl and your certificate is passphrase protected!
                    184: #
                    185: APACHE_START_TIMEOUT="5"
                    186: #APACHE_START_TIMEOUT="2"
                    187: 
                    188: ## Type:	list(on,off,email)
                    189: ## Default:	"on"
                    190: ## ServiceReload: apache2
                    191: #
                    192: # Configures the footer on server-generated documents 
                    193: # This correlates to the ServerSignature directive. 
                    194: #
                    195: APACHE_SERVERSIGNATURE="on"
                    196: 
                    197: ## Type:	list(debug,info,notice,warn,error,crit,alert,emerg)
                    198: ## Default:	"warn"
                    199: ## ServiceReload: apache2
                    200: #
                    201: # LogLevel: Control the number of messages logged to the error_log.
                    202: #
                    203: #APACHE_LOGLEVEL="warn"
                    204: APACHE_LOGLEVEL="debug"
                    205: 
                    206: ## Type:	string
                    207: ## Default:	"/var/log/apache2/access_log combined"
                    208: ## ServiceRestart: apache2
                    209: #
                    210: # The location and format of the access logfile (Common Logfile Format).
                    211: # If you do not define any access logfiles within a <VirtualHost>
                    212: # container, they will be logged here.  Contrarywise, if you *do*
                    213: # define per-<VirtualHost> access logfiles, transactions will be
                    214: # logged therein and *not* in this file.
                    215: #
                    216: # Simply set it to empty, if you configure it yourself somewhere else.
                    217: # 
                    218: # Examples:
                    219: #
                    220: # If you would like to have agent and referer logfiles:
                    221: #
                    222: # setting it to "/var/log/apache2/referer_log referer, /var/log/apache2/agent_log agent"
                    223: #   corresponds to 
                    224: # CustomLog /var/log/apache2/referer_log referer
                    225: # CustomLog /var/log/apache2/agent_log   agent
                    226: #
                    227: # If you prefer a single logfile with access, agent, and referer information
                    228: # (Combined Logfile Format):
                    229: #
                    230: # setting it to "/var/log/apache2/access_log combined"
                    231: #   corresponds to 
                    232: # CustomLog /var/log/apache2/access_log combined
                    233: #
                    234: APACHE_ACCESS_LOG="/var/log/apache2/access_log combined"
                    235: 
                    236: ## Type:	list(On,Off,DNS)
                    237: ## Default:	"Off"
                    238: ## ServiceReload: apache2
                    239: #
                    240: # UseCanonicalName: Determines how Apache constructs self-referencing 
                    241: # URLs and the SERVER_NAME and SERVER_PORT variables.
                    242: # When set "Off", Apache will use the Hostname and Port supplied
                    243: # by the client.  When set "On", Apache will use the value of the
                    244: # ServerName directive.
                    245: #
                    246: APACHE_USE_CANONICAL_NAME="off"
                    247: 
                    248: ## Type:	list(Major,Minor,Minimal,ProductOnly,OS,Full)
                    249: ## Default:	"OS"
                    250: ## ServiceReload: apache2
                    251: #
                    252: # How much information the server response header field contains about the server.
                    253: # (installed modules, versions, etc.)
                    254: # see http://httpd.apache.org/docs-2.2/mod/core.html#servertokens
                    255: #
1.3     ! raeburn   256: APACHE_SERVERTOKENS="Minimal"
1.1       raeburn   257: 
                    258: ## Type:	list(on,off)
                    259: ## Default:	"off"
                    260: ## ServiceReload: apache2
                    261: #
                    262: # If mod_status is used, include extended information about the server, like 
                    263: # CPU usage, in the status report. It is a server-wide setting, and it can cost
                    264: # some performance!
                    265: #
                    266: APACHE_EXTENDED_STATUS="off"
                    267: 
                    268: ## Type:	list(on,off)
                    269: ## Default:	"off"
                    270: ## ServiceRestart: apache2
                    271: #
                    272: # Enable buffered logging
                    273: #
                    274: APACHE_BUFFERED_LOGS="off"
                    275: 
                    276: ## Type:	integer
                    277: ## Default:	300
                    278: ## ServiceReload: apache2
                    279: #
                    280: # Timeout: The number of seconds before receives and sends time out.
                    281: # It is a server wide setting.
                    282: #
                    283: APACHE_TIMEOUT="300"

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>