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

Appendix F Reference Manual> F.2 Management Commands Specific to the GFS Shared File System

F.2.2 sfcadm(1M) Changes partition information settings

[SYNOPSIS]

sfcadm -r [ -a ] raw_device_file

sfcadm -L size raw_device_file

sfcadm -N raw_device_file,...

sfcadm -c { all | num } raw_device_file

sfcadm -u host[:host],... [ -g p_mds[,s_mds,mds,... ] ] [ -p p_port[,s_port ] ] [ -o keyword=value,... ] raw_device_file,...

sfcadm -m host[:host],... -g p_mds[,s_mds,mds,...] [ -p p_port[,s_port ] ] [ -o keyword=value,... ] raw_device_file,...

sfcadm -g p_mds[,s_mds,mds,...] raw_device_file

sfcadm -o keyword=value,... raw_device_file

sfcadm -p p_port[,s_port ] raw_device_file

sfcadm -h ohost nhost

sfcadm -D raw_device_file,...

sfcadm raw_device_file,...

[DESCRIPTION]

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.

[OPTIONS]

The following options can be specified:

-D raw_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.

-L size

Sets the update log area size of the log partition. For size, specify an appropriate update log area size. The unit is megabytes. Specify a value in the range from 5 to 100. The update log area must have been separated beforehand if this option is used.

-N or no options specified

Updates the node and device information for all hosts in the partition configuration data. Use this option if the minor numbers of the specified devices for hosts are different after the special file name of the file system in use has been changed or copying between partitions is performed. If all hosts have the same minor number, specify only the device information, without specifying the -N option. Then updates the file system configure information in a management partition.

-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(1M) 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 host 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 host name. In order to change host except primary and secondary, all hosts 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.

-h ohost nhost

Enables a host name to be changed. Use the "o_host n_host" syntax and specify the host names. In the file system configure information in a management partition, then, all occurrences of o_host are changed to n_host. The host names registered in the partition configuration data also change.

-m host[:host],..

Changes the node and device information in the partition configuration data to the information specified. Use a comma delimiter to specify multiple host names.
Use a colon delimiter to specify multiple host names. The multiplexed network path is used for communication path with AC and MDS, The host name of each node can be specified to four maximums.
And specifies the -g options for MDS host names.
The file system configure information in a management partition is also updated. Use this option when a file system in use is being migrated to another system.

-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=".
The file system configure information in a management partition is also updated.
You can specify the timeout of communication between nodes such as followings:
-o CON_TIMEOUT=60
For example, the timeout value of the mutilation between nodes is 60 seconds.

-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, and -c options for MDS node.
The file system configure information in a management partition is also updated.

-r raw_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[:host],...

Changes the node and device information in the partition configuration data to the information specified. Use a comma delimiter to specify multiple host names.
Use a colon delimiter to specify multiple host names. The multiplexed network path is used for communication path with AC and MDS, the host name of each node can be specified to four maximums.
In addition, the -g, and -p options can be used to change MDS host names, and port names.
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:

raw_device_file,...

Specify character-special devices for all partitions in the GFS Shared File System using a comma delimiter (,).

raw_device_file

Specify a character-special device for the representative partition of the GFS Shared File System.

[EXAMPLES]

# sfcadm -r /dev/sfdsk/gfs/rdsk/volume1

# sfcadm -r -a /dev/sfdsk/gfs/rdsk/volume1

# sfcadm -L 50 /dev/sfdsk/gfs/rdsk/volume1

# sfcadm -N /dev/sfdsk/gfs/rdsk/volume1,/dev/sfdsk/gfs/rdsk/volume2

Hosts have the same minor number.
# sfcadm /dev/sfdsk/gfs/rdsk/volume1,/dev/sfdsk/gfs/rdsk/volume2

# sfcadm -u host1,host2 -g host1,host2 -p port1,port2 /dev/sfdsk/gfs/rdsk/volume1,/dev/sfdsk/gfs/rdsk/volume2,/dev/sfdsk/gfs/rdsk/volume3

# sfcadm -m host1,host2,host3 -g host1,host2 -p port1,port2 /dev/sfdsk/gfs/rdsk/volume1,/dev/sfdsk/gfs/rdsk/volume2,/dev/sfdsk/gfs/rdsk/volume3

# sfcadm -c 3 /dev/sfdsk/gfs/rdsk/volume1

Place MDS to the all nodes.
# sfcadm -c all /dev/sfdsk/gfs/rdsk/volume1

# sfcadm -g host1, /dev/sfdsk/gfs/rdsk/volume1

Change secondary MDS to host2.
# sfcadm -g ,host2 /dev/sfdsk/gfs/rdsk/volume1

Change the priority ranking of nodes placing MDS.
# sfcadm -g host1,host2,host3 /dev/sfdsk/gfs/rdsk/volume1

# sfcadm -p sfcfs-1 /dev/sfdsk/gfs/rdsk/volume1

# sfcadm -o XXX=60 /dev/sfdsk/gfs/rdsk/volume1

# sfcadm -h host1 host2

# sfcadm -D /dev/sfdsk/gfs/rdsk/volume1

[SEE ALSO]

mkfs_sfcfs(1M), sfcadd(1M), sfcinfo(1M), sfcnewfs(1M), sfcnode(1M), sfcsetup(1M).

[NOTES]


Contents Index PreviousNext

All Rights Reserved, Copyright(C) FUJITSU LIMITED 2004