mkpath command
Purpose
Adds to the system another path to an MPIO capable device.
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.
- 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
| Flag name | Description |
|---|---|
| -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
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,0The system displays the following message:
path available - To configure an already defined path from fscsi0 to fiber
channel disk hdisk1, type:
mkpath -dev hdisk1 -pdev fscsi0The system displays the following message:
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,0The system displays the following message:
path defined
