Sun Microsystems Logo
Products and Services
 
Support and Training
 
 

A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X  Y  Z  
 
Program Interfacecmm_membership_remove(3CMM)


NAME

 cmm_membership_remove - remove peer node

SYNOPSIS

 
cc [ flag... ] file...  -lcgha_cmm  -lrt
 
#include <cmm.h>
cmm_error_t cmm_membership_remove( );

DESCRIPTION

The cmm_membership_remove() function removes the node from which this function is called from the cluster. The node is still configured to be in the cluster, but its role has changed. The CMM API is always accessible for an CMM_OUT_OF_CLUSTER node.

When the nhcmmd daemon detects that a node is no longer part of the cluster, it informs other applications or services that are registered to receive notification. See the Netra High Availability Suite Foundation Services 2.1 6/03 CMM Programming Guide for information on the notifications returned in different scenarios.

To reintegrate a node into the cluster after the cmm_membership_remove() function has been called on the node, restart the node's nhcmmd daemon by rebooting the node.

Note that after the cmm_membership_remove() call, a node is still to be configured to be in the cluster, but it has the CMM_OUT_OF_CLUSTER role. Because it is still configured to be in the cluster, it can access cluster information:

  • Functions that retrieve information on the cluster state can still be called by the node

  • Functions that modify the cluster state can no longer be called by the node

This is different from a node not being configured for any cluster. If the node is not configured for any cluster, the CMM_ENOCLUSTER value is returned.

Any program running on the node can call cmm_membership_remove(). There is no authentication carried out of the program making the call. Calling this function from the master leads to a failover (or CMM_ECANCELED if no vice-master can take the mastership role).

RETURN VALUES

The cmm_membership_remove() function returns one of the following values:

CMM_EBUSY

The CMM API server is temporarily out of resources to respond to the requested operation. The recommended action is to wait a short time and retry the operation. The length of the waiting must be decided by the user, depending on the application's characteristics.

CMM_ECANCELED

Operation canceled. The function was called on the master node but the vice-master node was not qualified to become master.

CMM_ECONN

No nhcmmd is accessible to the current node.

CMM_ENOCLUSTER

The calling node is not yet in a cluster.

CMM_ENOTSUP

An unexpected service error occurred. The cluster might be in a critical state.

CMM_ETIMEDOUT

The call timeout expired before the action was completed.

CMM_OK

Operation succeeds.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
ArchitectureSPARC
AvailabilitySUNWnhcmd
Interface StabilityEvolving
MT-LevelMT-Safe
Cancel-SafetyDeferred-Cancel-Safe Asynchronous-Cancel-Unsafe

SEE ALSO

Intro(3CMM), nhcmmd(1M)


Netra HAS FS 2.1Go To TopLast Changed September 2004