birdhousebuilder.recipe.tomcat 0.2.2

A Buildout recipe to install and configure tomcat for Anaconda.

Contents

• Introduction

• Usage

  • Supported options

  • Example usage

• Authors

• Changes

  • 0.2.2 (2015-06-17)

  • 0.2.1 (2015-02-24)

  • 0.1.4 (2014-12-06)

  • 0.1.3 (2014-12-04)

  • 0.1.2 (2014-07-31)

  • 0.1.1 (2014-07-22)

  • 0.1.0 (2014-07-10)

Introduction

birdhousebuilder.recipe.tomcat is a Buildout recipe to install Apache Tomcat application server with Anaconda. This recipe is used by the Birdhouse project.

Usage

The recipe requires that Anaconda is already installed. It assumes that the default Anaconda location is in your home directory ~/anaconda. Otherwise you need to set the ANACONDA_HOME environment variable or the Buildout option anaconda-home.

It installs the apache-tomcat package from a conda channel in a conda enviroment named birdhouse. The location of the birdhouse environment is .conda/envs/birdhouse. It deploys a Supervisor configuration in ~/.conda/envs/birdhouse/etc/supervisor/conf.d/tomcat.conf. Supervisor can be started with ~/.conda/envs/birdhouse/etc/init.d/supervisord start.

By default Tomcat will be available on http://localhost:8080/.

The recipe depends on birdhousebuilder.recipe.conda and birdhousebuilder.recipe.supervisor.

Supported options

This recipe supports the following options:

anaconda-home

Buildout option with the root folder of the Anaconda installation. Default: $HOME/anaconda. The default location can also be set with the environment variable ANACONDA_HOME. Example:

export ANACONDA_HOME=/opt/anaconda

Search priority is:

1. anaconda-home in buildout.cfg

2. $ANACONDA_HOME

3. $HOME/anaconda

http_port

HTTP Port for Tomcat service. Default: 8080

Example usage

The following example buildout.cfg installs tomcat as a Supervisor service:

[buildout]
parts = tomcat

anaconda-home = /home/myself/anaconda

[tomcat]
recipe = birdhousebuilder.recipe.tomcat
http_port = 8080

Authors

Carsten Ehbrecht ehbrecht at dkrz.de

Changes

0.2.2 (2015-06-17)

• added content_root().

• using catalina-wrapper.sh script for supervisor.

• added option http_port.

0.2.1 (2015-02-24)

• installing in conda enviroment birdhouse.

• using $ANACONDA_HOME environment variable.

• separation of anaconda-home and installation prefix.

0.1.4 (2014-12-06)

• Don’t update conda on buildout update.

0.1.3 (2014-12-04)

• Update tomcat config.

0.1.2 (2014-07-31)

• Update documentation.

0.1.1 (2014-07-22)

• Configure tomcat-users.xml.

0.1.0 (2014-07-10)

• Initial Release.