Annotation of doc/install/linux/sles-suse/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 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: 
        !            86: APACHE_MODULES="actions alias auth_basic authn_file authz_host authz_groupfile authz_default authz_user authn_dbm autoindex cgi dir env expires headers include ldap log_config mime negotiation perl rewrite setenvif ssl status userdir"
        !            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: #
        !           142: APACHE_MPM=""
        !           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: #
        !           175: APACHE_SERVERNAME="35.8.63.94"
        !           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: #
        !           256: APACHE_SERVERTOKENS="OS"
        !           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>