Skip Headers
Oracle® Coherence Management Guide
Release 3.7.1

Part Number E22842-01
Go to Documentation Home
Go to Book List
Book List
Go to Table of Contents
Go to Feedback page
Contact Us

Go to previous page
Go to next page
View PDF

1 Introduction to Coherence Management

This chapter provides an introduction to Coherence management features. Coherence management is implemented using Java Management Extensions (JMX). JMX is a Java standard for managing and monitoring Java applications and services. Refer to the following article for details on JMX:

The following sections are included in this chapter:

1.1 Conceptual Overview of Coherence Management

Coherence provides a JMX framework to manage clusters. The framework relies on one or more cluster members that are configured to host an MBean server. The MBean servers are responsible for managing the managed objects of all the other cluster members. The framework allows access to management information from any cluster member and is fault tolerant should a JMX member fail. The management framework is disabled by default and must be explicitly enabled by configuring at least one cluster member to host an MBean server. See Chapter 2, "Using JMX to Manage Coherence," for more information on enabling JMX management in Coherence.

Coherence MBeans

Coherence managed objects are registered to an MBean server using the interface. The interface is specific to managing Coherence clustered resources and is an abstraction of the basic JMX registration APIs. Though the interface is closely related to the JMX infrastructure, it is independent from* classes. The interface enables remote management support for cluster members that are not collocated with any JMX services and allows Coherence MBeans to be registered in an MBean server that is either collocated or remote in relation to the managed object.

Appendix A, "Coherence MBeans Reference," provides a list of all Coherence MBeans and describes each of the attributes and operations that are exposed for the managed resources. Some managed resources only have a single instance for each cluster member; while, some managed resources (such as the CacheMBean MBean) may have multiple MBean instances for each cluster member. In addition, an MBean is only registered if there is at least one managed resource operational. In the case of the CacheMBean MBean, a cache must be started before the MBean is registered.

Custom MBeans

Coherence provides the ability to manage and monitor custom MBeans within the management framework. Custom MBeans are any dynamic or standard MBeans that are specific to an application. The MBeans are registered either declaratively in an XML file or programmatically using the Registration interface. This allows an application's MBeans to be managed or monitored from any JVM, member, or end-point within the cluster. See Chapter 3, "Registering Custom MBeans," for more information on registering custom MBeans.

MBean Consoles

Any MBean-capable console can interact with Coherence MBeans. Coherence includes support for both the Java Management & Monitoring Console (jconsole) that is distributed with the JDK and the JMX HTTPAdapter Web application that is included as part of the JMX reference implementation. See "Accessing Coherence MBeans" for more information on using these consoles to interact with Coherence MBeans.

1.2 Management Reporting in Coherence

The Coherence Reporter provides management reports that are used to view management information over time. The reports are text files that are constructed from data that is obtained from the Coherence MBeans. The reports are automatically updated at a configured time interval and provide a historical context that is not possible simply by monitoring the MBeans. The reports are most often used to identify trends that are valuable for troubleshooting and planning.

Coherence includes many predefined reports out-of-box. The reports can be customized or new reports can be created as required. Reporting functionality is disabled by default and must be explicitly enabled. In addition, only a subset of the reports are initially configured to be generated. See Chapter 4, "Using JMX Reporting," for details on enabling reporting in Coherence. Also, see Chapter 6, "Analyzing Reporter Content," for detailed information on the predefined reports.

1.3 Overview of Management Configuration

Coherence management is configured using several configuration files. See Oracle Coherence Developer's Guide for detailed information on Coherence configuration. The files include:

1.4 Managing Coherence with Enterprise Manager

Oracle Enterprise Manager Grid Control includes the Management Pack for Oracle Coherence, which is used to manage and monitor Coherence clusters. The management pack helps administrators pro-actively monitor the performance of their Coherence clusters and reduces the time needed to identify and diagnose performance problems within their application environments. The key benefits include:

Oracle Enterprise Manager Grid Control, which includes the Management Pack for Oracle Coherence, can be downloaded from OTN:

See the Getting Started Guide for Oracle Coherence in the Oracle Enterprise Manager Documentation Library for detailed instructions on configuring and using the management pack.