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

B.1.6 mkfs_sfxfs(1M) - Builds the GFS Local File System

[SYNOPSIS]

mkfs -F sfxfs [ generic_options ] [ -o specific_options ] raw_device_file

[DESCRIPTION]

The mkfs command configures the GFS Local File System on the specified disk.

In GFS Local File System, update logs can be allocated to another partition so as to enhance file system performance. In this case, it is recommended to use a dedicated physical device for the update logs.

In GFS Local File System, multi-partition file systems can be specified. This makes it possible to configure a large file system independent of the physical disk size.

In GFS Local File System, the data block size for each file system is specified as 8,192 bytes.

An entry is registered with /etc/sfxfstab that a GFS Local File System is configured. /etc/sfxfstab is used for management of a GFS Local File System.

The Parameter generic_options is supported for the generic mkfs command.

See the description of mkfs(1M) options.

[OPTIONS]

-o

Specifies the GFS Local File System specific suboptions, commas delimit suboptions.

N

This option specifies a parameter that is used to create a file system.

The file system is not actually created by this option.

data=raw_device_file

This option specifies a character special device of data partition.

When configuring a data partition with multiple partitions, specify this parameter multiple times as required.

log=raw_device_file

This option specifies a character special device of update log partition.

Specify a partition that accommodates the size of the update log area, because, except the area used as an update log area, the area of update log partition remains unused.

free=n

This option specifies the minimum percentage of free areas in the file system.

The default value is 10%.

A value can be specified in the range from 0 to 99.

mfree=n

This option specifies the minimum percentage of free areas in the V-data area.

The default value is 10%.

Values from 0 to 99 can be used here.

nbpi=n

This option specifies the data size per i-node in units of bytes.

The default value is 8,192.

Specify a larger value when saving a metadata area.

Values from 512 to 1,048,576 can be used here.

opt=s|t

This option specifies whether to optimize space or time.

The parameter s indicates space, t indicates time.

The default value is t.

maxnode=n

This option specifies the maximum number of nodes sharing the file system, including also the case that the file system is in the future expanded with sfxnode(1M).

The default value is 16.

Values from 1 to 16 can be used here.

maxvol=n

This option species the maximum number of file system component partitions, including also the case that the file system is in the future expanded with the sfxadd(1M).

The default value is 16.

Values from 1 to 32 can be used here.

maxdsz=n

This option specifies the maximum size of the data areas for each file system, including also the case that a data partition is to be added.

This parameter is to be specified in megabyte.

A value larger than 1 terabyte (1,048,576 megabyte) cannot be used here.

metasz=n

This option specifies the size of each metadata area.

This parameter is to be specified in megabyte.

A value that exceeds the size of the representative partition cannot be used here.

logsz=n

This option specifies the size of each update log area.

The default is about 1% of the file system size. When maxdsz has been specified, the default is about 1% of the maxdsz value. If the default value is smaller 5 megabyte, 5 megabaytes is set. If the default value is greater than 50 megabyte, 50 megabytes is set.

A value can be specified in the range from 5 to 100.

nblkpext=n

This option specifies the average number of blocks that have to be managed in each extent.

This value can be used to calculate data area fragmentation.

The default value is 1.

A value can be specified in the range from 1 to 100.

dataopt=y|n

This option specifies whether or not a data area is included in a representative partition if a data partition is specified.

If y is specified, a data area is not included in a representative partition.

If n is specified, a data area is included.

If a data partition has not been specified, n is used regardless of the specification of this option.

The default is n.

[OPERAND]

raw_device_file

This file contains the names of each of the file system component partitions.

[EXAMPLES]

# mkfs -F sfxfs /dev/sfdsk/gfs/rdsk/vol0301

# mkfs -F sfxfs -o log=/dev/sfdsk/gfs/rdsk/vol0601 /dev/sfdsk/gfs/rdsk/vol0301

# mkfs -F sfxfs -o data=/dev/sfdsk/gfs/rdsk/vol0403,data=/dev/sfdsk/gfs/rdsk/vol0504 /dev/sfdsk/gfs/rdsk/vol0305

[FILE]

/etc/sfxfstab

This file contains the names of each of the file system component partitions.

[SEE ALSO]

sfxadd(1M), sfxnewfs(1M), sfxnode(1M), sfxtune(1M), fs_sfxfs(4)

fsck(1M), mkfs(1M), attributes(5).