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.

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. 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.
For more information, see the topic Setting the Quality of Service for I/O operations (QoS).

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 GPFS file system.

Examples

  1. This sequence of commands illustrates what happens when attempting to delete a fileset that is linked.
    1. 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 --
    2. Command:
      mmdelfileset gpfs1 fset1
      The system displays output similar to: 
      Fileset fset1 must be unlinked to be deleted.
    3. Command:
      mmdelfileset gpfs1 fset2
      The system displays output similar to: 
      Checking fileset ...
Checking fileset complete.
Deleting fileset ...
Fileset 'fset2' deleted.
    4. 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
  2. This sequence of commands illustrates what happens when attempting to delete a fileset that contains user files.
    1. 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  --
    2. Command:
      mmdelfileset gpfs1 fset2
      The system displays output similar to: 
      Fileset 'fset2' contains user files,
but can be deleted with the "-f" option.
    3. 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.
    4. 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

See also

Location

/usr/lpp/mmfs/bin
Parent topic: Command reference