Rhino 3.1 :: Rhino Administration and Deployment Guide

To list the services in a particular operational state, use the following rhino-console command or related MBean operation.

Console command: `listservicesbystate`

Command	listservicesbystate <state> [-node node] Description List the services that are in the specified state (on the specified node)
Output	The operational state of a service is node-specific. If the `-node` argument is not provided, this command returns the services in the given operational state on the node that `rhino-console` is connected to for management. (Otherwise, the command returns the services in the given operational state on the specified node.)
Example	To list the services in the ACTIVE state on node 102: $ ./rhino-console listservicesbystate Active -node 102 Services in Active state on node 102: ServiceID[name=SIP Proxy Service,vendor=OpenCloud,version=1.8] ServiceID[name=SIP Registrar Service,vendor=OpenCloud,version=1.8]

Command

listservicesbystate <state> [-node node]
  Description
    List the services that are in the specified state (on the specified node)

Output

The operational state of a service is node-specific. If the -node argument is not provided, this command returns the services in the given operational state on the node that rhino-console is connected to for management. (Otherwise, the command returns the services in the given operational state on the specified node.)

Example

To list the services in the ACTIVE state on node 102:

$ ./rhino-console listservicesbystate Active -node 102
Services in Active state on node 102:
  ServiceID[name=SIP Proxy Service,vendor=OpenCloud,version=1.8]
  ServiceID[name=SIP Registrar Service,vendor=OpenCloud,version=1.8]

MBean operation: `getServices`

MBean	`Service Management`
SLEE-defined	Get services on all nodes public ServiceID[] getServices(ServiceState state) throws NullPointerException, ManagementException; Rhino’s implementation of the SLEE-defined `getServices` operation returns an array identifying all the services in the requested state on the node where you invoke the operation.
Rhino extension	Get services on specific nodes public ServiceID[] getServices(ServiceState state, int nodeID) throws NullPointerException, InvalidArgumentException, ManagementException; Rhino provides an extension that adds an argument that lets you control the nodes on which to list services in a particular state (by specifying node IDs).

MBean

Service Management

SLEE-defined

Get services on all nodes

public ServiceID[] getServices(ServiceState state)
  throws NullPointerException, ManagementException;

Rhino’s implementation of the SLEE-defined getServices operation returns an array identifying all the services in the requested state on the node where you invoke the operation.

Rhino extension

Get services on specific nodes

public ServiceID[] getServices(ServiceState state, int nodeID)
  throws NullPointerException, InvalidArgumentException,
    ManagementException;

Rhino provides an extension that adds an argument that lets you control the nodes on which to list services in a particular state (by specifying node IDs).

Services by State

Console command: listservicesbystate

MBean operation: getServices

Console command: `listservicesbystate`

MBean operation: `getServices`