Version 11 (modified by ibaldin, 8 years ago)


Setting up Tomcat


Please note that you cannot use an off-the shelf version of Tomcat 5.5 or another webapp engine like Jetty. You must use the version provided on this website.

Installation and Configuration

We provide a customized version of Tomcat 5.5 with ORCA-specific start/stop scripts which should be customized to the specific site. Download and install our version of Tomcat 5.5: under $ORCA_HOME:

$ wget
$ tar zxvf tomcat.tar.gz
$ cd $ORCA_HOME/tomcat

Edit $ORCA_HOME/tomcat/ and $ORCA_HOME/tomcat/ to point to correct paths for ORCA_HOME and CATALINA_HOME. Example


# customize this to your setup
export ORCA_HOME=/opt/orca

# if you are using non-standard java, uncomment and change this
# export JAVA_HOME=/opt/java/jdk-1.6.20
export LD_LIBRARY_PATH=/usr/local/lib

# assuming tomcat is under $ORCA_HOME

# if you want to enable debugging, uncomment this line and comment out the following one. Default debug port is 11000
#declare -x CATALINA_OPTS="-ea -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=11000 -Xmx1024m"
declare -x CATALINA_OPTS="-Xmx1024m"

export ANT_HOME=
$CATALINA_HOME/bin/ start

Example of


# customize this to your install
export ORCA_HOME=/opt/orca

# uncomment and customize this if you are using non-standard Java install
#export JAVA_HOME=/opt/java/jdk1.6.0_23

# assuming tomcat lives under $ORCA_HOME


Only if using your institution's SSO (not widely tested): edit tomcat/conf/server.xml and tomcat/server/classes/webauth.xml to change references to '/shirako' to the new location of the directory you created (e.g., /opt/orca). Only do this step if you are using webauth authentication. If you are not sure, then you are not. Webauth authentication requires significant setup from your identity provider.

Deploying binary webapp downloaded from

After you filled in the configuration files in $ORCA_HOME, you can deploy the ORCA webapp.

Copy the downloaded orca.war file into Tomcat's webapps directory, then start Tomcat:

$ cp orca.war $ORCA_HOME/tomcat/webapps/
$ cd $ORCA_HOME/tomcat
$ ./

Watch the log file $ORCA_HOME/tomcat/logs/orca.log

Deploying weabapp built from source

  • Start tomcat.
  • Assuming you've downloaded ORCA source and built it
  • On the development host modify the property which points to which container ORCA should be deployed to. Modify the target.server property in $ORCA_SRC/webapp/ant/ .
  • Package and deploy the war file (the last step will deploy ORCA into the previously started Tomcat):
    dev-host$ cd $ORCA_SRC/webapp
    dev-host$ mvn clean package
    dev-host$ ant deploy

Enabling SSL in Tomcat

For some deployments (particularly SM), it may be necessary to enable SSL support in Tomcat. This step is optional and is explicitly called for when needed in other documents.

  • You must uncomment part of Tomcat server configuration file to enable SSL support. Open $ORCA_HOME/tomcat/conf/server.xml in an editor and locate the Connector definition for port 11443 and uncomment it.
  • You must also create a $ORCA_SRC/tomcat/ssl/tomcat.jks keystore with a password (default password is in the definition of the Connector above).
    $ keytool -genkey -alias tomcat -keyalg RSA -keystore $ORCA_HOME/tomcat/ssl/tomcat.jks
  • Restart Tomcat and verify that it works on port 11443 by hitting https://hostname:11443/orca with your browser (you will get a security exception because the certificate is self-signed).

More on this is available here.