Deploying an ORCA Actor Container in Emulation

Orca actors run within servlet containers (JVMs). This document is intended to assist you in getting a container up and running quickly, with instances of each of the three actors (Service Manager, Broker, and Aggregate Manager) operating in emulation mode.

Emulation Mode Setup

0. Create user/group orca.

$ sudo useradd orca
$ sudo groupadd orca

1. Create a directory /opt/orca, which we will refer to as $ORCA_HOME.

$ export ORCA_HOME=/opt/orca
$ sudo mkdir -p $ORCA_HOME

2. Ensure the orca user owns $ORCA_HOME, and become the orca user.

$ sudo chown orca:orca $ORCA_HOME
$ sudo su - orca

3. Download the attached sample emulation configuration and extract it into $ORCA_HOME.

$ tar -xf orca-home-emulation.tar 

4a. IF using Camano 3.0 or prior: Download our slightly-modified Tomcat and extract it into $ORCA_HOME.

$ tar -zxf tomcat-5.5.tar.gz

4b. ELSE: Download stock Tomcat 7 and untar/unzip under $ORCA_HOME. Follow these instructions. Emulation mode includes the SM with XMLRPC controller, so be sure to enable SSL as stated in the instructions.

5. Ensure MySQL is running on your system.

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

6. Follow the instructions in the "Create the database" section of the database setup page.

7. Ensure that you have an appropriate JVM installed, and the JAVA_HOME environment variable set, as described on the software prerequisites page.

8. Download the binary distribution of the ORCA webapp by following the directions on this page. As the instructions say, you will want to rename the file you download orca.war

9. Copy the file named orca.war into the $ORCA_HOME/tomcat/webapps directory (which should exist, if you have followed all steps up to this point correctly).

10. Start the container by executing the following command:

$ $ORCA_HOME/tomcat/

11. Log in to your container's portal.

Testing Emulation Mode

Videos attached to this page show how the system works once it is installed (no audio). A simple test with the default actor configuration described above is to

  1. Login to the ORCA portal
  2. Go to the Admin tab and click 'View Actors'. Verify that 3 actors are Online.
  3. Go to the User tab (Slice Manager). Click on 'Create Reservation'. Select 'Eucalyptus Virtual Machine' from the drop-down menu corresponding to 'Resource Pool'. Change the number of Units from 1 to something else (for anything greater than 10 you will receive only 10 units as that is the size of the initial delegation)
  4. Click the 'Create' button.
  5. Click 'View All Reservations'. Refresh your browser until the reservation goes into 'Active' state.
  6. You can optionally close the reservation by selecting a check-box next to it and selecting 'Close' from the Action menu.

Testing the sample XMLRPC Controller in Emulation Mode

See the section on XMLRPC controller for information.

Testing Recovery Features

See the section on ORCA Recovery features for information.