<SYNOPSIS>
sfcadm -r [ -a ] special
sfcadm -N special,...
sfcadm -u host,... [ -g p_mds[,s_mds ] ] [ -p p_port[,s_port] ] [ -o keyword=value,... ] special,...
sfcadm -m host,... -g p_mds[,s_mds ] -p p_port[,s_port] [ -o keyword=value,... ] special,...
sfcadm -g p_mds[,s_mds ] special
sfcadm -o keyword=value,... special
sfcadm -p p_port[,s_port] special
sfcadm -h ohost nhost
sfcadm -D special,...
sfcadm special,...
<DESCRIPTION>
The sfcadm command changes the partition information settings for a GFS Shared File System.
In a GFS Shared File System, the information about the group of partitions that makes up the file system is retained in each partition.
Partition information settings must be changed in the following cases:
Device information (path name, device number) for the file system is changed.
Information about the nodes sharing the file system is changed.
The node name is changed.
The file system is migrated to another system.
Use the command in the following cases:
Copying a super block and the partition configuration data
Recovery if a copy of the partition configuration data no longer matches the original information
Changing the information in the file system configuration information in a management partition and deleting the file system that is specified
Change the number of placing MDS(meta-data server) nodes
Change the priority of nodes which places MDS(meta-data server) as primary MDS or secondary MDS
The sfcadm updates the entries in the file system configure information which changes the partition information for the GFS Shared File System and/or the file system environment information. If changes are made to the partition information settings, the information retained in each of the partitions is updated.
This command can only be used if the file system is unmounted in all nodes beforehand.
<OPTIONS>
The following options can be specified:
Deletes the GFS Shared File System in which the representative partition provided by file system configure information in a management partition has been registered. Use a comma delimiter to specify multiple files.
Updates the node and device information for all nodes in the partition configuration data. Use the -N option if the minor numbers of the specified devices for nodes are different after the special file name of the file system in use has been changed or copying between partitions is performed. If all nodes have the same minor number, specify only the device information, without specifying the -N option.
The file system configure information in a management partition is also updated.
When the -r option is specified, performs the recovery using a copy of the super block in the partition of the recovery source and a copy of the partition configuration data.
Specifies the node name that MDS(meta-data server) can place delimited with a comma. To change either primary MDS node or secondary MDS node, use the "p_mds," or ",s_mds" syntax and specify the new node name.
To change a configuration with only a primary MDS, specify only p_mds (a comma delimiter is not required). The file system configure information in a management partition is also updated.
The node name to be specified needs to be a node which is sharing the file system. When specified with the option -u or -m at the same time, it can only specify the node name specified as either -u or -m option.
Enables a node name to be changed. Use the o_host n_host syntax and specify the node names. In the file system configure information in a management partition, then, all occurrences of o_host are changed to n_host. The node names registered in the partition configuration data also change.
Changes the node and device information in the partition configuration data to the information specified. Use a comma delimiter to specify multiple node names.
The -m option with the option -g and -p must be specified at the same time.
This option also updates the file system configuration information on the management partition. Use this option to migrate from the current file system to another system.
Specifies a variable setting that can be tuned in the GFS Shared File System using the "variable-name=value" syntax. Use a comma delimiter to specify multiple variables.
When deleting a registered variable, use the specification "variable-name=". The file system configure information in a management partition is also updated. You can specify the timeout of communication between nodes such as followings.
For example, the timeout value of the communication between nodes is 180 seconds.
-o CON_TIMEOUT=180 |
It is revokable at time to judge the remote node that the response is lost to be abnormal by specifying CON_TIMEOUT.
When the load of the system is expected to rise, set the above-mentioned value greatly.
Specifies the primary port name and the secondary port name delimited with a comma. To change either port name, use the "p_port," or ",s_port" syntax and specify the new port name.
To assign the same port name to the primary and secondary ports, specify only p_port (a comma delimiter is not required).
The -g option must be specified when the -p option is specified.
The file system configure information in a management partition is also updated.
Specifies the path name of the character special file or the block special file that will be the recovery source when a super block and partition configuration data are restored. When the -a option is specified, redundant blocks in the specified source partition are used for restoring the data into other partitions.
Changes the node and device information in the partition configuration data to the information specified. Use a comma delimiter to specify multiple node names.
The -g option or the -p option must be specified when the -u option is specified.
The file system configure information in a management partition is also updated. Use this option when the node and device information must be rewritten after the special file name of the file system in use has been changed or copying between partitions is performed.
<OPERANDS>
The following operands can be specified:
Specify the path name of a character special file or a block special file for all partitions in the GFS Shared File System using a comma delimiter (,).
Specify the path name of a character special file or a block special file for the representative partition of the GFS Shared File System. When the -r option is specified, it can be specified any one partition which constitutes a file system.
<EXAMPLES>
Perform recovery of another partition using a partition information of the recovery source.
# sfcadm -r /dev/sfdsk/gfs01/rdsk/volume01 <Enter> |
Perform recovery of another partition using a copy of a partition information of the recovery source.
# sfcadm -r -a /dev/sfdsk/gfs01/rdsk/volume01 <Enter> |
Update the node and device information for all nodes in the partition information.
# sfcadm /dev/sfdsk/gfs01/rdsk/volume01,/dev/sfdsk/gfs01/rdsk/volume02 <Enter> |
Rewrite the node and device information in the partition information.
# sfcadm -u host1,host2 -g host1,host2 -p sfcfs-1,sfcfs-1 /dev/sfdsk/gfs01/rdsk/volume01 <Enter> |
Migrate a specific file system to another system.
# sfcadm -m host1,host2 -g host1,host2 -p sfcfs-1,sfcfs-1 /dev/sfdsk/gfs01/rdsk/volume01 <Enter> |
Change the number of nodes placing MDS.
Change primary MDS to host1.
# sfcadm -g host1, /dev/sfdsk/gfs01/rdsk/volume01 <Enter> |
Change secondary MDS to host2.
# sfcadm -g ,host2 /dev/sfdsk/gfs01/rdsk/volume01 <Enter> |
Change the priority ranking of nodes placing MDS.
# sfcadm -g host1,host2 /dev/sfdsk/gfs01/rdsk/volume01 <Enter> |
Assign the same port name to the primary and secondary ports.
# sfcadm -p sfcfs-1 /dev/sfdsk/gfs01/rdsk/volume01 <Enter> |
Register the variable XXX=60.
# sfcadm -o XXX=60 /dev/sfdsk/gfs01/rdsk/volume01 <Enter> |
Change the node name host1 to host2.
# sfcadm -h host1 host2 <Enter> |
Delete a specific file system.
# sfcadm -D /dev/sfdsk/gfs01/rdsk/volume01 <Enter> |
<SEE ALSO>
<NOTES>
A file system can be changed only when all nodes 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 nodes is required.
host is necessary to be the node name of the node which constitutes the GFS Shared File System registered into the management partition by sfcsetup(1M).
Using -u option with specified new node name or device name, -g option must be specified.
When the representation partition name of a GFS Shared File System is changed by sfcadm, or when performing the shift to other file systems, /etc/vfstab needs to be set up.
When only one node is specified as MDS node by the -g option, the file system can not be mounted on the other node individually. In this case, the file system must be mounted on all nodes by using sfcmntgl(1M). Note that the file system will be blockaded on the node which is not MDS node, when unmount, shutting down or panic occurs on the MDS node.
