Camano 3.1

Release Notes

Overview

Camano 3.1 is primarily a bug-fix release with a few new features. It marks the beginning of ORCA operations in beta. Capabilities previously demonstrated are now available to external users on the limited set of resources available to ORCA.

  • Documentation has been updated in numerous places
  • Starting with this release we recommend using Tomcat 7 instead of Tomcat 5.5 with ORCA. This fixes a number of transient classpath problems experienced in the past.
  • The compute ontology has been updated and extended
  • Network embedding code has been extended and tested with a regression test suite (see below)
  • GENI Authorization is turned on by default for both the GENI AM API and the native ORCA API.
  • RSpec v2 request conversion has been extended and documented.
  • ORCA now generates proper RSpec v2 manifests for use by omni and Gush.
  • ORCA now has a GUI experimenter tool called Flukes for graphically generating slice requests, submitting the to ORCA and using the resulting slices. Flukes uses ORCA's native interface and its powerful stitching engine to create inter-domain slices.

The following ORCA sites are available at the time of this writing:

  • RENCI ACIS Eucalyptus cluster
  • RENCI BEN Eucalyptus cluster (Availability: intermittent)
  • UNC BEN Eucalyptus cluster
  • Duke CS Eucalyptus cluster
  • University of Houston Eucalyptus cluster

Layer 2-connected slices can be created within each cluster or between resources in different clusters. BEN and NLR and LEARN serve as the interconnect Layer 2 fabric.

Upgrade

  • Use stock Tomcat 7 instead of Tomcat 5.5
  • There are minor changes to configuration files for SM actor and XMLRPC controller within it due to GENI authorization being turned on by default.
  • ORCA native API has changed and the python scripts previously used to exercise it have been updated (including the use of certificates for authorization)
  • Due to the ontology changes, your site rdf file may require an update
  • For Eucalyptus sites, use the new template for your $ORCA_HOME/config/ec2.site.properties file where several new parameters have been added.

The release label for this is 'Camano-3.1' and subversion url is https://geni-orca.renci.org/svn/orca/tags/Camano-3.1 .

Regression testing

Network embedding and inter-domain stitching code in ORCA has become very complex, so starting with 3.1 release we are instituting a regression test suite for this code. Based on this code experimenters can determine whether ORCA is capable of fulfilling their slice request and use regression tests as starting points for their own slice requests. Regression tests use Flukes to generate requests, submit and operate on the slices.

Regression tests are described in this README file. You can find the regression suite requests in $ORCA_SRC/src/test/resources/orca/network/. You can get them from the ORCA Subversion as follows:

$ svn co https://geni-orca.renci.org/svn/orca/trunk/network/src/test/resources/orca/network/ orca-regression-tests

TS1

Test Case Status Notes
TS1-1 OK
TS1-2 OK
TS1-3 OK
TS1-4 OK
TS1-5 OK
TS1-6 OK
TS1-7 OK The manifest view only shows one node per nodegroup even though it has multiple units, as a nodegroup is treated as 1 ORCA reservation w/ multiple units when IP address is not specified in the request. The ORCA container GUI "management" shows all the units separately
TS1-8 OK The manifest view only shows one node per nodegroup even though it has multiple units, as a nodegroup is treated as 1 ORCA reservation w/ multiple units when IP address is not specified in the request. The ORCA container GUI "management" shows all the units separately

TS2

Test Case Status Notes
TS2-1 OK
TS2-2 OK
TS2-3 OK
TS2-4 OK
TS2-5 OK
TS2-6 OK

TS3

Test Case Status Notes
TS3-1 OK
TS3-2 OK Both bound and unbound are all provisioned in the same site
TS3-3 OK Two extra vms appeared in the otherwise correct topology.
TS3-4 OK
TS3-5 OK
TS3-6 OK
TS3-7 OK
TS3-8 OK
TS3-9 OK
TS3-10 OK
TS3-11 OK
TS3-12 OK
TS3-13 Not Covered
TS3-14 Not Covered

TS4

Test Case Status Notes
TS4-1 OK
TS4-2 OK
TS4-3 OK

Others

Other test suites have not been sufficiently formalized yet.

Bug List

  • Bugs
    • SM Race #210
    • Close/Renew problem #211
    • 'Bunch of VMs request' #212
    • orca.network refactoring #213, #216
    • Authorization issue #214
    • Transient classpath problem #215
    • updateTicket throws null pointer exceptions after initial reservation request fails because broker cannot fulfill it (per Prateek)
    • The container with the interdomain controller stopped ticking abruptly. Two requests were issued and closed successfully two days before this happened. When a new request was issued, after the interdomain path was computed, everything halted. orca.log wasn't growing. 'View Reservations' on the portal was showing only one reservation in 'Nascent' state.
  • Resurrect unit tests.

Ticket Reports