Skip to content
Chef cookbook to install and configure Terracotta
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
attributes
recipes
templates/default
.gitignore
License.md
README.md
metadata.json
metadata.rb

README.md

Description

Installs the Terracotta clustering software. This cookbook is intended for use with the Shibboleth IdP and has not been tested in other configurations.

Requirements

Platform

Tested and developed on CentOS

Cookbooks

Requires the stock java cookbook, and should probably only be used with our Shibboleth IdP cookbook.

Attributes

  • node["terracotta"]["version"] - The version of the software we're installing. Should match the archive you place in files/default - see Usage below.

  • node['terracotta']['install_dir'] - Where to unpack the software. Defaults to /opt/src

  • node['terracotta']['tims'] - A dictionary of TIM names mapped to version numbers. For each one, you must place a matching jar file in files/default/. See Usage, below, for more information. Defaults to what you need to run Shibboleth - vector, tomcat-6.0, tomcat-5.5, tomcat-common, session-common, and session-ui.

  • node['terracotta']['toolkits'] - A dictionary of toolkit major versions mapped to minor versions. For each one, you must place a matching jar file in files/default/. See Usage, below, for more information. Defaults to what you need to run Shibboleth - 1.6.

We support placing the tim and toolkit archives locally to faciliate deployments with default-deny outbound firewalls. We should probably make it a configuration option whether to use a local copy or fetch them with tim-get.sh.

Usage

Place the Terracotta distribution tarball in the files/default/ directory of this cookbook, along with any TIMs and/or toolkits you want to load.

Define at the version attribute to match the tarball you used above.

If you are using this cookbook with Shibboleth and Terracotta, also be sure to set the ['tomcat']['java_options'] attribute to something like this:

-Dtc.install-root=/opt/terracotta -XX:+MustCallLoadClassInternal -Dtc.config=/opt/terracotta/tc-config.xml -Xbootclasspath/p:$TC_HOME/lib/dso-boot/dso-boot-hotspot_linux_160_29.jar -Xms1G -Xmx1G -XX:+UseParallelOldGC -XX:MaxGCPauseMillis=5000 -XX:+PrintGCDetails -XX:+PrintGCTimeStamps -XX:-TraceClassUnloading

License and Author

Author:: Elliot Kendall (elliot.kendall@ucsf.edu)

Copyright:: 2013, The Regents of the University of California

You can’t perform that action at this time.