mkpath Command
Purpose
Adds to the system another path to an MPIO capable device.
Syntax
mkpath { [ -dev Name ] [ -pdev Parent ] [ -conn Connection ] } [ -def ]
Description
The mkpath command defines, and possibly configures,
one or more paths to the target device (-dev Name). The paths are identified by a combination of the -dev Name, -pdev Parent, and -conn Connection flags. Both the target device and parent must be previously defined
in the system to define a path. They both must be AVAILABLE to configure a
path.
If the -def flag is specified,
the mkpath command only defines the new path definition
to the system. If the -def flag is not specified, the mkpath command attempts to define the path, if it does not
already exist, before it attempts to configure the path. Configuring a path
requires the path to already be defined and both the device and the parent
device to already be configured.
The mkpath command displays a status message upon
completion. It is possible for some paths to configure and others to fail.
Note that not all devices will be able to have paths manually defined by
using the mkpath command. These limitations are due
to the way that path information is stored for these devices. Fiber channel
devices fall into this category.
The mkpath command provides status messages about
the results of operation. Messages in one of the following formats will be
generated:
- path [ available | defined ]
- This message is displayed when mkpath is run on
a single path. If the path is successfully configured the message path
available is displayed. If the path is not successfully configured and
there is no explicit error code returned by the method, the message path defined is displayed.
- paths available
- This message is displayed if multiple paths were identified and all
paths were successfully configured.
- some paths available
- This message is displayed if multiple paths were identified, but only
some of them were successfully configured.
- no paths processed
- This message is generated if no paths were found matching the selection
criteria.
Flags
| -conn Connection |
Indicates the connection information associated with
the path to be added. This flag is required if the -def flag
is specified. |
| -def |
Defines a new path to a device by adding a path definition
to the system. The new path will not automatically be configured when the -def flag is specified. Note that only one path may be defined
at a time. The -conn and the -pdev flags are required when the -def flag is used. |
| -dev Name |
Specifies the logical device name of the target device
to which the path(s) are being added. The path(s) to be added are qualified
by the -pdev and -conn flags. |
| -pdev Parent |
Indicates the logical device name of the parent device
associated with the path(s) to be added. This flag is required if the -def flag is specified. |
Exit Status
See Virtual I/O Server command exit status.
Examples
- To define and configure an already defined path between scsi0 and the hdisk1 device at SCSI ID 5 and LUN 0 (connection 5,0), enter:
mkpath -dev hdisk1 -pdev scsi0 -conn 5,0
The system displays a message
similar to the following:
path available
- To configure an already defined path from fscsi0 to
fiber channel disk hdisk1, type:
mkpath -dev hdisk1 -pdev fscsi0
The system displays a message similar to the following:
path available
- To only add to the Customized Paths object class a path definition between scsi0 and the hdisk1 disk device at SCSI ID 5 and LUN 0, enter:
mkpath -def -dev hdisk1 -pdev scsi0 -conn 5,0
The system displays a message similar to the following:
path defined
Related Information
The lspath command
and the rmpath command.