Rhino 2.5.0 :: Rhino Administration and Deployment Guide

To find SBB entities in the SLEE, use the following rhino-console command or related MBean operation.

Console command: findsbbs

Command

findsbbs [-maxpernode maxrows] [-node nodeid] <-service service> [-sbb sbb] [-created-after date|time|offset]
   [-created-before date|time|offset]
   Find SBBs.

Options

Option

Abbreviation

Description

-maxpernode <maxrows>

Retrieve at most this many SBB entities from each event-router node (default is 100). Can be used to limit Rhino’s load when processing the request.

-node <node-id>

Only display activities owned by the given node.

-service <service>

Look for SBB entities owned by the named service (must be specified).

-sbb <sbb>

Only display SBB entities of the named SBB.

-created-after <time>

-ca

Only display SBB entities created after the given time.

-created-before <time>

-cb

Only display SBB entities created before the given time.

Times for the above options may be entered in either absolute or relative format:

Type Format Description Examples

Absolute

[[yyyy/]MM/dd] [HH:mm[:ss]]

yyyy = the year
MM = the month (1-12)
dd = the date of the month (1-31)
HH = the hour (0-23)
mm = the minute (0-59)
ss = the second (0-59)

2008/04/15
04/15
10:57
10:57:35
2008/04/15 10:57:35

Relative

(<nn><d|h|m|s>)*

nn = a number
d = days
h = hours
m = minutes
s = seconds

1d
1h
1m
30s
1h30m
7m30s
1d12h5m30s

Rhino assumes relative time format is in the past. For example, 1h30m means 1 hour and 30 minutes ago.

Examples

To display all SBB entities owned by the JCC VPN service in the SLEE:

$ ./rhino-console findsbbs -service "name=JCC 1.1 VPN,vendor=Open Cloud,version=1.0"
pkey                   creation-time       parent-pkey            replicated   sbb-component-id                                     service-component-id
--  --  --  --  --  --------------------------------------------------
101:109504372474:0   20080424 18:12:15     101:109504372533:1        false   SbbID[name=AnytimeInterrogation sbb,vendor=Open Cl  ServiceID[name=JCC 1.1 VPN,vendor=Open Cloud,versi
101:109504372474:1   20080424 18:12:38     101:109504372533:4        false   SbbID[name=AnytimeInterrogation sbb,vendor=Open Cl  ServiceID[name=JCC 1.1 VPN,vendor=Open Cloud,versi
101:109504372474:10   20080424 18:12:44    101:109504372533:23        false   SbbID[name=AnytimeInterrogation sbb,vendor=Open Cl  ServiceID[name=JCC 1.1 VPN,vendor=Open Cloud,versi
101:109504372474:11   20080424 18:12:45    101:109504372533:24        false   SbbID[name=AnytimeInterrogation sbb,vendor=Open Cl  ServiceID[name=JCC 1.1 VPN,vendor=Open Cloud,versi
101:109504372474:12   20080424 18:12:45    101:109504372533:26        false   SbbID[name=AnytimeInterrogation sbb,vendor=Open Cl  ServiceID[name=JCC 1.1 VPN,vendor=Open Cloud,versi
101:109504372474:13   20080424 18:12:45    101:109504372533:27        false   SbbID[name=AnytimeInterrogation sbb,vendor=Open Cl  ServiceID[name=JCC 1.1 VPN,vendor=Open Cloud,versi
...
101:109504372533:0   20080424 18:12:15                               false   SbbID[name=JCC 1.1 VPN sbb,vendor=Open Cloud,versi  ServiceID[name=JCC 1.1 VPN,vendor=Open Cloud,versi
101:109504372533:101   20080424 18:13:00                               false   SbbID[name=JCC 1.1 VPN sbb,vendor=Open Cloud,versi  ServiceID[name=JCC 1.1 VPN,vendor=Open Cloud,versi
101:109504372533:106   20080424 18:13:02                               false   SbbID[name=JCC 1.1 VPN sbb,vendor=Open Cloud,versi  ServiceID[name=JCC 1.1 VPN,vendor=Open Cloud,versi
101:109504372533:107   20080424 18:13:02                               false   SbbID[name=JCC 1.1 VPN sbb,vendor=Open Cloud,versi  ServiceID[name=JCC 1.1 VPN,vendor=Open Cloud,versi
101:109504372533:112   20080424 18:13:02                               false   SbbID[name=JCC 1.1 VPN sbb,vendor=Open Cloud,versi  ServiceID[name=JCC 1.1 VPN,vendor=Open Cloud,versi
...
100 rows

To narrow the search:

To search for SBB entities belonging to node 101 (replicated or non-replicated SBB entities owned by 101) that are more than one hour old, you would use the parameters -node 101 and -cb 1h:

$ ./rhino-console findsbbs -service "name=JCC 1.1 VPN,vendor=Open Cloud,version=1.0" -node 101 -cb 1h
pkey                   creation-time       parent-pkey            replicated   sbb-component-id                                     service-component-id
--  --  --  --  --  --------------------------------------------------
101:109504172475:229   20080424 17:17:33   101:109504172535:443        false   SbbID[name=AnytimeInterrogation sbb,vendor=Open Cl  ServiceID[name=JCC 1.1 VPN,vendor=Open Cloud,versi
101:109504172535:443   20080424 17:17:33                               false   SbbID[name=JCC 1.1 VPN sbb,vendor=Open Cloud,versi  ServiceID[name=JCC 1.1 VPN,vendor=Open Cloud,versi
2 rows

This example returned two SBB entities, one the parent SBB entity of the other.

MBean operations: `getSbbs`

MBean

Housekeeping MBean

Rhino operations

Get summary information for all SBB entities owned by a service

public TabularData getSbbs(int maxPerNode, ServiceID serviceID)
  throws UnrecognizedServiceException, ManagementException;

This operation returns tabular data summarising all SBB entities in the given service.

Get summary information for all SBB entities owned by a service using time-based criteria

public TabularData getSbbs(int maxPerNode, ServiceID serviceID, long createdAfter, long createdBefore)
  throws ManagementException, UnrecognizedServiceException;

This operation returns tabular data summarising the SBB entities owned by the given service using the time-based criteria specified (in milliseconds, as used by java.util.Date, or the value 0 to ignore a particular parameter).

Get summary SBB entity information for a particular SBB in a service using time-based criteria

public TabularData getSbbs(int maxPerNode, ServiceID serviceID, SbbID sbbType, long createdAfter, long createdBefore)
  throws ManagementException, UnrecognizedSbbException, UnrecognizedServiceException;

This operation returns tabular data summarising only SBB entities of the given SBB in the given service using the time-based criteria specified (in milliseconds, as used by java.util.Date, or the value 0 to ignore a particular parameter).

Results depend on the Housekeeping MBean that invokes the operation:

Cluster Housekeeping MBean — returns results from all event-router nodes in the primary component
Node Housekeeping MBean — returns results from that node only.

For a description of the format of the tabular data that these operations return, see the javadoc.

Previous page Next page

Finding SBB Entities

Console command: findsbbs

MBean operations: getSbbs

MBean operations: `getSbbs`