<SYNOPSIS>
sfcmkfs [ -m ] [ -o specific_options ] device
<DESCRIPTION>
The sfcmkfs command builds the GFS Shared File System on specified disks.
Once the GFS Shared File System has been created, its entry is added to file system configure information in a management partition. Thereafter, file system configure information in a management partition is used to manage the GFS Shared File System.
<OPTIONS>
The following options can be specified.
Outputs command lines of file system creation time. The file system needs to be present.
Allows options specific to GFS Shared File System to be specified. Insert a comma delimiter between options.
Displays parameters used for creating a file system.
Does not actually create a file system.
Specifies a path name of the block special file of a file data partition.
If you use multiple file data partitions, specify the parameter for each file data partition.
Determines whether or not the file data area is detached from a representative partition. If y is specified, the file data area will not be included in the representative partition. If n is specified, the file data area will be included in the representative partition.
If this parameter is omitted, n will be selected as default.
If a file data partition is not specified for the data option, n will be selected as default.
Specifies the minimum percentage of free area in the file system.
The default is 10%.
A value can be specified in the range from 0 to 99.
Specifies the force option to re-create a file system previously registered in file system configure information in a management partition when its configuration is unchanged. If, however, the target file system is being mounted, specifying this option results in an error.
Specifies the size of the update log area. The unit is megabytes.
The default is about 1% of the file system size (if maxdsz is specified, it is taken maxdsz). If the specified value is smaller than 5 megabytes, 5 megabytes is set. If the specified value is greater than 50 megabytes, 50 megabytes is set.
A value can be specified in the range from 5 to 100.
Specifies the maximum size of the file data area of a file system that includes additional partitions. The unit is megabytes. Based on the value specified for this parameter, the size of meta-data and the update log area size are set to proper values after taking into account the additional partitions.
If this option is not specified, the sizes of meta-data area and the update log area are determined based on the file system size of the specified partition.
A minimum value is the same as default. A maximum value is 1048576 (1 terabyte).
Specifies the maximum number of nodes, including expanded nodes by sfcnode(8) in the future, that are shared in the file system configuration on disks.
The default is 16.
A value can be specified in the range from 1 to 32.
Specifies the maximum number of partitions that configure a file system on a disk including additional partitions that will be expanded with sfcadd(8).
When the value is omitted, the default value 16 will be selected.
The minimum value is 1, and the maximum value is 32.
Specifies the size of the meta-data area. The unit is megabytes.
The default is about 10% of the file system size (if maxdsz is specified, it is taken maxdsz). However, when the file system size is larger, the ratio of the meta-data area becomes smaller.
The minimum value that can be specified is same as default.
The larger value than the size of the representative partition cannot be specified because the meta-data area is allocated in the representative partition. Moreover, if the file system size is smaller than 1-terabyte, the larger value than the minimum requirement size for managing 1-mega V-data cannot be specified. When the specified value doesn't meet these requirements, either of following messages is displayed and the file system is built by the default value.
sfcmkfs:WARNING: value : bogus metasz reset |
Specifies the minimum percentage of free V-data area.
The default is 10%.
A value can be specified in the range from 0 to 99.
Specifies an average number of blocks to be managed by one extent.
This parameter is used as a fragmentation factor for the file data area.
The default is 1.
A value can be specified in the range from 1 to 100.
Specifies the byte count of data per i-node. Number of total i-nodes is decided by dividing the size of the file system's file data area by this parameter. Specify a large value for this parameter if the number of total i-nodes is to be reduced. And specify a larger value for this parameter if the meta-data area is to be saved, too.
The default is 8192 or a value adjusted as the number of total i-nodes should not exceed the maximum value (16 mega).
A value can be specified by the N power of 2. (N is a range from 9 to 20.)
Registers the name of a host that will share the file system. If multiple nodes should share the file system, specify multiple entries for this parameter using commas.
Hosts whose names are to be specified for host must be able to communicate with each other. MDS (meta-data server) placing nodes are selected in order of descriptions for this option.
Unless this option is specified, only the host name of the local node is registered.
<OPERAND>
The following operand can be specified:
Specifies a path name of the block special file on the representative partition of the GFS Shared File System.
<EXAMPLES>
# sfcmkfs -o node=host1,host2 /dev/sfdsk/gfs01/dsk/volume01 <Enter> # sfcmkfs -o dataopt=y,data=/dev/sfdsk/gfs01/dsk/volume02,data=/dev/sfdsk/gfs01/dsk/ volume03,node=host1,host2 /dev/sfdsk/gfs01/dsk/volume01 <Enter> |
<FILE>
/etc/fstab
Environment file for the file system.
<SEE ALSO>
sfcadd(8), sfcadm(8), sfcdf(8), sfcnode(8), sfcsetup(8)
fstab(5) in the online manual
<NOTES>
host must be the host name of the node configuring the GFS Shared File System registered on the management partition by sfcsetup(8) in advance.
A file system can be created only when all hosts that share the file system have started operation and GFS Shared File System has been installed. The reason is that the information for these hosts is required.
If another option is specified after a comma (,) that follows a node option, the option will have no effect because it will be interpreted as a host name.
In the GFS Shared File System, the data block size is fixed at 8192 bytes and cannot be altered.
To re-create a GFS Shared File System by modifying its configuration, first delete the file system with sfcadm(8) .
The parameter value of the metasz option that is included in the command line displayed by -m option is a value in which the size of an actual meta-data area was rounded up every a megabyte. Therefore, if the size of an actual meta-data area is same as upper limit, the following warning message might be displayed when the file system is built by using the command line displayed by -m option. However, the action is unnecessary.
sfcmkfs:WARNING: value : bogus metasz reset |
