1/95

Contents

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents
• Conventions

Part I Java Management Extensions Technology User’s Guide

1 Introduction to JMX Technology

• What Is JMX Technology
• Why Use JMX Technology

2 JMX Technology Architecture

• Architecture Outline
• Instrumenting Resources by Using MBeans
• Creating a JMX Agent
• Managing Resources Remotely

3 Instrumenting Your Resources for JMX Technology

• Manageable Resources
• Managed Beans (MBeans)
• Java Virtual Machine Instrumentation

4 Using JMX Agents

• MBean Server
• Agent Services
• Protocol Adaptors and Connectors
  • Protocol Adaptors
  • Connectors

5 Using JMX Connectors to Manage Resources Remotely

• RMI Connector
• Generic Connector
• User-Defined Protocols

6 Discovery and Lookup Services

• Getting Started with Lookup Services

7 JMX Technology Versions

• JMX Instrumentation and Agent Specification (JSR 3)
• JMX Remote API Specification (JSR 160)

8 Java Management Extensions (JMX) API Specification

Part II Java Management Extensions (JMX) Technology Tutorial

9 Getting Started

• Platform Information

10 Essentials of the JMX API

• Standard MBeans
  • MBean Interface
  • MBean Implementation
  • Managing a Resource
  • Running the Standard MBean Example
• Sending Notifications
  • NotificationBroadcaster Interface
  • Running the MBean Notification Example
• Introducing MXBeans
  • QueueSamplerMXBean Interface
  • QueueSampler Class
  • QueueSample Class
  • Creating and Registering the MXBean in the MBean Server
  • Running the MXBean Example
• MBean Descriptors
  • DescriptorKey Annotations
  • Using MBean Descriptors
  • Running the MBean Descriptors Example

11 JMX Connectors

• Accessing Standard and Dynamic MBeans By Using the RMI Connector
  • Server.java in the MBean Example
  • SimpleStandardMBean.java in the MBean Example
  • SimpleStandard.java in the MBean Example
  • SimpleDynamic.java in the MBean Example
  • ClientListener.java in the MBean Example
  • Client.java in the MBean Example
• Running the MBean Example

12 Lookup Services

• Initial Configuration
  • External RMI Registry
  • External LDAP Registry
• Service Location Protocol (SLP) Lookup Service
  • Server.java in the SLP Lookup Example
  • Client.java in the SLP Lookup Example
  • Running the SLP Lookup Service Example
• Jini Lookup Service
  • Server.java in the Jini Lookup Service Example
  • Client.java in the Jini Lookup Service Example
  • java.policy in the Jini Lookup Service Example
  • jini.properties.template
  • Running the Jini Lookup Service Example
• Java Naming and Directory Interface (JNDI) / LDAP Lookup Service
  • Server.java in the JNDI/LDAP Lookup Service Example
  • Client.java in the JNDI/LDAP Lookup Service Example
  • jmx-schema.txt
  • 60jmx-schema.ldif
  • Running the JNDI/LDAP Lookup Service Example

13 Security

• Simple Security
  • Server.java in the Simple Security Example
  • SimpleStandardMBean.java in the Simple Security Example
  • SimpleStandard.java in the Simple Security Example
  • ClientListener.java in the Simple Security Example
  • Client.java in the Simple Security Example
  • Running the RMI Connector Example With Simple Security
• Subject Delegation
  • Server.java in the Subject Delegation Example
  • java.policy in the Subject Delegation Example
  • SimpleStandardMBean.java in the Subject Delegation Example
  • SimpleStandard.java in the Subject Delegation Example
  • ClientListener.java in the Subject Delegation Example
  • Client.java in the Subject Delegation Example
  • Running the Secure RMI Connector Example With Subject Delegation
• Fine-Grained Security
  • Server.java in the Fine-Grained Security Example
  • java.policy in the Fine-Grained Security Example
  • SimpleStandardMBean.java in the Fine-Grained Security Example
  • SimpleStandard.java in the Fine-Grained Security Example
  • ClientListener.java in the Fine-Grained Security Example
  • Client.java in the Fine-Grained Security Example
  • Running the RMI Connector Example With Fine-Grained Security

