ORCA for Experimenters

Overview

ORCA allows users to create global topologies of nodes connected via Layer 2 QoS-provisioned links. ORCA offers opportunities for experimentation (on substrate belonging to Cluster D and ExoGENI) and also for developing new resource control and management policies via ORCA plugins.

The ORCA default SM (Service Manager) actor installation comes with an XMLRPC controller plugin that exports the GENI AM API and ORCA native API, which can be exercised by command-line tools and GUI-driven tools (see below).

To use ORCA resources you must acquire GENI credentials from the GENI Project office. You can then identify the controller you wish to use to submit your requests from ORCA Actor Registry and contact the administrator to be sure your credentials are accepted.

Resource/Experiment Descriptions

ORCA supports a native semantic resource description mechanism called NDL-OWL. It also supports a subset of GENI RSpec v3.

Tools and APIs

ORCA supports its native as well as GENI AM API via the XMLRPC Controller plugin that comes with a standard Service Manager Actor. For resource descriptions, ORCA supports its native NDL-OWL semantic descriptions via its native interface API as well as ProtoGENI RSpec v3 via GENI AM API. Note that with some caveats, conversion between formats is supported internally in ORCA and as a stand-alone web-service.

Here is a list of user tools interoperable with ORCA:

  • Flukes. A GUI application that uses native ORCA NDL-OWL resource descriptions and native ORCA APIs
  • GUSH. Uses RSpec v3 and GENI AM API. Here is a page on how to use GUSH tool with ORCA substrates.
  • GPO Omni. Uses RSpec v3and GENI AM API.

From within the VM (only VM - this functionality is not currently available on bare-metal nodes) the experimenter can inspect the metadata of the VM assigned by the cloud controller. This is done using NEucaPy tools that should be installed on the image.

Orca compute instances (VM or baremetal) can have powerful post-boot scripts which can be templated to ease the configuration of the slice.

OS Images

When standing up a Virtual Machine via Orca an experimenter can supply their own kernel/ramdisk/filesystem. This document explains how it can be done. There is also a list of available virtual machine images. See the Flukes help page as well as NDL-to-RSpec conversion page for details on specifying images you want booted within the slice.

Error handling

Consult this document for common error scenarios and ways of dealing with them.

Help