Skip to main content

A Buildout recipe to install and configure tomcat for Anaconda.

Project description

Travis Build

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

Xms

Initial Java heap size: Default: 128m

Xmx

Maximum Java heap size: Default: 1024m

MaxPermSize

Maximum Java permanent heap size: Default: 128m

ncwms_password

Enable ncWMS2 admin web interface by setting a password: Default: disabled

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
Xms = 256m
Xmx = 2048m
MaxPermSize = 128m

Authors

Carsten Ehbrecht ehbrecht at dkrz.de

Changes

0.2.8 (2015-12-07)

  • using latest supervisor recipe.

0.2.7 (2015-10-20)

  • added ncwms-password option for tomcat-users.xml

0.2.6 (2015-10-19)

  • add tomcat_home() and unzip() methods.

0.2.5 (2015-08-04)

  • using OpenJDK from conda package.

  • setting JAVA_HOME in cataling wrapper.

0.2.4 (2015-06-30)

  • Java options Xms, Xmx, MaxPermSize are configurable.

0.2.3 (2015-06-26)

  • added user option.

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

birdhousebuilder.recipe.tomcat-0.2.8.tar.gz (9.6 kB view details)

Uploaded Source

File details

Details for the file birdhousebuilder.recipe.tomcat-0.2.8.tar.gz.

File metadata

File hashes

Hashes for birdhousebuilder.recipe.tomcat-0.2.8.tar.gz
Algorithm Hash digest
SHA256 b6ea02d378e3365196b82285d9b898105d37acf5d156162e2e029649b19cc018
MD5 b7f09e249d5b7a2f04cb34985d0d461a
BLAKE2b-256 7d56f3fb7f174ce91d7f84dc029e5896ff28afb4495d2293c95b90de6df5a2ae

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page