birdhousebuilder.recipe.pycsw
is a Buildout recipe to install and configure pycsw with Anaconda. pycsw is a Python implementation of a Catalog Service for the Web (CSW). pycsw
will be deployed as a Supervisor service and is available on a Nginx web server.
This recipe is used by the Birdhouse project.
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 pycsw
package from a conda channel in a conda environment named birdhouse
. The location of the birdhouse environment is .conda/envs/birdhouse
. It setups a pycsw database (sqlite
) in ~/.conda/envs/birdhouse/var/lib/pycsw
. It deploys a Supervisor configuration for pycsw
in ~/.conda/envs/birdhouse/etc/supervisor/conf.d/pycsw.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 deploy a Nginx site configuration for pycsw
. The configuration will be deployed in ~/.conda/envs/birdhouse/etc/nginx/conf.d/pycsw.conf
. Nginx can be started with ~/.conda/envs/birdhouse/etc/init.d/nginx start
.
By default pycsw
will be available on http://localhost:8082/csw?service=CSW&version=2.0.2&request=GetCapabilities.
The recipe depends on birdhousebuilder.recipe.conda
, birdhousebuilder.recipe.supervisor
and birdhousebuilder.recipe.nginx
.
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
hostname
The hostname of the pycsw service (nginx). Default:
localhost
port
The port of the pycsw service (nginx). Default:
8082
The following example buildout.cfg
installs pycsw
with Anaconda:
[buildout]
parts = pycsw
anaconda-home = /opt/anaconda
[pycsw]
recipe = birdhousebuilder.recipe.pycsw
hostname = localhost
port = 8082
After installing with Buildout start the pycsw
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 pycsw is running
$ less var/log/pycsw/pycsw.log # check log file
Open your browser with the following URL:
http://localhost:8082/csw?service=CSW&version=2.0.2&request=GetCapabilities