This chapter describes how to configure heartbeats for HTTP-based stateless network protocol plug-ins for Oracle Communications Services Gatekeeper.
The heartbeat functionality performs heartbeat checks on HTTP-based network nodes on behalf of a Services Gatekeeper communication service plug-in. When a heartbeat fails, the plug-in is set to an INACTIVE state. The heartbeat functionality continues trying to connect to the node and, when a positive answer is received, the plug-in re-enters the ACTIVE state.
The following network protocol plug-ins use this functionality:
Parlay X 2.1 Terminal Location/MLP
Extended Web Services WAP Push/PAP
Parlay X 2.1 Multimedia Messaging/MM7
Native MM7
The heartbeat operation administration and management (OAM) WebLogic interface functionality is shared among the plug-ins. They all use the same MBean, com.bea.wlcp.wlng.heartbeat.management.HeartbeatMBean. But the result is rendered per plug-in (one instance is displayed per plug-in). It appears slightly differently depending on how to the MBean is accessed:
In the Administrative Console, expand the plug-in that uses heartbeat functionality, for example:
Plugin_px21_multimedia_messaging-HeartbeatConfiguration
Plugin_ews_push_message_papHeartbeatConfiguration
Plugin_px21_terminal_location_mlp-HeartbeatConfiguration
Plugin_multimedia_messaging_mm7-HeartbeatConfiguration
Then click HeartBeat Configuration to display the attributes for the heartbeat module.
In an MBean browser, such as JConsole, one instance of the MBean is displayed using the same ObjectName (at the same hierarchical level) as the plug-in it is used by.
Note:
You must configure heartbeat attributes for all of the above mentioned plug-ins that use this feature. Only the heartbeat attributes for the related plug-in are displayed in the console.To configure heartbeat attributes:
Specify if heartbeats should be enabled for the associated plug-in using the HeatBeatMbean Enabled field.
If heartbeats are enabled, set values for these HeartBeatMBean fields:
ContentMatch
Interval
NetworkServiceUrl
Set field values and use methods from the Administration Console (Container Services , the HeartbeatMBean) or a Java application. For information on the methods and fields, see the "All Classes" section of Services Gatekeeper OAM Java API Reference.