Commands Reference, Volume 3

mkpath Command

Purpose

Adds another path to a multipath I/O (MPIO) capable device.

Syntax

mkpath -l Name [ -p Parent ] [ -w Connection ] [ -d [ -c ] ] [ -v Level ]

mkpath -h

The mkpath command defines, in the Customized Paths (CuPath) object class, configures, or both defines and configures a path for the specified device (-l Name). The path that is defined or configured is indicated by the -p Parent and -w Connection flags. Both the specified device and parent must be previously defined in the Customized Devices (CuDv) object class.

If the -d flag is specified, the mkpath command only adds (defines) the path definition to the CuPath object class with the Path_Status descriptor set to Path_Defined unless the -c flag is also specified, in which case the path is also configured. If the -d flag is not specified, the mkpath command only configures one or more paths. Configuring a path requires the path to already be defined and both the device and the parent device to already be configured.

When configuring multiple paths, this command may only be able to configure some paths and not others. If this happens, the command indicates only that this occurred. To determine which paths are still configured, the lspath command should be executed.

Attention: To protect the Configuration database, the mkpath command cannot be interrupted. Stopping this command before execution is complete could result in a corrupted database.

Flags

-c	Indicates that the path being defined should also be configured. This flag is only valid when used with the -d flag.
-d	Defines a new path to a device by adding a path definition to the CuPath object class. The new path is not configured unless the -c flag is also specified.
-h	Displays the command usage message.
-l Name	Specifies the logical device name of the device whose path(s) is being added. The path(s) to be added is qualified through the -p and -w flags.
-p Parent	Indicates the logical device name of the parent device for the path(s) to be added. This flag is required if the -d flag is specified.
-v Level	Indicates that verbose output at the indicated Level is desired. The only allowable value for this flag is debug. This provides information for diagnosing command problems.
-w Connection	Indicates the connection information associated with the path to be added. This flag is required if the -d flag is specified.

Examples

To only configure an already defined path between scsi0 and the hdisk1 device at SCSI ID 5 and LUN 0 (or connection 5,0), type:
```
mkpath -l hdisk1 -p scsi0 -w 5,0
```
The system displays a message similar to the following:
```
hdisk1 path from parent scsi0 connection 5,0 available
```
To only add to the CuPath object class a path definition between scsi0 and the hdisk1 disk device at SCSI ID 5 and LUN 0, type:
```
mkpath -d -l hdisk1 -p scsi0 -w 5,0
```
The system displays a message similar to the following:
```
hdisk1 path from parent scsi0 connection 5,0 defined
```

Files

/usr/sbin/mkpath

Contains the mkpath command.

Related Information

The lspath command.