Version 10 (modified by vjo, 6 years ago)


Pequod command shell

In ORCA 3.x and prior, the web portal was the only way to manage ORCA actors. Starting with ORCA 4.x the portal has been deprecated in favor of open management API. Pequod is a command-line shell-like application that speaks to this API and allows operators to monitor and manage the state of ORCA actors. Note that Pequod does not speak to ORCA XMLRPC controllers, as these are not ORCA actors, rather remote policies that speak to the SM actor using the same management API.

Getting Pequod

Pequod is offered as RPMs as well as downloadable ZIP files. It requires no special privileges and can be run on any system with Java 1.6.x+ installed.

Configuring Pequod

Start pequod and it will print out the template of the configuration file that must be created in $HOME/.pequod/properties:

# User editable settings

# comma-separated list of urls of containers you wish to control

# User name and password on those containers

Note that each container can be specified as either a plain URL or a URL with username and password credentials e.g.:


Running Pequod

Starting pequod is done by

$ cd /wherever/you/unzipped/pequod
$ sh bin/pequod

You will see

Pequod Orca Shell (c) 2012 RENCI/UNC Chapel Hill 
Pequod supports history and command auto-completion.
Available commands:
  help: Returns help for individual commands
  file: File-related commands
  set: Modify internal set variables
  show: Show the state of things
  manage: Manage actor state
  history: show command history (!<command index> invokes the command)
  exit: Exit from the shell (Ctrl-D or Ctrl-C also works)
Type the entire command, or enter the first word of the command to enter subcommand with intelligent auto-completion (Using TAB).

At this point you can type in commands or enter into one of subcommands listed above, which will support auto-completion of some of the more common options.

Brief list of Pequod capabilities:

  • Extensive inspection capability (show command)
  • Shell auto-completion and history (including !<number> command recall)
  • Ability to execute script files (file command)
  • Ability to manipulate resource delevations (manage command)
  • Internal registers (single and multi-value lists) (set command)
    • You can set current actor, slice or reservation and use the word 'current' in many of other show and manage commands which require the corresponding actor, slice or reservation parameter
  • Extensive help (help command)
    • Use 'help <subcommand>' to learn more about each