B.2.10 sfcsetup(1M) Perform the following functions: (1) Initialization of management partition. (2) Addition, deletion and display of node information. (3) Display path of management partition. (4) Registration and display of the startup mode of the sfcfrmd daemon.

sfcsetup -c [ -f ] raw_device_file

sfcsetup -a raw_device_file

sfcsetup -d

sfcsetup -m [startup_mode ]

sfcsetup -p

sfcsetup

The sfcsetup command can perform the following functions:

Initialization of management partition.
Addition, deletion and display of node information.
Display path of management partition.
Registration and display of the startup mode of the sfcfrmd daemon.

To initialize the management partition, specify the path name of the -c option and the character special file. When the specified character special file seems to have been used for the management partition, the sfcsetup command returns the error in order to prevent incorrect operation. In this case, perform initialization with the -f option specified. The size of a management partition needs to be 40 megabytes or more.

To add node information, specify the -a option. When the specified character special file that has already been initialized for the management partition, local node information is added to the management partition.

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

To register the startup mode of the sfcfrmd daemon, specify the -m option and the startup mode. When the command is executed specify the -m option without the startup mode, display the registered startup mode of the sfcfrmd daemon.

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.

The following options can be specified:

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

-f: Initialize a character special file that has been used as a management partition.

-a raw_device_file: Adds node information.

-d: Deletes node information.

-m [ startup_mode ]

Registers the startup mode of the sfcfrmd daemon specified in startup_mode. When the startup_mode is not specified, displays the registered startup mode of the sfcfrmd daemon.
The following startup mode can be specified in startup_mode. When initializing as management partition, wait is registered as startup mode of sfcfrmd daemon.

wait: When a node is started up, the startup of the sfcfrmd daemon will be suspended until it can confirm that a cluster quorum exists. Node startup also will be suspended.
You can confirm if startup of the sfcfrmd daemon is suspended by checking if the message "WARNING: sfcfsrm:5001: Starting the sfcfrmd daemon was suspended because quorum does not exist" is output.
And, when the CF is started up by the GUI, startup of the sfcfrmd daemon is given up if a quorum does not exist.

wait_bg: When a node is started up or the CF is started up by the GUI, the startup of the sfcfrmd daemon will be suspended until it can confirm that a cluster quorum exists.
This differs from wait in that node startup or CF startup will continue.
You can confirm if startup of the sfcfrmd daemon is suspended by checking if the message "WARNING: sfcfsrm:5001: Starting the sfcfrmd daemon was suspended because quorum does not exist" is output.

nowait: When a node is started up or the CF is started up by the GUI, the sfcfrmd daemon will be started even if it cannot confirm that a cluster quorum exists.
This startup mode exists for backward compatibility only.

-p: Display the path name of a management partition.

The following operand can be specified:

raw_device_file: Specifies the character special file path to be used for the management partition.

Initializing a management partition.

# sfcsetup -c /dev/sfdsk/gfs/rdsk/control <Enter>

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

# sfcsetup -c -f /dev/sfdsk/gfs/rdsk/control <Enter>

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

# sfcsetup -a /dev/sfdsk/gfs/rdsk/control <Enter>

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

# sfcsetup -d <Enter>

Registering the startup mode to wait. When a startup mode is wait, sfcfrmd daemon will be suspended until it can confirm that a cluster quorum exists, and node startup also will be suspended.

# sfcsetup -m wait <Enter>

Displaying the startup mode of the sfcfrmd daemon registered.

# sfcsetup -m <Enter>
wait

<FILES>

/var/opt/FJSVgfs/sfcfsrm.conf

Environment file of sfcfrmd daemon

sfcadm(1M), sfcfrmstop(1M)

<NOTES>

When the sfcfrmd daemon has started, can not perform the following functions:
(1) Initialization of a management partition.
(2) Addition and deletion of node information.
(3) Registering the startup mode of the sfcfrmd daemon.
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 a cluster partition condition occurs during node startup or when the CF is started by the GUI, and nowait is set as the startup mode of the sfcfrmd daemon, a data inconsistent may be caused in the GFS Shared File System.