A description of how to create the Alpha Testing Services

This is a guide to create an OpenQuake Alpha Testing Services typically on the cloud.

==Overview==

Openquake is still in a development stage, meaning at this time we are only able to provide a terminal interface for the tool, in addition we are not able to provide support for multiple operating systems, only Ubuntu 11.04.

Because of this, we do not expect everyone to switch operating systems or run a virtual environment that will have limited capabilities in order to use OpenQuake.
Instead we strongly recommend that users try OpenQuake with our Alpha Testing Service. This Server is a place where users can test drive OpenQuake without the hassel of meeting the installation requirements. All that is need to get started is a SSH client.

==Create an OpenQauke Alpha Testing Service==

1. create a cloud sever somewhere with the curent supported OS, in this case Ubuntu 11.04, we created a VPS with Linode, with 1 GB RAM, and 40 GB's disk space.

2. install the standard OQ package (https://github.com/gem/openquake/wiki/Ubuntu-11.04)

We now need to customize some things in order to allow multiple users the ability to use the OQ installation.

3. create /usr/local/etc/README that directs users to some documentation 'For instructions on running OpenQuake navigate to 'Using the engine' at: https://github.com/gem/openquake/wiki/Using-OpenQuake-with-Cloud-Computing'

4. edit /etc/profile to include:
export JAVA_HOME=/usr/lib/jvm/java-6-openjdk/jre
export OQ_JVM_MAXMEM=1000
cat /usr/local/etc/README
cd /usr/openquake

5. add celeryd startup script to /etc/init.d/celeryd

6. add celeryd-default config script to /etc/default/celeryd

NOTE: you can get the scripts from this https://bugs.launchpad.net/openquake/+bug/819230 bug

7. run update-rc.d celeryd defaults to create startup links for that VPS

8. create a celeryd user with adduser and give it a password

9. create a /etc/logrotate.d/celeryd file that contains that enables log rotation on :

/var/log/celeryd.log {
        weekly
        missingok
        copytruncate
        rotate 20
        compress
        notifempty
}

==Create a new user workflow==

* adduser NewUser

* cp -r /usr/openquake/openquake1-smoketests /usr/openquake/NewUser-smoketests

* chown NewUser: /usr/openquake/NewUser-smoketests -R

* chmod 750 /home/NewUser

* chmod 750 /usr/openquake/NewUser-smoketests/

* then set the limit max logins:

you have to edit /etc/security/limits.conf and go to the bottom

and add: @NewUser (which basically points to that specific user) with the following settings:

hard limit maxlogins 2

for example:

@NewUser hard maxlogins 2

* set the max disk space for each user:

edquota NewUser

with the following settings (4000000 = +-4 GBs:
hard limit: 4000000
soft limit: 4000000