Part III Java Management Extensions Examples

14 JMX Essentials

• examples/Essential/README
• examples/Essential/com/example/mbeans/Main.java
• examples/Essential/com/example/mbeans/Hello.java
• examples/Essential/com/example/mbeans/HelloMBean.java

15 JMX MBean Notifications

• examples/Notification/README
• examples/Notification/com/example/mbeans/Main.java
• examples/Notification/com/example/mbeans/Hello.java
• examples/Notification/com/example/mbeans/HelloMBean.java

16 MXBeans

• examples/MXBean/README
• examples/MXBean/com/example/mxbeans/Main.java
• examples/MXBean/com/example/mxbeans/QueueSamplerMXBean.java
• examples/MXBean/com/example/mxbeans/QueueSampler.java
• examples/MXBean/com/example/mxbeans/QueueSample.java

17 MBean Descriptors

• examples/Descriptors/README
• examples/Descriptors/com/example/mxbeans/Author.java
• examples/Descriptors/com/example/mxbeans/DisplayName.java
• examples/Descriptors/com/example/mxbeans/Main.java
• examples/Descriptors/com/example/mxbeans/QueueSample.java
• examples/Descriptors/com/example/mxbeans/QueueSampler.java
• examples/Descriptors/com/example/mxbeans/QueueSamplerMXBean.java
• examples/Descriptors/com/example/mxbeans/Version.java

18 JMX Connectors

• examples/Basic/README
• examples/Basic/Server.java
• examples/Basic/SimpleStandardMBean.java
• examples/Basic/SimpleStandard.java
• examples/Basic/SimpleDynamic.java
• examples/Basic/ClientListener.java
• examples/Basic/Client.java

19 Service Location Protocol (SLP) Lookup Service

• examples/Lookup/slp/README
• examples/Lookup/slp/Server.java
• examples/Lookup/slp/Client.java

20 Jini Lookup Service

• examples/Lookup/jini/README
• examples/Lookup/jini/Server.java
• examples/Lookup/jini/Client.java
• examples/Lookup/jini/java.policy

21 Java Naming and Directory Interface (JNDI)/LDAP Lookup Service

• examples/Lookup/ldap/README
• examples/Lookup/ldap/Server.java
• examples/Lookup/ldap/Client.java
• examples/Lookup/ldap/jmx-schema.txt
• examples/Lookup/ldap/60jmx-schema.ldif

22 Simple Security

• examples/Security/simple/README
• examples/Security/simple/server/Server.java
• examples/Security/simple/client/Client.java
• examples/Security/simple/client/ClientListener.java
• examples/Security/simple/config/access.properties
• examples/Security/simple/config/password.properties
• examples/Security/simple/mbeans/SimpleStandard.java
• examples/Security/simple/mbeans/SimpleStandardMBean.java

23 Security with Subject Delegation

• examples/Security/subject_delegation/README
• examples/Security/subject_delegation/server/Server.java
• examples/Security/subject_delegation/client/Client.java
• examples/Security/subject_delegation/client/ClientListener.java
• examples/Security/subject_delegation/config/access.properties
• examples/Security/subject_delegation/config/password.properties
• examples/Security/subject_delegation/config/java.policy
• examples/Security/subject_delegation/mbeans/SimpleStandard.java
• examples/Security/subject_delegation/mbeans/SimpleStandardMBean.java

24 Fine-Grained Security

• examples/Security/fine_grained/README
• examples/Security/fine_grained/server/Server.java
• examples/Security/fine_grained/client/Client.java
• examples/Security/fine_grained/client/ClientListener.java
• examples/Security/fine_grained/config/password.properties
• examples/Security/fine_grained/config/java.policy
• examples/Security/fine_grained/mbeans/SimpleStandard.java
• examples/Security/fine_grained/mbeans/SimpleStandardMBean.java