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

B.2.10 sfxnode(1M) - Adds or changes GFS Local File System node configuration information

[SYNOPSIS]

sfxnode raw_device_file,...
sfxnode -a -n node -i hostid raw_device_file
sfxnode -d [ -n node | -i hostid ] raw_device_file

[DESCRIPTION]

The sfxnode command adds or changes the GFS Local File System node information.

When adding nodes that share a GFS Local File System, execute sfxnode on these nodes; this will modify the node configuration information (host ID or name). The number of each special device as seen from the node is also set in the partition configuration information.

To delete node information, specify the -d option. Using the -n option, specify the host name of a node to be deleted. Alternatively, using the -i option, specify the host ID to be deleted. If neither the -n option nor the -i option is specified, node information of the node for which sfxnode is executed is deleted. In the raw_device_file field, specify a character special device for the representative partition.

When adding nodes that share a GFS Local File System, if a device cannot be opened on the switched node of the switched file system, specify the -a option to add node information. In this case, use the -n option to specify a host name of the switched node, or use the -i option to specify the host ID of the switched node. This option is specified on an active node. After specifying this option, specify the -A option with sfxadm(1M) to add partition configuration information of the GFS Local File System corresponding to the switched node.

When sfxnode is used to change partition configuration information for the GFS Local File System, the entry in /etc/sfxfstab will be updated and the information on the each partition will be changed.

[OPTIONS]

The following options can be specified:

-a

Adds node information.

-d

Deletes node information.

-n node

This option specifies a host name.

-i hostid

This option specifies a host ID with hexadecimal notation.

[OPERANDS]

The following operands can be specified:

raw_device_file,...

When add own node information to GFS Local File System (no option case), this operand specifies all character special devices of all partition; that specified the representative partition at the first; that constitute the GFS Local File System on the nodes.

raw_device_file

When option is specified, this operand specifies the character special device for the representative partition.

[EXAMPLES]

Add own node information for GFS Local File System (3 partitions configuration)

# sfxnode /dev/sfdsk/gfs/rdsk/vol0301,/dev/sfdsk/gfs/rdsk/vol0401,/dev/sfdsk/gfs/rdsk/vol0501

Add specified node information for GFS Local File System

# sfxnode -a -n moony -i 0x80fca402 /dev/sfdsk/gfs/rdsk/vol0301

Delete specified node information for GFS Local File System

# sfxnode -d -n moony /dev/sfdsk/gfs/rdsk/vol0301

[NOTES]

Although the GFS Local File System can be used on all nodes where sfxnode is executed, access it only from one of the two nodes. In other words, mount and use the GFS Local File System that is to be shared by the nodes only on one of these nodes.

If sfxnode failed and displayed the message "node full can't sfxnode", the number of registered nodes has already amounted to the maximum number of sharing nodes that was specified to create the file system. After checking the number of the registered nodes by using sfxinfo(1M) and deleting unnecessary node information by using sfxnode with -d option, add the node information.

[FILE]

/etc/sfxfstab

This file contains the names of each of the file system component partitions.

[SEE ALSO]

mkfs_sfxfs(1M), sfxadd(1M), sfxadm(1M), sfxnewfs(1M)