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


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 TYPEATTRIBUTE VALUE
Interface StabilityEvolving
AvailabilitySUNWnhfsa, SUNWnhfsb

SEE ALSO

nhcrfsd(1M)


Netra HAS FS 2.1Go To TopLast Changed September 2004