Document Outline

• User Guide (for Linux(R))
• 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
    • System Configuration Using an FC-SAN
    • System Configuration Using an IP-SAN
  • LU Configuration
  • Program Configuration
  • Position of the HDLM Driver and HDLM Device
  • Logical Device Files for HDLM Devices
  • 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
  • Error Management
    • Types of Collected Logs
    • Filtering of Error Information
    • Collecting Error Information Using the Utility for Collecting HDLM Error Information (DLMgetras)
    • Utility for Collecting HDLM Installation Error Information (installgetras)
  • 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
    • Hosts and OSs Supported by HDLM
    • Storage Systems Supported by HDLM
    • Related Products When Using Red Hat Enterprise Linux AS4/ES4
    • Related Products When Using Red Hat Enterprise Linux 5
    • Related Products When Using Red Hat Enterprise Linux 6
    • Related Products When Using SUSE LINUX Enterprise Server 9
    • Related Products When Using SUSE LINUX Enterprise Server 10
    • Related Products When Using SUSE LINUX Enterprise Server 11
    • Related Products When Using Oracle Enterprise Linux 4
    • Related Products When Using Oracle Enterprise Linux 5
    • Memory and Disk Capacity Requirements
    • Number of Paths Supported in HDLM
    • Virtual Environments Supported by HDLM
  • Flow for Creating an HDLM Environment
  • HDLM Installation Types
  • Knowledge Required Before You Install HDLM
  • Notes on Creating an HDLM Environment
    • Notes on Hardware Settings
    • Notes on Linux
    • Notes on Installing HDLM
    • Notes on an Upgrade Installation or Re-installation of HDLM
    • Notes on a Device Manager Agent
  • Installing HDLM
    • Preparations for a New Installation of HDLM
    • Performing a New Installation of HDLM
    • Preparations for an Upgrade Installation or Re-installation of HDLM
    • Performing a Re-installation of HDLM
    • Performing an Upgrade Installation of HDLM
    • Unattended Installation of HDLM
  • Installing HDLM for Managing Boot Disks
    • Notes on Installing HDLM in a Boot Disk Environment
    • Overview of the Procedure for Installing HDLM in a Boot Disk Environment
    • Settings for Using an HDLM Device as a Boot Disk
    • Upgrade Installation in an Environment Where an HDLM Device Is Used as a Boot Disk
    • Settings for Using a Logical Volume (LVM2) on an HDLM Device as a Boot Disk
    • Upgrade Installation in an Environment Where a Logical Volume (LVM2) on an HDLM Device Is Used as a Boot Disk
    • Countermeasures for Unsuccessful Startup of the OS from an HDLM Device
  • Settings for LUKS
    • Notes on Using LUKS
    • Using HDLM in an LUKS Environment
  • Settings for md Devices
    • Notes on Setting Up md Devices
    • Creating an md Device
    • Using HDLM in an md Device Environment
  • Settings for LVM2
    • Notes on Using LVM2
    • When Using an HDLM Device to Create a New Logical Volume
    • When Moving a Logical Volume Created on a SCSI Device in a Single-Path Environment to an HDLM Device
  • Settings for Xen
  • Settings for KVM
  • Settings for Heartbeat
  • Settings for Oracle RAC
  • Settings for the RHCM
    • Notes on Using RHCM
    • When Using Red Hat Enterprise Linux AS4/ES4
    • When Using Red Hat Enterprise Linux 5, or Red Hat Enterprise Linux 6
  • Settings for VCS
  • Checking the Path Configuration
  • Setting Up HDLM
    • Checking the Current Settings
    • Setting Up the HDLM Functions
    • Checking the Updated Settings
  • The Process-specific-trace Information File
    • Notes on Using the Hitachi Network Objectplaza Trace Library
  • Creating a Character-Type Device File for an HDLM Device
    • When Using Red Hat Enterprise Linux 5 or Red Hat Enterprise Linux 6
    • When Using Red Hat Enterprise Linux AS4/ES4 or SUSE LINUX Enterprise Server
  • Creating File Systems for HDLM (When Volume Management Software Is Not Used)
    • Mounting a File System
    • Creating a File System
  • Settings for Automatic Mounting
    • Setting the HDLM Device for the First Time
    • Migrating from an Environment Where a SCSI Device Is Already Set
  • Canceling the Settings for HDLM
    • Operations on HDLM-Managed Devices
    • Canceling the Heartbeat Settings
    • Canceling the Settings for Oracle RAC
    • Canceling the Settings for RHCM
    • Canceling the Settings for VCS
    • Canceling the Xen Settings
    • Canceling the KVM Settings
    • Canceling the Settings for LVM2
    • Canceling the md Device Settings
    • Canceling the LUKS Settings
    • Uninstalling HDLM
    • Uninstalling Hitachi Network Objectplaza Trace Library (HNTRLib2)
