C H A P T E R 1 |
The Service Availability Forum (SA Forum) Cluster Membership (CLM) API can be used to develop programs for highly available clusters running the Foundation Services. For more information, see the following topics:
Foundation Services 3.0 is supported for use with the SA Forum CLM API B.02.01, in addition to the existing CMM API.
The CLM API provides a programming interface to the Cluster Membership Service, which provides membership information about the nodes in a cluster. This API enables you to write applications that monitor the state of peer nodes. You can use the CLM API to obtain information about which node is a member of the cluster.
More information about the SA Forum/CLM API can be found at:http://www.saforum.org/
This interaction of the CLM API with the Foundation Services is illustrated in FIGURE 1-1.
The CLM API enables you to create highly available applications to determine which nodes are in the cluster. The main functions of the CLM API are as follows:
The CLM API has the following multithreading characteristics:
It is multithread safe: mutual exclusion among threads is guaranteed when critical sections of the API are executed.
API calls cannot be interrupted by signals: If a signal is caught during a call, the call runs to completion. The call is not aborted and does not return an error in this case.
The locations of the CLM API header file and the default location for the CLM API library files differ depending on the operating system (OS) used.
For the Solaris OS, the CLM API header file, saClm.h, is located in the /opt/SUNWcgha/include/saf directory. The default location of the CLM API library files is the /opt/SUNWcgha/lib directory.
For the Linux OS, the cmm.h file, is located in the /opt/sun/include directory and the default location of the CMM API library files is the /opt/sun/lib directory for 32-bit applications or the /opt/sun/lib64 directory for 64-bit applications.
To access the CLM API header file and libraries for the Solaris OS, the following packages must be installed in your development environment:
To access the CLM API header file and libraries for Linux, the following packages must be installed in your development environment:
In addition, examples of using SA Forum/CLM will be provided in the SUNWnhas-safclm-headers package in the /opt/SUNWcgha/examples/SaClm_API directory (Solaris OS) or the /opt/sun/nhas/examples/SaClm_API directory (Linux OS).
Copyright © 2008, Sun Microsystems, Inc. All rights reserved.