Installing a local, development version of GobyWeb

From Icbwiki

Instructions for installing a local, development version of GobyWeb.

Notes:

• This document assumes you are installing GobyWeb either on a Mac or in Windows using Cygwin.
• It is assumed your shell is Bash.
• Some commands start with "sudo", if you are running in Windows using Cygwin, the "sudo" portion of the command should not be necessary.

Instructions:

1. Make sure there is password-less SSH access between gobyweb@spanky and the local user's account.

2. Checkout gobyweb from SVN and/or make sure it's up to date

3. Make an temporary environment variable GOBYWEB that points to your gobyweb checkout directory (this will just make it easier to reference this directory later in this guide).

$ cd your gobyweb checkout dir

$ export GOBYWEB=`pwd`

4. Create the /home/gobyweb/ directory and sub-directories

On a Mac, see http://install-climber.blogspot.com/2011/10/machomedirresourcebusyinputoutputerror.html

Comment the mounting of /home by editing...

$ sudo vi /etc/auto_master

Unmount /home and recreate it.

$ sudo umount /home

$ sudo rmdir /home

$ sudo mkdir -p /home/gobyweb

On Windows, etc.

$ mkdir -p /home/gobyweb

5. More configuration withing /home/gobyweb

$ sudo chown USERNAME /home/gobyweb

$ sudo mkdir /home/gobyweb/webapp

$ ln -s $GOBYWEB/server-conf /home/gobyweb/webapp/conf

$ mkdir /home/gobyweb/GOBYWEB_UPLOADS;

$ mkdir /home/gobyweb/GOBYWEB_RESULTS

6. Obtain working copies of Config.groovy and DataSource.groovy, or configure from the -SAMPLE versions

$ cd /home/gobyweb/webapp/conf

$ cp Config.groovy-SAMPLE Config.groovy

$ cp DataSource.groovy-SAMPLE DataSource.groovy

7. Install Groovy 1.8.x somewhere, make sure the environment variable GROOVY_HOME is set and ${GROOVY_HOME}/bin is in your PATH (edit your ~/.bash_profile).

8. Install Grails 1.3.7 somewhere, make sure the environment variable GRAILS_HOME is set and ${GRAILS_HOME}/bin is in your PATH (edit your ~/.bash_profile).

9. To run locally from a window, run

$ cd your gobyweb checkout dir

$ grails run-app

10. Open your web browser and go to

localhost:8080/gobyweb

11. Upload a sample, see that it works correctly. Avoid doing testing, such as this, with large samples.