birdhousebuilder.recipe.adagucserver
Contents
Introduction
birdhousebuilder.recipe.adagucserver
is a Buildout recipe to install and configure Adagucserver with Anaconda. Adagucserver is an implementation of a Web Map Service (WMS). Adagucserver will be deployed as a Supervisor service and is available on a Nginx web server.
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 adagucserver
package from a conda channel in a conda environment named birdhouse
. The location of the birdhouse environment is .conda/envs/birdhouse
. It deploys a Supervisor configuration for Adagucserver
in ~/.conda/envs/birdhouse/etc/supervisor/conf.d/adagucserver.conf
. Supervisor can be started with ~/.conda/envs/birdhouse/etc/init.d/supervisor start
.
The recipe will install the nginx
package from a conda channel and deploys a Nginx site configuration for Adagucserver
. The configuration will be deployed in ~/.conda/envs/birdhouse/etc/nginx/conf.d/adagucserver.conf
. Nginx can be started with ~/.conda/envs/birdhouse/etc/init.d/nginx start
.
By default Adagucserver
will be available on http://localhost:9002?service=WMS&version=1.3.0&request=GetCapabilities.
The recipe depends on:
birdhousebuilder.recipe.conda
birdhousebuilder.recipe.supervisor
birdhousebuilder.recipe.nginx
Supported options
The 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 variableANACONDA_HOME
. Example:export ANACONDA_HOME=/opt/anaconda
Search priority is:
-
anaconda-home
inbuildout.cfg
$ANACONDA_HOME
$HOME/anaconda
-
- title
- Title of the Web Map Service. Default: Birdhouse ADAGUC WMS
- abstract
- Description of the Web Map Service. Default: ADAGUC Web Map Service used in Birdhouse
- port
- Port used by the Adaguc WMS service. Default: 9002
- data_dir
- Path to the data directory with NetCDF files. Default:
~/.conda/envs/birdhouse/var/lib/pywps/outputs
- enablecache
- Enabled caching of WMS requests. Default: false
Example usage
The following example buildout.cfg
installs Adagucserver
with Anaconda:
[buildout] parts = adaguc anaconda-home = /home/myself/anaconda [adaguc] recipe = birdhousebuilder.recipe.adagucserver port = 9002
After installing with Buildout start the Adagucserver WMS service with:
$ cd /home/myself/.conda/envs/birdhouse $ etc/init.d/supervisord start # start|stop|restart $ etc/init.d/nginx start # start|stop|restart $ bin/supervisorctl status # check that adagucserver is running $ less var/log/adaguc.log # check log file
Open your browser with the following URL:
http://localhost:9002?service=WMS&version=1.3.0&request=GetCapabilities
Run a GetCapabilites with an OpenDAP source:
http://localhost:9002/?service=WMS&version=1.3.0&request=GetCapabilities&source=http://www.esrl.noaa.gov/psd/thredds/dodsC/Datasets/ncep.reanalysis2.dailyavgs/surface/mslp.1979.nc