The Rhino SLEE command console (rhino-console) is a command-line shell which supports both interactive and batch-file commands to manage and configure the Rhino SLEE.

Tip See also the instructions to configure, log into, select a management command from, and configure failover for the command console.

Below are details on the usage of the command-line console, the available commands, the Java archives required to run the command line console, and the security configuration.

rhino-console usage

The command console takes the following arguments:

Usage:

   rhino-console <options> <command> <parameters>

Valid options:

   -? or --help   - Display this message
   -h <host>      - Rhino host
   -p <port>      - Rhino port
   -u <username>  - Username
   -w <password>  - Password, or "-" to prompt

   -D             - Display connection debugging messages
   -r <timeout>   - Initial reconnection retry period (in seconds). May be 0
                    to indicate that the client should reconnect forever.
   -n <namespace> - Set the initial active namespace
If no command is specified, client will start in interactive mode.
The help command can be run without connecting to Rhino.

If you don’t specify a command argument, the client starts in interactive mode. If you do give rhino-console a command argument, it runs in non-interactive mode. (./rhino-console install is the equivalent of entering install in the interactive command shell.)

In interactive mode, the client reports alarms when they occur and includes the SLEE state and alarm count in the prompt. It only reports the SLEE state if SLEE of any event routing node is not RUNNING. This new behaviour can be disabled by setting the system property "rhino.console.disable-listeners" to true in $CLIENT_HOME/etc/rhino-client-common.

Tip
  • The command console features command-line completion: if you press the tab key, the console guesses the rest of a partially input command or command argument. It also records the history of the commands entered in interactive mode. The up and down arrow keys cycle through the history, and the history command prints a list of recent commands.

  • You can specify the help command argument without a connection to a Rhino node.

Command categories

Below are the available categories of rhino-console commands. Enter help <category name | command name substring> for a list of available commands in each category.

Category Description
 auditing

Manage Rhino’s auditing subsystem

 bindings

Manage component bindings

 config

Import, export, and manage Rhino configuration

 deployment

Deploy, undeploy, and view SLEE deployable units

 general

Rhino console help and features

 housekeeping

Housekeeping and maintenance functions

 license

Install, remove, and view Rhino licenses

 limiting

Manage Rhino’s limiting subsystem

 logging

Configure Rhino’s internal logging subsystem

 persistence

Configure Rhino’s external database persistence subsystem

 profile

Manage profiles and profile tables

 resources

Manage resource adaptors

 security

Manage Rhino security

 services

Manage services running in the SLEE

 sleestate

Query and manage Rhino SLEE state

 snmp

Manage Rhino SNMP agent configuration

 thresholdrules

Manage threshold alarm rules

 trace

View and set SLEE trace levels using the trace MBean

 usage

View SLEE service usage statistics

 usertransaction

Manage client-demarcated transaction boundaries

Java archives

The classes required to run the command console are packaged as a set of Java libraries. They include:

File/directory Description
 rhino-console.jar

Command-line client implementation

 rhino-remote.jar

Rhino remote API for Rhino

 rhino-logging.jar

Rhino logging system

 slee.jar

JAIN SLEE 1.1 API

 $RHINO_HOME/client/lib

Third-part libraries such as jline, log4j and other dependencies

Security

The command-line console relies on the JMX Remote Adaptor for security.

Note

For a detailed description of JMX security and MBean permission format, see Chapter 12 of the JMX 1.2 specification.

See also Security.

Previous page Next page
Rhino Version 3.2