Installing a local, development version of GobyWeb

From Icbwiki

Instructions for installing a local, development version of GobyWeb.

Contents 1 Preliminary Notes 2 Set up the Environment 3 Download and Install GobyWeb 4 Run GobyWeb

Preliminary 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.

Set up the Environment

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

2. 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).

3. 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).

Download and Install GobyWeb

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

5. 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`

6. 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

7. More configuration within /home/gobyweb

$ sudo chown -R $USER:<group> /home/gobyweb

$ mkdir /home/gobyweb/webapp

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

$ mkdir /home/gobyweb/GOBYWEB_UPLOADS

$ mkdir /home/gobyweb/GOBYWEB_RESULTS

8. 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

9. Configure GobyWeb files:

• DataSource.groovy: configure the data source settings (environment/*/dataSource entries)
• Config.groovy: set the value of the entry gobyweb.webServerSshPrefix to gobyweb@spanky
• Config.groovy: set the value of the entry gobyweb.default_oge_server to spanky

Run GobyWeb

10. To run locally from a window, run

$ cd ${GOBYWEB}

$ grails run-app

11. Open your web browser and go to

localhost:8080/gobyweb

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