Overview
This is a quick guide for the OpenQuake Alpha Testing Service (OATS). OATS provides GEM stakeholders a cloud-based solution to easily access OpenQuake. If you would like to try OpenQuake and learn about it, please apply for an account at here. If your request is approved, and we have supplied you with an account, username and password, you can follow the instructions below:
Getting started
Download and intall the SSH client of your choice, for windows operating systems we suggest Putty. Linux and Mac OSX users can use the Terminal which is included in all versions of Mac OSX (Utlities folder) and in Linux distributions.
The putty setting should look something like this (windows users only):
NOTE when you enter your password in Putty you must type it out, copy and pasted password will not be accepted
Within your SSH client, access your OATS account by typing the following text followed by your password:
ssh YOURACOUNT@IPADDRESS
Example:
ssh wyss@173.75.183.121 173.75.183.121's password:
You can change your password with:
passwd
Output:
Changing password for vivek
(current) UNIX password:
Enter new UNIX password:
Retype new UNIX password:
passwd: password updated successfully
Accessing the server
One can access the server with any FTP client, we would recommend Filezilla, here you can find a guide to using Filezilla. The Filezilla connection configuration could look similar to this:
Once you are connected to the OATS server you can upload input fils by navigating to the remote site such as: ‘/usr/openquake/YOURACCOUNT/YOURWORKINGDIR/’
you can also download completed results the same way by navigating to the remote site such as: ‘/usr/openquake/YOURACCOUNT/YOURWORKINGDIR/computed_output’
In Filezilla this setting can be adjusted like this:
Once you have navigated to your source model directory, in Filezilla you can bookmark this location by selecting the bookmark tab and clicking on ‘Add Bookmark…’
Workflow
Adding source models to your directory
Using the Terminal or Putty, change to your user account directory:
cd /usr/openquake/YOURACCOUNT/
and add your input models with Filezilla by adding sub-directories with meaningful names, or add your input models directly within your terminal e.g.:
cd /usr/openquake/YOURACCOUNT/ mkdir YOURWORKINGDIR cp -a <some-path>/demos_1_9_11/classical_psha_simple YOURWORKINGDIR
View available demo calculations
To view the demo calculations that are provided with an OATS account:
cd /usr/openquake/YOURACCOUT/demos_12_10_11/
then
ls
The output should look like this:
area_source_demo_hazard deterministic_event_based_risk classical_psha_based probabilistic_event_based classical_psha_based_risk probabilistic_event_based_risk complex_fault_demo_hazard simple_fault_demo_harzard deterministic_event_based
Running calculations
note: to run a calculation you MUST be in the /usr/openquake directory
Assuming you have a valid input model in the `/usr/openquake/YOURACCOUT/WORKINGDIR/` directory you may start a calculation by running a command like:
cd /usr/openquake openquake --config_file=YOURACCOUNT/demos_14_12_11/simple_fault_demo_hazard/config.gem --output_type=xml
You can view and download the calculation results in Filezilla by navigating to /usr/openquake/YOURACCOUNT/YOURWORKINGDIR/computed_output, or view them directly in the terminal:
cd /usr/openquake/YOURACCOUNT/demos_1_9_11/classical_psha_based/computed_output
then
ls
In case of errors and/or a hung-up calculation please take a look at the log file:
less /var/log/celeryd.log
Tip: look for errors at the end of the log file (e.g. by typing the letter G while viewing the log file using the less utility).
FAQ
error:
redis.exceptions.ConnectionError: Error 111 connecting localhost:6379. Connection refused.
This indicated that the redis key value store (a dependency of the OpenQuake system architecture) is not running. Please contact the OATS system administrator via the OATS malling list.
Aborted
This is a funny little bug, if you get this output, chances are that your computation has run correctly. To verify check the computed_results directory of the calculation you ran.
Getting help
Help is available either through our mailing list.
When asking for help please let us know what version of OpenQuake you are running. The version information can be obtained as follows:
openquake --version
The output should be similar to
OpenQuake version 0.3.9, released 2011-06-06T10:54:54
In case you ask for help on the mailing list please attach the (zipped) /tmp/celeryd.log file to the email.