mkfset
Use the mkfset command to create a fileset that is associated with a file system on a Storwize V7000 File Module storage system. With filesets, you can use functions such as snapshots or quotas within a file system. You must have Administrator authority to use this command.
The new fileset is empty except for a root directory, and is not shown in the directory name space until you run the linkfset command. When you create a fileset, you can establish policies and quotas on the fileset before you link the fileset to the name space. You can create a maximum of 10,000 filesets for each file system.
Syntax
Parameters and arguments
- -user user_name
- Specifies an IBM Spectrum Control user ID.
- -pwd password
- Specifies the password for the IBM Spectrum Control user ID.
- -url url
- Specifies the Device server. The format of the URL is system:port_number, where system represents either the host name or IP address, and port_number represents the IBM Spectrum Control Device server port.
- -name name
- Specifies the name of the fileset.
- -filesystem file_system_id
- Specifies the IBM Spectrum Control file system key. The file system key is listed in the ID column of the lsfs command output.
- -owner owner_file_set_name
- Specifies the name of the independent fileset where the new file set is allocated. This parameter is mutually exclusive with the -independent parameter. Both filesets must belong to the same file system.
- -independent
- Specifies whether you want to create an independent fileset with its own allocated inodes. Otherwise, the fileset is created as a dependent fileset, and is allocated on the file system or in an independent fileset. This parameter is mutually exclusive with the -owner parameter.
- -comment comment
- Specifies a comment that displays in the output of the lsfset command. The length of this comment can be a maximum of 255 characters. You must enclose comments in double quotation marks.
- -numInodes max_num_inodes[:num_inodes_preallocate]
- Specifies the maximum number of files for a new, independent file
set. This parameter can be used only with the -independent parameter.
The num_inodes_preallocate variable specifies the
number of inodes that the system immediately preallocates. You can
specify values in thousands (k) or in millions (M). To specify values
of 100 million for the max_num_inodes variable
and 1million for the num_inodes_preallocate variable,
enter -numInodes 100M:1M.
GPFS defines a minimum number of inodes, which might be greater than the maximum specified. The default values for the fileset are 1million (1 M) for the max_num_inodes variable and 50,000 (50 K) for the num_inodes_preallocate variable.
- -fs character
- Specifies the 7-bit character that separates the information in the output. If you omit this parameter, the information is separated by blank spaces.
- -header
- Suppresses the column headings in the output. If you omit this parameter, the column headings are included.
- -help | -h | -?
- Lists help information for the command.
- -qs character
- Specifies the 7-bit character that surrounds character strings and date stamps in the output. If you omit this parameter, character strings and date stamps are enclosed by double quotation marks (").
- -silent
- Suppresses all output for the command. If you omit this parameter, output is included.
Example: Create a file system
tpctool> mkfset -name eefset
-filesystem eefs+kq458mv.ibm+00000200A2A0153C+0
-user admin -pwd password -url localhost:9550
The following output is returned:
FilesetId Status
==================================================
eefset+eefs+kq458mv.ibm+00000200A2A0153C+0 SUCCESS