PRIMECLUSTER Global File Services Configuration and Administration Guide 4.2 (Solaris(TM) Operating Environment)

F.2.15 sfcnode(1M) Adds, deletes, and alters node configuration information

[SYNOPSIS]

sfcnode -a host[:host],... raw_device_file

sfcnode -d [ -h host,... | -i hostid,... ] raw_device_file

[DESCRIPTION]

The sfcnode command adds, deletes, and changes GFS Shared File System node configuration information.

To add or update node information, specify the -a option. If a specified host name already exists, sfcnode updates node and device information for the host. If the host does not exist, sfcnode adds the node and device information. Use a comma delimiter to specify multiple host names.

Node information can be added while the target file system is mounted or unmounted. If the target file system is unmounted, multiple host names can be specified. When specifying multiple host names, separate the host names with commas.

If all is specified as the MDS distribution node setting of the file system, the node added by sfcnode is also set as an MDS distribution node.

If node information addition is interrupted before completion because of a system failure or other error, the target file system is managed correctly as the processing-ongoing status for node information addition.

You can use sfcinfo(1M) to check whether the file system is the processing-ongoing status for node information addition.

A processing-ongoing status is set only when node information addition is executed while the target file system is mounted.

Execute node information update while the target file system is unmounted.

To delete node information, specify the -d option. For the -h or -i option, specify the host name (host) or host ID (hostid) of the host to be deleted. sfcnode deletes the node information of the host. If neither the -h nor -i option is specified, sfcnode deletes the node information for the host on which the sfcnode is executed. Use a comma delimiter to specify multiple host names or IDs. The -h and -i options cannot be specified together.

Execute node information deletion while the target file system is unmounted.

After the sfcnode command changes the GFS Shared File System node information, the entries in the file system configure information in a management partition are updated. The information retained in the partitions is also changed.

[OPTIONS]

The following options can be specified:

-a host[:host],...

Specifies the name of a host whose node information is to be added.

Use a colon delimiter to specify multiple host names. The multiplexed network path is used for communication path with AC and MDS.

If the target file system is mounted, one host name can be specified. If the file system is unmounted, up to four host names can be specified.

-d

Deletes node information.

-h host,...

Specifies the name of a host whose node information is to be deleted. The host must be one that can be used by the GFS Shared File System.

-i hostid,...

Specifies the ID in hexadecimal of a host whose node information is to be deleted. The host must be one that can be used by the GFS Shared File System.

[OPERAND]

The following operand can be specified:

raw_device_file

Specify a character-special device for the representative partition of the GFS Shared File System whose node information is to be updated.

[EXAMPLES]

The following example shows the specification for adding host1 as a new shared node to a mounted GFS Shared File System (/dev/sfdsk/gfs/rdsk/volume1).

# sfcnode -a host1 /dev/sfdsk/gfs/rdsk/volume1

The following example shows the specification for adding host1 and host2 as new shared nodes to an unmounted GFS Shared File System (/dev/sfdsk/gfs/rdsk/volume1).

# sfcnode -a host1,host2 /dev/sfdsk/gfs/rdsk/volume1

Add or update node/device information for hosts by specifying host names.

# sfcnode -a host1, host2 /dev/sfdsk/gfs/rdsk/volume1

Delete node/device information for hosts by specifying host names.

# sfcnode -d -h host1,host2 /dev/sfdsk/gfs/rdsk/volume1

Delete node/device information for a host by specifying its ID.

# sfcnode -d -i 80000000 /dev/sfdsk/gfs/rdsk/volume1

Delete node/device information for the local host.

# sfcnode -d /dev/sfdsk/gfs/rdsk/volume1

[SEE ALSO]

mkfs_sfcfs(1M), sfcadd(1M), sfcadm(1M), sfcinfo(1M), sfcnewfs(1M), sfcsetup(1M).

[NOTES]

• A file system can be changed only when all hosts that share the file system have started operation and the sfcfrmd daemon has been started in all nodes in the scope of nodes sharing the file system. The reason is that the information for these hosts is required.
• For node information to be added while the file system is mounted, the target file system must be mounted in the node in which sfcnode is to be executed.
• host is necessary to be the host name of the node which constitutes the GFS Shared File System registered into the management partition by sfcsetup(1M).
• If sfcnode command output message "node full, can't sfcnode" and failed, exceeded the maximum number of sharing nodes when making GFS Shared File System by sfcnewfs(1M). Check registered node information by sfcinfo(1M) , and then add node after delete no need node information by sfcnode -d option.
• Cannot delete node information of host that placing primary MDS, and secondary MDS.
• If sfcnode terminates abnormally, and the target file system is an processing-ongoing status for node information addition, re-execute sfcnode to complete the process.
• Do not mount or unmount the target file system while sfcnode is being executed.