source: gpfs_3.1_ker2.6.20/share/man/man8/mmimportfs.8 @ 123

.TH mmimportfs 02/16/06
mmimportfs Command
.SH "Name"
.PP
\fBmmimportfs\fR - Imports into the cluster one or more file systems that
were created in another GPFS cluster.
.SH "Synopsis"
.PP
\fBmmimportfs\fR {\fIDevice\fR | \fBall\fR} \fB-i\fR
\fIImportfsFile\fR [\fB-S\fR \fIChangeSpecFile\fR]
.SH "Description"
.PP
The \fBmmimportfs\fR command, in conjunction with the \fBmmexportfs\fR command, can be used to move into the
current GPFS cluster one or more file systems that were created in another
GPFS cluster. The \fBmmimportfs\fR command extracts all relevant
file system and disk information from the \fIExportFilesysData\fR file
specified with the \fB-i\fR parameter. This file must have been
created by the
\fBmmexportfs\fR command.
.PP
When \fBall\fR is specified in place of a file system name, any disks
that are not associated with a file system will be imported as well.
.PP
If the file systems being imported were created on nodes that do not
belong to the current GPFS cluster, the \fBmmimportfs\fR command assumes
that all disks have been properly moved, and are online and available to the
appropriate nodes in the current cluster.
.PP
If any node in the cluster, including the node on which you are running the
\fBmmimportfs\fR command, does not have access to one or more disks, use
the \fB-S\fR option to assign NSD servers to those disks.
.PP
The \fBmmimportfs\fR command attempts to preserve any NSD server
assignments that were in effect when the file system was exported.
.PP
If the file system was exported from a cluster created with a version of GPFS
prior to 2.3, it is possible that the disks of the file system are not
NSDs. Such disks will be automatically converted into NSDs by the
\fBmmimportfs\fR command.
.PP
After the \fBmmimportfs\fR command completes, use \fBmmlsnsd\fR to display the NSD server names that are
assigned to each of the disks in the imported file system. Use \fBmmchnsd\fR to change the current NSD server
assignments as needed.
.PP
After the \fBmmimportfs\fR command completes, use \fBmmlsdisk\fR to display the failure groups to which
each disk belongs. Use
\fBmmchdisk\fR to make
adjustments if necessary.
.PP
If you are importing file systems into a cluster that already contains GPFS
file systems, it is possible to encounter name conflicts. You must
resolve such conflicts before the \fBmmimportfs\fR command can
succeed. You can use the
\fBmmchfs\fR command
to change the device name and mount point of an existing file system.
If there are disk name conflicts, use the \fBmmcrnsd\fR command to define new disks and specify
unique names (rather than let the command generate names). Then replace
the conflicting disks using
\fBmmrpldisk\fR and
remove them from the cluster using \fBmmdelnsd\fR.
.SH "Results"
.PP
Upon successful completion of the \fBmmimportfs\fR command, all
configuration information pertaining to the file systems being imported is
added to configuration data of the current GPFS cluster.
.SH "Parameters"
.PP
.RS +3
\fB\fIDevice\fR | all
\fR
.RE
.RS +9
The device name of the file system to be imported. File system
names need not be fully-qualified. \fBfs0\fR is as acceptable as
\fB/dev/fs0\fR. Specify \fBall\fR to import all GPFS file
systems, as well as all disks that do not belong to a file system yet.
This must be the first parameter.
.RE
.PP
.RS +3
\fB-i \fIImportfsFile\fR
\fR
.RE
.RS +9
The path name of the file containing the file system information.
This file must have previously been created with the \fBmmexportfs\fR command.
.RE
.PP
.RS +3
\fB-S \fIChangeSpecFile\fR
\fR
.RE
.RS +9
The path name of an optional file containing disk descriptors, one per
line, in the format: 
.sp
.nf
DiskName:PrimaryServer:BackupServer:
.fi
.sp
.PP
.RS +3
\fBDiskName
\fR
.RE
.RS +9
The name of a disk from the file system being imported.
.RE
.PP
.RS +3
\fBPrimaryServer
\fR
.RE
.RS +9
The name of the primary NSD server node you want to assign to the
disk.
.RE
.PP
.RS +3
\fBBackupServer
\fR
.RE
.RS +9
The name of the backup NSD server node you want to assign to the
disk.
.RE
.PP
\fBNotes: \fR
.RS +3
.sp
.HP 3
1. You cannot change the name of a disk. You cannot change the disk
usage or failure group assignment with the \fBmmimportfs\fR command.
Use the
\fBmmchdisk\fR command for this
purpose.
.sp
.HP 3
2. All disks that do not have descriptors in \fIChangeSpecFile\fR are
assigned the NSD servers that they had at the time the file system was
exported. All disks with NSD servers that are not valid are assumed to
be SAN-attached to all nodes in the cluster. Use the \fBmmchnsd\fR command to assign new or change existing
NSD server nodes.
.RE
.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 \fBmmimportfs\fR command.
.PP
You may issue the \fBmmimportfs\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
\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"
.PP
To import all file systems in the current cluster, issue this
command:
.sp
.nf
mmimportfs all -i /u/admin/exportfile
.fi
.sp
.PP
The output is similar to this:
.sp
.nf
mmimportfs: Processing file system fs1 ...
mmimportfs: Processing disk gpfs2nsd
mmimportfs: Processing disk gpfs3nsd
mmimportfs: Processing disk gpfs4nsd
mmimportfs: Processing file system fs2 ...
mmimportfs: Processing disk gpfs1nsd1
mmimportfs: Processing disk gpfs5nsd
mmimportfs: Processing disks that do not belong to any file system ...
mmimportfs: Processing disk gpfs6nsd
mmimportfs: Processing disk gpfs1001nsd
mmimportfs: Committing the changes ...
mmimportfs: The following file systems were successfully imported:
        fs1
        fs2
mmimportfs: 6027-1371 Propagating the changes to all affected
                      nodes. This is an asynchronous process.
.fi
.sp
.SH "See also"
.PP
mmexportfs Command
.SH "Location"
.PP
\fB/usr/lpp/mmfs/bin\fR
.PP