Installation

Install from Conda

Warning

TODO: Prepare Conda package.

Install from GitHub

Check out code from the Hummingbird GitHub repo and start the installation:

$ git clone https://github.com/bird-house/hummingbird.git
$ cd hummingbird
$ conda env create -f environment.yml
$ source activate hummingbird
$ python setup.py develop

… or do it the lazy way

The previous installation instructions assume you have Anaconda installed. We provide also a Makefile to run this installation without additional steps:

$ git clone https://github.com/bird-house/hummingbird.git
$ cd hummingbird
$ make clean    # cleans up a previous Conda environment
$ make install  # installs Conda if necessary and runs the above installation steps

Start Hummingbird PyWPS service

After successful installation you can start the service using the hummingbird command-line.

$ hummingbird --help # show help
$ hummingbird start  # start service with default configuration

OR

$ hummingbird start --daemon # start service as daemon
loading configuration
forked process id: 42

The deployed WPS service is by default available on:

http://localhost:5000/wps?service=WPS&version=1.0.0&request=GetCapabilities.

Note

Remember the process ID (PID) so you can stop the service with kill PID.

You can find which process uses a given port using the following command (here for port 5000):

$ netstat -nlp | grep :5000

Check the log files for errors:

$ tail -f  pywps.log

… or do it the lazy way

You can also use the Makefile to start and stop the service:

$ make start
$ make status
$ tail -f pywps.log
$ make stop

Run Hummingbird as Docker container

You can also run Hummingbird as a Docker container.

Warning

TODO: Describe Docker container support.

Use Ansible to deploy Hummingbird on your System

Use the Ansible playbook for PyWPS to deploy Hummingbird on your system.