PRIMECLUSTER Global File Services Configuration and Administration Guide 4.1 (Solaris(TM) 10 Operating System)

B.2.8 sfcnode(1M) Add, delete, and alter node configuration information

<SYNOPSIS>

sfcnode -a host,... special

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

<DESCRIPTION>

The sfcnode command adds, deletes, and changes the GFS Shared File System node 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.

To delete node information, specify the -d option. sfcnode deletes the node information of the host which is specified by the -d or -i option. 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.

After the sfcnode 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,...

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

-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 to be deleted from node information. The host must be one that can be used by the GFS Shared File System. Note that a host ID specified for this option differs from a host ID obtained with hostid(1).

<OPERANDS>

The following operand can be specified:

special

Specify path name of a character special file or a block special file for the representative partition of the GFS Shared File System whose node information is to be updated.

<EXAMPLES>

Add new node that was added by sfcsetup(1M) to the sharing nodes of the GFS Shared File System.

# sfcnode -a host2 /dev/sfdsk/gfs01/rdsk/volume01 <Enter>

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

# sfcnode -a host1,host2 /dev/sfdsk/gfs01/rdsk/volume01 <Enter>

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

# sfcnode -d -h host2 /dev/sfdsk/gfs01/rdsk/volume01 <Enter>

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

# sfcnode -d -i 80000000 /dev/sfdsk/gfs01/rdsk/volume01 <Enter>

Delete node/device information for the local host.

# sfcnode -d /dev/sfdsk/gfs01/rdsk/volume01 <Enter>

<SEE ALSO>

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

hostid(1) in the "Solaris X Reference Manual Collection".

<NOTES>

• A file system can be changed only when all hosts that share the file system have started operation and the GFS Shared File System has been installed. The reason is that the information for these hosts is required.
• host must be the host name of the node which constitutes the GFS Shared File System registered into the management partition by sfcsetup(1M).
• If sfcnode fails outputing a message as "node full, can't sfcnode," the number of nodes has exceeded the maximum number of sharing nodes set when the GFS Shared File System was created with mkfs_sfcfs(1M). Check the registered node information with sfcinfo(1M), and then add nodes after deleting node information no longer necessary using sfcnode with the -d option.
• Cannot delete node information of host that placing primary MDS, and secondary MDS.