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

F.2.14 sfcnewfs(1M) Builds the GFS Shared File System

[SYNOPSIS]

sfcnewfs [ -v ] [ -N ] [ mkfs-options ] [ raw_device_file ]

sfcnewfs -C file

[DESCRIPTION]

The sfcnewfs command is a mkfs_sfcfs(1M) front end for building a GFS Shared File System. The sfcnewfs command calculates the appropriate parameters and calls mkfs_sfcfs(1M).

Interactive execution of sfcnewfs from a standard input terminal enables information about the file system to be confirmed before it is created.

[OPTIONS]

The following options can be specified:

-v

Redundant mode. Displays operations, including the passing of parameters to mkfs_sfcfs(1M).

-N

Displays the parameters to be used for creating the file system.

The file system is not actually created.

-C file

Specifies the file containing the parameters that be used for creating the file system. When this option is used, a raw_device_file parameter is not required. Other options cannot be specified. For the syntax of the parameter file, see the example.

mkfs-options

These options are used to change the default parameters passed to mkfs_sfcfs(1M).

-A

Specify this option so that the file system is configured with a representative partition that has no file data area or other partitions if a file data partition or partitions are specified with the -D option.

When the -D option is not specified, the -A option is invalid if specified.

-D raw_device_file,...

Specifies the character-special devices for a file data partition. Use a comma delimiter to specify multiple files.

-H host[:host],...

Registers the name of a host that shares the file system. If multiple nodes share the file system, use a comma delimiter to specify multiple hosts.

Hosts whose names are to be specified with host must be able to communicate with each other. MDS (meta-data server) placing nodes are selected from head of the host names specified with -H option. The numbers of MDS placing nodes are specified by the -S option.

If this option is not specified, one host name, which is that of the local node, is registered.

A maximum of four entries can be specified.

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.

-L raw_device_file

Specifies the character-special devices for the update log partition.

The portion of the update log partition not used, as an update log area becomes an unused area. Specify a partition that is the same size as the update log area.

-S all|num

Specifies the number of MDS placing nodes. MDS placing nodes are selected from head of the host names specified with -H 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(1M) 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 -H option cannot be specified.

-Z

Specify the -Z option to re-create a file system previously registered in the file system configure information in a management partition with the same configuration. If, however, the target file system is being mounted, specifying this option results in an error.

-a metasz

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

The default is about 10% of the file system size. When maxdsz has been specified, the default is set at about 10% of the maxdsz value.

A size greater than the size of the representative partition cannot be specified.

-c

A meta-data area is initialized altogether.

-d maxdsz

Specifies the maximum size of the total file data area of the file system, including additional file data partitions. The unit is megabytes. Based on the value specified for this parameter, the size of the meta-data and the update log area size are set to appropriate values that take into account additional file data partitions.

The default is the size of the file system containing the partition or partitions specified less the meta-data area size and the update log area size.

A value greater than 32 terabyte (33,554,432 megabytes) cannot be specified.

-e nblkpext

Specifies the average number of blocks that are 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.

-f free

Specifies the percentage of the file data area that only a super user is allowed to use.

The default is 10%.

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

-g logsz

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

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 than 5 megabytes, 5 megabytes is set. If the default value is greater than 50 megabytes, 50 megabytes is set.

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

-i nbpi

Specifies the byte count 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 in the range from 512 to 1,048,576.

-l maxvol

Specifies the maximum number of partitions that can make a file system built on disks. The value should include any partitions added in a future expansion with sfcadd(1M).

The default is 16.

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

-m mfree

Specifies the percentage of the V-data area that only a super user is allowed to use.

The default is 10%.

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

-n maxnode

Specifies the maximum number of nodes that share a file system built on disks. The value should include any partitions added in a future expansion with sfcnode(1M).

The default is 16.

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

-o space|time

Selects either space or time on which to base the optimization of free block allocation. space indicates space, and time indicates time.

The default is time.

[OPERAND]

The following operand can be specified:

raw_device_file

Specifies a character-special device for the representative partition. A device specified for a file data partition or the update log partition cannot be specified for the representative partition.

[EXAMPLES]

# sfcnewfs -H host1,host2 /dev/sfdsk/gfs/rdsk/volume1

# sfcnewfs -H host1,host2 -L /dev/sfdsk/gfs/rdsk/volume2 /dev/sfdsk/gfs/rdsk/volume1

# sfcnewfs -H host1,host2 -D /dev/sfdsk/gfs/rdsk/volume3, /dev/sfdsk/gfs/rdsk/volume4 /dev/sfdsk/gfs/rdsk/volume2

# sfcnewfs -S all -H host1,host2,host3,host4 /dev/sfdsk/gfs/rdsk/volume2

# sfcnewfs -S 3 -H host1,host2,host3,host4 /dev/sfdsk/gfs/rdsk/volume2

# cat paramfile
meta: /dev/sfdsk/gfs/rdsk/volume1           # representative partition
log : /dev/sfdsk/gfs/rdsk/volume2           # -L option argument
data: /dev/sfdsk/gfs/rdsk/volume3           # -D option argument
data: /dev/sfdsk/gfs/rdsk/volume4           # -D option argument
logsz: 10                                   # -g option argument
free: 10                                    # -f option argument
node: host1 host2                           # -H option argument
mdsnode: all                                # -S option argument
# sfcnewfs -v -C paramfile

[EXIT STATUS]

0 The GFS Shared File System has been created correctly.

1 An abnormal event during the execution of sfcnewfs has been detected.

10 Inappropriate options specified for sfcnewfs have been detected.

Other than above an abnormal event during the execution of mkfs_sfcfs(1M) has been detected.

[SEE ALSO]

fsck_sfcfs(1M), mkfs_sfcfs(1M), sfcadd(1M), sfcnode(1M), sfcsetup(1M), sfctune(1M).

[NOTES]

• host is necessary to be the host name of the node which constitutes the GFS Shared File System registered into the management partition by sfcsetup(1M).
• 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.
• In the GFS Shared File System, the data block size is fixed at 8192 bytes and cannot be altered.
• To re-create the GFS Shared File System by modifying its configuration, first delete the file system with sfcadm(1M).
• The file system configuration must be MDS can place in all nodes, if building the file system (if possible).
• The I/O performance of the application has influence while MDS perform meta-data area initialization after the file system start. Specify a -c option to avoid this influence.
• When using a quota function, please initialize meta-data areas with -c option.