Recovery Procedure During normal shutdown procedures this alarm should

Monitoring and Troubleshooting 8-17

8.5.2.11.1 Recovery Procedure The typical failure is caused by an invalid sip.xml

configuration file and should occur only during software installation or upgrade procedures. When it occurs, undeploy the application, validate the sip.xml file, and retry the deployment.

8.6 Using the WebLogic Diagnostics Framework WLDF

The WebLogic Diagnostic Framework WLDF consists of a number of components that work together to collect, archive, and access diagnostic information about a WebLogic Server instance and its applications. Oracle WebLogic Communication Services version integrates with several components of the WLDF in order to monitor and diagnose the operation of engine and SIP data tier nodes, as well as deployed SIP Servlets: ■ Data Collectors—Oracle WebLogic Communication Services integrates with the Harvester service to collect information from runtime MBeans, and with the Logger service to archive SIP requests and responses. ■ Watches and Notifications—Administrators can use the Watches and Notifications component to create complex rules, based on Oracle WebLogic Communication Services runtime MBean attributes, that trigger automatic notifications using JMS, JMX, SNMP, SMTP, and so forth. ■ Image Capture—Oracle WebLogic Communication Services instances can collect certain diagnostic data and write the data to an image file when requested by an Administrator. This data can then be used to diagnose problems in a running server. ■ Instrumentation—Oracle WebLogic Communication Services instruments the server and application code with monitors to help you configure diagnostic actions that are performed on SIP messages requests and responses that match certain criteria. The sections that follow provide more details about how Oracle WebLogic Communication Services integrates with each of the above WLDF components.

8.6.1 Data Collection and Logging

Oracle WebLogic Communication Services uses the WLDF Harvester service to collect data from the attributes of these runtime MBeans: ■ ReplicaRuntimeMBean ■ SipApplicationRuntimeMBean ■ SipServerRuntimeMBean You can add charts and graphs of this data to your own custom views using the WLDF console extension. To do so, first enable the WLDF console extension by copying the JAR file into the console-ext subdirectory of your domain directory: cp ~beawlserver_10.3serverlibconsole-extdiagnostics-console-extension.jar ~beauser_projectsdomainsmydomainconsole-ext When accessing the WLDF console extension, the Oracle WebLogic Communication Services runtime MBean attributes are available in the Metrics tab of the extension. Note: This alarm should never occur during normal operations. If it does, contact Tier 4 support immediately.