source: gpfs_3.1_ker2.6.20/share/man/man8/mmdelfileset.8 @ 195

.TH mmdelfileset 04/06/06
mmdelfileset Command
.SH "Name"
.PP
\fBmmdelfileset\fR - Deletes a GPFS fileset.
.SH "Synopsis"
.PP
\fBmmdelfileset\fR \fIDevice\fR \fIFilesetName\fR \fB[-f]\fR
.SH "Description"
.PP
The \fBmmdelfileset\fR command deletes a GPFS fileset. The
\fBmmdelfileset\fR command fails if the fileset is currently linked into
the name space. By default, the \fBmmdelfileset\fR command fails if
the fileset contains any contents except for an empty root
directory.
.PP
The root fileset cannot be deleted.
.PP
If the deleted fileset is included in a snapshot, the fileset is
deleted from the active file system, but remains part of the file system in a
deleted state. Filesets in the deleted state are displayed by the
\fBmmlsfileset\fR command with their
names in parenthesis. If the \fB-L\fR flag is specified, the latest
including snapshot is also displayed. A deleted fileset's contents
are still available in the snapshot (that is, through some path name
containing a \fB.snapshots\fR component), since it was saved when
the snapshot was created.
\fBmmlsfileset\fR command illustrates
the display of a deleted fileset. When the last snapshot that includes
the fileset has been deleted, the fileset is fully removed from the file
system.
.PP
The delete operation fails if fileset being deleted is not
empty. You need to specify \fB-f\fR option to delete a non-empty
fileset. When \fB-f\fR is specified, all of a fileset's child
filesets are unlinked, but their content is unaffected.
.PP
For information on GPFS filesets, see the chapter
\fIPolicy-based data management for
GPFS\fR in
\fIGeneral Parallel File
System: Advanced Administration Guide\fR.
.SH "Parameters"
.PP
.RS +3
\fB\fIDevice\fR
\fR
.RE
.RS +9
The device name of the file system that contains the fileset.
.PP
File system names need not be fully-qualified. \fBfs0\fR is as
acceptable as \fB/dev/fs0\fR.
.RE
.PP
.RS +3
\fB\fIFilesetName\fR
\fR
.RE
.RS +9
Specifies the name of the fileset to be deleted.
.RE
.SH "Options"
.PP
.RS +3
\fB-f
\fR
.RE
.RS +9
Forces the deletion of the fileset. All fileset contents are
deleted. Any child filesets are first unlinked.
.RE
.SH "Exit status"
.PP
.PP
.RS +3
\fB0
\fR
.RE
.RS +9
Successful completion.
.RE
.PP
.RS +3
\fBnonzero
\fR
.RE
.RS +9
A failure has occurred.
.RE
.SH "Security"
.PP
You must have root authority to run the \fBmmdelfileset\fR
command.
.PP
You may issue the \fBmmdelfileset\fR command from any node in the GPFS
cluster.
.PP
When using the \fBrcp\fR and \fBrsh\fR commands for remote
communication, a properly configured \fB.rhosts\fR file must exist
in the root user's home directory on each node in the GPFS
cluster. If you have designated the use of a different remote
communication program on either the
\fBmmcrcluster\fR
or the
\fBmmchcluster\fR command, you must
ensure:
.RS +3
.HP 3
1. Proper authorization is granted to all nodes in the GPFS cluster.
.HP 3
2. The nodes in the GPFS cluster can communicate without the use of a
password, and without any extraneous messages.
.RE
.SH "Examples"
.RS +3
.HP 3
1. This sequence of commands illustrates what happens when attempting to
delete a fileset that is linked. 
.RS +3
.HP 3
a. mmlsfileset gpfs1
.sp
The system displays output similar to:
.sp
.nf
Filesets in file system 'gpfs1':
Name                     Status    Path\ 
fset1                    Linked    /gpfs1/fset1\ 
fset2                    Unlinked  --\ 
\ 
.fi
.sp
.HP 3
b. mmdelfileset gpfs1 fset1
.sp
The system displays output similar to:
.sp
.nf
Fileset fset1 must be unlinked to be deleted.
.fi
.sp
.HP 3
c. mmdelfileset gpfs1 fset2
.sp
The system displays output similar to:
.sp
.nf
Fileset 'fset2' deleted.
.fi
.sp
.HP 3
d. To confirm the change, issue this command:
.sp
.nf
mmlsfileset gpfs1
.fi
.sp
.sp
The system displays output similar to:
.sp
.nf
Filesets in file system 'gpfs1':
Name                     Status    Path\ 
fset1                    Linked    /gpfs1/fset1
\ 
.fi
.sp
.RE
.HP 3
2. This sequence of commands illustrates what happens when attempting to
delete a fileset that contains user files. 
.RS +3
.HP 3
a. mmlsfileset gpfs1
.sp
The system displays output similar to:
.sp
.nf
Filesets in file system 'gpfs1':
Name                     Status    Path\ 
fset1                    Linked    /gpfs1/fset1\ 
fset2                    Unlinked  --\ 
\ 
.fi
.sp
.HP 3
b. mmdelfileset gpfs1 fset2
.sp
The system displays output similar to:
.sp
.nf
Fileset 'fset2' contains user files,
but can be deleted with the "-f" option.
\ 
.fi
.sp
.HP 3
c. mmdelfileset gpfs1 fset2 -f
.sp
The system displays output similar to:
.sp
.nf
Deleting user files ...
  83 %  complete on Tue Dec 17 11:38:25 2005
  86 %  complete on Tue Dec 17 11:42:47 2005
  88 %  complete on Tue Dec 17 11:43:13 2005
  91 %  complete on Tue Dec 17 11:44:15 2005
  94 %  complete on Tue Dec 17 11:45:20 2005
  97 %  complete on Tue Dec 17 11:50:14 2005
 100 %  complete on Tue Dec 17 11:50:47 2005
Fileset 'fset2' deleted.
\ 
.fi
.sp
.HP 3
d. To confirm the change, issue this command:
.sp
.nf
mmlsfileset gpfs1
.fi
.sp
.sp
The system displays output similar to:
.sp
.nf
Filesets in file system 'gpfs1':
Name                     Status    Path\ 
fset1                    Linked    /gpfs1/fset1\ 
\ 
.fi
.sp
.RE
.RE
.SH "See also"
.PP
mmchfileset Command
.PP
mmcrfileset Command
.PP
mmlinkfileset Command
.PP
mmlsfileset Command
.PP
mmunlinkfileset Command
.SH "Location"
.PP
\fB/usr/lpp/mmfs/bin\fR