This book describes how
to write applications that use the Cluster Membership Manager API
for the Netra High Availability
(HA) Suite 3.0 1/08 Foundation Services.
This book is for application developers who are writing programs for clusters running the Foundation Services. This book describes how to perform the following tasks:
To write applications for Netra HA Suite, you must have experience
with the C programming language. Knowledge of using and deploying
highly available applications on a cluster and knowledge of the
developer tools offered by the Solaris Operating
System (Solaris OS) is an advantage.
Before reading this book, read the Netra High Availability Suite 3.0 1/08 Foundation Services Overview.
This book is divided into the following chapters:
Chapter 1 provides an overview of the basic functions and characteristics of the CMM API.
Chapter 2 describes the roles, qualification levels, and attributes that a node can have.
Chapter 3 describes the requirements of a development host on which to write applications that use the CMM API.
Chapter 4 describes how to install, compile, and run your applications.
Chapter 5 describes how to identify and retrieve data about nodes in the cluster.
Chapter 6 describes the nhcmmd daemon, the notifications this daemon sends, and how to interpret these notifications.
Chapter 7 describes how to retrieve and react to cluster notifications, and how to modify the cluster if necessary.
Chapter 8 describes how to debug your applications. This chapter also describes the return values provided by the CMM API.
Shell | Prompt |
---|---|
C shell | machine-name% |
C shell superuser | machine-name# |
Bourne shell and Korn shell | $ |
Bourne shell and Korn shell superuser | # |
Typeface | Meaning | Examples |
---|---|---|
AaBbCc123 | The names of commands, files, and directories; on‐screen computer output | Edit your .login file. |
AaBbCc123 | What you type, when contrasted with on-screen computer output | % su |
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. |
Note - Characters display differently depending on browser settings. If characters do not display correctly, change the character encoding in your browser to Unicode UTF-8. |
The following table lists the documentation for this product. The online documentation is available at:
http://docs.sun.com/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 |
The Sun web site provides information about the following additional resources:
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 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 CMM Programming Guide, part number 819-5236-13
Copyright © 2008, Sun Microsystems, Inc. All rights reserved.