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 2.6.0