blob: a9280ea3db0a40c5ddb274aca1449e5a1551748b [file] [log] [blame]
{
"suggestions": {
},
"attributes": {
"apache/traceenable": {
"required": "optional",
"calculated": false,
"choice": [
],
"default": "On",
"type": "string",
"recipes": [
],
"description": "Determine behavior of TRACE requests",
"display_name": "Apache Trace Enable"
},
"apache/serversignature": {
"required": "optional",
"calculated": false,
"choice": [
],
"default": "On",
"type": "string",
"recipes": [
],
"description": "Configure footer on server-generated documents",
"display_name": "Apache Server Signature"
},
"apache/contact": {
"required": "optional",
"calculated": false,
"choice": [
],
"default": "ops@example.com",
"type": "string",
"recipes": [
],
"description": "Email address of webmaster",
"display_name": "Apache Contact"
},
"apache/icondir": {
"required": "optional",
"calculated": false,
"choice": [
],
"default": "/usr/share/apache2/icons",
"type": "string",
"recipes": [
],
"description": "Directory location for icons",
"display_name": "Apache Icondir"
},
"apache/user": {
"required": "optional",
"calculated": false,
"choice": [
],
"default": "www-data",
"type": "string",
"recipes": [
],
"description": "User Apache runs as",
"display_name": "Apache User"
},
"apache/worker/threadsperchild": {
"required": "optional",
"calculated": false,
"choice": [
],
"default": "64",
"type": "string",
"recipes": [
],
"description": "Constant number of worker threads in each server process",
"display_name": "Apache Worker MPM ThreadsPerChild"
},
"apache/worker/maxclients": {
"required": "optional",
"calculated": false,
"choice": [
],
"default": "1024",
"type": "string",
"recipes": [
],
"description": "Maximum number of simultaneous connections",
"display_name": "Apache Worker MPM MaxClients"
},
"apache/worker": {
"required": "optional",
"calculated": false,
"choice": [
],
"type": "hash",
"recipes": [
],
"description": "Hash of Apache prefork tuning attributes.",
"display_name": "Apache Worker"
},
"apache/keepaliverequests": {
"required": "optional",
"calculated": false,
"choice": [
],
"default": "100",
"type": "string",
"recipes": [
],
"description": "Number of requests allowed on a persistent connection",
"display_name": "Apache Keepalive Requests"
},
"apache/timeout": {
"required": "optional",
"calculated": false,
"choice": [
],
"default": "300",
"type": "string",
"recipes": [
],
"description": "Connection timeout value",
"display_name": "Apache Timeout"
},
"apache/worker/maxrequestsperchild": {
"required": "optional",
"calculated": false,
"choice": [
],
"default": "0",
"type": "string",
"recipes": [
],
"description": "Maximum number of request a child process will handle",
"display_name": "Apache Worker MPM MaxRequestsPerChild"
},
"apache/dir": {
"required": "optional",
"calculated": false,
"choice": [
],
"default": "/etc/apache2",
"type": "string",
"recipes": [
],
"description": "Location for Apache configuration",
"display_name": "Apache Directory"
},
"apache/prefork/serverlimit": {
"required": "optional",
"calculated": false,
"choice": [
],
"default": "400",
"type": "string",
"recipes": [
],
"description": "Upper limit on configurable server processes",
"display_name": "Apache Prefork MPM ServerLimit"
},
"apache/prefork/minspareservers": {
"required": "optional",
"calculated": false,
"choice": [
],
"default": "16",
"type": "string",
"recipes": [
],
"description": "Minimum number of spare server processes",
"display_name": "Apache Prefork MPM MinSpareServers"
},
"apache/allowed_openids": {
"required": "optional",
"calculated": false,
"choice": [
],
"default": "",
"type": "string",
"recipes": [
],
"description": "Array of OpenIDs allowed to authenticate",
"display_name": "Apache Allowed OpenIDs"
},
"apache/binary": {
"required": "optional",
"calculated": false,
"choice": [
],
"default": "/usr/sbin/apache2",
"type": "string",
"recipes": [
],
"description": "Apache server daemon program",
"display_name": "Apache Binary"
},
"apache/prefork/startservers": {
"required": "optional",
"calculated": false,
"choice": [
],
"default": "16",
"type": "string",
"recipes": [
],
"description": "Number of MPM servers to start",
"display_name": "Apache Prefork MPM StartServers"
},
"apache/listen_ports": {
"required": "optional",
"calculated": false,
"choice": [
],
"default": [
"80",
"443"
],
"type": "array",
"recipes": [
],
"description": "Ports that Apache should listen on",
"display_name": "Apache Listen Ports"
},
"apache/prefork/maxrequestsperchild": {
"required": "optional",
"calculated": false,
"choice": [
],
"default": "10000",
"type": "string",
"recipes": [
],
"description": "Maximum number of request a child process will handle",
"display_name": "Apache Prefork MPM MaxRequestsPerChild"
},
"apache/keepalivetimeout": {
"required": "optional",
"calculated": false,
"choice": [
],
"default": "5",
"type": "string",
"recipes": [
],
"description": "Time to wait for requests on persistent connection",
"display_name": "Apache Keepalive Timeout"
},
"apache/keepalive": {
"required": "optional",
"calculated": false,
"choice": [
],
"default": "On",
"type": "string",
"recipes": [
],
"description": "HTTP persistent connections",
"display_name": "Apache Keepalive"
},
"apache": {
"required": "optional",
"calculated": false,
"choice": [
],
"type": "hash",
"recipes": [
],
"description": "Hash of Apache attributes",
"display_name": "Apache Hash"
},
"apache/worker/maxsparethreads": {
"required": "optional",
"calculated": false,
"choice": [
],
"default": "192",
"type": "string",
"recipes": [
],
"description": "Maximum number of spare worker threads",
"display_name": "Apache Worker MPM MaxSpareThreads"
},
"apache/worker/startservers": {
"required": "optional",
"calculated": false,
"choice": [
],
"default": "4",
"type": "string",
"recipes": [
],
"description": "Initial number of server processes to start",
"display_name": "Apache Worker MPM StartServers"
},
"apache/prefork/maxclients": {
"required": "optional",
"calculated": false,
"choice": [
],
"default": "400",
"type": "string",
"recipes": [
],
"description": "Maximum number of simultaneous connections",
"display_name": "Apache Prefork MPM MaxClients"
},
"apache/prefork": {
"required": "optional",
"calculated": false,
"choice": [
],
"type": "hash",
"recipes": [
],
"description": "Hash of Apache prefork tuning attributes.",
"display_name": "Apache Prefork"
},
"apache/servertokens": {
"required": "optional",
"calculated": false,
"choice": [
],
"default": "Prod",
"type": "string",
"recipes": [
],
"description": "Server response header",
"display_name": "Apache Server Tokens"
},
"apache/log_dir": {
"required": "optional",
"calculated": false,
"choice": [
],
"default": "/etc/apache2",
"type": "string",
"recipes": [
],
"description": "Location for Apache logs",
"display_name": "Apache Log Directory"
},
"apache/worker/minsparethreads": {
"required": "optional",
"calculated": false,
"choice": [
],
"default": "64",
"type": "string",
"recipes": [
],
"description": "Minimum number of spare worker threads",
"display_name": "Apache Worker MPM MinSpareThreads"
},
"apache/prefork/maxspareservers": {
"required": "optional",
"calculated": false,
"choice": [
],
"default": "32",
"type": "string",
"recipes": [
],
"description": "Maximum number of spare server processes",
"display_name": "Apache Prefork MPM MaxSpareServers"
}
},
"maintainer_email": "cookbooks@opscode.com",
"conflicting": {
},
"dependencies": {
},
"recipes": {
"apache2::mod_dav": "Apache module 'dav'",
"apache2::mod_proxy_ajp": "Apache module 'proxy_ajp'",
"apache2::mod_php5": "Apache module 'php5'",
"apache2::mod_mime": "Apache module 'mime' with config file",
"apache2::mod_deflate": "Apache module 'deflate' with config file",
"apache2::mod_ssl": "Apache module 'ssl' with config file, adds port 443 to listen_ports",
"apache2::mod_setenvif": "Apache module 'setenvif' with config file",
"apache2::mod_python": "Apache module 'python'",
"apache2::mod_negotiation": "Apache module 'negotiation' with config file",
"apache2::mod_cgi": "Apache module 'cgi'",
"apache2::mod_authz_groupfile": "Apache module 'authz_groupfile'",
"apache2::mod_auth_basic": "Apache module 'auth_basic'",
"apache2::mod_rewrite": "Apache module 'rewrite'",
"apache2::mod_dav_svn": "Apache module 'dav_svn'",
"apache2::mod_autoindex": "Apache module 'autoindex' with config file",
"apache2::mod_authz_host": "Apache module 'authz_host'",
"apache2::mod_headers": "Apache module 'headers'",
"apache2::mod_authz_user": "Apache module 'authz_user'",
"apache2::mod_proxy_connect": "Apache module 'proxy_connect'",
"apache2::mod_proxy": "Apache module 'proxy' with config file",
"apache2::mod_fcgid": "Apache module 'fcgid', package on ubuntu/debian, rhel/centos, compile source on suse; with config file",
"apache2::mod_authnz_ldap": "Apache module 'authnz_ldap'",
"apache2::mod_auth_digest": "Apache module 'auth_digest'",
"apache2::mod_env": "Apache module 'env'",
"apache2::mod_status": "Apache module 'status' with config file",
"apache2::mod_proxy_http": "Apache module 'proxy_http'",
"apache2::mod_log_config": "Apache module 'log_config'",
"apache2::mod_ldap": "Apache module 'ldap'",
"apache2::mod_expires": "Apache module 'expires'",
"apache2::mod_alias": "Apache module 'alias' with config file",
"apache2": "Main Apache configuration",
"apache2::mod_authn_file": "Apache module 'authn_file'",
"apache2::mod_auth_openid": "Apache module 'authopenid'",
"apache2::mod_proxy_balancer": "Apache module 'proxy_balancer'",
"apache2::mod_dir": "Apache module 'dir' with config file",
"apache2::mod_authz_default": "Apache module 'authz_default'"
},
"providing": {
},
"platforms": {
"debian": [
],
"centos": [
],
"ubuntu": [
],
"redhat": [
]
},
"license": "Apache 2.0",
"version": "0.12.2",
"replacing": {
},
"groupings": {
},
"name": "apache2",
"recommendations": {
},
"description": "Installs and configures all aspects of apache2 using Debian style symlinks with helper definitions",
"maintainer": "Opscode, Inc.",
"long_description": "= DESCRIPTION:\n\nComplete Debian/Ubuntu style Apache2 configuration.\n\n= REQUIREMENTS:\n\nDebian or Ubuntu preferred.\n\nRed Hat/CentOS and Fedora can be used but will be converted to a Debian/Ubuntu style Apache as it's far easier to manage with chef. \n\n= ATTRIBUTES:\n\nThe file attributes/apache.rb contains the following attribute types:\n\n* platform specific locations and settings.\n* general settings\n* prefork attributes\n* worker attributes\n\nGeneral settings and prefork/worker attributes are tunable.\n\n= USAGE:\n\nInclude the apache2 recipe to install Apache2 and get 'sane' default settings. Configuration is modularized through Apache vhost sites a la Debian style configuration.\n\nFor Red Hat, CentOS and Fedora you should first disable selinux as it's not supported (yet), then remove the stock httpd and all it's dependencies prior to attempting to use this recipe. Many packages in these distributions drop conflicting configs into conf.d, all of which haven't been accounted for yet. Starting from scratch will also make it far easier to debug.\n\n== Defines:\n\n* apache_module: sets up an Apache module.\n* apache_conf: sets up a config file for an apache module.\n* apache_site: sets up a vhost site. The conf file must be available.\n* web_app: copies the template for a web app and enables it as a site via apache_site.\n\n== Web Apps:\n\nVarious applications that can be set up with Apache as the front end, such as PHP, Django, Rails and others can use the web_app define to set up the template and the Apache site. The define is kind of dumb, so the template needs have the application implementation settings, since we don't know what your app is or what is needed from Apache.\n\nWe only prototype one parameter for the web_app define, \"template\". This is used to specify the name of the template to use in the current cookbook. When you use web_app, you can set up any parameters you want to use in your template. They will get passed to the template through the params hash. For example, the sample web_app.conf.erb template in this cookbook makes use of these.\n\n* docroot\n* server_name\n* server_aliases\n\nThese are available as @params[:docroot], @params[:server_name], @params[:server_aliases] within the template. \n\nIf 'cookbook' and 'template' are not specified, the current cookbook's templates/default/web_app.conf.erb will be used. If this template is not suitable for your application, copy it to your cookbook and customize as needed.\n\n== God Monitor:\n\nThere's a new recipe, apache2::god_monitor. You will need to make sure to include the 'god' recipe before using the apache2::god_monitor recipe in your cookbook.\n\n== OpenID Auth\n\nInstalls the mod_auth_openid module from source. Specify an array of OpenIDs that are allowed to authenticate with the attribute apache[:allowed_openids]. Use the following in a vhost to protect with OpenID authentication:\n\n AuthOpenIDEnabled On\n AuthOpenIDDBLocation /var/cache/apache2/mod_auth_openid.db\n AuthOpenIDUserProgram /usr/local/bin/mod_auth_openid.rb\n\nChange the DBLocation as appropriate for your platform. You'll need to change the file in the recipe to match. The UserProgram is optional if you don't want to limit access by certain OpenIDs.\n\n= LICENSE & AUTHOR:\n\nAuthor:: Joshua Timberman (<joshua@opscode.com>)\nCopyright:: 2009, Opscode, Inc\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n"
}