Document Outline

• User Guide for AIX®
• Contents
• Preface
  • Intended audience
  • Product version
  • Release notes
  • Document revision level
  • Document organization
  • Referenced documents
  • Document conventions
  • Convention for storage capacity values
  • Getting help
  • Comments
• Overview of HDLM
  • What is HDLM?
  • HDLM Features
• HDLM Functions
  • Devices Managed by HDLM
  • System Configuration
  • LU Configuration
  • Program Configuration
  • Position of the HDLM Driver and hdisk
  • Distributing a Load Using Load Balancing
    • Paths to which load balancing is applied
    • Load Balancing Algorithms
  • Performing Failovers and Failbacks Using Path Switching
    • Automatic path switching
    • Manual path switching
    • Path status transition
  • Monitoring intermittent errors (functionality when automatic failback is used)
    • Checking intermittent errors
    • Setting up intermittent error monitoring
    • Intermittent Error Monitoring Actions
    • When a User Changes the Intermittent Error Information
  • Detecting errors by using path health checking
  • Distributing a Load by Using the Dynamic I/O Path Control Function
    • What is the Dynamic Load Balance Control Function
    • Dynamic I/O Path Control Function
  • Error management
    • Types of Collected Logs
    • Filtering of error information
    • Collecting error information using the utility for collecting HDLM error information (DLMgetras)
    • Collecting installation error information using the utility for collecting HDLM installation error information (dlmgetrasinst)
  • Collecting Audit Log Data
    • Categories and Audit Events that HDLM Can Output to the Audit Log
    • Requirements for Outputting Audit Log Data
    • Destination and Filtering of Audit Log Data
    • Audit Log Data Formats
  • Integrated HDLM management using Global Link Manager
  • Cluster support
• Creating an HDLM Environment
  • HDLM System Requirements
    • Host and OS Support for HDLM
    • Storage Systems Supported by HDLM
    • Cluster Software Supported by HDLM
    • Memory and Disk Capacity Requirements
    • Number of LUs and Paths That Are Supported in HDLM
  • Flow for Creating an HDLM Environment
  • Types of HDLM Installation
  • Notes on Creating an HDLM Environment
    • Notes on Installing HDLM
    • Notes on an Upgrade Installation or Re-installation of HDLM
    • Notes on the Virtual I/O Server
    • Notes on a License Key
    • Notes on Trace Files
    • Notes on Storage Systems
    • Notes on the Cluster
    • Notes on the Automatic Failback
    • Notes on the queue_depth Parameter Value for an HDLM-Managed device
  • Installing HDLM
    • Available Installation Methods
    • Preparations for a New Installation of HDLM
    • Performing a New Installation of HDLM
    • Preparations for an Upgrade Installation or Re-installation of HDLM
    • Performing an Upgrade Installation or Re-installation of HDLM
    • Migrating from HDLM Version 5.8.1 or Earlier to Version 5.9 or Later
    • Installing HDLM in a PowerHA 5.5 or PowerHA 6.1 Environment
    • Installing HDLM in a PowerHA 7.1 Environment
    • Performing an Unattended Installation of HDLM
  • Checking the Path Configuration
  • Setting up HDLM
    • Checking the Current Settings
    • Setting Up the HDLM Functions
    • Checking the Updated Settings
  • Setting up Integrated Traces
    • Notes on Using the Hitachi Network Objectplaza Trace Library
    • Displaying the Hitachi Network Objectplaza Trace Library setup menu
    • Changing the Size of Integrated Trace Files
    • Changing the Number of Integrated Trace Files
    • Changing the Buffer Size Per Monitoring Interval Duration
    • Adjusting the Number of Messages to be Output Per Monitoring Interval
    • Finishing the Hitachi Network Objectplaza Trace Library Settings
    • Applying the Hitachi Network Objectplaza Trace Library Settings
  • About the Reservation Policy
  • Settings for Using PowerHA
    • Storage System Settings
    • Registering the HDLM Script for PowerHA
    • Setting the Reservation Policy
  • Settings for Using GPFS
  • Settings for Using Oracle RAC 10g or Oracle RAC 11g
    • Settings for MISSCOUNT and DISKTIMEOUT
    • Settings for Reservation Policy
  • Settings for Using VCS
  • Removing HDLM
    • Preparations for HDLM Removal
    • Removing HDLM
    • Removing Hitachi Network Objectplaza Trace Library (HNTRLib2)
    • Removing Hitachi Network Objectplaza Trace Library (HNTRLib)
    • Canceling Cluster Software (PowerHA) Settings
