PRIMECLUSTER Global File Services Configuration and Administration Guide 4.1 (Linux)

B.1.3 sfcmkfs(8) Construct the GFS Shared File System

<SYNOPSIS>

sfcmkfs [-m] [-o specific_options] device_file

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

-m

Outputs command lines of file system creation time. The file system needs to be present.

- o specific_options

Allows options specific to GFS Shared File System to be specified. Insert a comma delimiter between options.

N

Displays parameters used for creating a file system. Does not actually create a file system.

free=n

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.

force

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.

logsz=n

Specifies the size of the update log area. The unit is megabytes.

The default is about 1% of the file system size. 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.

maxnode=n

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.

mdsnode=all|num

Specifies the number of MDS placing nodes. MDS placing nodes are selected from head of the host names specified with node option. 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 constructing the file system is also set up as a MDS placing node.

The default is 2.

0 or less value and value bigger than the number of nodes specified with node option cannot be specified.

metasz=n

Specifies the size of the meta-data area. The unit is megabytes.

The default is about 10% of the file system size.

The use ratio of the meta-data area decreases by growing of the file system size when the meta-data area size is not specified.

The size of the meta-data area shall not exceed the size of the representative partition.

mfree=n

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.

nblkpext=n

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.

nbpi=n

Specifies the byte count of data per i-node. Specify a larger value for this parameter if the meta-data area is to be saved.

The default is 8192.

A value can be specified by the N power of 2. (N is a range from 9 to 20.)

node=host,...

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:

device_file

Specifies a block special device or a character special device on the representative partition of the GFS Shared File System.

<EXAMPLES>

# sfcmkfs -o node=host1,host2 /dev/sfdsk/gfs/dsk/volume1

<FILE>

/etc/fstab

Environment file for the file system.

<SEE ALSO>

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) .