mkfileset

Creates a new fileset.

Read syntax diagramSkip visual syntax diagram
>>-mkfileset--+--------+--+-----------------------+------------->
              +- -?----+  '- -server--server_name-'
              +- -h----+
              '- -help-'

>--+---------------+--+----------------------+------------------>
   '- -quota--size-'  '- -thresh--percentage-'

>--+-------------------+---------------------------------------->
   |          .-soft-. |
   '- -qtype--+-hard-+-'

>--+-------------------------------------------+---------------->
   '- -attach--location-- -dir--directory_name-'

>--+----------------------+--fileset_name----------------------><
   '- -descv--description-'

Parameters

–? | –h | –help
Displays a detailed description of this command, including syntax, parameter descriptions, and examples. If you specify a help option, all other command options are ignored.
–server server_name
Specifies the metadata server to host the fileset. This name can be up to 32 characters in length.
  • If you do not specify a metadata server, the fileset is assigned to a metadata server automatically.
  • If the specified metadata server goes down, the fileset is reassigned to another metadata server automatically.
This metadata server can be in any state as long as it is part of the cluster.
–quota size
Specifies the maximum size limit, in megabytes, for the specified fileset that, when exceeded, causes the metadata server to generate an alert. You can specify a number from 0 to 1 073 741 824 MB (1 PB). The default size is 0.

If not specified or set to 0, there is no quota size limit for this fileset, and alerts are not sent.

–thresh percentage
Specifies the maximum percentage (alert threshold) of the specified quota size for this fileset that, when exceeded, causes the metadata server to generate an alert. You can specify a value between 0 and 100. The default alert percentage is 80.

If the –thresh parameter is set to 0 or if the quota size is not specified, no alerts are generated.

–qtype hard | soft
Specifies the quota type for the fileset. You can specify one of the following values:
hard
A hard quota produces a log message and potential alert when the quota is met, and denies requests for more space.
soft
A soft quota produces a log message and potential alert when the quota size is exceeded, but grants requests for more space. This is the default type.
–attach location
Specifies the existing directory path (relative to the root of the global namespace and without the / prefix) at which to attach the fileset.

The root of the global namespace must be included in the directory path. For example, to attach the fileset to the /homes location, specify –attach sanfs/homes. To attach the fileset directly to the root of the global namespace, use –attach sanfs.

Requirements: This directory must already exist. Use only forward slashes (/) in the directory path for delimiters.
Tip: If the –attach parameter is not specified, the fileset cannot be attached to the global namespace.
–dir directory_name
Specifies the directory name for the root of the fileset directory tree. This directory can be up to 256 characters in length.

The attach point (location/directory_name) appears as a drive and directory on Windows© clients or as a file system on UNIX©-based clients.
Tip: Map the name of the directory to its associated fileset by using the same name as the fileset plus an additional suffix to distinguish it as the directory and not the fileset. For example, if you want to attach the fileset named work to the root of the global namespace, specify sanfs for the location and specify work_ap for the directory_name. On a Windows® client, the work_ap directory appears under the sanfs drive.
Requirements: The directory name must not already exist. The directory must not contain backslash (\) or forward slash (/) characters as delimiters.
–desc description
Specifies a description for the fileset. The description must be enclosed in matching single (') or double (") quotation marks if it contains any blank characters. This description can be up to 256 characters in length.

The default is an empty string.

fileset_name
Specifies the name to assign to the new fileset. This name can be up to 256 characters in length.

Prerequisites

You must have Administrator privileges to use the command.

You must be logged in to the operating system on the engine hosting the master metadata server to run this command.

Description

You must attach the fileset to the global namespace using the –attach and –dir parameters in this command or the attachfileset command before clients can access the fileset.

Newly created filesets have permissions set to the following values:

  • 555 permissions when viewed from UNIX-based clients.
  • Read control (to Everyone) and Write discretionary access control list (DACL)/Owner (for administrator or root clients) from Windows-based clients.

Example

Create filesets The following example creates a fileset named cnt_A, assigns the fileset to the ST1 metadata server, sets the quota to 1 000 MB, specifies to send alerts when the quota reaches 70%, and attaches the fileset to the sanfs/homes directory.
sfscli> mkfileset -server ST1 -quota 1000 -thresh 70 –qtype soft
-attach sanfs/homes -dir cntA_ap cnt_A
Fileset "cnt_A" created.

Parent topic: Administrative commands

Related reference
autofilesetserver
attachfileset
chfileset
detachfileset
lsfileset
reportfilesetuse
rmfileset
setfilesetserver
statfileset

Terms of use | Feedback
(C) Copyright IBM Corporation 2003, 2004. All Rights Reserved.