• HDLM Operation
  • Notes on Using HDLM
    • Notes Common to OSs
    • Notes When Using Red Hat Enterprise Linux AS4/ES4, or Oracle Enterprise Linux 4
    • Notes When Using Red Hat Enterprise Linux 5, Red Hat Enterprise Linux 6, or Oracle Enterprise Linux 5
    • Notes When Using SUSE LINUX Enterprise Server 9
    • Notes When Using SUSE LINUX Enterprise Server 10
    • Notes When Using SUSE LINUX Enterprise Server 11
  • Updating Kernel Packages and Applying OS Update Packages
    • Environment Where an HDLM Device Is not Used as the Boot Disk
    • Environment Where an HDLM Device Is Used as the Boot Disk
    • Environment Where a Logical Volume (LVM2) on an HDLM Device Is Used as the Boot Disk
  • HDLM Operations Using Commands
    • Notes on Using Commands
    • Viewing Path Information
    • Changing the Status of Paths
    • Viewing LU Information
    • Displaying Corresponding Information About an HDLM Device, SCSI Device, and LDEV
    • 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
  • Reconfiguring the HDLM Operating Environment
    • Replacing HBAs
    • Replacing a Fiber Cable
    • Replacing the Fibre Channel Switch
    • Changing the HDLM Device Configuration
    • About Creating a New HDLM Device
    • Note on adding a BladeSymphony I/O drawer
• 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 Error
    • 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 (To display program information)
• Utility Reference
  • Overview of the Utilities
  • DLMgetras Utility for Collecting HDLM Error Information
    • Format
    • Parameters
    • List of Collected Error Information
  • dlmcfgmgr Utility for Managing the HDLM Configuration
    • Format
    • Parameters
  • dlmmkinitrd Utility for Supporting a Boot Disk
    • Format
    • Parameters
  • dlmpr Utility for Clearing HDLM Persistent Reservation
    • Format
    • Parameters
  • dlmsetopt Utility for Setting HDLM Driver Options
    • Format
    • Parameters
  • dlmstart Utility for Starting HDLM
    • Format
  • dlmupdatesysinit Utility for Updating System Scripts
    • Format
  • installgetras Utility for Collecting HDLM Installation Error Information
    • Format
    • Parameters
    • Error Information To Be Collected
  • installhdlm Utility for Installing HDLM
    • Format
    • Parameters
    • Editing an Installation-Information Settings 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
  • KAPL12001 to KAPL13000
  • KAPL13001 to KAPL14000
  • KAPL15001 to KAPL16000
  • Return Codes for Hitachi Command Suite Common Agent Component
• Notes on Linux Commands and Files
  • Notes on the /proc/partitions File
  • Notes on Linux Commands
  • Notes on the iostat Command
  • Notes on the mkfs Command
  • Notes on the fdisk Command
  • Notes on the sar Command
  • Notes on the fdisk and parted Commands
  • Notes on the parted Command
  • Notes on the vgrename and lvrename Commands
• Troubleshooting Products That Use the Weak-Modules Script
  • Overview
  • Installing Products That Use the Weak-Modules Script
  • Uninstalling Products That Use the Weak-Modules Script
• Functional Differences Between Versions of HDLM
  • Functional Differences Between Version 7.2 and Versions Earlier Than 7.2
  • Functional Differences Between Version 6.2.1 and Versions Earlier Than 6.2.1
  • 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
  • Functional Differences Between Version 5.9.4 or Later and Versions Earlier Than 5.9.4
  • Functional Differences Between Version 5.9.1 or Later and Versions Earlier Than 5.9.1
  • Functional Differences Between Version 5.9 or Later and Versions Earlier Than 5.9
  • Functional Differences Between Version 5.8 or Later and Versions Earlier Than 5.8
  • Functional Differences Between Version 5.7.1 or Later and Versions Earlier Than 5.7.1
  • Functional Differences Between Version 5.7.0-01 or Later and Versions Earlier Than 5.7.0-01
  • Functional Differences Between Version 5.7 or Later and Versions Earlier Than 5.7
  • Functional Differences Between Version 5.6.3 or Later and Versions Earlier Than 5.6.3
  • Functional Differences Between Version 5.4 or Later and Versions Earlier Than 5.4
• Acronyms and abbreviations
• Glossary
• Index