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  
 
Maintenance Commandsnhcmmqualif(1M)


NAME

 nhcmmqualif - qualify the current node as master

SYNOPSIS

 /opt/SUNWcgha/sbin/nhcmmqualif [-v] [-t timeout]

DESCRIPTION

The nhcmmqualif command calls the cmm_member_seizequalif(3CMM) function to qualify the current node as master-eligible and start a new master election. This call is only successful if there is no active master node in the cluster and if the current node is master-eligible. If this call is not successful, a 255 exit code is returned. If this call is successful, this command forces the qualification of the current node so that this node becomes the master node. Use this command when no node is qualified to become master. Note that an unsynchronized node will only be elected as master node if its former role was master.

The nhcmmqualif command can only be called from a master-eligible node. This call has one of two outcomes for this node; either the node becomes master, or it reverts to the qualification level it had prior to the nhcmmqualif call.

If you attempt to call nhcmmqualif from a node that is not master-eligible, the command exits with a 255 exit code. If a master is already running when nhcmmqualif is called, the command exits with a 255 exit code. If nhcmmqualif provokes a change in the status of a peer node, a notification is sent by the CMM API.

OPTIONS

The following options are supported by nhcmmqualif:

-t timeout

Wait for a specified period of time for a MASTER ELECTED notification. If a master is elected within this period of time, nhcmmqualif is successful and returns 0. If no master is elected within this period of time, nhcmmqualif fails and returns 255.

-v

Verbose mode.

EXIT STATUS

The following exit values are returned:

0

Successful completion.

255

The current node is not master-eligible, there is already a master in the cluster, or no master was elected within the specified timeout (if -t was used).

EXAMPLES

This section contains examples of how to use the nhcmmqualif command.

Example 1. To Force Qualification of a Master-Eligible Node

When there is no current master node in the cluster and no node is qualified to be the master node:

  • Log in to a master-eligible node.

  • Run:

    # nhcmmqualif
    
    # echo $?
    0
    

The master-eligible node on which you ran the nhcmmqualif command is temporarily qualified as the master node.

If you run nhcmmqualif on a master-eligible node in a cluster with a valid master node, the node is not forced to become master and the 255 exit status is produced.

Example 2. To Requalify a Node Synchronously

Use the timeout option to requalify a node synchronously.

  • Log in to one of the master-eligible nodes.

  • Run:

    # nhcmmqualif -t timeout
    

    This command is synchronous. The option -t blocks the node until a MASTER ELECTED notification is received or the timeout is reached.

ATTRIBUTES

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

ATTRIBUTE TYPEATTRIBUTE VALUE
ArchitectureSparc
AvailabilitySUNWnhcmb
Interface StabilityEvolving

SEE ALSO

cmm_member_seizequalif(3CMM).


Netra HAS FS 2.1Go To TopLast Changed September 2004