Vminstall

Installation using a virtual machine

By far the easiest way to install afterParty locally is by download the virtual machine image. The afterParty VM image contains all the dependencies required to run afterParty including BLAST, MIRA and InterProScan.

The image is provided in Open Virtualization Application (OVA) Format in order to ensure compatibility with a majority of virtualization platforms.

Creating the Virtual Machine

Download the OVA file:

http://nematodes.org/bioinformatics/afterparty/afterparty_export.ova

Warning: this is a very large (23GB) file so it will take a while.

Follow the instructions for your virtualization platform to import the OVA.

For VirtualBox, take a look here:

http://www.virtualbox.org/manual/ch01.html#ovf

For VMWare, take a look here:

http://pubs.vmware.com/vsphere-4-esx-vcenter/index.jsp?topic=/com.vmware.vsphere.vmadmin.doc_41/vsp_vm_guide/working_with_ovf_templates/t_import_a_virtual_appliance.html

During import, you will be able to set hardware parameters for the virtual machine - be sure to set them to appropriate value for your host machine - i.e. don't try to assign more RAM or more processors than you have available. afterParty is somewhat memory-hungry, so if possible keep the amount of memory above 2GB.

Set up the virtual machine

Boot up the virtual machine and log in using the following credentials:

username:afterparty

password:afterparty

Hit Control + T to bring up a terminal, then navigate to the afterparty directory and start it up:

cd afterparty/AfterParty2
grails run-app

start a web browser on the VM and browse to

localhost:8080

You should see the front page of the AfterParty instance. You are done!

Further steps

Change passwords : the default username / password combination is very insecure - if the machine is going to be visible on a network then it is strongly recommended that you change it. The postgresql database username and password is the same. If you change the database password, be sure to make the corresponding change in ~/afterparty.config.groovy

Update afterParty : the default branch of afterParty is under git version control. To update your VM, run

git pull

from the afterparty/AfterParty2 directory

Set up google analytics

If you have a Google Analytics account, set the UID in /home/afterparty/afterparty.config.groovy