linux-on-ibm-z/tomcat

Name: tomcat

Owner: LinuxONE and Linux on z Systems Open-source Team

Description: Development repository for tomcat Chef cookbook

Created: 2016-04-08 14:11:11.0

Updated: 2016-04-08 14:11:12.0

Pushed: 2016-04-12 05:21:54.0

Homepage: http://supermarket.chef.io/cookbooks/tomcat

Size: 399

Language: Ruby

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

tomcat Cookbook

Provides resources for installing Tomcat and managing the Tomcat service for use in wrapper cookbooks. Installs Tomcat from tarballs on the Apache.org website and installs the appropriate configuration for your platform's init system.

Requirements

Platforms

• Debian / Ubuntu derivatives
• RHEL and derivatives
• Fedora
• openSUSE / SUSE Linux Enterprises

Chef

• Chef 12.1+

Cookbooks

• compat_resource

Usage

Due to the complexity of Tomcat cookbooks it's not possible to create an attribute driven cookbook that solves everyone's problems. Instead this cookbook provides resources for installing Tomcat and managing the Tomcat service, which are best used in your own wrapper cookbook. The best way to understand how this could be used is to look at the helloworld test recipe located at test/cookbooks/test/recipes/helloworld_example.rb

Resources (providers)

tomcat_install

tomcat_install installs an instance of the tomcat binary direct from Apache's mirror site. As distro packages are not used we can easily deploy per-instance installations and any version available on the Apache archive site can be installed.

properties

• version: The version to install. Default: 8.0.32
• install_path: Full path to the install directory. Default: /opt/tomcat_INSTANCENAME_VERSION
• tarball_base_path: The base path to the apache mirror containing the tarballs. Default: 'http://archive.apache.org/dist/tomcat/'
• checksum_base_path: The base path to the apache mirror containing the md5 file. Default: 'http://archive.apache.org/dist/tomcat/'
• exclude_docs: Exclude ./webapps/docs from installation. Default true.
• exclude_examples: Exclude ./webapps/examples from installation. Default true.
• exclude_manager: Exclude ./webapps/manager from installation. Default: false.
• exclude_hostmanager: Exclude ./webapps/host-manager from installation. Default: false.

example

Install an Tomcat 8.0.32 instance named 'helloworld' to /opt/tomcat_helloworld_8_0_32/ with a symlink at /opt/tomcat_helloworld/

at_install 'helloworld' do
rsion '8.0.32'

tomcat_service

tomcat_service sets up the installed tomcat instance to run using the appropriate init system (sys-v, upstart, or systemd)

properties

• install_path: Full path to the install directory. Default: /opt/tomcat_INSTANCENAME
• env_vars: An array of hashes containing the environmental variables for Tomcat's setenv.sh script. Note: If CATALINA_BASE is not passed it will automatically be added as the first item in the array. Default: [ {'CATALINA_BASE' => '/opt/INSTANCE_NAME/'}, {'CATALINA_PID' => '$CATALINA_BASE/bin/tomcat.pid'} ]

actions

• start
• stop
• enable
• disable
• restart

example

at_service 'helloworld' do
tion :start
v_vars [{CATALINA_PID => '/my/special/path/tomcat.pid'}]

License & Authors

• Author: Tim Smith (tsmith@chef.io)

right:: 2010-2016, Chef Software, Inc

nsed under the Apache License, Version 2.0 (the "License");
may not use this file except in compliance with the License.
may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

ss required by applicable law or agreed to in writing, software
ributed under the License is distributed on an "AS IS" BASIS,
OUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
the License for the specific language governing permissions and
tations under the License.