HP HP-UX Diagnostics User Manual
Offline Diagnostics Environment Administrator's and User's Guide
HP Part Number: 5992-6605
Published: April 2009
Edition: 2
© Copyright 2009 Hewlett-Packard Development Company, L.P.
Confidential computersoftware. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial
Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under
vendor's standard commercial license.
The informationcontained hereinis subject to change without notice. The only warranties for HP productsand servicesare setforth in the express
warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP
shall not be liable for technical or editorial errors or omissions contained herein
Intel and Itanium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.
Table of Contents
About This Document.........................................................................................................5
Intended Audience.................................................................................................................................5
New and Changed Information in This Edition.....................................................................................5
Document Organization.........................................................................................................................5
Typographic Conventions......................................................................................................................5
Related Information................................................................................................................................6
HP Encourages Your Comments............................................................................................................6
1 ODE Overview................................................................................................................7
Offline Diagnostics Environment...........................................................................................................7
ODE Limitations.....................................................................................................................................8
Support Plus Media for HP 9000 systems.........................................................................................8
2 Using ODE on Integrity Servers and Itanium Workstations.......................................9
ODE Tools Overview..............................................................................................................................9
Obtaining the Latest Version of ODE.....................................................................................................9
Ordering a CD...................................................................................................................................9
Downloading an Image to Create a CD..........................................................................................10
Running ODE........................................................................................................................................10
Running ODE from the HPSP.........................................................................................................10
Running ODE from the CD.............................................................................................................11
Non-ODE Tools on the CD..............................................................................................................11
3 Using ODE on HP 9000 Systems...............................................................................13
ODE Tools Overview............................................................................................................................13
Obtaining the Latest Version of ODE for HP 9000 Systems.................................................................14
Running ODE........................................................................................................................................14
Running ODE from the CD.............................................................................................................15
Running from the System Disk.......................................................................................................16
Determining Whether LIF-LOAD Is Installed...........................................................................16
Installing LIF-LOAD..................................................................................................................16
Running the ODE Tools..............................................................................................................17
4 Performing Common ODE Tasks................................................................................19
Running ODE Tools on Integrity Systems and Itanium Worksations..................................................19
Loading ODE and Running a Test Module.....................................................................................19
Running Multiple Test Modules......................................................................................................22
Error Detection................................................................................................................................24
Determining the Tools Supported by the Platform.........................................................................24
Entering Invalid Commands...........................................................................................................25
Running ODE Tools on HP 9000 Systems.............................................................................................25
Examining the Tools Suite...............................................................................................................25
Examining a Tool's Functions and Running the Tool......................................................................26
Using the makodiag Command......................................................................................................29
Using the diskexpt2 Command.......................................................................................................32
Index.................................................................................................................................37
Table of Contents 3
List of Examples
4-1 Loading ODE and Running a Test Module...................................................................................20
4-2 Running Multiple Test Modules....................................................................................................23
4-3 Error Detection..............................................................................................................................24
4-4 Using an Unsupported Tool..........................................................................................................25
4-5 Determining the System-Supported Tools....................................................................................25
4-6 Entering Invalid Commands.........................................................................................................25
4-7 Examining the Tools Suite.............................................................................................................26
4-8 Examining a Tool's Functions and Running the Tool....................................................................27
4-9 Using the makodiag Command....................................................................................................30
4-10 Using the diskexpt2 Command.....................................................................................................33
4 List of Examples
About This Document
The Offline Diagnostics Environment (ODE) provides a support tools platform that enables you
to troubleshoot a system that is running without an operating system. With the ODE you can
test systems that cannot be tested using the online tools.
Intended Audience
This document is intended for HP service and support personnel and system administrators
who manage the following systems:
• HP Integrity servers and workstations based on the Itanium® processor
• HP 9000 servers and workstations
Administrators are expected to have knowledge of operating system concepts, commands, and
configuration.
This document is not a tutorial.
New and Changed Information in This Edition
This is a new manual. Some of the information it contains came from the following documents
and supersedes those documents:
• ODE: Overview
• Overview Guide: Itanium Processor Family (IPF) Offline Diagnostics and Utilities CD
• Overview Guide: PA-RISC HP 9000 Offline Diagnostics Environment CD
• ODE: Frequently Asked Questions
Document Organization
This document is organized as follows:
Chapter 1 “ODE Overview” Provides an overview of the offline diagnostics
Chapter 2 “Using ODE on Integrity
Servers and Itanium Workstations”
Chapter 3 “Using ODE on HP 9000
Systems”
Chapter 4 “Performing Common
ODE Tasks”
Typographic Conventions
This document uses the following typographical conventions:
Command
Variable
Filename
User input
NOTE A note contains additional information to emphasize or supplement important
A command name or qualified command phrase.
The name of a placeholder in a command or other syntax display that you
replace with an actual value.
The name of a file or directory.
Commands and other text that you enter.
points of the main text.
environment.
Describes the ODE tools for the Integrity Systems and
Itanium workstations and tells you how to obtain and
install them.
Describes the ODE tools for HP 9000 systems and tells you
how to obtain and install them.
Provides examples of using ODE tools to perform common
tasks and how ODE reacts when it detects a problem.
Intended Audience 5
Related Information
The following Web sites can provide you with additional information about the ODE and system
diagnostics in general:
• For more information about diagnostic tools and concepts:
www.hp.com/go/hpux-diagnostics-docs
• To read about changes in the latest CD release:
www.hp.com/go/hpux-diagnostics-offline-docs
• To order the latest version of the ODE CD or to download an image from which you can
create your own CD:
www.software.hp.com
• For a suumary of how to use the ODE tools, a Quick Reference Guide is available in PDF format
at the following Web site:
www.hp.com/go/hpux-diagnostics-offline-docs
HP Encourages Your Comments
HP encourages your comments concerning this document. We are committed to providing
documentation that meets your needs. Send any errors found, suggestions for improvement, or
compliments to:
docsfeedback@hp.com
Include the document title, manufacturing part number, and any comments, errors found, or
suggestion for improvement you have concerning this document.
6
1 ODE Overview
This chapter provides information on the following topics:
• The purpose of ODE and when to use it.
• ODE limitations.
Offline Diagnostics Environment
The Offline Diagnostics Environment (ODE) provides a support tools platform that enables you
to troubleshoot a system that is running without an operating system.
With the ODE you can test systems that cannot be tested using online tools. The offline
environment is also useful for certain types of testing, such as when booting the system first is
undesirable, as is often the case with manufacturing applications.
ODE tools are available for troubleshooting problems on the Itanium processor family and on
HP 9000 systems (also referred to as PA-RISC systems). The way you use these tools is similar
on both types of platforms. The syntax and operation is the same; the primary differences are
the names of the tools and the way that ODE is launched. It does not depend on any operating
system.
The ODE provides two user interfaces:
• The command-line interface lets you select specific tests and utilities to execute on specific
hardware modules.
Use the command-line interface option if you are an advanced user and familiar with the
ODE. The command line interface allows you more control over the tests that you want to
conduct.
• The menu-driven interface, which is only available on 32-bit systems, lets you specify the
hardware module for the tests you want to run. ODE selects the appropriate tests to execute
on the specified module.
Use the menu-driven interface if you are unfamiliar with the command-line interface or
with ODE. When you select a module to test, the menu-driven interface is designed to choose
and then execute the appropriate tests for that module.
ODE has a distributed architecture that consists of several modules. Each module has a specific
function and uses well defined protocols to communicate with other modules. ODE includes the
following modules:
• Test Controller
Acts as a user interface and launches the execution of the Test Modules.
• Test Modules
Diagnostic or utility programs that execute within ODE.
These modules exercise or diagnose the user-specified hardware component or perform
operations such as downloading firmware. The test modules are provided for the following
components:
— Processor
— Memory
— Core electronic chipset
— Core I/O
— I/O cards
— Peripheral devices
• System Library (SysLib)
A set of common routines used by both the Test Controller and Test Modules.
Offline Diagnostics Environment 7
These routines perform functions such as I/O, string parsing, and system control.
The ODE tools are provided on CDs for Itanium systems (See “Obtaining the Latest Version of
ODE” (page 9)) and HP 9000 systems (See “Obtaining the Latest Version of ODE for HP 9000
Systems” (page 14)). You can order the CDs free or you can download the CD image and burn
your own CD.
ODE Limitations
The Offline Diagnostics Environment cannot be used on all systems and the way it is distributed
has recently changed for HP 9000 systems. The following sections describe these limitations.
V-Class Systems
Offline diagnostics on V-Class systems are different from offline diagnostics on all other HP
systems.
The offline diagnostics tools for V-Class systems are not supplied on the Offline Diagnostics and
Utilities CD. Instead, they are run from the V-Class Test Station. For procedures and details, see
the V-Class hardware documentation.
RX4610 and RX9610 systems
The Offline diagnostics tools for RX4610 and RX9610 systems systems are different from the ODE
diagnostics provided for other HP Integrity servers and Itanium-based workstations. For more
information, go to the following Web site:
www.hp.com/go/hpux-diagnostics-offline-docs
Support Plus Media for HP 9000 systems
ODE for HP 9000 systems was distributed on the Support Plus Media until the June 2005 release
(PA0506). Since the September 2005 release (PA0509), ODE is distributed only on the HP 9000
Offline Diagnostics Environment CD-ROM.
8 ODE Overview
2 Using ODE on Integrity Servers and Itanium Workstations
ODE tools for HP Integrity servers and HP workstations based on the Itanium processor are
distributed on the HP Integrity Servers and Itanium Workstations Offline Diagnostics and Utilities
CD-ROM. In addition to the ODE tools, the CD provides other utilities that are helpful in
identifying problems with your Integrity server or Itanium workstation.
This chapter describes the ODE tools for Integrity Systems and Itanium worksations and tells
you how to obtain and install them. See “Non-ODE Tools on the CD” for information about
non-ODE tools included on the CD. The following topics are discussed:
• An overview of the ODE tools for Integrity systems and Itanium workstations.
• How to obtain a CD containing the ODE or to create your own CD using an image
downloaded from the Web.
• How to run the ODE either from CD or from the HP Service Partition (HPSP).
ODE Tools Overview
The ODE tools are located in the \EFI\HP\DIAG\ODE directory on the CD. The following is a
partial list of the diagnostics and utilities provided under ODE. The complete list is documented
in the \EFI\HP\DIAG\DOCUMENTATION\Prod_Desc_All file on the CD.
CIODIAG2
CPUDIAG
DFDUTIL
FCFUPDATE
IODIAG
MAPPER
MEMDIAG
PCIUTIL
PERFVER
PLUTODIAG
Core I/O diagnostic tool
CPU diagnostic tool
Firmware update utilities for SCSI disks
Fibre Channel firmware update tool.
Diagnostic tool for HP Tachyon Fibre Channel board
Utility for mapping the physical layout of the SPU and its peripherals
Memory diagnostic tool
PCI HBA firmware update utility
Utility to run supported SCSI/IDE self-tests on devices
Diagnostic tool for Pluto and Mercury Core Electronics Complex (CEC)
Obtaining the Latest Version of ODE
The HP Integrity Servers and Itanium Workstations Offline Diagnostics and Utilities CD-ROM is
shipped with all Integrity systems and Itanium workstations. This CD is updated quarterly, at
which time new functions and features may be added, new hardware diagnostics may be
incorporated, and performance may be enhanced.
You can order a CD for free from the HP Software Depot Web page or you can download an
image of the CD to create your own CD. The following sections describe these alternatives.
To read about changes in the latest CD release, go to the following Web site:
www.hp.com/go/hpux-diagnostics-offline-docs
Ordering a CD
To order a CD free of charge from HP Software Depot, follow these steps:
1. Open a browser and navigate to the HP Software Depot Web main page:
http://www.software.hp.com
2. In the Search field, type ipf offline and click the search button (>>). The page displays
current and previous versions of the CD.
3. Select the appropriate version.
ODE Tools Overview 9
4. Click Receive for Free and follow the instructions to complete your order.
Downloading an Image to Create a CD
You can download a master .iso image file to create your own CD using your CD burner and
software.
The following steps describe how to download a Zip file that contains the image.
1. Open a browser and navigate to the HP Support and Drivers Web site:
http://welcome.hp.com/country/us/en/support.html
2. Under the section Select a product category, click Servers.
3. Select Integrity Servers and Integrity Blade Servers.
4. Select the desired server series.
5. Select the desired server product.
6. On the left pane of the screen, under the heading Tasks for my selected product, select
Download drivers and software.
7. Under Select operating system, select Cross operating system (BIOS, Firmware,
Diagnostics, etc.).
8. On the Download drivers and software page, go the Diagnostic section and select IPF
Offline Diagnostics and Utilities for the version you want to download.
9. Select the Release Notes tab. Read the Release Notes before downloading the CD image.
The Release Notes contain important instructions on downloading and producing an image
of the CD and other useful information such as platform information and revision history.
10. Select Obtain software. You will have to accept the license agreement to download the Zip
file.
11. Follow the instructions found in the Release Notes to create the CD.
Running ODE
You can run the ODE either from the CD or from the HP Service Partition (HPSP), a special disk
partition that is available when the operating system is not running. Determine which action is
best for you:
• Running ODE from the HPSP is considerably faster than running it from CD. On systems
that have an HPSP, you can copy the files to the partition from the CD by using a command
on the Launch menu (see “Running ODE from the HPSP”).
If your system does not have an HPSP, refer to your operating system user guide for
instructions on creating one.
• Run ODE from the CD if any of the following conditions exist:
— The hard disk is not functioning or is unavailable.
— The system does not support an HPSP.
— The HPSP does not have the latest version of the tools installed.
Running ODE from the HPSP
The following steps describe the procedure for running ODE from an HPSP.
1. Reset system power. The computer should come up to the Boot Manager menu.
2. See whether the HPSP is listed as one of the boot devices on the Boot Manager menu:
• If the HPSP appears as a boot device, move the cursor to the line that contains that
option and press Enter. The computer will boot to the Launch menu.
• If the HPSP does not appear as a boot device, verify that an HPSP exists on the system.
If the HPSP does not exist, you may have to create one. Refer to your operating system
10 Using ODE on Integrity Servers and Itanium Workstations
user guide for instructions on verifying and creating of the HPSP. When the partition
is created, copy the files from the CD. Follow these steps:
1. Boot from the CD to the Launch menu.
2. At the Launch menu, select the option for copying the contents of the CD to the
HPSP (Run CD Installer to install/update CD content to HPSP).
3. When you return tothe Boot Manager menu, an entry for the HPSPas a boot device
displays.
3. Start ODE by choosing the selection for ODE at the Launch menu.
Alternately, you can start ODE from the EFI prompt. To do this, change directories to \EFI\
HP\DIAG\ODE and enter the ODE command. For example:
fs2:> cd \EFI\HP\DIAG\ODE
fs2:\EFI\HP\DIAG\ODE> ODE
Running ODE from the CD
The following steps describe the procedure for running the HP Integrity Servers and Itanium
Workstations Offline Diagnostics and Utilities CD-ROM
1. Insert the CD into the CD drive and reboot. The system boots to the Boot Manager menu.
2. See whether the CD drive is listed as one of the boot devices on the Boot Manager menu:
• If the CD drive appears as a boot device, move the cursor to the line that contains it and
press the Enter key. The CD will boot to the Launch menu.
• If the CD drive does not appear as one of the boot devices, select the item on the Boot
Manager menu to add a boot device. Although this process can vary, the following
steps reflect a typical procedure:
1. Confirm that the CD is in the CD-ROM drive.
2. Select Boot Option Maintenance.
3. Select Add a Boot Option.
4. Select Removable Media Boot.
5. Answer the prompts.
NOTE: You can give any response to the Boot Option Data Type prompt.
6. Exit the menu, then exit the Boot Option maintenance menu. You return to the Boot
Manager menu.
7. Select CD drive as the boot device to boot from the CD to the Launch menu. After
configuring the CD drive as a boot device, you will not have to add it again on
subsequent boots.
3. Start ODE by choosing ODE on the Launch menu.
Alternately, you can start ODE from the EFI (Extensible Firmware Interface) prompt. To do
this, change directories to \EFI\HP\DIAG\ODE and enter the ode command. For example:
fs2:> cd \EFI\HP\DIAG\ODE
fs2:\EFI\HP\DIAG\ODE> ode
Non-ODE Tools on the CD
The HP Integrity Servers and Itanium Workstations Offline Diagnostics and Utilities CD-ROM also
provides a collection of non-ODE based diagnostic utilities. The following list describes several
of those utilities:
Launchmenu An application that allows the selection and execution of a set of
other applications available in a specific environment. It is available
in the \EFI\HP\TOOLS\LaunchMenu directory.
Running ODE 11
CD_Installer An application to update/install the diagnostics CD image to the
HP Service Partition (HPSP) of the disk running under EFI. It is
available in the \EFI\HP\TOOLS\CD_Installer directory.
MCA utilities A Machine Check Analyzer (MCA) Binary Logs gathering tool. It
is available in the \EFI\HP\TOOLS\MCA_Utilities directory.
Network utilities Utilities to diagnose network latency, communication, or
configuration issues. The following tools are available in the \EFI\
HP\TOOLS\Network directory:
ftp.efi
ifconfig.efi
inet.nsh
ping.efi
route.efi
tcpipv4.efi
I/O card utilities Diagnostics and firmware update utilities for various I/O cards.
Each supported card has its own utility and instruction set. A
complete list of the I/O cards diagnostics and utilities is available
in the \EFI\HP\DIAG\DOCUMENTATION\Prod_Desc_All
directory.
12 Using ODE on Integrity Servers and Itanium Workstations
Loading...