Virtual Environment

The virtual environment installation needs testing and it is still a work in progress and it could just FAIL, so please do not rely on it at the moment. We would be happy to receive your feedback, thanks!

VirtualEnv is a tool to build isolated Python environments. It is useful to have isolated envs without affecting the local Python installation. If you are new to virtual environments please see this guide to get started. We have a fabric script that automatically downloads, compiles and installs all the dependencies needed inside a virtual environment.

Mandatory tools

In order to run the bootstrap script you need to install Git, Fabric and you need a running ssh server on your local machine.

Download source code

First of all, download the latest version of OpenQuake. Take a look at the source code page to know how to get the latest sources.

Using the Fabric Bootstrap

We can now start the bootstrap script. Open a new terminal, and type:

cd /to/your/openquake/dir/
fab -H localhost -f tools/bootstrap_fabfile.py bootstrap

When the script completes (it will take a while), you can start the services as explained in the running OpenQuake page. The only difference is that you have to start Celery and trigger the tests suite inside the virtual environment. To jump into the virtual environment, open a new terminal and type:

workon openquake
cd /to/your/openquake/dir/

And to leave it, just type:

deactivate

Further assistance you can get help through our mailing list or on irc.freenode.net (freenode network) at #openquake.
your installation was successful you can now visit the running OpenQuake page to learn which services you need to start and how to run a smoke test or the tests suite. Enjoy!
Please help us improve the process, if you have any suggestion that could improve this documentation contact us at [email protected]
Back to Installation