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

F.2.27 sfcsetup(1M) Initializes the management partition; adds, deletes, displays path of the management partition

[SYNOPSIS]

sfcsetup -c [ -f ] raw_device_file

sfcsetup -a raw_device_file

sfcsetup -a -r nodename

sfcsetup -d

sfcsetup -d -r hostid

sfcsetup -p

sfcsetup

[DESCRIPTION]

The sfcsetup command is used to initialize the management partition, and to add, delete, and display node information in the management partition, and display the path of management partition.

To initialize the management partition, specify the -c option and the character device. When the specified device seems to have been user for the management partition, perform initialization with the -f option specified. The size of a management partition needs to be 40 Mbyte or more.

To add node information, specify the -a option. Specify the special file of the initialized management partition, and execute sfcsetup.

To delete node information, specify the -d option. Note, however, that sfcfrmd demon must be stopped in all node of the cluster foundation.

To register or delete node information for a node other than the sfcsetup execution node, specify the -r option and the target node by using nodename or hostid. The specification for deleting node information for a node other than the sfcsetup execution node is used when the other node cannot be started.

When the command is executed with -p options specified, display the path name of a management partition.

When the command is executed with no options specified, a listing of the node information recorded in the management partition is displayed.

When addition of node information and deletion are performed by the sfcsetup command, add/delete entries of management partition to/from the sfcfsrm.conf file.

[OPTIONS]

The following options can be specified:

-c

Initializes the partition specified in raw_device_file for use as a management partition.

-a

Adds node information.

-d

Deletes node information.

-f

Initialize a character special device that has been used as a management partition.

-p

Display the path name of a management partition.

-r

Adds or deletes node information of another node.

Node information addition of another node can be executed only if the sfcfrmd daemon has been started in the configuration node. The cluster setup must be completed in the node to be added, and the system must be restarted.

Node information deletion of another node can be executed only if the sfcfrmd daemon has not been started in the configuration node. Use this option if the node for which node information is to be deleted cannot be started.

[OPERAND]

The following operand can be specified:

raw_device_file

Specifies the character special device to be used for the management partition.

nodename

Specifies the CF node name of the node for which node information is to be added.

hostid

Specifies the host ID of the node for which node information is to be deleted.

[EXAMPLES]

Initializing a management partition.

# sfcsetup -c /dev/sfdsk/gfs/rdsk/control

When you display node information registered in the management partition.

# sfcsetup
HOSTID          CIPNAME         MP_PATH
80f1ab32        host1RMS        yes
80f1ab33        host2RMS        yes

Initializing a parturition that has previously been used as a management partition.

# sfcsetup -c -f /dev/sfdsk/gfs/rdsk/control

When sfcfrmd is not running in all node of the cluster, and adding information for a node.

# sfcsetup -a /dev/sfdsk/gfs/rdsk/control

When sfcfrmd is not running in the cluster, and deleting information for a node.

# sfcsetup -d

The following example adds configuration node information for the CF node named sunny while the sfcfrmd daemon is started.

# sfcsetup -a -r sunny

[FILE]

/var/opt/FJSVsfcfs/sfcfsrm.conf

Environment file of sfcfrmd daemon

[SEE ALSO]

sfcadm(1M), sfcfrmstop(1M).

clexec(1M), cip.cf(4) in manual page of PRIMECLUSTER Cluster Foundation.

[NOTES]

• Initialization of a management partition, deletion of node information cannot be performed when the sfcfrmd demon has started.
• Node information used by a file system cannot be deleted. Please delete the file system configuration information related the node in a management partition by sfcadm(1M).
• If you are adding node information while the sfcfrmd daemon is started, do not start or stop a cluster configuration node until the node addition process is completed.
• If you are adding node information while the sfcfrmd daemon is started and a cluster configuration node goes down during the addition process, an error message indicating that the node information is already registered may be displayed.