Rhino 2.5.0 :: Rhino Administration and Deployment Guide

To find activities in the SLEE, use the following rhino-console command or related MBean operations.

Console command: `findactivities`

Command

findactivities [-all] [-maxpernode maxrows] [-node nodeid] [-ra <ra-entity>] [-created-after date|time|offset]
   [-created-before date|time|offset] [-updated-after date|time|offset] [-updated-before date|time|offset]
   Find activities. Use -all to display activities removed but not garbage
   collected.

Options

Option

Abbreviation

Description

-all

Include all activities removed but not yet garbage collected.

-maxpernode <maxrows>

Retrieve at most this many activities 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.

-ra <ra-entity>

Only display activities created by the named resource adaptor entity.

-created-after <time>

-ca

Only display activities created after the given time.

-created-before <time>

-cb

Only display activities created before the given time.

-updated-after <time>

-ua

Only display activities updated after the given time.

-updated-before <time>

-ub

Only display activities updated 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
1m
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 activities in the SLEE:

$ ./rhino-console findactivities
pkey                       attach-count   handle                               node   ra-entity   ref-count   replicated   submission-time     update-time
--  --  --  --  --  --  --  --  ------------------
0.101:108896044881:1.1              0  ServiceActivity[ServiceID[name=Simp    101  Rhino Inte           0         true   20080417 16:48:19   20080417 16:48:19
A.101:108896044898:100.1              1  SAH[switchID=1208407667,connectionI    101      simple           1         true   20080417 17:32:19   20080417 17:32:19
A.101:108896044898:104.1              1  SAH[switchID=1208407667,connectionI    101      simple           1         true   20080417 17:32:20   20080417 17:32:20
A.101:108896044898:106.1              1  SAH[switchID=1208407667,connectionI    101      simple           1         true   20080417 17:32:21   20080417 17:32:21
A.101:108896044898:108.1              1  SAH[switchID=1208407667,connectionI    101      simple           1         true   20080417 17:32:21   20080417 17:32:21
A.101:108896044898:110.1              1  SAH[switchID=1208407667,connectionI    101      simple           1         true   20080417 17:32:23   20080417 17:32:23
A.101:108896044898:112.1              1  SAH[switchID=1208407667,connectionI    101      simple           1         true   20080417 17:32:24   20080417 17:32:24
A.101:108896044898:116.1              1  SAH[switchID=1208407667,connectionI    101      simple           1         true   20080417 17:32:25   20080417 17:32:25
...
100 rows

Finding stale activities

A common search would be for stale activities. Rhino performs a periodic activity-liveness scan, checking all active activities and ending those detected as stale. Sometimes, however, a failure in the network or inside a resource adaptor might prevent the liveness scan from detecting and ending some activities. In this case, the Administrator would have to locate and end the stale activities manually.

To narrow the search:

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

$ ./rhino-console findactivities -node 101 -cb 1h
pkey                       attach-count   handle                               node   ra-entity   ref-count   replicated   submission-time     update-time
--  --  --  --  --  --  --  --  ------------------
A.101:108896044898:104.1              1  SAH[switchID=1208407667,connectionI    101      simple           1         true   20080417 17:32:20   20080417 17:32:20
A.101:108896044898:106.1              1  SAH[switchID=1208407667,connectionI    101      simple           1         true   20080417 17:32:21   20080417 17:32:21
2 rows

(This example returned two activities.)

MBean operation: `getActivities`

MBean

Housekeeping MBean

Rhino operations

Get summary information for all activities

public TabularData getActivities(int maxPerNode, boolean includeRemoved)
    throws ManagementException;

This operation returns tabular data summarising all activities.

Get summary information for activities belonging to a resource adaptor entity

public TabularData getActivities(int maxPerNode, String entityName, boolean includeRemoved)
    throws ManagementException, UnrecognizedResourceAdaptorEntityException;

This operation returns tabular data summarising the activities owned by the given resource adaptor entity.

Get summary information for activities using time-based criteria

public TabularData getActivities(int maxPerNode, String entityName, long createdAfter, long createdBefore, long updatedAfter, long updatedBefore, boolean includeRemoved)
    throws ManagementException, UnrecognizedResourceAdaptorEntityException;

This operation returns tabular data summarising the activities owned by the given resource adaptor entity 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 Activities

Console command: findactivities

MBean operation: getActivities

Console command: `findactivities`

MBean operation: `getActivities`