Preface

This book describes how to use the Node Management Agent (NMA) Javatrademark application programming interfaces (APIs) of the Netratrademark High Availability (HA) Suite 3.0 1/08 software.

The information in this book can help you perform the following tasks:


Who Should Use This Book

This book is for application developers who want to develop applications that use the NMA.


Before You Read This Book

To program the NMA you must have working knowledge of the Java language. Knowledge of the Java Dynamic Management Kit (DMK) 5.0 and the Solaristrademark Operating System (Solaris OS)is an advantage.

Before reading this book, read the Netra High Availability Suite 3.0 1/08 Foundation Services Overview.


How This Book Is Organized

Chapter 1 outlines the features of the NMA.

Chapter 2 introduces and defines the requirements and dependencies of the NMA.

Chapter 3 describes how to access the NMA from a Java manager.

Chapter 4 describes how to access the NMA from a SNMP manager.

Chapter 5 explains how to use the NMA to provoke a master node switchover and set Daemon Monitor parameters.

Chapter 6 describes the Carrier Grade Transfer Protocol (CGTP) statistics that can be accessed from the NMA.

Chapter 7 describes the Daemon Monitor statistics that can be accessed from the NMA.

Chapter 8 describes the Reliable NFS statistics that can be accessed from the NMA.

Chapter 9 describes the Cluster Membership Manager (CMM) statistics that can be accessed from the NMA.

Chapter 10 explains the NMA notification mechanism and the meaning of the NMA notification types.

Appendix A describes the syntax of the MBean naming conventions.


Using UNIX Commands

This document might not contain information on basic UNIX® commands and procedures such as shutting down the system, booting the system, and configuring devices. Refer to the following for this information:


Shell Prompts


Shell Prompt
C shell machine-name%
C shell superuser machine-name#
Bourne shell and Korn shell $
Bourne shell and Korn shell superuser #


Typographic Conventions


Typeface[1] Meaning Examples
AaBbCc123 The names of commands, files, and directories; on‐screen computer output Edit your .login file.

Use ls -a to list all files.

% You have mail.

AaBbCc123 What you type, when contrasted with on-screen computer output % su

Password:

AaBbCc123 Book titles, new words or terms, words to be emphasized. Replace command-line variables with real names or values. Read Chapter 6 in the User’s Guide.

These are called class options.

To delete a file, type rm filename.



Related Documentation

The following table lists the documentation for this product. The online documentation is available at:

http://www.oracle.com/technetwork/indexes/documentation/index.html/app/docs/prod/netra.ha30


Application Title Part Number
Late-breaking news Netra High Availability Suite 3.0 1/08 Release Notes 819-5249-14
Introduction to concepts Netra High Availability Suite 3.0 1/08 Foundation Services Overview 819-5240-13
Basic setup, supported hardware, and configurations Netra High Availability Suite 3.0 1/08 Foundation Services Getting Started Guide 819-5241-13
Automated installation methods Netra High Availability Suite 3.0 1/08 Foundation Services Installation Guide 819-5242-13
Detailed installation methods Netra High Availability Suite 3.0 1/08 Foundation Services Manual Installation Guide for the Solaris OS 819-5237-13
Cluster administration Netra High Availability Suite 3.0 1/08 Foundation Services Cluster Administration Guide 819-5235-13
Using the Cluster Membership Manager Netra High Availability Suite 3.0 1/08 Foundation Services CMM Programming Guide 819-5236-13
Using the SAF CMM API Netra High Availability Suite 3.0 1/08 Foundation Services SA Forum Programming Guide 819-5246-13
Using the Node Management Agent Netra High Availability Suite 3.0 1/08 Foundation Services NMA Programming Guide 819-5239-13
Configuring outside the cluster using CGTP Netra High Availability Suite 3.0 1/08 Foundation Services Standalone CGTP Guide 819-5247-13
Man pages for Foundation Services features and APIs using the Solaris OS Netra High Availability Suite 3.0 1/08 Foundation Services Solaris Reference Manual 819-5244-13
Man pages for Foundation Services features and APIs using Linux Netra High Availability Suite 3.0 1/08 Foundation Services Linux Reference Manual 819-5245-12
Definitions and acronyms Netra High Availability Suite 3.0 1/08 Foundation Services Glossary 819-5238-13
Common problems Netra High Availability Suite 3.0 1/08 Foundation Services Troubleshooting Guide 819-5248-13


Documentation, Support, and Training

The Sun web site provides information about the following additional resources:


Third-Party Web Sites

Sun is not responsible for the availability of third-party web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused by or in connection width the use of or reliance on any such content, goods, or services that are available on or through such sites or resources.


Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions. You can submit your comments by going to:

http://www.sun.com/hwdocs/feedback

Please include the title and part number of your document with your feedback:

Netra™ High Availability Suite 3.0 1/08 Foundation Services NMA Programming Guide, part number 819-5239-13


1 (Table Footnote) The settings on your browser might differ from these settings.