PRIMECLUSTER Global File Services Configuration and Administration Guide 4.1 (Linux) |
Contents
Index
![]() ![]() |
Appendix B Reference Manual | > B.2 GFS Shared File System Specific Management Commands |
sfcadm -r [-a] device_file
sfcadm -N device_file
sfcadm -u host,... [-g p_mds[,s_mds,mds,...]] [-p p_port[,s_port]] [-o keyword=value,...]device_file,...
sfcadm -m host,... -g p_mds[,s_mds,mds,...]-p p_port[,s_port] [-o keyword=value,...]device_file
sfcadm -g p_mds[,s_mds,mds,...]device_file
sfcadm -o keyword=value,... device_file
sfcadm -p p_port[,s_port] device_file
sfcadm -h ohost nhost
sfcadm -D device_file,...
sfcadm -c {all | num} raw_device_file
sfcadm device_file
The sfcadm command changes the partition information settings for the GFS Shared File System.
In the 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:
Use the command in the following cases:
The sfcadm updates the entries in the file system configure information in a management partition, 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.
The following options can be specified:
-D device_file,...
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.
-N or no options specified
Updates the node and device information for all nodes in the partition configuration data. Use this option if the minor numbers of the specified devices on each nodes are different after the special file name of the file system in use has been changed or copying between partitions is performed.
-a
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.
-c {all|num}
Change the MDS placing information. Zero or less value and value bigger than the number of nodes that share the file system cannot be specified. When all is specified, all nodes are set up as MDS placing node. If and only if all is specified, the node added to node information by sfcnode(8) after changing the MDS placing information is also set up as a MDS placing node. The file system configure information in a management partition is also updated.
-g p_mds,s_mds,mds,...
Specifies the node name that MDS can place delimited with a comma. Primary MDS and secondary MDS can be specified in order of the descriptions of node names. To change either primary MDS or secondary MDS, use the "p_mds," or ",s_mds" and specify the new node name. In order to change node except primary and secondary, all nodes must be specified.
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.
-h o_host n_host
Changes 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.
-m host,...
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 MDS node name can be specified with the -g option.
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.
-p p_port,s_port
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 change only the primary port name, specify only p_port (a comma delimiter is not required).
And specifies the -g options for MDS node. The file system configure information in a management partition is also updated.
-o keyword=value,...
Specifies a variable setting that can be tuned in the GFS Shared File System using the syntax "variable-name=value" syntax. Use a comma delimiter to specify multiple variables. When deleting a registered variable, use the specification "variable-name=". You can specify the timeout of communication between nodes such as follow. In the following example, the timeout of communication between nodes is set to 180 seconds.
-o CON_TIMEOUT=180
Changes the time after a communicative response is lost until it estimates a partner node to be an abnormal state in the monitoring of the node by communication. Please set the large value in the above-mentioned timeout of communication when it is forecast that the load of the system rises.
-r device_file
Specifies the character-special device 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.
-u host,...
Changes the node and device information in the partition configuration data to the information specified. Use a comma delimiter to specify multiple node names.
In addition, MDSnode name and a port name need to be changed by the -g and -p options.
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 device name of the file system in use has been changed or copying between partitions is performed.
The following operands can be specified:
device_file
Specifies a block special device or a character special device on the representative partition of the GFS Shared File System.
# sfcadm -r /dev/sfdsk/gfs/dsk/volume1
# sfcadm -r -a /dev/sfdsk/gfs/dsk/volume1
# sfcadm /dev/sfdsk/gfs/dsk/volume1
# sfcadm -u host1,host2 -g host1,host2 -p port1,port2 /dev/sfdsk/gfs/dsk/volume1
# sfcadm -m host1,host2,host3 -g host1,host2 -p port1,port2 /dev/sfdsk/gfs/dsk/volume1
Change the number of the nodes placing MDS to 3.
# sfcadm -c 3 /dev/sfdsk/gfs/dsk/volume1
Place MDS to the all nodes.
# sfcadm -c all /dev/sfdsk/gfs/dsk/volume1
Change primary MDS to host1.
# sfcadm -g host1, /dev/sfdsk/gfs/dsk/volume1
Change secondary MDS to host2.
# sfcadm -g ,host2 /dev/sfdsk/gfs/dsk/volume1
Change the priority ranking of nodes placing MDS.
# sfcadm -g host1,host2,host3 /dev/sfdsk/gfs/dsk/volume1
# sfcadm -p sfcfs-1 /dev/sfdsk/gfs/dsk/volume1
# sfcadm -o XXX=60 /dev/sfdsk/gfs/dsk/volume1
# sfcadm -h host1 host2
# sfcadm -D /dev/sfdsk/gfs/dsk/volume1
sfcinfo(8), sfcmkfs(8), sfcnode(8), sfcsetup(8).
Contents
Index
![]() ![]() |