To place paths offline

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

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

Make sure that you specify the paths to be taken offline by using the -hba, -cha, -pathid, or -device parameter.

Use this parameter to place offline, at one time, all the paths that pass through a specific HBA port. The command will place offline 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 offline all paths connected to the 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 offline -hba 0010.0000
KAPL01055-I All the paths which pass the specified HBA will be changed to the Offline(C) status. Is this OK? [y/n]:y
KAPL01056-I If you are sure that there would be no problem when all the paths which pass the specified HBA are placed in the Offline(C) status, enter y.  Otherwise, enter n. [y/n]:
KAPL01061-I 3 path(s) were successfully placed Offline(C); 0 path(s) were not. Operation name = offline
#

Use this parameter to place offline, at one time, all the paths that pass through a specific CHA port. The command will place offline all the paths that pass through the CHA port to which the path with the specified AutoPATH_ID is connected. Paths that pass through a physical CHA port on a physical storage system will be offline.

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 for managing the HDLM configuration. Always make sure that you use the view operation to find the current AutoPATH_ID of the target path, before executing the offline operation.

Example

The following example shows how to place offline all the paths connected to the CHA port 0A. In this example, a path whose AutoPATH_ID is 000001 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 offline -cha -pathid 000001
KAPL01055-I All the paths which pass the specified CHA port will be changed to the Offline(C) status. Is this OK? [y/n]:y
KAPL01056-I If you are sure that there would be no problem when all the paths which pass the specified CHA are placed in the Offline(C) status, enter y.  Otherwise, enter n. [y/n]:
KAPL01061-I 2 path(s) were successfully placed Offline(C); 0 path(s) were not. Operation name = offline
#

Use this parameter to place a single path offline.

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 for managing the HDLM configuration. Always make sure that you use the view operation to find the current AutoPATH_ID of the target path, before executing the offline operation.

Use this parameter to place offline 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 offline a path whose SCSI device name is /dev/sde while confirming command operation.

# /opt/DynamicLinkManager/bin/dlnkmgr offline -path -device /dev/sde
KAPL01052-I The currently selected paths will be changed to the Offline(C) status. Is this OK? [y/n]:y
KAPL01053-I If you are sure that there would be no problem when the path is placed in the Offline(C) status, enter y. Otherwise, enter n. [y/n]:y
KAPL01061-I 1 path(s) were successfully placed Offline(C); 0 path(s) were not. Operation name = offline

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 000001, offline without asking for confirmation of command execution from the user:

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