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_config_reload(3CMM)


NAME

 cmm_config_reload - reload the cluster node table

SYNOPSIS

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

DESCRIPTION

The cmm_config_reload() function forces the nhcmmd(1M) daemon to reload the cluster node table. When a node is added to or removed from this table, the nhcmmd daemon must be informed. There are two ways to inform the nhcmmd daemon of the changes to the cluster node table: call the cmm_config_reload() function or type one of the following:

pkill  -HUP nhcmmd
nhcmmstat--creload
kill  -HUP <CMM process Id>

This function can only be called from the master node. If it is called from a non-master node it returns a CMM_EPERM error. As a result of this call, notifications are sent indicating the modifications occurring in the cluster because of the new configuration read from the cluster node table. See the Netra High Availability Suite Foundation Services 2.1 6/03 CMM Programming Guide for information on notifications. The supported operations are add a node and remove a node, with the node powered off. The attributes of a node must not be changed.

To remove a node from the cluster, ensure that the node is powered off before changing the cluster nodes table. Only after a node has been powered off should you perform a cmm_config_reload().

RETURN VALUES

The cmm_config_reload() 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_ECONN

No nhcmmd is accessible on the current node.

CMM_ENOCLUSTER

Calling node is not yet in a cluster.

CMM_ENOTSUP

Unexpected service error.

CMM_EPERM

Permission denied. The function was not called from the master node.

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