
Chapter 6
Administrative Maintenance
6.1 Introduction
A system administrator must ensure that the Rhino SLEE maintains peak operational performance. The administrator can
maximise the processing throughput and perform regular precautionary measures to ensure that, in the event of a failure, a
recovery can occur effectively.
6.2 Runtime Diagnostics and Maintenance
During normal Rhino SLEE operation SBB entities are removed by the SLEE when they are no longer needed. This usually
happens when all activities attached to the SBB have ended. In certain cases, however, the normal SBB life-cycle is interrupted
and SBB entities are not removed at the appropriate time. This could occur, for instance, if the SBB is attached to an activity
that hasn’t ended correctly due to a problem in the Resource Adaptor that created it. It is also possible for normal SBB removal
to fail if the SBB
sbbRemove
method throws an exception.
Rhino SLEE provides an administration interface to safeguard against the type of resource leak that unexpected problems
caused by deployed Resource Adaptors or Services may cause. The Housekeeping MBean allows interrogation of SBB state
and provides facilities for removing SBBs which have not been removed in the normal manner. There are also mechanisms for
finding and removing stale or problematic Activities, SBB entities, Activity Context Naming bindings, and Timers.
6.2.1 Inspecting Activities
The activity inspection commands allow the administrator to search for activities within the SLEE and to examine activity
details.
The
findActivities
command is used to search for activities corresponding to certain search parameters. When executed
with no arguments will return all activities in the system, limited only by the maximum results argument. Other arguments
available are:
Argument Description
-max <num>
The maximum number of activities returned.(100 by default)
-node <node-id>
Limit the search to activities whose processing node is the specified node.
-cb <time>
Limit the search to activities created before <time> specified as a number of days, hours,
minutes and seconds before now.
-ca <time>
Limit the search to activities created after <time>.
-ra <ra entity name>
Limit the search to activities created by a particular RA entity.
Table 6.1: Command-line arguments for
findActivities
The max parameter is used to limit the load placed on Rhino SLEE when processing the request. If too many rows are returned
43
Commentaires sur ces manuels