admiopath(1M) DG/UX 5.4R3.00 admiopath(1M)
NAME
admiopath - manage multi path I/O
SYNOPSIS
admiopath -o add [ -sb ] -k backup-path primary-path
admiopath -o delete [ -k backup-path ] primary-path
admiopath -o modify [ -sb ] [ -k backup-path ] -n new-path primary-
path
admiopath -o list [ -lqv ] [ primary-path ... ]
admiopath -o start [ primary-path ... ]
admiopath -o stop [ primary-path ... ]
admiopath -o switch -i inactive-path primary-path
admiopath -o repaired -r repaired-path primary-path
DESCRIPTION
The admiopath command is used to manage multi path I/O. There are
operations provided for maintaining the iopath.params database, as
well as operations for starting and stopping the multi-path I/O
relationship between devices, and switching between I/O paths. A LAN
primary I/O path can only have one backup I/O path associated with
it.
Once the primary and backup I/O paths have been added to the
iopath.params database, the system can start to use multi-path I/O
for those paths. In the event of a failure on the primary I/O path,
the operating system will automatically switch to a backup I/O path.
This change in I/O path will be transparent to the users of the
system.
The system administrator can manually switch I/O paths if desired, or
start and stop multi-path I/O relationships on a system.
Additionally, when a failed path is repaired, the administrator can
inform the system of this fact.
In all operations the path that is specified as the primary is used
as a key for database searches. The database relationship is not
changed if a backup path is being used instead of the primary path.
The list operation will show which path in the relationship is
currently active.
Operations
add Add an iopath.params database entry. The add operation
creates an entry in the iopath.params(4M) database for the
specified primary and backup I/O paths. It can optionally
start the multi-path I/O relationship for these paths.
delete Delete an iopath.params database entry. The delete
Licensed material--property of copyright holder(s) 1
admiopath(1M) DG/UX 5.4R3.00 admiopath(1M)
operation terminates the specified multi-path I/O
relationship and deletes the entry from the iopath.params
database.
modify Modify an iopath.params database entry. The modify
operations allows the user to change either the primary-
path or any of the backup I/O paths for the specified
iopath.params database entry. This operations can
optionally stop and restart multi-path I/O for the modified
entry.
list List iopath.params database entries. The list operation
reports the following information to stdout:
name of the primary I/O path
flag indicating if relationship is started on system reboot
name of the backup I/O path
name of the backup I/O path
name of the currently active I/O path
With the "verbose" format (-v), information is printed in
aligned columns with headers. With the "quiet" format (-q)
headers are suppressed and each iopath.params database
entry is printed on a separate line. If both -q and -v are
specified, the output will be in "quiet" format.
start Start multi-path I/O. This operation starts the multi-path
I/O relationship for the specified paths. If the paths are
LAN controllers and a failovermon(1M) monitor is not
running, this operation will start the failovermon(1M)
monitor to control the LAN redirection.
stop Stop multi-path I/O. This operation stops the multi-path
I/O relationship for the specified paths.
switch Switch to an inactive I/O path. The switch operation is
used to manually switch I/O from the currently active path
to an inactive one.
repaired Inform the appropriate driver that a path in a multi-path
I/O relationship has been repaired. This operation should
be used after the failed device has been replaced and
reconfigured into the system.
Options
The following option must be used with the add operation, and can be
used with the delete and modify operations:
-k backup-path
The name of the backup I/O path for the relationship. This
can be a space separated list of devices to be assigned as
backups for the specified primary I/O path. A LAN primary
I/O path can have only one backup I/O path assigned to it.
Licensed material--property of copyright holder(s) 2
admiopath(1M) DG/UX 5.4R3.00 admiopath(1M)
The following option must be used with the modify operation:
-n new-path
The name of the new I/O path to assign to the iopath.params
database entry. If no backup-path argument is given to the
modify operation, this new-path will replace the specified
primary I/O path in the database entry. If a backup-path
name is given, this new-path will replace the backup-path
in the database entry.
The following option can be used with the add or modify operations:
-s Start now. If specified on an add operation the specified
multi-path I/O relationship will be started when the add
operation completes. If specified on a modify operation, a
multi-path I/O relationship currently in effect for the
modified iopath.params entry will be stopped and restarted
with the new information.
-b Start on reboot. If specified the multi-path I/O
relationship will be started when the system is rebooted.
This is controlled by the rc.failover script.
The following options can be used with the list operation:
-l LANs. List iopath.params information about entries that are
for multi-path LAN I/O.
-q Quiet. Produce an unformatted listing with no headers,
fields delimited by a single space.
-v Verbose. Produce a formatted listing with headers and
aligned columns. This option is the default.
EXAMPLE
The following command line is used to add hken1 as a secondary I/O
path to hken0 and start using multi-path I/O:
admiopath -o add -s -k hken1 hken0
The following command line is used to switch to the secondary I/O
path:
admiopath -o switch -i hken1 hken0
The following command line is used to stop multi-path I/O and delete
the iopath.params database entry:
admiopath -o delete hken0
FILES
/etc/iopath.params
Licensed material--property of copyright holder(s) 3
admiopath(1M) DG/UX 5.4R3.00 admiopath(1M)
DIAGNOSTICS
Warnings
- An attempt was made to start multi-path I/O when it has
already been started.
Errors
- An attempt was made to add or modify a backup I/O path that is
not of the same type as the primary I/O path.
- An attempt was made to switch to a currently active I/O path.
- An attempt was made to add a backup I/O path that is already
assigned to a primary I/O path.
- An attempt was made to add, delete, modify, list, or switch a
backup I/O path that does not exist.
- An attempt was made to add a backup I/O path to a primary I/O
path that does not exist.
- An attempt was made to add a backup I/O path to a primary I/O
path that already has the maximum number of backup I/O paths
assigned to it.
- An attempt was made to start a multi-path relationship on two
currently active I/O paths.
Exit Codes
0 The operation was successful.
1 The operation was unsuccessful.
2 The operation failed due to access restrictions.
3 There was an error in the command line.
SEE ALSO
failovermon(1M), iopath.params(4M)
Licensed material--property of copyright holder(s) 4