• HDLM Operation
  • Notes on Using HDLM
    • Displaying Path Information
    • When a Path Error Is Detected
    • Storage System
    • Notes on Shutting Down a Host
    • Notes on Errors in a Host
    • Notes on Enabling Both Primary and Secondary Volumes to Be Viewed From the Same Server
    • Notes on an LVM Mirror Configuration
    • Notes on When the OS Functionality in Not Available in a Boot Disk Environment
    • Notes on Replicating a System
  • HDLM Operations Using Commands
    • Notes on Using Commands
    • Viewing Path Information
    • Changing the Status of Paths
    • Viewing LU Information
    • Displaying the Correspondences Between hdisks, OS Management Path IDs, and LDEVs
    • Initializing Statistical Information for Paths
    • Viewing and Setting Up the Operating Environment
    • Viewing License Information
    • Updating the License
    • Viewing HDLM Version Information
    • Viewing HDLM Component Information
  • Starting and Stopping the HDLM Manager
    • Starting the HDLM Manager
    • Stopping the HDLM Manager
  • HDLM Resident Processes
  • Changing the Configuration of the HDLM Operating Environment
    • Changing an HDLM Management-Target Device
    • Changing hdisk attributes
    • Changing a Path
    • Replacing an HBA
    • Replacing a Fiber Cable
    • Replacing a Fibre Channel Switch
• Troubleshooting
  • Information Collected by the DLMgetras Utility for Collecting HDLM Error Information
  • Checking error information in messages
  • What To Do for a Path Error
    • Examining the messages
    • Obtain path information
    • Identifying the Error Path
    • Narrowing Down the Hardware That Might Have Caused the Error
    • Identifying the Error Location and Correcting any Hardware Errors
    • Placing the Path Online
  • What To Do for a Program Error
    • Examining the Messages
    • Obtaining Program Information
    • What To Do for the Program Error
    • Contacting your HDLM Vendor or Maintenance Company
  • What To Do for Other Errors
• Command Reference
  • Overview of the HDLM Command dlnkmgr
  • clear (Returns the Path Statistics to the Initial Value)
    • Format
    • Parameters
  • help (Displays the Operation Format)
    • Format
    • Parameter
  • offline (Places Paths Offline)
    • Format
    • Parameters
  • online (Places Paths Online)
    • Format
    • Parameters
  • set (Sets Up the Operating Environment)
    • Format
    • Parameters
  • view (Displays Information)
    • Format
    • Parameters
• Utility Reference
  • Overview of the Utilities
  • DLMgetras Utility for Collecting HDLM Error Information
    • Format
    • Parameters
    • List of Collected Error Information
  • dlmchpdattr Utility for Changing HDLM Default Settings
    • Format
    • Parameters
  • dlmgetrasinst Utility for Collecting HDLM Installation Error Information
    • Format
    • Parameters
    • List of Collected Error Information
  • dlminstcomp Utility for HDLM Component Installation
    • Format
    • Parameter
  • dlmmigsts Utility for Assisting HDLM Migration
    • Format
    • Parameters
  • dlmodmset Utility for Setting the HDLM Execution Environment ODM
    • Format
    • Parameters
  • dlmpostrestore Utility for HDLM Restoration Support
    • Format
    • Parameters
  • dlmpr Utility for Clearing HDLM Persistent Reservation
    • Format
    • Parameters
  • dlmpreremove Utility for Executed Before Removing HDLM
    • Format
    • Parameters
  • dlmrmdev Utility for Deleting HDLM Drivers
    • Format
    • Parameters
  • installhdlm Utility for Installing HDLM
    • Format
    • Parameters
    • Items To Be Defined in an installation-information Settings File
    • Log file
  • installux.sh Utility for HDLM Common Installer
    • Format
    • Parameters
    • Log file
• Messages
  • Before Viewing the List of Messages
    • Format and Meaning of Message IDs
    • Terms Used in Messages and Message Explanations
    • Components that Output Messages to syslog
  • KAPL01001 to KAPL02000
  • KAPL03001 to KAPL04000
  • KAPL04001 to KAPL05000
  • KAPL05001 to KAPL06000
  • KAPL06001 to KAPL07000
  • KAPL07001 to KAPL08000
  • KAPL08001 to KAPL09000
  • KAPL09001 to KAPL10000
  • KAPL10001 to KAPL11000
  • KAPL11001 to KAPL12000
  • KAPL13001 to KAPL14000
  • KAPL15001 to KAPL16000
  • Return Codes for Hitachi Command Suite Common Agent Component
• Functional Differences Between Versions of HDLM
  • Functional Differences Between Version 6.2 and Versions Earlier than 6.2
  • Functional Differences Between Version 6.1 and Versions Earlier than 6.1
  • Functional Differences Between Version 6.0 or Later and Versions Earlier than 6.0
• Differences Between HDLM Version 5.9 or Later and Version 5.8.1 or Earlier
  • Add-in HDLM Driver Module
  • Simplifying the HDLM Environment Configuration and Operation Procedures by Changes to the Logical Device Files
  • Changing the HDLM Environment Configuration and Operation Procedures by Changes to the Logical Device Files
  • Migrating Reservation Control Settings
  • Support for a Boot Disk Environment
  • About Settings when Upgrading the OS
    • Eliminating Settings when Upgrading the OS
    • Eliminating Settings when Changing the Kernel Mode
  • Changing a Virtual I/O Server's Method of Recognizing Virtual SCSI Disks
• Acronyms and abbreviations
• Glossary
• Index