To place paths online

Indicates that the target of the operation is a path managed by HDLM.

This parameter is optional because online is always used for paths, so it is assumed.

Make sure that you specify the path to be taken online by using the -hba, -cha, -pathid, or -device parameter. If you do not specify any of these parameters, the command will place all the offline paths online. If there is a path that cannot be placed online, a message asking whether you would like to continue processing will be displayed. To ignore the offline path that cannot be placed online and to continue processing, enter y. To stop the processing, enter n.

Use this parameter to place online, at one time, all the paths that pass through a specific HBA port. The command will place online all the paths connected to the HBA port that has the specified host port number and bus number.

Specify the host port number and bus number of the target HBA port: the numbers are found in the PathName field displayed using the view operation. Enter a period between these two parameter values. For details about the view operation, see view (displays information).

Example

The following example shows how to place online all paths connected to an HBA port whose host port number is 0010 and bus number is 0000:

When the confirmation message is displayed, the user enters y to continue, or n to cancel the operation.

# /opt/DynamicLinkManager/bin/dlnkmgr online -hba 0010.0000
KAPL01057-I All the paths which pass the specified HBA will be changed to the Online status. Is this OK? [y/n]:y
KAPL01061-I 3 path(s) were successfully placed Online; 0 path(s) were not. Operation name = online
#

Use this parameter to simultaneously place online all paths that pass through a specific CHA port. The command will place online all paths that pass through the CHA port in the path specified by the -pathid parameter. Paths that pass through a specific physical CHA port on a physical storage system will be online.

Specify the current AutoPATH_ID of the target path, which is displayed by using the view operation. For details about the view operation, see view (displays information). Leading zeros can be omitted (000001 and 1 indicate the same AutoPATH_ID); however, when the target AutoPATH_ID is 000000, enter 000000 or 0 for the parameter value.

AutoPATH_IDs are re-assigned every time the host is restarted. When you want to add a new LU without restarting the host, AutoPATH_IDs are re-assigned to each path of the LU when you execute the HDLM-configuration definition utility (dlmcfgmgr). Always make sure that you use the view operation to find the current AutoPATH_ID of the target path, before executing the online operation.

Example

The following example shows how to place online the paths connected to the CHA port 0A. In this example, a path whose AutoPATH_ID is 000002 is connected to the target CHA port:

When the confirmation message is displayed, the user enters y to continue, or n to cancel the operation.

# /opt/DynamicLinkManager/bin/dlnkmgr online -cha -pathid 000002
KAPL01057-I All the paths which pass the specified CHA port will be changed to the Online status. Is this OK? [y/n]:y
KAPL01061-I 2 path(s) were successfully placed Online; 0 path(s) were not. Operation name = online
#

Use this parameter to place a single path online.

Specify the current AutoPATH_ID of the target path, which is displayed by using the view operation. For details about the view operation, see view (displays information). Leading zeros can be omitted (000001 and 1 indicate the same AutoPATH_ID); however, when the target AutoPATH_ID is 000000, enter 000000 or 0 for the parameter value.

AutoPATH_IDs are re-assigned every time the host is restarted. When you want to add a new LU without restarting the host, AutoPATH_IDs are re-assigned to each path of the LU when you execute the dlmcfgmgr utility. Always make sure that you use the view operation to find the current AutoPATH_ID of the target path, before executing the online operation.

Use this parameter to place online a path connected to the specified SCSI device.

For SCSI-device-name, specify the value of Device displayed by executing the view operation as follows:

# /opt/DynamicLinkManager/bin/dlnkmgr view -lu

For details on how to execute the view operation and display the SCSI device name, see To display LU information. Only one case-sensitive parameter value can be specified.

Example

The following shows an example of how to place online a path whose SCSI device name is /dev/sde while confirming command operation.

# /opt/DynamicLinkManager/bin/dlnkmgr online -path -device /dev/sde
KAPL01050-I The currently selected paths will be changed to the Online status. Is this OK? [y/n]:y
KAPL01061-I 1 path(s) were successfully placed Online; 0 path(s) were not. Operation name = online
 

Specify management-target paths for each LU (P-VOL). The target LUs are the LUs that belong to a path ID that you specify in the -pathid AutoPATH_ID parameter.

Executes the command without displaying the message asking for confirmation of command execution from the user. Specify this parameter if you want to skip the response to the confirmation message: for example, when you want to execute the command in a shell script or batch file.

Example

The following example shows how to place a path, whose AutoPATH_ID is 000002, online without asking for confirmation of command execution from the user:

# /opt/DynamicLinkManager/bin/dlnkmgr online -pathid 2 -s
KAPL01061-I 1 path(s) were successfully placed Online; 0 path(s) were not. Operation name = online
#