Netra™ High Availability Suite 3.0 1/08 Foundation Services NMA Programming Guide

Netra™ High Availability Suite 3.0 1/08 Foundation Services NMA Programming Guide

819-5239-13

Contents

Figures

Examples

Preface

Introduction to the Node Management Agent

Accessing the NMA

Master and Node Views

MBean Instances on the Master Node

MBean Instances on Peer Nodes

Floating External Address

Configuration Files, Dependencies, and Requirements

Configuration Files

Dependencies

Software Requirements

Developing an External Java Manager

Configuring an External Java Manager Using HTTP

Connecting to the NMA

Using the Floating Address

Using a Physical Node Address

Using Proxy MBeans

Developing a Remote SNMP Manager

Configuring an SNMP Agent

IP-Based Access Control Lists

Format of the acl Group

Format of the Trap Group

SNMPv3 User-Based Access Control

Configuring SNMPv3 Security

Engine ID

Context Name

Managing Users in Security Files

SNMP Manager Configuration Examples

SNMPv2 Configuration Example

SNMPv2 and SNMPv3 Hybrid Configuration Example

SNMPv3 Configuration Example

Manipulating the Cluster Using the NMA

Using the NMA to Initiate a Switchover

Checking Whether the Netra HA Suite Software Is Ready for Switchover

Initiating a Switchover

Example of Switchover Using an HTTP Connector Client

Getting the CMM Status of All Cluster Nodes

Manipulating Daemon Monitor Retry Settings

Carrier Grade Transport Protocol Statistics

Introducing CGTP Statistics

CGTP Master Statistics

CgtpMasterMBean

Getting All Local CGTP Addresses for Which Statistics Are Available

Getting All Remote CGTP Addresses for Which Statistics Are Available

CGTP Node Statistics

CgtpMBean

Getting All Local CGTP Addresses for Which Statistics Are Available

Getting All Remote CGTP Addresses for Which Statistics Are Available

CgtpEmitterStatisticsMBean

Getting the Number of Packets Sent Through Each Subinterface

CgtpFilterMBean

Getting the Number of Packets Not Received in Duplicate

Getting the Amount of Memory Currently Used by the Filter Module

Getting the Number of Packets Successfully Received

Getting the Number of Hash Table Collisions

Getting the Number of Direct Hash Table Entries

Getting the Number of Hash Table Entries

Getting the Maximum Amount of Memory Used by the Filter Module

Getting the Number of Packets Waiting for Duplicate Reception

Getting the Number of Packet Hash Collisions

Getting the Maximum Number of Packet Hash Collisions

Getting the Maximum Number of Packet Hash Collisions in One Row

CgtpReceiverStatisticsMBean

Getting the Number of Packets Not Successfully Filtered

Getting the Number of Packets Successfully Filtered

Getting the Number of Packets Received Through Each Subinterface

CgtpReliableLinkStatisticsMBean

Getting the Remote Subinterface Addresses

Getting Local End Reliable Link CGTP Addresses

Getting Remote End Reliable Link CGTP Addresses

Getting Local Subinterface Addresses

Daemon Monitor Statistics

Example of Accessing Statistics Using an HTTP Client

Introducing Daemon Monitor Statistics

Daemon Monitor Master Statistics

PmdMasterStatisticsMBean

Getting All Nametags

Daemon Monitor Node Statistics

PmdStatisticsMBean

Getting All Nametags

PmdNameTagStatisticsMBean

Getting the Daemon Monitor Nametag

Getting the PIDs Associated With a Nametag

Getting the Daemon Monitor Maximum Retries

Getting the Number of Retries for a Nametag

Reliable NFS Statistics

Introducing Reliable NFS Statistics

Reliable NFS Using SNDR

Reliable NFS Master Statistics for SNDR

RnfsMasterReplicatedSliceMBean

Reliable NFS Peer Node Statistics for SNDR

RnfsStatisticsMBean

RnfsMasterStatisticsMBean

RnfsReplicatedSliceMBean

Reliable NFS Using Shared Disk Configuration

Reliable NFS Master Statistics for Shared Disk

SDMasterStatisticsMBean

Cluster Membership Manager Statistics

Introducing CMM Statistics

CMM Master Statistics

CmmMasterStatisticsMBean

Getting the Average Time Between Node Starts

Getting the Number of CMM Clients

Getting the CMM Lifetime

Getting the Number of Node Elections

Getting the Longest Interval Between Node Starts

Getting the Shortest Interval Between Node Starts

Getting the Number of Nodes in the Cluster

Getting the Number of Outstanding CMM Requests

Getting the Switchover Count

CMM Node Statistics

ClusterNodeMBean

Getting a Node's CGTP Address

Getting the Domain ID of the Cluster That a Node Is Eligible to Join

Getting the Time Since Node Was Last Rebooted

Getting the CMM Membership Role of a Node

Getting the Node ID

Getting the Node Name

Getting the Node Boot Image ID

Getting the CMM State Flags of a Node

CmmStatisticsMBean

Getting the Average Time Taken to Start CMM Services

Getting the Number of Master Elections Performed on a Node

Getting the Maximum Time Taken to Elect a Master Node

Getting the Minimum Time Taken to Elect a Master Node

Getting the Number of Nodes Present

Getting the Number of Switchovers Performed

Getting the Number of Currently Connected CMM Clients

Getting the Number of Outstanding Requests

Getting the Lifetime of the CMM on a Node

Receiving Notifications

Registering to Receive Notifications

NhasCmmNotification

NhasPmdMaxRetriesNotification

NhasPmdAttributeChangeNotification

NhasPmdNewNameTagNotification

NhasPmdRemoveNameTagNotification

Registering to Receive SNMP Traps

MBean Naming Conventions

Nodes and Services

Cluster Membership Manager

Reliable NFS Using SNDR

Reliable NFS Using a Shared-Disk Configuration

Daemon Monitor

CGTP

Netra™ High Availability Suite 3.0 1/08 Foundation Services NMA Programming Guide

819-5239-13

Copyright © 2008, Sun Microsystems, Inc. All rights reserved.