Quick start

To install

GWCelery requires Python >= 3.6.

The easiest way to install it is with venv and pip:

$ python -m venv --system-site-packages ~/gwcelery
$ source ~/gwcelery/bin/activate
$ pip install gwcelery

• Note: GWCelery requires a fairly new version of setuptools. If you get an error message that looks like this:

  pkg_resources.VersionConflict: (setuptools 0.9.8 (gwcelery/lib/python2.7/site-packages), Requirement.parse('setuptools>=30.3.0'))
  

  then run pip install --upgrade setuptools and try again.

To test

With setup.py:

$ python setup.py test

To start

NOTE that GWCelery requires redis. Your package manager (apt, yum, macports) should be able to install, configure, and automatically launch a suitable redis server, but otherwise you can use the Redis Quick Start instructions to build redis and start a server:

$ wget http://download.redis.io/redis-stable.tar.gz
$ tar xvzf redis-stable.tar.gz
$ cd redis-stable
$ make -j
$ src/redis-server

GWCelery itself consists of four workers:

$ gwcelery worker -l info -n gwcelery-worker -Q celery -B
$ gwcelery worker -l info -n gwcelery-openmp-worker -Q openmp -c 1
$ gwcelery worker -l info -n gwcelery-superevent-worker -Q superevent -c 1
    $ gwcelery worker -l info -n gwcelery-exttrig-worker -Q exttrig -c 1