Installing a local, development version of GobyWeb
From Icbwiki
| Revision as of 16:56, 24 July 2012 Kdorff (Talk | contribs) ← Previous diff |
Revision as of 16:58, 24 July 2012 Kdorff (Talk | contribs) Next diff → |
||
| Line 1: | Line 1: | ||
| '''Instructions for installing a local, development version of GobyWeb.''' | '''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. | + | 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. |
| 1. Make sure there is password-less SSH access between gobyweb@spanky and the local user's account. | 1. Make sure there is password-less SSH access between gobyweb@spanky and the local user's account. | ||
| Line 10: | Line 10: | ||
| <code> | <code> | ||
| - | : cd ''your gobyweb checkout dir'' | + | : $ cd ''your gobyweb checkout dir'' |
| - | : export GOBYWEB=`pwd` | + | : $ export GOBYWEB=`pwd` |
| </code> | </code> | ||
| Line 19: | Line 19: | ||
| :: Comment the mounting of /home by editing... | :: Comment the mounting of /home by editing... | ||
| <code> | <code> | ||
| - | ::: sudo vi /etc/auto_master | + | ::: $ sudo vi /etc/auto_master |
| </code> | </code> | ||
| :: Unmount /home and recreate it. | :: Unmount /home and recreate it. | ||
| <code> | <code> | ||
| - | ::: sudo umount /home | + | ::: $ sudo umount /home |
| - | ::: sudo rmdir /home | + | ::: $ sudo rmdir /home |
| - | ::: sudo mkdir -p /home/gobyweb | + | ::: $ sudo mkdir -p /home/gobyweb |
| </code> | </code> | ||
| :; On Windows, etc. | :; On Windows, etc. | ||
| <code> | <code> | ||
| - | :: mkdir -p /home/gobyweb | + | :: $ mkdir -p /home/gobyweb |
| </code> | </code> | ||
| Line 36: | Line 36: | ||
| <code> | <code> | ||
| - | :sudo chown USERNAME /home/gobyweb | + | : $ sudo chown USERNAME /home/gobyweb |
| - | :sudo mkdir /home/gobyweb/webapp | + | : $ sudo mkdir /home/gobyweb/webapp |
| - | :ln -s $GOBYWEB/server-conf /home/gobyweb/webapp/conf | + | : $ ln -s $GOBYWEB/server-conf /home/gobyweb/webapp/conf |
| - | :mkdir /home/gobyweb/GOBYWEB_UPLOADS; | + | : $ mkdir /home/gobyweb/GOBYWEB_UPLOADS; |
| - | :mkdir /home/gobyweb/GOBYWEB_RESULTS | + | : $ mkdir /home/gobyweb/GOBYWEB_RESULTS |
| </code> | </code> | ||
| Line 46: | Line 46: | ||
| <code> | <code> | ||
| - | :cd /home/gobyweb/webapp/conf | + | : $ cd /home/gobyweb/webapp/conf |
| - | :cp Config.groovy-SAMPLE Config.groovy | + | : $ cp Config.groovy-SAMPLE Config.groovy |
| - | :cp DataSource.groovy-SAMPLE DataSource.groovy | + | : $ cp DataSource.groovy-SAMPLE DataSource.groovy |
| </code> | </code> | ||
| Line 58: | Line 58: | ||
| <code> | <code> | ||
| - | : cd ''your gobyweb checkout dir'' | + | : $ cd ''your gobyweb checkout dir'' |
| - | :grails run-app | + | : $ grails run-app |
| </code> | </code> | ||
Revision as of 16:58, 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. Some commands start with "sudo", if you are running in Windows using Cygwin, the "sudo" portion of the command should not be necessary.
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.
