Deploy geWorkbench web to production

From Informatics

This is the instruction of deploy process for geWorkbench web application to production server. First, we generate geworkbench.war file on afdev server, then manually deploy it to production.

Pre-Requirements

1. Install maven 3.1.1 version on afdev sever(http://maven.apache.org/download.cgi)

Please follow maven installation instructions to set up related environment variable.

2. Install git for linux on afdev sever(http://git-scm.com/download/linux)

Initial Setting for Deployment Script

1. login to afdev server as "cagrid" user

2. go to home directory of "cagrid", make directories "git_src" and "db_prod_config"

3. copy persistence.xml to "db_prod_config", this file is configurated for production server. It will replace the persistence.xml from check out.

4. go to "git_src" directory, use git to check out the maven project from https://github.com/geworkbench-group/geworkbench-web

5. go to "geworkbench-web" directory, you will find deployToProd.sh

6. run this script to generate geworkbench.war file.

How To Generate War File

Currently, the initial setting is done on afdev server. You just need:

1. login to afdev server as "cagrid" user.

2. go to "~git_src/geworkbench-web" directory.

3. run "deployToProd.sh" script to generate geworkbench.war file.

4. geworkbench.war will be generated under directory "~git_src/geworkbench-web/target".

Deploy War To Production

1. login to web[12] server as geworkbenchwb.

2. cd to ~/tomcat-instnce/webapps

3. rename geworkbench.war as geworkbench.war.bak

4. scp cagrid@afdev.c2b2.columbia.edu://ifs/data/c2b2/af_lab/cagrid/git_src/geworkbench-web/target/geworkbench.war .

Start/Stop Tomcat Server

sudo /sbin/start tomcat/geworkbench.c2b2.columbia.edu

sudo /sbin/stop tomcat/geworkbench.c2b2.columbia.edu