Installation

• Install from Github
• Start thunderbird PyWPS service
• Run thunderbird as Docker container
• Use Ansible to deploy thunderbird on your System

Install from GitHub

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

$ git clone https://github.com/pacificclimate/thunderbird.git
$ cd thunderbird

Install requirements and thunderbird app:

$ poetry install
# OR
$ make install

For development you can use this command:

$ poetry install --with=dev
# OR
$ make develop

After creating the environment, you can enter it with this command:

$ poetry shell

The environment name will be thunderbird-py<python_version>, and you can use an environment with a different Python version with the following command (provided said version is installed on your machine):

$ poetry env use <other_python_version>

Start thunderbird PyWPS service

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

(thunderbird-py<python_version>)$ thunderbird --help # show help
(thunderbird-py<python_version>)$ thunderbird start  # start service with default configuration

# OR

(thunderbird-py<python_version>)$ thunderbird 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 thunderbird as Docker container

You can also run thunderbird as a Docker container.

$ docker-compose build
$ docker-compose up

thunderbird will be available on port 8099.

Use Ansible to deploy thunderbird on your System

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