.TH mmremotefs 02/16/06
mmremotefs Command
.SH "Name"
.PP
\fBmmremotefs\fR - Manages the information about GPFS file systems
from other clusters that this cluster can mount.
.SH "Synopsis"
.PP
\fBmmremotefs\fR \fBadd\fR \fIDevice\fR \fB-f\fR
\fIRemoteDevice\fR \fB-C\fR \fIRemoteClusterName\fR \fB-T\fR
\fIMountPoint\fR [\fB-A {yes | \fR\fB\fIno\fR\fR\fB |
automount}\fR] [\fB-o\fR \fIMountOptions\fR]
.PP
Or,
.PP
\fBmmremotefs\fR \fBdelete {\fR\fIDevice\fR\fB | all | \fR
\fB-C\fR \fIRemoteClusterName\fR\fB}\fR
.PP
Or,
.PP
\fBmmremotefs\fR \fBshow\fR [\fIDevice\fR\fB | all |
\fR\fB-C\fR \fIRemoteClusterName\fR]
.PP
Or,
.PP
\fBmmremotefs\fR \fBupdate\fR \fIDevice\fR [\fB-f\fR
\fIRemoteDevice\fR] [\fB-C\fR \fIRemoteClusterName\fR]
[\fB-T\fR \fIMountPoint\fR] [\fB-A {yes | \fR\fB\fIno\fR\fR\fB | automount}\fR] [\fB-o\fR
\fIMountOptions\fR]
.SH "Description"
.PP
The \fBmmremotefs\fR command is used to make GPFS file systems that
belong to other GPFS clusters known to the nodes in this cluster, and to
maintain the attributes associated with these file systems. The keyword
appearing after \fBmmremotefs\fR determines which action is
performed:
.PP
.RS +3
\fBadd
\fR
.RE
.RS +9
Define a new remote GPFS file system.
.RE
.PP
.RS +3
\fBdelete
\fR
.RE
.RS +9
Delete the information for a remote GPFS file system.
.RE
.PP
.RS +3
\fBshow
\fR
.RE
.RS +9
Display the information associated with a remote GPFS file system.
.RE
.PP
.RS +3
\fBupdate
\fR
.RE
.RS +9
Update the information associated with a remote GPFS file system.
.RE
.PP
Use the \fBmmremotefs\fR command to make the nodes in this cluster aware
of file systems that belong to other GPFS clusters. The cluster that
owns the given file system must have already been defined with the \fBmmremotecluster\fR command. The
\fBmmremotefs\fR command is used to assign a local name under which the
remote file system will be known in this cluster, the mount point where the
file system is to be mounted in this cluster, and any local mount options that
you may want.
.PP
Once a remote file system has been successfully defined and a local device
name associated with it, you can issue normal commands using that local name,
the same way you would issue them for file systems that are owned by this
cluster.
.SH "Parameters"
.PP
.RS +3
\fB\fIDevice\fR
\fR
.RE
.RS +9
Specifies the name by which the remote GPFS file system will be known in
the cluster.
.RE
.PP
.RS +3
\fB-C \fIRemoteClusterName\fR
\fR
.RE
.RS +9
Specifies the name of the GPFS cluster that owns the remote GPFS file
system.
.RE
.PP
.RS +3
\fB-f \fIRemoteDevice\fR
\fR
.RE
.RS +9
Specifies the actual name of the remote GPFS file system. This is
the device name of the file system as known to the remote cluster that owns
the file system.
.RE
.SH "Options"
.PP
.RS +3
\fB-A {yes | \fB\fIno\fR\fR | automount}
\fR
.RE
.RS +9
Indicates when the file system is to be mounted:
.PP
.RS +3
\fByes
\fR
.RE
.RS +9
When the GPFS daemon starts.
.RE
.PP
.RS +3
\fBno
\fR
.RE
.RS +9
Manual mount. This is the default.
.RE
.PP
.RS +3
\fBautomount
\fR
.RE
.RS +9
When the file system is first accessed.
.RE
.RE
.PP
.RS +3
\fB-o \fIMountOptions\fR
\fR
.RE
.RS +9
Specifies the mount options to pass to the mount command when mounting the
file system. For a detailed description of the available mount options,
see \fIGPFS-specific mount options\fR in \fIGPFS: Administration and Programming Reference\fR.
.RE
.PP
.RS +3
\fB-T \fIMountPoint\fR
\fR
.RE
.RS +9
Indicates the local mount point for the remote GPFS file system.
.RE
.SH "Exit status"
.PP
.PP
.RS +3
\fB0
\fR
.RE
.RS +9
Successful completion. After successful completion of the
\fBmmremotefs\fR command, the new configuration information is propagated
to all nodes in the cluster.
.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 \fBmmremotefs\fR command.
.PP
You may issue the \fBmmremotefs\fR command from any node in the GPFS
cluster.
.SH "Examples"
.PP
This command adds remote file system \fBgpfsn\fR, owned by remote
cluster \fBk164.kgn.ibm.com\fR, to the local cluster,
assigning \fBrgpfsn\fR as the local name for the file system, and
\fB/gpfs/rgpfsn\fR as the local mount point. 
.sp
.nf
mmremotefs add rgpfsn -f gpfsn -C k164.kgn.ibm.com -T /gpfs/rgpfsn
.fi
.sp
.PP
The output is similar to this:
.sp
.nf
mmremotefs: 6027-1371 Propagating the changes to all affected
                      nodes. This is an asynchronous process.
.fi
.sp
.PP
The \fBmmremotefs show\fR command can be used to see the changes.
.sp
.nf
mmremotefs show rgpfsn
.fi
.sp
.PP
The output is similar to this:
.sp
.nf
Local Name  Remote Name Cluster name  Mount Point Mount Options Automount
rgpfsn      gpfsn      k164n.kgn.ibm.com   /gpfs/rgpfsn rw,mtime,noatime no
.fi
.sp
.SH "See also"
.PP
mmauth Command
.PP
mmremotecluster Command
.PP
\fIAccessing GPFS file systems from other
GPFS clusters\fR in
\fIGeneral Parallel
File System: Advanced Administration Guide\fR.
.SH "Location"
.PP
\fB/usr/lpp/mmfs/bin\fR
.PP