mmunlinkfileset command

Removes the junction to a GPFS fileset.

Synopsis

mmunlinkfileset Device {FilesetName | -J JunctionPath} [-f]

Availability

Available on all IBM Spectrum Scale editions.

Description

The mmunlinkfileset command removes the junction to the fileset. The junction can be specified by path or by naming the fileset that is its target. The unlink fails if there are files open in the fileset, unless the -f flag is specified. The root fileset may not be unlinked.

Attention: If you are using the IBM Spectrum Protect Backup-Archive client, use caution when you unlink filesets that contain data backed up by IBM Spectrum Protect. IBM Spectrum Protect tracks files by pathname and does not track filesets. As a result, when you unlink a fileset, it appears to IBM Spectrum Protect that you deleted the contents of the fileset. Therefore, the IBM Spectrum Protect Backup-Archive client inactivates the data on the IBM Spectrum Protect server which may result in the loss of backup data during the expiration process.

For information on GPFS filesets, see the IBM Spectrum Scale: 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 removed.
-J JunctionPath
Specifies the name of the junction to be removed.

A junction is a special directory entry that connects a name in a directory of one fileset to the root directory of another fileset.

-f
Forces the unlink to take place even though there may be open files. This option forcibly closes any open files, causing an errno of ESTALE on their next use of the file.

Exit status

0
Successful completion.
nonzero
A failure has occurred.

Security

You must have root authority to run the mmunlinkfileset 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 command indicates the current configuration of filesets for file system gpfs1: 
    mmlsfileset gpfs1
    The system displays output similar to: 
    Filesets in file system 'gpfs1':
Name                     Status    Path  
root                     Linked    /gpfs1  
fset1                    Linked    /gpfs1/fset
    This command unlinks fileset fset1 from file system gpfs1: 
    mmunlinkfileset gpfs1 fset1
    The system displays output similar to: 
    Fileset 'fset1' unlinked.
    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                    Unlinked  --
  2. This command indicates the current configuration of filesets for file system gpfs1: 
    mmlsfileset gpfs1
    The system displays output similar to: 
    Filesets in file system 'gpfs1':
Name                     Status    Path 
root                     Linked    /gpfs1  
fset1                    Linked    /gpfs1/fset1
    This command unlinks junction path /gpfs1/fset1 from file system gpfs1: 
    mmunlinkfileset gpfs1 -J /gpfs1/fset1
    The system displays output similar to: 
    Fileset 'fset1' unlinked.
    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                    Unlinked  --

See also

Location

/usr/lpp/mmfs/bin