Skip to main content

A Buildout recipe to install and configure ncWMS2 server with Anaconda.

Project description

Travis Build

Introduction

birdhousebuilder.recipe.ncwms is a Buildout recipe to install and configure ncWMS 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 ncWMS2 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 ncWMS2 will be available on http://localhost:8080/ncWMS2.

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_dir

Root Path of data files (NetCDF) for ncWMS2 (used in dynamic service outputs). Default: ~/.conda/envs/birdhouse/var/lib/pywps/outputs

title

Title for this Web Map Service. Default: Birdhouse ncWMS2 Server

abstract

More details about this Web Map Service. Default: ncWMS2 Web Map Service used in Birdhouse

contact

Name of server administrator. Default: Birdhouse Admin

organization

Organization of server administrator. Default: Birdhouse

url

Web site of the service provider. Default: http://bird-house.github.io/

enablecache

Enable WMS caching: Default: false

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

http_port

HTTP Port for Tomcat service. Default: 8080

ncwms_password

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

Example usage

The following example buildout.cfg installs ncWMS2 with Anaconda and default options:

[buildout]
parts = ncwms

anaconda-home = /home/myself/anaconda

[ncwms]
recipe = birdhousebuilder.recipe.ncwms
organization = Birdhouse
http_port = 8080

An example GetCapabilities URL to access for an output NetCDF file in outputs (using DATASET param):

http://localhost:8080/ncWMS2/wms?SERVICE=WMS&REQUEST=GetCapabilities&VERSION=1.3.0&DATASET=outputs/malleefowl/tasmax.nc

Authors

Carsten Ehbrecht ehbrecht at dkrz.de

Changes

0.2.0 (2015-12-17)

  • added tomcat installation.

  • using ncWMS2 2.0.4

  • added empty datasets tag in config.xml template.

0.1.2 (2015-10-22)

  • added more options: title, abstract, …

  • renamed option data_root to data_dir

  • updated to ncWMS2 2.0.3

0.1.1 (2015-10-20)

  • added Dataset config for PyWPS outputs.

0.1.0 (2015-10-19)

  • 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.ncwms-0.2.0.tar.gz (7.5 kB view hashes)

Uploaded Source

Built Distribution

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