The OME Administration Tool

ome is the tool included in the distribution package for administering and otherwise controlling your OME installation from the command-line. These pages document ome's features.

Unfortunately, none of the available tools are accessible via the web-ui or other GUI. We haven't had time (or resources) to build graphical admin interfaces. We're ever hopeful that someone will build such things for all to benefit.

During the installation process, you can have ome automatically copied to the directory of your choice (by default /usr/local/bin). ome is always additionally installed into the OME binary directory (by default /OME/bin).

OME needs to run periodic tasks to maintain optimal performance. The installer can optionally schedule these tasks as cron jobs.

ome's Philosophy

ome was written in the philosophy that a super-tool (such as CVS) is superior to a directory of small independent tools (such as Postgres's tools) that each do something different. ome encapsulates all the possible functions from administering users to importing images, to backing up data.

ome hierarchically groups its commands, much like GUI menus, based on their logical similarities. This makes it very easy to find the appropriate functionality without exhaustively reading a flat list of tools and their parameters. However, users must get used to typing commands that are space delimited list of grouping and action words. For example, to add a user you would use the command "users add":

ome admin users add

One of ome's powerful features is its self-documenting help. Try:

ome help

OME commander, version 2.7.0

Usage:
    ome  <command> [<options>]

ome commands are:
    admin            Commands for administering OME users and settings
    annotate         Commands for mass annotation of OME objects
    data             Commands for managing OME data
    execute          Command for executing OME analysis chains
    chex_stats       Command for getting information about a Chain Execution
    import           Command for importing files to OME
    top              Command for displaying progress info about OME tasks
    help <command>   Display help information about a specific command

Global options are:
    --OMEUser, --ou       Specify the OME username (i.e. --ou igg)
    --OMEPassword, --opw  Specify the OME password (i.e. --opw abc123)
    --OMESessionKey, --ok Specify the OME SessionKey (i.e. --ok ABC123HKL456)
    
Note that most of these commands will require you to log in as an
already-existing OME administrative user.

The self-documenting help has been used to create the OME Commander Online Documentation.