Notices

Summary of amendments

Preface

1. Overview of HDLM

1.1 What is HDLM?

1.2 HDLM features

1.3 HDLM GUI Overview

1.3.1 About the Path Management window

1.3.2 About the Options window

1.3.3 About the Help window

2. HDLM Functions

2.1 Devices managed by HDLM

2.2 System configuration

2.2.1 System configuration using an FC-SAN

2.2.2 System configuration using an IP-SAN

2.3 LU configuration

2.4 Program configuration

2.5 Positions of the HDLM and MPIO drivers

2.6 Load distribution using load balancing

2.6.1 Paths to which load balancing is applied

2.6.2 Algorithms for Load Balancing

2.7 Failover and failback using path switching

2.7.1 Automatic path switching

2.7.2 Manual path switching

2.7.3 Path status transition

2.8 Monitoring intermittent errors (functionality when automatic failback is used)

2.8.1 Checking intermittent errors

2.8.2 Setting up intermittent error monitoring

2.8.3 Actions for intermittent error monitoring

2.8.4 When user operations change the intermittent error information

2.9 Detecting errors by using path health checking

2.10 Dynamic re-configuration

2.10.1 Adding an LU dynamically

2.10.2 Deleting an LU dynamically

2.11 Error management

2.11.1 Types of logs collected

2.11.2 Filtering of error information

2.11.3 Collecting error information using the utility for collecting HDLM error information (DLMgetras)

2.12 Cluster support

3. Creating an HDLM Environment

3.1 System requirements

3.1.1 Applicable models

3.1.2 Microsoft MPIO drivers

3.1.3 Related programs

3.1.4 Memory and disk space requirements

3.1.5 Number of paths guaranteed in HDLM

3.2 Flow for creating an HDLM environment

3.3 HDLM installation types

3.4 Notes on creating an HDLM environment

3.4.1 Notes on HBA and HBA driver

3.4.2 Notes on storage subsystems

3.4.3 Notes on HDLM versions

3.4.4 Notes on Windows

3.4.5 Notes on related software

3.4.6 Notes on new installations and upgrade installations

3.4.7 Notes on upgrade installation

3.5 Installing HDLM

3.5.1 Preparations for a new installation of HDLM

3.5.2 Preparations for installing HDLM by performing an unattended installation

3.5.3 Performing a new installation of HDLM

3.5.4 Upgrade installation or re-installation of HDLM

3.5.5 Migrating from HDLM 5.4 or earlier to HDLM 5.5 or later

3.5.6 Installing JRE

3.6 Checking the path configuration

3.7 Setting up HDLM

3.7.1 Preparations for setting the HDLM functionality

3.7.2 Setting the HDLM functionality by using the Options window and the set operation

3.7.3 Applying the settings and closing the windows

3.8 Setting up integrated traces

3.9 Uninstalling HDLM

3.9.1 Preparations for HDLM uninstallation

3.9.2 Notes on uninstalling HDLM

3.9.3 Uninstalling HDLM

3.9.4 Uninstalling Hitachi Network Objectplaza Trace Library (HNTRLib2)

3.9.5 Uninstalling Hitachi Network Objectplaza Trace Library (HNTRLib)

3.9.6 Clearing the Persistent Reservation

4. HDLM Operation

4.1 Notes on using HDLM

4.1.1 Using a storage management program

4.1.2 Upgrading Windows

4.1.3 Using MSCS

4.1.4 Using the EMC DMX series, EMC CX series, and HP EVA series

4.1.5 Notes on using VERITAS Backup Exec for Windows and the VERITAS NetBackup Intelligent Disaster Recovery facility

4.2 HDLM operations using the HDLM GUI

4.2.1 Notes on operating HDLM GUI windows

4.2.2 Displaying or closing the Path Management window

4.2.3 Viewing path information

4.2.4 Exporting path information to a CSV file

4.2.5 Setting the path statistics to the initial value

4.2.6 Changing the path status

4.2.7 Refreshing path information

4.2.8 Viewing or setting up the operating environment

4.2.9 Viewing the HTML manual

4.2.10 Using the HDLM GUI to perform the same operations as commands

4.3 Using commands for HDLM operations

