Installing a local, development version of GobyWeb

From Icbwiki

Revision as of 16:55, 24 July 2012 Kdorff (Talk | contribs) ← Previous diff		Revision as of 16:55, 24 July 2012 Kdorff (Talk | contribs) Next diff →
Line 7:		Line 7:
	2. Checkout gobyweb from SVN and/or make sure it's up to date		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 dir	+	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).
	<code>		<code>
-	: cd ''your gobyweb checkout dir''	+	: cd '''your gobyweb checkout dir'''
	: export GOBYWEB=`pwd`		: export GOBYWEB=`pwd`
	</code>		</code>

---

Revision as of 16:55, 24 July 2012

Instructions for installing a local, development version of GobyWeb.

This document assumes you are installing GobyWeb either on a Mac or in Windows using Cygwin. It is assumed your shell is Bash.

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.