Requirements


  • A local installation of Tomcat 7.x
  • Authorized access to CampagneLab’s SVN repository

Prepare the environment


Base Folder

Create a base folder (we refer it as BASE_FOLDER in this guide)

Plugins

Download plugins and auxiliary files from SVN:

cd BASE_FOLDER
svn co https://pbtech-vc.med.cornell.edu/public/svn/campagnelab/gobyweb/trunk/gobyweb_home/

Tomcat

Set the local Tomcat installation folder by editing the following line in BASE_FOLDER/gobyweb_home/gobyweb-cmd.sh

CATALINA_HOME=

Change the following TCP ports for the Tomcat instance according to the desired values by editing BASE_FOLDER/gobyweb_home/conf/server.xml

<Server port=”8204″ shutdown=”SHUTDOWN”>
  …
    <Connector port=”8104″ protocol=”HTTP/1.1″
       connectionTimeout=”20000″ redirectPort=”8443″ />
    <Connector port=”8004″ protocol=”AJP/1.3″ redirectPort=”8443″ />
  …
</Server>

Execution Environment

Set the GobyWeb execution environment by editing the following line in BASE_FOLDER/gobyweb_home/gobyweb-cmd.sh

CATALINA_OPTS="-server -Xmx6g -Djava.awt.headless=true -Dgrails.env=development"

Below we assume to use the development environment.

Data Source

Rename the template file:

cd BASE_FOLDER/gobyweb_home/conf/
mv DataSource.groovy-template DataSource.groovy

Then, configure the data source settings in DataSource.groovy.

Paths

Create paths for the following content:

  • QUEUE_MESSAGES:…
  • FILES:…
  • RESULTS:…
  • UPLOADS:…
  • UPLOAD_STAGING:…

Decide if FILES should have Fanouts.

Configure the Web Application


Rename the webapp configuration file:

cd BASE_FOLDER/gobyweb_home/conf/
mv WebAppConfig.groovy-template WebAppConfig-development.groovy

Then, edit the file and change the values of the following variables according to the paths previously created:

  • gobyweb.queueMessagesDir=QUEUE_MESSAGES
  • gobyweb.webFilesDi=FILES
  • gobyweb.webResultsDir=RESULTS
  • gobyweb.webUploadDir=UPLOADS
  • gobyweb.webTempUploadStageDir=UPLOAD_STAGING

Also, change the grails.serverURL according to the Tomcat instance/Virtual Host configuration.