Skip to content
Justin Miranda edited this page May 6, 2015 · 2 revisions

Dependencies

Ensure that the following dependencies are installed:

  • Java 7
  • Tomcat 7
  • Grails 2.2.5 (for developers only)
  • MySQL 5.x+

It is recommended that you install Grails using GVM (http://gvmtool.net/). However, if you'd prefer to install it manually you can grab a previous release from https://grails.org/download.html.

Project structure

In order to build the Annotation Hub it is necessary to replicate the following structure:

  • catcha
  • annotationframework/AfShared
  • annotationframework/AfSecurity
  • annotationframework/AfPersistence

For reaching this configuration you can run the following commands in your shell:

$ git clone https://github.com/annotationsatharvard/catcha.git
$ git clone https://github.com/annotationframework/AfShared.git
$ git clone https://github.com/annotationframework/AfSecurity.git
$ git clone https://github.com/annotationframework/AfPersistence.git

Generate the WAR file

In order to generate the war file properly you need to position in the root of the main (catcha/Catch) Grails project and to run the following grails instruction:

grails prod war

This will generate the war file in the directory catcha/target

Deploy the application

Copy the war file in the webapps directory of Tomcat or use Tomcat Manager to upload the WAR file to your Tomcat instance.

Configure the application

All the Annotation Hub configurations have been externalized in the file catch-config.properties (case sensitive), which content will look similar to the following:

af.shared.name=CATCH-A
af.shared.title=CATCH-A, Annotations at Harvard

af.shared.logo.title=CATCH
af.shared.logo.subtitle=Annotation Hub

af.shared.copyright.label=Annotations @ Harvard 
af.shared.copyright.link=http://www.annotations.harvard.edu/

af.security.initialize.user=true
af.security.moderation.user.request=true

af.node.organization=Massachusetts General Hospital
af.node.administrator.name=Dr. Paolo Ciccarese
af.node.administrator.email.to=paolo.ciccarese@gmail.com
af.node.administrator.email.display=paolo dot ciccarese at gmail.com

# af.node.base.url=http://purl.org/catcha/1/ 
af.node.base.url=http://localhost:8080/catch/

The catch-config.properties file has to be included in the Tomcat classpath.