Version 46 (modified by chase, 9 years ago)



Software prerequisites

Build ORCA from source

Deploying GENI-ORCA

Install Tomcat and create the initial database

These instructions help set up a local Tomcat container with an example inventory of substrate that allows ORCA to run in emulation mode. This step is highly recommended before running with real resources to make sure your setup is correct.

1. Download the Tomcat tar file. ORCA uses a customized Tomcat, so using standard Tomcat is not recommended

2. Create a directory named 'shirako' somewhere

3. Untar the contents of the tomcat tar file into 'shirako' directory

4. Edit shirako/tomcat/ and to set CATALINA_HOME to point to the shirako/tomcat directory, And set ORCA_HOME to your $ORCA_HOME

5. Edit shirako/tomcat/conf/server.xml and shirako/tomcat/server/classes/webauth.xml to change references to '/shirako' to the new location of the 'shirako' directory you created. 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.

6. Execute shirako/tomcat/

7. Make sure MySQL is running on your system.

NOTE 2: For Mac OS X you can use fink to install mysqld and then

$ cd /sw/bin
$ sudo ./mysqld_safe

This will make sure mysqld is running as long as you don't exit this shell

8. Create a mysql database and populate it

9. Give ANT more heap space. This can be added to ~/.profile

$ export ANT_OPTS="-XX:MaxPermSize=512m -Xms40m -Xmx1024m"

Generating the GENI-ORCA web application

1. Create the webapp with this command:

$ mvn package

in orca/webapp.

2. Deploy into an already running tomcat instance on the local machine by typing

$ cd <orca>/webapp
$ ant deploy

3. Wait until the actors start ticking before you log into the portal. Check in the log file (tomcat/logs/log) or just wait 30-45 seconds. Tomcat has an annoying race condition during webapp initialization. If you try to log in too early, ORCA will fail to start up correctly.

4. Log into the portal at http://localhost:8080/orca with username "admin" and no password, unless you changed the defaults.

NOTE: as of Bella 2.0 container administrator credentials are located in