.TH mmremotecluster 02/16/06
mmremotecluster Command
.SH "Name"
.PP
\fBmmremotecluster\fR - Manages the information about other GPFS
clusters that this cluster can access when mounting remote GPFS file
systems.
.SH "Synopsis"
.PP
\fBmmremotecluster\fR \fBadd \fR \fIRemoteClusterName\fR
[\fB-n\fR \fIContactNodes\fR] [\fB-k\fR
\fIKeyFile\fR]
.PP
Or,
.PP
\fBmmremotecluster\fR \fBupdate\fR \fIRemoteClusterName\fR
[\fB-C\fR \fINewClusterName\fR] [\fB-n\fR
\fIContactNodes\fR] [\fB-k\fR \fIKeyFile\fR]
.PP
Or,
.PP
\fBmmremotecluster\fR \fBdelete {\fR\fIRemoteClusterName\fR\fB |
all}\fR
.PP
Or,
.PP
\fBmmremotecluster\fR \fBshow\fR [\fIRemoteClusterName\fR\fB
| all\fR]
.SH "Description"
.PP
The \fBmmremotecluster\fR command is used to make remote GPFS clusters
known to the local cluster, and to maintain the attributes associated with
those remote clusters. The keyword appearing after
\fBmmremotecluster\fR determines which action is performed:
.PP
.RS +3
\fBadd
\fR
.RE
.RS +9
Adds a remote GPFS cluster to the set of remote clusters known to the
local cluster.
.RE
.PP
.RS +3
\fBdelete
\fR
.RE
.RS +9
Deletes the information for a remote GPFS cluster.
.RE
.PP
.RS +3
\fBshow
\fR
.RE
.RS +9
Displays information about a remote GPFS cluster.
.RE
.PP
.RS +3
\fBupdate
\fR
.RE
.RS +9
Updates the attributes of a remote GPFS cluster.
.RE
.PP
To be able to mount file systems that belong to some other GPFS cluster,
you must first make the nodes in this cluster aware of the GPFS cluster that
owns those file systems. This is accomplished with the
\fBmmremotecluster add\fR command. The information that the command
requires must be provided to you by the administrator of the remote GPFS
cluster. You will need this information:
.RS +3
.HP 3
\(bu The name of the remote cluster.
.HP 3
\(bu The names or IP addresses of a few nodes that belong to the remote GPFS
cluster.
.HP 3
\(bu The public key file generated by the administrator of the remote cluster
by running the
\fBmmauth genkey\fR command for the
remote cluster.
.RE
.PP
Since each cluster is managed independently, there is no automatic
coordination and propagation of changes between clusters like there is between
the nodes within a cluster. This means that once a remote cluster is
defined with the \fBmmremotecluster\fR command, the information about that
cluster is automatically propagated across all nodes that belong to this
cluster. But if the administrator of the remote cluster decides to
rename it, or deletes some or all of the contact nodes, or change the public
key file, the information in this cluster becomes obsolete. It is the
responsibility of the administrator of the remote GPFS cluster to notify you
of such changes so that you can update your information using the appropriate
options of the \fBmmremotecluster update\fR command.
.SH "Parameters"
.PP
.RS +3
\fB\fIRemoteClusterName\fR
\fR
.RE
.RS +9
Specifies the cluster name associated with the remote cluster that owns
the remote GPFS file system. The value \fBall\fR indicates all
remote clusters defined to this cluster, when using the \fBmmremotecluster
delete\fR or \fBmmremotecluster show \fR commands.
.RE
.PP
.RS +3
\fB-C \fINewClusterName\fR
\fR
.RE
.RS +9
Specifies the new cluster name to be associated with the remote
cluster.
.RE
.PP
.RS +3
\fB-k \fIKeyFile\fR
\fR
.RE
.RS +9
Specifies the name of the public key file provided to you by the
administrator of the remote GPFS cluster. This could be relative path
(therefore just a need to name the file) or an absolute path (need full path
name, but just file name).
.RE
.PP
.RS +3
\fB-n \fIContactNodes\fR
\fR
.RE
.RS +9
A comma separated list of nodes that belong to the remote GPFS cluster, in
this format:
.sp
.nf
[tcpPort=NNNN,]node1[,node2 ...]
.fi
.sp
.PP
where: 
.RS +3
.HP 3
\(bu tcpPort=NNNN is the TCP port number to be used by the local
GPFS daemon when contacting the remote cluster. If not specified, GPFS
will use the default TCP port number 1191.
.HP 3
\(bu node1[,node2 ...] is a list of nodes that
belong to the remote cluster. The nodes can be identified through their
host names or IP addresses.
.RE
.RE
.SH "Options"
.PP
None.
.SH "Exit status"
.PP
.PP
.RS +3
\fB0
\fR
.RE
.RS +9
Successful completion. After successful completion of the
\fBmmremotecluster\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 \fBmmremotecluster\fR
command.
.PP
You may issue the \fBmmremotecluster\fR command from any node in the
GPFS cluster.
.SH "Examples"
.RS +3
.HP 3
1. This command adds remote cluster
\fBk164.kgn.ibm.com\fR to the set of remote clusters
known to the local cluster, specifying \fBk164n02\fR and \fBk164n03\fR
as remote contact nodes. File \fBk164.id_rsa.pub\fR is
the name of the public key file provided to you by the administrator of the
remote cluster.
.sp
.nf
mmremotecluster add k164.kgn.ibm.com -n k164n02,k164n03\\
 -k k164.id_rsa.pub
.fi
.sp
The output is similar to this:
.sp
.nf
mmremotecluster: 6027-1371 Propagating the changes to all\ 
affected nodes. This is an asynchronous process.
.fi
.sp
.HP 3
2. This command displays information for the remote cluster
\fBk164.kgn.ibm.com\fR.
.sp
.nf
mmremotecluster show k164.kgn.ibm.com
.fi
.sp
The output is similar to this:
.sp
.nf
Cluster name:    k164.kgn.ibm.com
Contact nodes:   k164n02,k164n03
SHA digest:      a3917c8282fca7a27d951566940768dcd241902b
File systems:    (none defined)
.fi
.sp
.sp
For more information on the SHA digest, see
\fIGeneral Parallel File System: Problem
Determination Guide\fR and search on \fISHA digest\fR.
.HP 3
3. This command updates information for the remote cluster
\fBk164.kgn.ibm.com\fR, changing the remote contact
nodes to \fBk164n02\fR and \fBk164n01\fR. The TCP port to be used
when contacting cluster \fBk164.kgn.ibm.com\fR is
defined to be 6667..
.sp
.nf
mmremotecluster update k164.kgn.ibm.com 
-n tcpPort=6667,k164n02,k164n01
.fi
.sp
The output is similar to this:
.sp
.nf
mmremotecluster: 6027-1371 Propagating the changes to all\ 
affected nodes. This is an asynchronous process.
.fi
.sp
.sp
The \fBmmremotecluster show\fR command can then be used to see
the changes.
.sp
.nf
mmremotecluster show k164.kgn.ibm.com
.fi
.sp
.sp
The output is similar to this:
.sp
.nf
Cluster name:    k164.kgn.ibm.com
Contact nodes: tcpPort=6667,k164n02,k164n01
SHA digest:      a3917c8282fca7a27d951566940768dcd241902b
File systems:    (none defined)
.fi
.sp
.sp
For more information on the SHA digest, see
\fIGeneral Parallel File System: Problem
Determination Guide\fR and search on \fISHA digest\fR.
.HP 3
4. This command deletes information for remote cluster
\fBk164.kgn.ibm.com\fR from the local cluster.
.sp
.nf
mmremotecluster delete k164.kgn.ibm.com
.fi
.sp
The output is similar to this:
.sp
.nf
mmremotecluster: 6027-1371 Propagating the changes to all\ 
affected nodes. This is an asynchronous process.
.fi
.sp
.RE
.SH "See also"
.PP
mmauth Command
.PP
mmremotefs 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