source: gpfs_3.1_ker2.6.20/share/man/man8/mmunlinkfileset.8 @ 44

.TH mmunlinkfileset 04/06/06

mmunlinkfileset Command

.SH "Name"

.PP

\fBmmunlinkfileset\fR - Removes the junction to the a GPFS

fileset.

.SH "Synopsis"

.PP

\fBmmunlinkfileset\fR \fIDevice\fR {\fIFilesetName\fR |

\fB-J\fR \fIJunctionPath\fR} \fB[-f]\fR

.SH "Description"

.PP

The \fBmmunlinkfileset\fR 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 \fB-f \fR flag is specified. The root fileset

may not be unlinked.

.PP

\fBAttention:\fR If you are using the TSM Backup Archive client you

must use caution when you unlink filesets that contain data backed up by

TSM. TSM tracks files by pathname and does not track filesets.

As a result, when you unlink a fileset, it appears to TSM that you deleted the

contents of the fileset. Therefore, the TSM Backup Archive client

inactivates the data on the TSM server which may result in the loss of backup

data during the expiration process.

.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 removed.

.RE

.PP

.RS +3

\fB-J \fIJunctionPath\fR

\fR

.RE

.RS +9

Specifies the name of the junction to be removed. 

.PP

A junction is a special directory entry that connects a name in a directory

of one fileset to the root directory of another fileset.

.RE

.SH "Options"

.PP

.RS +3

\fB-f

\fR

.RE

.RS +9

Forces the unlink to take place even though there may be open

files. This option forcibly closes any open files, causing an

\fBerrno\fR of \fBESTALE\fR on their next use of the file.

.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 \fBmmunlinkfileset\fR

command.

.PP

You may issue the \fBmmunlinkfileset\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 command indicates the current configuration of filesets for file

system \fBgpfs1\fR:

.sp

.nf

mmlsfileset gpfs1

.fi

.sp

The system displays output similar to:

.sp

.nf

Filesets in file system 'gpfs1':

Name                     Status    Path\ 

root                     Linked    /gpfs1\ 

fset1                    Linked    /gpfs1/fset

.fi

.sp

.sp

This command unlinks fileset \fBfset1\fR from file system

\fBgpfs1\fR:

.sp

.nf

mmunlinkfileset gpfs1 fset1

.fi

.sp

.sp

The system displays output similar to:

.sp

.nf

Fileset 'fset1' unlinked.

.fi

.sp

.sp

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\ 

root                     Linked    /gpfs1\ 

fset1                    Unlinked  --

.fi

.sp

.HP 3

2. This command indicates the current configuration of filesets for file

system \fBgpfs1\fR:

.sp

.nf

mmlsfileset gpfs1

.fi

.sp

The system displays output similar to:

.sp

.nf

Filesets in file system 'gpfs1':

Name                     Status    Path\ 

root                     Linked    /gpfs1\ 

fset1                    Linked    /gpfs1/fset1

.fi

.sp

.sp

This command unlinks junction path \fB/gpfs1/fset1\fR from file system

\fBgpfs1\fR:

.sp

.nf

mmunlinkfileset gpfs1 -J /gpfs1/fset1

.fi

.sp

.sp

The system displays output similar to:

.sp

.nf

Fileset 'fset1' unlinked.

.fi

.sp

.sp

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\ 

root                     Linked    /gpfs1\ 

fset1                    Unlinked  --

.fi

.sp

.RE

.SH "See also"

.PP

mmchfileset Command

.PP

mmcrfileset Command

.PP

mmdelfileset Command

.PP

mmlinkfileset Command

.PP

mmlsfileset Command

.SH "Location"

.PP

\fB/usr/lpp/mmfs/bin\fR