Installation
Currently we are supporting:
- Ubuntu 11.04 64bit (very easy installation)
- Ubuntu 10.10 32bit
- Ubuntu 10.04 LTS
- Gentoo Installation instructions
- Running OpenQuake
Note: the above tutorials refers to an installation on your local environment. We also tried an installation on a chrooted environment. Check this guide for a chrooted installation.
If you are running Mac OSX we recommend that you develop with a virtual environment.
We currently are not supporting windows OS, however we can recommend workaround
Dependencies
There are a number of dependencies and services that must be installed to run OpenQuake. This is the list of dependencies needed, along with the version required, if necessary:
| Library name | Version required |
| redis client | >= 2.x |
| redis server | >= 2.x |
| lxml | |
| pyyaml | |
| sphinx | 1.0.5 |
| nose | |
| scipy | |
| numpy | |
| shapely | |
| django | |
| python-gflags | 1.4 |
| paramiko | |
| fabric | |
| gdal | |
| matplotlib | |
| jpype | >= 0.5.4 |
| guppy | |
| geohash | |
| rabbitmq | >= 2.1.1 |
| celery | >= 2.0.3 |
| ant | |
| JDK | 1.6 |
Configuration
First, we need to add a user and a virtualhost for Celery in RabbitMQ. Start RabbitMQ and type:
sudo rabbitmqctl add_user celeryuser celery sudo rabbitmqctl add_vhost celeryvhost sudo rabbitmqctl set_permissions -p celeryvhost celeryuser ".*" ".*" ".*"
In order to have the Java side working correctly, we must set some parameters for JPype. Make sure you have the JAVA_HOME environment variable pointing to the JDK you are using. Then we must set up the maximum amount of heap space we can use in OpenQuake. Remember to set an heap space that is less than the amount of your physical memory.
cd /to/your/openquake/dir/ edit openquake/java.py, line 52: def jvm(max_mem=4000)
We also need to build the Java OpenQuake classes for the hazard stuff.
cd /to/your/openquake/dir/ ant build-openquake-jar
If everything went well, you can visit the running OpenQuake page to learn which services you need to start and how to run a smoke test or the tests suite. Remember that for any problem you can get help through our mailing list or on irc.freenode.net (freenode network) at #openquake.
Back to Documentation