39 lines
7.9 KiB
JSON
39 lines
7.9 KiB
JSON
{
|
|
"name": "tomcat",
|
|
"version": "0.16.2",
|
|
"description": "Installs/Configures tomcat",
|
|
"long_description": "tomcat Cookbook\n===============\nInstalls and configures Tomcat, Java servlet engine and webserver.\n\n\nRequirements\n------------\n### Platforms\n- Debian, Ubuntu (OpenJDK, Oracle)\n- CentOS 6+, Red Hat 6+, Fedora, Amaxon (OpenJDK, Oracle), Scientific Linux 6\n\n### Dependencies\n- java\n- openssl\n\n\nAttributes\n----------\n* `node[\"tomcat\"][\"base_version\"]` - The version of tomcat to install, default `6`.\n* `node[\"tomcat\"][\"port\"]` - The network port used by Tomcat's HTTP connector, default `8080`.\n* `node[\"tomcat\"][\"proxy_port\"]` - if set, the network port used by Tomcat's Proxy HTTP connector, default nil.\n* `node[\"tomcat\"][\"ssl_port\"]` - The network port used by Tomcat's SSL HTTP connector, default `8443`.\n* `node[\"tomcat\"][\"ssl_proxy_port\"]` - if set, the network port used by Tomcat's Proxy SSL HTTP connector, default nil.\n* `node[\"tomcat\"][\"ajp_port\"]` - The network port used by Tomcat's AJP connector, default `8009`.\n* `node[\"tomcat\"][\"shutdown_port\"]` - The network port used by Tomcat to listen for shutdown requests, default `8005`.\n* `node[\"tomcat\"][\"catalina_options\"]` - Extra options to pass to the JVM only during start and run commands, default \"\".\n* `node[\"tomcat\"][\"java_options\"]` - Extra options to pass to the JVM, default `-Xmx128M -Djava.awt.headless=true`.\n* `node[\"tomcat\"][\"use_security_manager\"]` - Run Tomcat under the Java Security Manager, default `false`.\n* `node[\"tomcat\"][\"loglevel\"]` - Level for default Tomcat's logs, default `INFO`.\n* `node[\"tomcat\"][\"deploy_manager_apps\"]` - whether to deploy manager apps, default `true`.\n* `node[\"tomcat\"][\"authbind\"]` - whether to bind tomcat on lower port numbers, default `no`.\n* `node[\"tomcat\"][\"max_threads\"]` - maximum number of threads in the connector pool.\n* `node[\"tomcat\"][\"tomcat_auth\"]` -\n* `node[\"tomcat\"][\"instances\"]` - A dictionary defining additional tomcat instances to run.\n* `node[\"tomcat\"][\"run_base_instance\"]` - Whether or not to run the \"base\" tomcat instance, default `true`.\n* `node[\"tomcat\"][\"user\"]` -\n* `node[\"tomcat\"][\"group\"]` -\n* `node[\"tomcat\"][\"home\"]` -\n* `node[\"tomcat\"][\"base\"]` -\n* `node[\"tomcat\"][\"config_dir\"]` -\n* `node[\"tomcat\"][\"log_dir\"]` -\n* `node[\"tomcat\"][\"tmp_dir\"]` -\n* `node[\"tomcat\"][\"work_dir\"]` -\n* `node[\"tomcat\"][\"context_dir\"]` -\n* `node[\"tomcat\"][\"webapp_dir\"]` -\n* `node[\"tomcat\"][\"lib_dir\"]` -\n* `node[\"tomcat\"][\"endorsed_dir\"]` -\n\n### Attributes for SSL\n* `node[\"tomcat\"][\"ssl_cert_file\"]` - SSL certificate file\n* `node[\"tomcat\"][\"ssl_chain_files\"]` - SSL CAcert chain files used for generating the SSL certificates\n* `node[\"tomcat\"][\"ssl_max_threads\"]` - maximum number of threads in the ssl connector pool, default `150`.\n* `node[\"tomcat\"][\"keystore_file\"]` - Location of the file where the SSL keystore is located\n* `node[\"tomcat\"][\"keystore_password\"]` - Generated by the `secure_password` method from the openssl cookbook; if you are using Chef Solo, set this attribute on the node\n* `node[\"tomcat\"][\"truststore_password\"]` - Generated by the `secure_password` method from the openssl cookbook; if you are using Chef Solo, set this attribute on the node\n* `node[\"tomcat\"][\"truststore_file\"]` - location of the file where the SSL truststore is located\n* `node[\"tomcat\"][\"certificate_dn\"]` - DN for the certificate\n* `node[\"tomcat\"][\"keytool\"]` - path to keytool, used for generating the certificate, location varies by platform\n\n\nUsage\n-----\nSimply include the recipe where you want Tomcat installed.\n\nDue to the ways that some system init scripts call the configuration, you may wish to set the java options to include `JAVA_OPTS`. As an example for a java app server role:\n\n```ruby\nname \"java-app-server\"\nrun_list(\"recipe[tomcat]\")\noverride_attributes(\n 'tomcat' => {\n 'java_options' => \"${JAVA_OPTS} -Xmx128M -Djava.awt.headless=true\"\n }\n)\n```\n\n\nRunning Multiple Instances\n--------------------------\nTo run multiple instances of Tomcat, populate the `instances` attribute, which is a dictionary of instance name => array of attributes. Most of the same attributes that can be used globally for the tomcat cookbook can also be set per-instance - see resources/instance.rb for details.\n\nIf they are not set for a particular instance, the `base`, `home`, `config_dir`, `log_dir`, `work_dir`, `context_dir`, and `webapp_dir` attributes are created by modifying the global values to use the instance name. For example, under Tomcat 7, with `home` /usr/share/tomcat7, `home` for instance \"instance1\" would be set to /usr/share/tomcat7-instance1. The port attributes - `port`, `proxy_port`, `ssl_port`, `ssl_proxy_port`, `ajp_port`, and `shutdown_port` - are not inherited and must be set per-instance. Other attributes that are not set are inherited unmodified from the global attributes. Each instance must define `shutdown_port`, and at least one of `port`, `ssl_port` or `ajp_port`.\n\nIf you only want to run specific instances and not the \"base\" tomcat instances, you can set `run_base_instance` to `false`.\n\nHere is an example partial role:\n\n```javascript\n...\n\"override_attributes\": {\n \"tomcat\": {\n \"run_base_instance\": false,\n \"instances\": {\n \"instance1\": {\n \"port\": 8081,\n \"shutdown_port\": 8006\n },\n \"lookup\": {\n \"port\": 8082,\n \"shutdown_port\": 8007,\n \"java_options\": \"-Xms1G -Xmx2G\"\n }\n },\n ...\n }\n ...\n}\n```\n\nManaging Tomcat Users\n---------------------\nThe recipe `tomcat::users` included in this cookbook is used for managing Tomcat users. The recipe adds users and roles to the `tomcat-users.xml` conf file.\n\nUsers are defined by creating a `tomcat_users` data bag and placing [Encrypted Data Bag Items](http://docs.opscode.com/chef/essentials_data_bags.html) in that data bag. Each encrypted data bag item requires an 'id', 'password', and a 'roles' field. The data bag key is retrieved from the default location `/etc/chef/encrypted_data_bag_secret`.\n\n```javascript\n{\n \"id\": \"reset\",\n \"password\": \"supersecret\",\n \"roles\": [\n \"manager\",\n \"admin\"\n ]\n}\n```\n\nIf you are a Chef Solo user the data bag items are not required to be encrypted and should not be.\n\n\nLicense & Authors\n-----------------\n- Author: Seth Chisamore (<schisamo@opscode.com>)\n- Author: Jamie Winsor (<jamie@vialstudios.com>)\n- Author: Phillip Goldenburg (<phillip.goldenburg@sailpoint.com>)\n- Auther: Mariano Cortesi (<mariano@zauberlabs.com>)\n- Author: Brendan O'Donnell (<brendan.james.odonnell@gmail.com>)\n\n```text\nCopyright:: 2010-2013, 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```\n",
|
|
"maintainer": "Opscode, Inc.",
|
|
"maintainer_email": "cookbooks@opscode.com",
|
|
"license": "Apache 2.0",
|
|
"platforms": {
|
|
"debian": ">= 0.0.0",
|
|
"ubuntu": ">= 0.0.0",
|
|
"centos": ">= 0.0.0",
|
|
"redhat": ">= 0.0.0",
|
|
"amazon": ">= 0.0.0",
|
|
"scientific": ">= 0.0.0"
|
|
},
|
|
"dependencies": {
|
|
"java": ">= 0.0.0",
|
|
"openssl": ">= 0.0.0"
|
|
},
|
|
"recommendations": {
|
|
},
|
|
"suggestions": {
|
|
},
|
|
"conflicting": {
|
|
},
|
|
"providing": {
|
|
},
|
|
"replacing": {
|
|
},
|
|
"attributes": {
|
|
},
|
|
"groupings": {
|
|
},
|
|
"recipes": {
|
|
"tomcat::default": "Installs and configures Tomcat",
|
|
"tomcat::users": "Setup users and roles for Tomcat"
|
|
}
|
|
} |