mmdelfileset command
Deletes a GPFS™ fileset.
Synopsis
mmdelfileset Device FilesetName [-f] [--qos QOSClass]
Availability
Available with IBM Spectrum Scale™ Standard Edition or higher.
Description
The mmdelfileset command
deletes a GPFS fileset. When
deleting a fileset, consider these points:
- The root fileset cannot be deleted.
- A fileset that is not empty cannot be deleted unless the -f flag is specified.
- A fileset that is currently linked into the namespace cannot be deleted until it is unlinked with the mmunlinkfileset command.
- A dependent fileset can be deleted at any time.
- An independent fileset cannot be deleted if it has any dependent filesets or fileset snapshots.
- Deleting a dependent fileset that is included in a fileset or global snapshot removes it from the active file system, but it remains part of the file system in a deleted state.
- Deleting an independent fileset that is included in any global snapshots removes it from the active file system, but it remains part of the file system in a deleted state.
- A fileset in the deleted state is displayed in the mmlsfileset output with the fileset name in parenthesis. If the -L flag is specified, the latest including snapshot is also displayed. The --deleted option of the mmlsfileset command can be used to display only deleted filesets.
- The contents of a deleted fileset are still available in the snapshot, through some path name containing a .snapshots component, because it was saved when the snapshot was created.
- When the last snapshot that includes the fileset has been deleted, the fileset is fully removed from the file system.
For information on GPFS filesets, see Information Lifecycle Management for GPFS in IBM Spectrum Scale: Advanced Administration Guide.
Parameters
- Device
- The device name of the file system that contains the fileset.
File system names need not be fully-qualified. fs0 is as acceptable as /dev/fs0.
- FilesetName
- Specifies the name of the fileset to be deleted.
- -f
- Forces the deletion of the fileset. All fileset contents are deleted. Any child filesets are first unlinked.
- --qos QOSClass
- Specifies the Quality of Service for I/O operations (QoS) class
to which the instance of the command is assigned. If you do not specify
this parameter, the instance of the command is assigned by default
to the maintenance QoS class. This parameter has
no effect unless the QoS service
is enabled. For more information, see the topic mmchqos
command in the IBM
Spectrum Scale: Administration
and Programming Reference. Specify
one of the following QoS classes:
- maintenance
- This QoS class is typically configured to have a smaller share of file system IOPS. Use this class for I/O-intensive, potentially long-running GPFS commands, so that they contribute less to reducing overall file system performance.
- other
- This QoS class is typically configured to have a larger share of file system IOPS. Use this class for administration commands that are not I/O-intensive.
Exit status
- 0
- Successful completion.
- nonzero
- A failure has occurred.
Security
You must have root authority to run the mmdelfileset command.
The node on which the command is issued must be able to execute remote shell commands on any other node in the cluster without the use of a password and without producing any extraneous messages. For more information, see Requirements for administering a file system in IBM Spectrum Scale: Administration and Programming Reference.
Examples
- This sequence of commands illustrates what happens when attempting
to delete a fileset that is linked.
- Command:
mmlsfileset gpfs1
The system displays output similar to:Filesets in file system 'gpfs1': Name Status Path root Linked /gpfs1 fset1 Linked /gpfs1/fset1 fset2 Unlinked --
- Command:
mmdelfileset gpfs1 fset1
The system displays output similar to:Fileset fset1 must be unlinked to be deleted.
- Command:
mmdelfileset gpfs1 fset2
The system displays output similar to:Checking fileset ... Checking fileset complete. Deleting fileset ... Fileset 'fset2' deleted.
- To confirm the change, issue this command:
mmlsfileset gpfs1
The system displays output similar to:Filesets in file system 'gpfs1': Name Status Path root Linked /gpfs1 fset1 Linked /gpfs1/fset1
- Command:
- This sequence of commands illustrates what happens when attempting
to delete a fileset that contains user files.
- Command:
mmlsfileset gpfs1
The system displays output similar to:Filesets in file system 'gpfs1': Name Status Path root Linked /gpfs1 fset1 Linked /gpfs1/fset1 fset2 Unlinked --
- Command:
mmdelfileset gpfs1 fset2
The system displays output similar to:Fileset 'fset2' contains user files, but can be deleted with the "-f" option.
- Command:
mmdelfileset gpfs1 fset2 -f
The system displays output similar to:Checking fileset ... Checking fileset complete. Deleting user files ... 100.00 % complete on Wed Feb 15 11:38:05 2012 Deleting fileset ... Fileset 'fset2' deleted.
- To confirm the change, issue this command:
mmlsfileset gpfs1
The system displays output similar to:Filesets in file system 'gpfs1': Name Status Path root Linked /gpfs1 fset1 Linked /gpfs1/fset1
- Command: