mmdelfs command

Removes a GPFS file system.

Synopsis

mmdelfs Device [-p]

Availability

Available on all IBM Storage Scale editions.

Description

The mmdelfs command removes all the structures for the specified file system from the nodes in the cluster.

Important: If the file system to be deleted is authorized to be used by remote clusters, you must complete these tasks before you use the mmdelfs command:
  • Use the mmauth deny command on the storage cluster to deny any remote cluster the authority to mount the file system. For more information, see mmauth command.
  • Use the mmremotefs delete on the remote clusters to delete their linkage and clean up their configuration. When the remote mount is not removed, it can cause stale configuration entries on the remote clusters that might lead to unexpected behavior. For more information, see mmremotefs command.

Results

Upon successful completion of the mmdelfs command, these tasks are completed on all nodes:
  • Deletes the character device entry from /dev.
  • Removes the mount point directory where the file system had been mounted.

Parameters

Device
The device name of the file system to be removed. File system names need not be fully-qualified. fs0 is as acceptable as /dev/fs0.

This must be the first parameter.

-p
Indicates that the disks are permanently damaged and the file system information should be removed from the GPFS cluster data even if the disks cannot be marked as available.

Exit status

0
Successful completion.
nonzero
A failure has occurred.

Security

You must have root authority to run the mmdelfs 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

To delete file system fs0, issue this command: 
mmdelfs fs0
The system displays information like the following: 
GPFS: 6027-573 All data on the following disks of fs0 will be destroyed:
    gpfs9nsd
    gpfs10nsd
    gpfs15nsd
    gpfs17nsd
GPFS: 6027-574 Completed deletion of file system fs0.
mmdelfs: 6027-1371 Propagating the cluster configuration data to all
  affected nodes.  This is an asynchronous process.

See also

Location

/usr/lpp/mmfs/bin