HiCommand Dynamic Link Manager User's Guide (for Windows(R))

5.3.2 Using the HDLM command (dlnkmgr) to handle a path error

The following shows the procedure for using the HDLM command (dlnkmgr) to handle a path error.

Organization of this subsection

(1) Examine the messages

(2) Obtain path information

(3) Identify the error path

(4) Narrow down the hardware that may have caused the error

(5) Identify the error location and correct any hardware error

(6) Place the path online

(1) Examine the messages

Examine the message that is output to the event log in the host for monitoring messages. If the KAPL08022-E message is output, view the message to check the path in which the error occurs. For details on each item displayed in the message, see 5.2 Checking error information in messages.

If an error occurred in all the paths to the LU, the KAPL08022-E message appears, in addition to the KAPL08026-E message.

When using the LU dynamic deletion functionality, the KAPL05301-E message appears if all paths are deleted.

(2) Obtain path information

Obtain path information to narrow down the hardware in which the error occurred.

Execute the following command:
>dlnkmgr view -path -iem > pathinfo.txt
pathinfo.txt is the redirection-output file name. Use a file name that matches your environment.

(3) Identify the error path

Check the obtained path information to find the error path. In the Status column, the error path has the status Offline(E) or Online(E).

(4) Narrow down the hardware that may have caused the error

Check the DskName, iLU, and ChaPort columns for the error path to narrow down the hardware that may be the cause of the error. To physically identify the hardware corresponding to DskName, iLU, and ChaPort, use the information provided by the storage-subsystem management program.

(5) Identify the error location and correct any hardware error

Use the Windows and hardware management tools to identify the error location, and then take appropriate, corrective action. If an error occurs in the path, HDLM outputs an error message to the event log of the host. Information about the path in which the error occurred is also output to the event log. For hardware maintenance, contact your hardware vendor or maintenance company if there is a maintenance contract.

(6) Place the path online

After the path recovers from the error, use the dlnkmgr command's online operation to place online the path that went offline due to the error. For details on the online operation, see 7.5 online (Places a path or paths online). Execute the following command:
>dlnkmgr online
Executing this command places all the offline paths online.

If any path cannot be placed online due to an error, the KAPL01039-W message appears. To ignore such paths and to continue processing, type y. Type n to cancel the processing.

Check the status of the paths that cannot be placed online, and take appropriate, corrective action.

Note

Even if you execute the dlnkmgr command's online operation (with the -pathid parameter) for the paths in the Offline(E) status, some paths may not be placed online. In this case, use the offline operation to change those paths from the Offline(E) status to the Offline(C) status. Then, execute the online operation. The system automatically checks whether the target paths are available, puts available paths into the Online status, and puts unavailable paths into the Offline(E) status. The paths in the Offline(E) status have not recovered from an error yet. Take corrective action for the error, and then execute the online operation again. For details on the online operation, see 7.5 online (Places a path or paths online). For details on the offline operation, see 7.4 offline (Places a path or paths offline).

If path errors occur on all of the paths, and some or all of the paths are recognized by Windows, disk numbers might then be changed from the ones that were assigned when the host started. If this happens, restarting the host will cause the disk numbers to be changed back to the ones that were assigned when the host started . After the disk numbers have changed back, use VERITAS Backup Exec for Windows or the Intelligent Disaster Recovery functionality of VERITAS NetBackup.

[Contents][Back][Next]

[Trademarks]