Deploying ORCA as a binary webapp and from source

The ORCA webapp can be deployed into Tomcat in a variety of ways.

Deploying the binary webapp downloaded from geni-orca.renci.org

After you have filled in the configuration files in $ORCA_HOME, and downloaded and installed Tomcat 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
$ ./start.sh

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

Deploying webapp built from source

  • Start tomcat.
  • Assuming you've downloaded the ORCA source and built it, setup the MySQL database and configured ORCA
  • 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/build.properties .
  • In $ORCA_SRC/webapp/ant/build.properties modify the username and password of the user authorized to deploy webapps into this container (it is set in tomcat/conf/tomcat-users.xml)
  • 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
    

NOTE: if you are using Tomcat 7 (starting with Camano 3.1) instead of 'ant deploy', use the command 'ant deploy.t7'.