Installation¶
This installation works on Linux 64-bit (Ubuntu 14.04, Centos 6, …). It might still work on MacOSX but packages are updated only from time to time. Most of the dependencies come from Anaconda Python distribution system. Additional conda packages come from the Binstar channel Birdhouse. The installation is done with Buildout.
Phoenix uses WPS processes provided by Malleefowl. As a requiste you should install a local Malleefowl WPS (this will become part of the Phoenix installer). Alternatively you could configure the WPS URL of a running Malleefowl WPS instance in the Phoenix custom.cfg
.
To install Malleefowl follow the instructions given in the Malleefowl documentation. In short:
$ git clone https://github.com/bird-house/malleefowl.git
$ cd malleefowl
$ make clean install
Now start with downloading Phoenix with sources from github:
$ git clone https://github.com/bird-house/pyramid-phoenix.git
$ cd pyramid-phoenix
For install options run make help
and read the documention for the Makefile.
Before installation you need to create a password for the local phoenix
user which is used to login to the Phoenix web application:
$ make passwd
Generate Phoenix password ...
Enter a password with at least 8 characters.
Enter password:
Verify password:
Run 'make install restart' to activate this password.
Optionally take a look at custom.cfg
and make additional changes. When you’re finished, run make clean install
to install Phoenix:
$ make clean install
You always have to rerun make update
after making changes in custom.cfg.
After successful installation you need to start the services. All installed files (config etc …) are below the conda environment birdhouse
which is by default in your home directory ~/.conda/envs/birdhouse
. Now, start the services:
$ make start # starts supervisor services
$ make status # shows status of supervisor services
Phoenix web application is available on http://localhost:8081.
Check the log file for errors:
$ tail -f ~/birdhouse/var/log/supervisor/phoenix.log
$ tail -f ~/birdhouse/var/log/supervisor/celery.log
Run Docker¶
Set the HOSTNAME
environment variable (not localhost
) and run docker-compose
:
HOSTNAME=phoenix HTTP_PORT=8081 HTTPS_PORT=8443 SUPERVISOR_PORT=9001 docker-compose up