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.

Contents [hide] 1 Pre-Requirements 2 Initial Setting for Deployment Script 3 How To Generate War File 4 Deploy War To Production 5 Start/Stop Tomcat Server 6 Log information

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

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 steps:

   ssh login.c2b2.columbia.edu
   ssh web1.lb or 
   ssh web2.lb
   sudo -u geworkbenchwb -s -H
   

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

When you stop/start geworkbench, your account can not be "geworkbenchwb". You should be yourself to run the following command:

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

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

Log information

There are two place you can see the log information:

1. ~/tomcat-instance/logs

2. /var/log/tomcat/geworkbench.c2b2.columbia.edu.log