sun.com | docs.sun.com |  | How To Buy | My Sun | Worldwide Sites |

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 Commands | nhcmmqualif(1M)

- NAME
- SYNOPSIS
- DESCRIPTION
- OPTIONS
- EXIT STATUS
- EXAMPLES
- ATTRIBUTES
- SEE ALSO

## 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 TYPE | ATTRIBUTE VALUE
> --- | ---
> Architecture | Sparc
> Availability | SUNWnhcmb
> Interface Stability | Evolving

## SEE ALSO

> `cmm_member_seizequalif`(3CMM).

Netra HAS FS 2.1 | Go To Top | Last Changed September 2004

Company Info | Contact | Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.