PRIMECLUSTER Global File Services Configuration and Administration Guide 4.1 (Linux)

B.2.7 sfcnode(8) Add, delete, and change node configuration information

<SYNOPSIS>

sfcnode -a host,... device_file

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

 

<DESCRIPTION>

The sfcnode command adds, deletes, and changes 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. 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.

The value which took the logical sum of the nodes ID obtained by clgetnode(8) and '0x80000000' is specified as Host ID. That is, when the node ID obtained by clgetnode(8) is 1, '0x80000001' is specified as Host ID.

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,...

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).

 

<OPERAND>

The following operand can be specified:

device_file

Specify a block special device or a character special device on 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(8) to the sharing nodes of GFS Shared File System.

# sfcnode -a host2 /dev/sfdsk/gfs/dsk/volume1

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

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

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

# sfcnode -d -h host2 /dev/sfdsk/gfs/dsk/volume1

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

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

• Delete node/device information for the local host.

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

 

<SEE ALSO>

sfcmkfs(8), sfcadm(8), sfcinfo(8),sfcsetup(8)

 

<NOTES>

• A file system can be changed only when all hosts that share the file system have started operation and 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 configuring the GFS Shared File System registered on the management partition by sfcsetup(8) in advance.
• 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 sfcmkfs(8). Check the registered node information with sfcinfo(8), 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.