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

- NAME
- SYNOPSIS
- DESCRIPTION
- OPTIONS
- USAGE
- EXIT STATUS
- ENVIRONMENT VARIABLES
- FILES
- EXAMPLES
- ATTRIBUTES
- SEE ALSO

## NAME

> nhcrfsadm - command line tool for Reliable NFS administration

## SYNOPSIS

> `/opt/SUNWcgha/sbin/nhcrfsadm [ -hv ]`
> `/opt/SUNWcgha/sbin/nhcrfsadm -a [ -s server ]`
> `/opt/SUNWcgha/sbin/nhcrfsadm -r [ -s server ]`
> `/opt/SUNWcgha/sbin/nhcrfsadm [ -s server ] -f all`
> `/opt/SUNWcgha/sbin/nhcrfsadm [ -s server ] -f partition-name`

## DESCRIPTION

> The `nhcrfsadm` tool is a command line tool for the RNFS supervisory daemon administration.

> The `nhcrfsadm` tool performs the following tasks:

> - Authorizes or refuses the Reliable NFS to start on the vice-master node when a change of disk has been detected

> - Performs a replication of one or all of the replicated partitions

> Replication must be authorized to start on the vice-master node in the following circumstances:

> - The vice-master node has been stopped because of failure or maintenance

> - A vice-master node disk containing a replicated partition has been changed

> The demand for authorization ensures that the new vice-master node disk is not corrupted.

> While the vice-master node is rebooting, the master node `nhcrfsd` daemon asks the operator whether the `nhcrfsd` daemon on the vice-master is allowed to follow the boot procedure or not. The `nhcrfsd` daemon on the vice-master node does not start until an order is given to the `nhcrfsd` daemon on the master node.

## OPTIONS

> The following options are supported:

> -a

>   Authorize replication to start on the vice-master node. This option can be used on the master node only. Replication will start automatically.

> -f all

>   Perform a full replication of all partitions present in the RNFS configuration.

> -f partition-name

>   Perform a full replication of the partition specified by partition-name. The partition must be specified by its name, for example, `/dev/rdsk/c0t0d0s3`.

> -h

>   Display help on options.

> -r

>   Refuse permission for replication to startup on the vice-master node. This option can be used on the master node only. The `nhcrfsd` daemon on the vice-master node will stop. The vice-master disk can then be removed, replaced, and rebooted.

> -s server

>   Specify the server whose `nhcrfsd` is to be administrated. The default server is localhost. The specified machine should always be the master node.

> -v

>   Display the version and the build date of the tool.

## USAGE

> You must be logged on as superuser to run the `nhcrfsadm` command.

## EXIT STATUS

> 0

>   Command succeeded

> 1

>   Command failed

## ENVIRONMENT VARIABLES

> The `nhcrfsadm` tool uses a catalog of messages in compliance with International Language Environments (I18N) standards. The `NLSPATH` variable must contain the pattern: `/opt/SUNWcgha/lib/locale/%L/LC_MESSAGES/%N`

## FILES

> The following file is generated by the `nhcrfsadm` tool:

> `/opt/SUNWcgha/lib/locale/C/LC_MESSAGES/CRFS_ADM.cat`

>   Default catalog of messages.

## EXAMPLES

> The following examples demonstrates how `nhcrfsadm` is used.

> Example 1. To Start Replication

> > After you have changed a disk:

> > 1. Log in to the master node as superuser.

> > 2. Accept the start of replication by typing:

> >    >     # /opt/SUNWcgha/sbin/nhcrfsadm -a

> Example 2. To Resynchronize the Master Node Disk and Vice-Master Node Disk

> > 1. Log in to the master node as superuser.

> > 2. Resynchronize the master and vice-master disks.

> >    >     # nhcrfsadm -f all

## ATTRIBUTES

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

> ATTRIBUTE TYPE | ATTRIBUTE VALUE
> --- | ---
> Interface Stability | Evolving
> Availability | SUNWnhfsa, SUNWnhfsb

## SEE ALSO

> `nhcrfsd`(1M)

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.