4.3.1 Notes on using commands

4.3.2 Viewing path information

4.3.3 Changing the status of paths

4.3.4 Viewing LU information

4.3.5 Initializing statistical information for paths

4.3.6 Viewing and setting up the operating environment

4.3.7 Viewing license information

4.3.8 Updating the license

4.3.9 Viewing HDLM version information

4.3.10 Viewing HDLM component information

4.4 Using the Windows administrative tool to check path information

4.5 Starting and stopping the HDLM manager

4.5.1 Starting the HDLM manager

4.5.2 Stopping the HDLM manager

4.6 Reconfiguring the HDLM operating environment

4.6.1 Setting up an added LU and path as an HDLM management-target

4.6.2 Deleting an LU dynamically

5. Troubleshooting

5.1 Information collected by the DLMgetras utility for collecting HDLM error information

5.2 Checking error information in messages

5.3 Actions taken for a path error

5.3.1 Using the HDLM GUI to handle a path error

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

5.4 Actions taken for a program error

5.4.1 Using the HDLM GUI to handle a program error

5.4.2 Using the HDLM command (dlnkmgr) to handle a program error

5.5 Actions taken for other errors

6. GUI Reference

6.1 HDLM GUI windows

6.1.1 List of HDLM windows

6.1.2 Window transitions

6.2 Path Management window

6.2.1 Common frame

6.2.2 Tree frame

6.2.3 Configuration view in the view frame

6.2.4 Path List view in the view frame

6.3 Options window

7. Command Reference

7.1 Overview of the HDLM command (dlnkmgr)

7.2 clear (Clears the path statistics to the initial value)

7.2.1 Format

7.2.2 Parameters

7.3 help (Displays the operation format)

7.3.1 Format

7.3.2 Parameter

7.4 offline (Places a path or paths offline)

7.4.1 Format

7.4.2 Parameters

7.5 online (Places a path or paths online)

7.5.1 Format

7.5.2 Parameters

7.6 set (Sets the operating environment)

7.6.1 Format

7.6.2 Parameters

7.7 view (Displays information)

7.7.1 Format

7.7.2 Parameters

8. Utility Reference

8.1 Overview of the utilities

8.2 DLMgetras (utility for collecting HDLM error information)

8.2.1 Format

8.2.2 Parameters

8.2.3 List of collected error information

8.3 dlmpr (utility for clearing HDLM persistent reservation)

8.3.1 Format

8.3.2 Parameters

8.4 dlmprsvkey (utility for registering a HDLM persistent reservation key)

8.4.1 Format

8.4.2 Parameter

8.5 dlmchkpath (utility for checking HDLM paths)

8.5.1 Format

8.5.2 Parameters

9. Messages

9.1 Before viewing the list of messages

9.1.1 Format and meaning of message IDs

9.1.2 Terms used in messages and message explanations

9.2 HDLM command (dlnkmgr and operations) messages

9.3 HDLM GUI messages

9.4 HDLM API messages

9.5 HDLM manager messages

9.6 HDLM driver (filter component) messages

9.7 HDLM driver (core logic component) messages

9.8 HDLM management target messages

9.9 HDLM installation program messages

9.10 Messages from the DLMgetras utility for collecting HDLM error information

9.11 Messages from the dlmpr utility for canceling the HDLM persistent reserve

9.12 Messages from HDLM remote access interface

9.13 Messages from the dlmprsvkey utility for registration of the HDLM persistent reserve

9.14 Messages from the HDLM Performance Monitor

9.15 Messages from the dlmchkpath utility for checking HDLM paths

9.16 Return Codes for the HDLM remote access Interface

Appendixes

A. Functionality Differences Between HDLM Versions

A.1 Functionality differences between version 5.9.1 and versions earlier than 5.9.1

A.2 Functionality differences between versions 5.9 or later and versions earlier than 5.9

A.3 Path status transition and automatic path switching

A.4 Differences in LU dynamic removal functionality

A.5 Differences in the drive letters displayed in Windows

A.6 Differences in default values

A.7 Differences in the load balancing functionality in an MSCS environment

B. Glossary

Index

All Rights Reserved. Copyright (C) 2003, 2007, Hitachi, Ltd.