A Buildout recipe to install and configure ncWMS2 server with Anaconda.
Project description
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. You can use the buildout option anaconda-home to set the prefix for the anaconda installation. Otherwise the environment variable CONDA_PREFIX (variable is set when activating a conda environment) is used as conda prefix.
The recipe will install the ncWMS2 and apache-tomcat package from a conda channel in a conda enviroment defined by CONDA_PREFIX. The intallation folder is given by the prefix buildout option. It deploys a Supervisor configuration for Tomcat in ${prefix}/etc/supervisor/conf.d/tomcat.conf. Supervisor can be started with ${prefix}/etc/init.d/supervisord start.
By default ncWMS2 will be available on http://localhost:8080/ncWMS2.
The configuration files of ncWMS2 are in ${prefix}/var/lib/tomcat/conf/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 pointing to the root folder of the Anaconda installation. Default: $HOME/anaconda.
- data_dir
Root Path of data files (NetCDF) for ncWMS2 (used in dynamic service outputs). Default: ${prefix}/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
[ncwms]
recipe = birdhousebuilder.recipe.ncwms
organization = Birdhouse
http_port = 8080
An example GetCapabilities URL to access a 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
Changes
0.3.2 (2016-07-27)
added data2 dynamic service.
0.3.1 (2016-07-26)
prepared for ncWMS 2.2.x.
config files are now in var/lib/tomcat/conf/ncWMS2.
0.3.0 (2016-07-25)
using zc.recipe.deployment.
updated doctests.
updated travis.
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for birdhousebuilder.recipe.ncwms-0.3.2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 09494d6735a6c4f86f8f7966b54df87983a07418a1d72ac747577f36ef4258d0 |
|
MD5 | 865d3710240ff3890e08971828fb60ff |
|
BLAKE2b-256 | 8a469a0a27f5dbbbf100631819e6566d1515618f3ff4b3ceb1e572989b309f02 |