birdhousebuilder.recipe.thredds

Introduction

birdhousebuilder.recipe.thredds is a Buildout recipe to install and configure Thredds 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 thredds and 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 for Tomcat 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 Thredds will be available on http://localhost:8080/thredds.

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

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

data_root

Root Path of data files (NetCDF) for Thredds. Default: ~/.conda/envs/birdhouse/var/lib/pywps/output

organisation

The name of your organisation. Default: Birdhouse

website

The URL of your organisation. Default: None

allow_wms

If set to true Web Mapping Service will be enabled. Default: true.

allow_wcs

If set to true Web Coverage Service will be enabled. Default: false.

allow_nciso

If set to true ISO generator Service will be enabled. Default: false.

To configure tomcat see the options in the tomcat recipe. For example:

http_port

HTTP Port for Tomcat service. Default: 8080

Example usage

The following example buildout.cfg installs Thredds with Anaconda and given data_root directory:

[buildout]
parts = thredds

anaconda-home = /home/myself/anaconda

[thredds]
recipe = birdhousebuilder.recipe.thredds
# ncwms
data_root = /var/lib/thredds/data_root
organisation = Birdhouse
allow_wms = true
# tomcat
http_port = 8080