Annotation of doc/install/linux/sles-suse/apache2.4/sysconfig_apache2, revision 1.1

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 authn_file authz_host authz_groupfile authz_core authz_user autoindex cgi dir env expires include log_config mime negotiation setenvif ssl socache_shmcb userdir reqtimeout"
        !            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: #   see /usr/lib64/apache2-$MPM
        !            42: #   see http://httpd.apache.org/docs/2.4/mod/ !
        !            43: #
        !            44: # * It pays to use IfDefine statements... like
        !            45: #    <IfModule mod_xyz.c>
        !            46: #        ....
        !            47: #    </IfModule>
        !            48: #
        !            49: # * In the APACHE_MODULES variable, you can use mod_xyz or just xyz syntax.
        !            50: #   You may also name an absolute path if you like.
        !            51: #
        !            52: # * NOTES ON SSL: 
        !            53: #   1. Before you can use mod_ssl, you need a server certificate. 
        !            54: #      A test certificate can be created by entering e. g.
        !            55: #
        !            56: #      $ gensslcert -n a.com
        !            57: #
        !            58: #      See gensslcert -h for or gensslcert script itself for details.
        !            59: #   2. Also, you need to set the ServerName inside the <VirtualHost _default_:443> 
        !            60: #      block to the fully qualified domain name (see /etc/HOSTNAME).
        !            61: #   3. If your server certificate is protected by a passphrase you should increase the
        !            62: #      APACHE_START_TIMEOUT (see above)
        !            63: #   4. Consider to load also socache_shmcb module, see
        !            64: #      http://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslsessioncache
        !            65: #      for details.
        !            66: #   5. To finally enable ssl support, you need to add 'SSL' to APACHE_SERVER_FLAGS 
        !            67: #      below.
        !            68: #
        !            69: # * modules listed here will be ignored if they are not installed
        !            70: #
        !            71: #
        !            72: # EXAMPLES:
        !            73: #
        !            74: # fairly minimal
        !            75: # APACHE_MODULES="authz_host alias auth dir log_config mime setenvif"
        !            76: #
        !            77: # apache's default installation
        !            78: # APACHE_MODULES="authz_host actions alias asis auth autoindex cgi dir imap include log_config mime negotiation setenvif status userdir"
        !            79: # your settings
        !            80: APACHE_MODULES="actions alias auth_basic authn_core authn_file authz_host authz_groupfile authz_core authz_user autoindex cgi dir env expires headers include ldap log_config mime negotiation perl rewrite setenvif ssl socache_shmcb userdir reqtimeout"
        !            81: 
        !            82: 
        !            83: ## Type:	string
        !            84: ## Default:	""
        !            85: ## ServiceRestart: apache2
        !            86: #
        !            87: # Additional server flags:
        !            88: #
        !            89: # Put here any server flags ("Defines") that you want to hand over to 
        !            90: # httpd at start time, or other command line flags.
        !            91: #
        !            92: # Background: Any directives within an <IfDefine flag>...</IfDefine>
        !            93: #             section are only processed if the flag is defined.
        !            94: #             This allows to write configuration which is active only in a
        !            95: #             special cases, like during server maintenance, or for testing
        !            96: #             something temporarily.
        !            97: #
        !            98: # Notably, to enable ssl support, 'SSL' needs to be added here.
        !            99: # To enable the server-status, 'STATUS' needs to be added here.
        !           100: #
        !           101: # It does not matter if you write flag1, -D flag1 or -Dflag1.
        !           102: # Multiple flags can be given as "-D flag1 -D flag2" or simply "flag1 flag2".
        !           103: #
        !           104: # Specifying such flags here is equivalent to giving them on the commandline.
        !           105: # (e.g. via rcapache2 start -DReverseProxy)
        !           106: #
        !           107: # Example:
        !           108: #      "SSL HTTP2 STATUS AWSTATS SVN_VIEWCVS no_subversion_today"
        !           109: #
        !           110: APACHE_SERVER_FLAGS="SSL"
        !           111: 
        !           112: ## Type:	string
        !           113: ## Default:	""
        !           114: ## ServiceRestart: apache2
        !           115: #
        !           116: # Which config file do you want to use?
        !           117: # (if not set, /etc/apache2/httpd.conf is used.)
        !           118: # It is unusual to need to use this setting.
        !           119: #
        !           120: APACHE_HTTPD_CONF=""
        !           121: 
        !           122: ## Type:	list(prefork,worker,event,itk)
        !           123: ## Default:	""
        !           124: ## ServiceRestart: apache2
        !           125: #
        !           126: # MPM (multi-processing module) to use.
        !           127: #
        !           128: # Needed to determine with which MPM apache will run, as well as
        !           129: # against which header files modules will be built. 
        !           130: #
        !           131: # If not set, the system will simply pick one of the installed MPMs.
        !           132: #
        !           133: # The implementation of the logic is in /usr/share/apache2/find_mpm,
        !           134: # a script which can be used standalone as well if needed.
        !           135: #
        !           136: APACHE_MPM="prefork"
        !           137: 
        !           138: ## Type:	string
        !           139: ## Default:	""
        !           140: ## ServiceReload: apache2
        !           141: #
        !           142: # email address of the server administrator (ServerAdmin directive)
        !           143: # This address is added to the server's responses if APACHE_SERVERSIGNATURE 
        !           144: # is set to "email". 
        !           145: #
        !           146: # If empty ("") it defaults to webmaster@$FQHOSTNAME, where FQHOSTNAME is
        !           147: # taken from /etc/HOSTNAME. 
        !           148: #
        !           149: # Note that ServerAdmin directives inside VirtualHost statements are not
        !           150: # changed, even not the one in the stock SSL virtual host block. 
        !           151: #
        !           152: APACHE_SERVERADMIN=""
        !           153: 
        !           154: ## Type:	string
        !           155: ## Default:	""
        !           156: ## ServiceReload: apache2
        !           157: #
        !           158: # ServerName gives the name and port that the server uses to identify itself.
        !           159: # This can often be determined automatically, but we recommend you specify
        !           160: # it explicitly to prevent problems during startup.
        !           161: #
        !           162: # If this is not set to valid DNS name for your host, server-generated
        !           163: # redirections will not work.  See also the UseCanonicalName directive.
        !           164: #
        !           165: # If your host doesn't have a registered DNS name, enter its IP address here.
        !           166: # You will have to access it by its address anyway, and this will make 
        !           167: # redirections work in a sensible way.
        !           168: #
        !           169: APACHE_SERVERNAME=""
        !           170: 
        !           171: ## Type:	integer
        !           172: ## Default:	2
        !           173: #
        !           174: # timeout during server startup (seconds)
        !           175: # after this time, the start script decides wether the httpd process started without error.
        !           176: #
        !           177: # Increase it, if you use mod_ssl and your certificate is passphrase protected!
        !           178: #
        !           179: APACHE_START_TIMEOUT="2"
        !           180: 
        !           181: ## Type:	list(on,off,email)
        !           182: ## Default:	"on"
        !           183: ## ServiceReload: apache2
        !           184: #
        !           185: # Configures the footer on server-generated documents 
        !           186: # This correlates to the ServerSignature directive. 
        !           187: #
        !           188: APACHE_SERVERSIGNATURE="off"
        !           189: 
        !           190: ## Type:	list(debug,info,notice,warn,error,crit,alert,emerg)
        !           191: ## Default:	"warn"
        !           192: ## ServiceReload: apache2
        !           193: #
        !           194: # LogLevel: Control the number of messages logged to the error_log.
        !           195: #
        !           196: APACHE_LOGLEVEL="warn"
        !           197: 
        !           198: ## Type:	string
        !           199: ## Default:	"/var/log/apache2/access_log combined"
        !           200: ## ServiceRestart: apache2
        !           201: #
        !           202: # The location and format of the access logfile (Common Logfile Format).
        !           203: # If you do not define any access logfiles within a <VirtualHost>
        !           204: # container, they will be logged here.  Contrarywise, if you *do*
        !           205: # define per-<VirtualHost> access logfiles, transactions will be
        !           206: # logged therein and *not* in this file.
        !           207: #
        !           208: # Simply set it to empty, if you configure it yourself somewhere else.
        !           209: # 
        !           210: # Examples:
        !           211: #
        !           212: # If you would like to have agent and referer logfiles:
        !           213: #
        !           214: # setting it to "/var/log/apache2/referer_log referer, /var/log/apache2/agent_log agent"
        !           215: #   corresponds to 
        !           216: # CustomLog /var/log/apache2/referer_log referer
        !           217: # CustomLog /var/log/apache2/agent_log   agent
        !           218: #
        !           219: # If you prefer a single logfile with access, agent, and referer information
        !           220: # (Combined Logfile Format):
        !           221: #
        !           222: # setting it to "/var/log/apache2/access_log combined"
        !           223: #   corresponds to 
        !           224: # CustomLog /var/log/apache2/access_log combined
        !           225: #
        !           226: APACHE_ACCESS_LOG="/var/log/apache2/access_log combined"
        !           227: 
        !           228: ## Type:	list(On,Off,DNS)
        !           229: ## Default:	"Off"
        !           230: ## ServiceReload: apache2
        !           231: #
        !           232: # UseCanonicalName: Determines how Apache constructs self-referencing 
        !           233: # URLs and the SERVER_NAME and SERVER_PORT variables.
        !           234: # When set "Off", Apache will use the Hostname and Port supplied
        !           235: # by the client.  When set "On", Apache will use the value of the
        !           236: # ServerName directive.
        !           237: #
        !           238: APACHE_USE_CANONICAL_NAME="off"
        !           239: 
        !           240: ## Type:	list(Major,Minor,Minimal,ProductOnly,OS,Full)
        !           241: ## Default:	"OS"
        !           242: ## ServiceReload: apache2
        !           243: #
        !           244: # How much information the server response header field contains about the server.
        !           245: # (installed modules, versions, etc.)
        !           246: # see http://httpd.apache.org/docs/2.4/mod/core.html#servertokens
        !           247: #
        !           248: APACHE_SERVERTOKENS="Minimal"
        !           249: 
        !           250: ## Type:	list(on,off)
        !           251: ## Default:	"off"
        !           252: ## ServiceReload: apache2
        !           253: #
        !           254: # If mod_status is used, include extended information about the server, like 
        !           255: # CPU usage, in the status report. It is a server-wide setting, and it can cost
        !           256: # some performance!
        !           257: #
        !           258: APACHE_EXTENDED_STATUS="off"

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