Developing Custom Management Utilities with JMX

Introduction and Roadmap

Document Scope and Audience

Guide to this Document

Related Documentation

New and Changed JMX Features in This Release

Understanding WebLogic Server MBeans

Basic Organization of a WebLogic Server Domain

Separate MBean Types for Monitoring and Configuring

The Life Cycle of WebLogic Server MBeans

WebLogic Server MBean Data Model

Containment and Reference Relationships

Containment Relationship

Reference Relationship

WebLogic Server MBean Object Names

MBean Servers

Connecting to MBean Servers

Local Connections to MBean Servers

Remote Connections to MBean Servers

Service MBeans

Security for WebLogic Server MBeans

Additional Security Resources for Some Attributes and Operations

Overview of WebLogic Server Subsystem MBeans

Domain and Server Logging Configuration

JMS Server and JMS System Module Configuration

JDBC Resource Configuration

Accessing WebLogic Server MBeans with JMX

Set Up the Classpath for Remote Clients

Make Remote Connections to an MBean Server

Example: Connecting to the Domain Runtime MBean Server

Best Practices: Choosing an MBean Server

Remote Connections Using Only JDK Classes

Make Local Connections to the Runtime MBean Server

Navigate MBean Hierarchies

Example: Printing the Name and State of Servers

Example: Monitoring Servlets

Managing a Domain’s Configuration with JMX

Editing MBean Attributes: Main Steps

Start an Edit Session

Change Attributes or Create New MBeans

Save Changes to the Pending Configuration Files

Activate Your Saved Changes

Example: Changing the Administration Port

Exception Types Thrown by Edit Operations

Listing and Undoing Changes

List Unsaved Changes

List Unactivated Changes

List Changes in the Current Activation Task

Undoing Changes

Tracking the Activation of Changes

Listing the Status of the Current Activation Task

Listing All Activation Tasks Stored in Memory

Purging Completed Activation Tasks from Memory

Managing Locks

Best Practices: Recommended Pattern for Editing and Handling Exceptions

Setting and Getting Encrypted Values

Set the Value of an Encrypted Attribute (Recommended Technique)

Set the Value of an Encrypted Attribute (Compatibility Technique)

Back Up an Encrypted Value

Managing Security Realms with JMX

Understanding the Hierarchy of Security MBeans

Base Provider Types and Mix-In Interfaces

Security MBeans

Choosing an MBean Server to Manage Security Realms

Working with Existing Security Providers

Discovering Available Services

Example: Adding Users to a Realm

Modifying the Realm Configuration

Using Notifications and Monitor MBeans

Best Practices: Listening Directly Compared to Monitoring

Best Practices: Listening for WebLogic Server Events

Best Practices: Listening or Monitoring WebLogic Server Runtime Statistics

Listening for Notifications from WebLogic Server MBeans: Main Steps

Creating a Notification Listener

Listening from a Remote JVM

Best Practices: Creating a Notification Listener

Configuring a Notification Filter

Creating a Custom Filter

Registering a Notification Listener and Filter

Packaging and Deploying Listeners on WebLogic Server

Example: Listening for The Registration of Configuration MBeans

Using Monitor MBeans to Observe Changes: Main Steps

Monitor MBean Types and Notification Types

Errors and the MonitorNotification Type Property

Creating a Notification Listener for a Monitor MBean

Registering the Monitor and Listener

Example: Registering a CounterMonitorMBean and Its Listener

Configuring WebLogic Server JMX Services

Example: Using WebLogic Scripting Tool to Make a Domain Read-Only