Interface Card OL* Support Guide HP-UX 11i v2 Edition 0709 Manufacturing Part Number : 5992-1908 September 2007 United States © Copyright 2004 Hewlett-Packard Development Company L.P.
Legal Notices The information contained herein is subject to change without notice. Warranty The only warranties fro HP products and services are set forth 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 of omissions contained herein. U.S. Government License Confidential computer software.
Contents 1. PCI Card OL* Overview and Concepts Important Terms and Concepts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Planning and Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Card Compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Online Addition . . . . . .
Contents I/O Tree Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Changing Views. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Refresh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Reinstall Device Files . . . . . . . . . . . . . .
Contents Comparing OL* Methods. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 Adding a Card . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 Replacing a Card. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 Attention LED Control . . . . . . . . . . . . .
Contents 6
Figures Figure 2-1. What pdweb looks like on screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Figure 2-2. pdweb Banner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Figure 2-3. pdweb Tabs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Figure 2-4. pdweb List Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Figures 8
About This Document This document describes how to manage slots and cards using On-Line Add and Replace (OL*) functionality on systems running HP-UX 11i v2 or HP-UX 11i v2 September 2004. The IO card online addition and replacement procedure for systems running HP-UX 11i v1 is detailed in Chapter 2 (Managing PCI Cards with OLAR) of Configuring HP-UX for Peripherals. Search for B2355-90698 on http://www.docs.hp.com to locate Configuring HP-UX for Peripherals.
To ensure that you receive new editions, you should subscribe to the appropriate product support service. See your HP sales representative for details. The latest version of this document can also be found online at http://www.docs.hp.com. Intended Audience This document is intended for system and network administrators responsible for installing, configuring, and managing slots and cards. Administrators are expected to have knowledge of operating system concepts, commands, and configuration.
Typographic Conventions This document uses the following conventions. audit (5) An HP-UX manpage. In this example, audit is the name and 5 is the section in the HP-UX Reference. On the web and on the Instant Information CD, it may be a hot link to the manpage itself. From the HP-UX command line, you can enter “man audit” or “man 5 audit” to view the manpage. See man (1). Book Title The title of a book. On the web and on the Instant Information CD, it may be a hot link to the book itself.
Related Documents The IO card online addition and replacement procedure for systems running HP-UX 11i v1 is detailed in Chapter 2 (Managing PCI Cards with OLAR) of Configuring HP-UX for Peripherals. Search for B2355-90698 on http://www.docs.hp.com to locate Configuring HP-UX for Peripherals. Additional documentation for the Peripheral Device Tool (pdweb) can be found using the online help system, click on Help Overview from the main screen.
1 PCI Card OL* Overview and Concepts Most cards and servers support OL* functionality, but there are a few that do not, see specific card and server documentation for details.
PCI Card OL* Overview and Concepts WARNING Observe all safety precautions to avoid being injured while accessing systems to add or replace cards. CAUTION Observe all safety precautions prior to physically accessing the system to prevent static discharge from damaging the system. NOTE Certain “Classes” of hardware are not intended for access by users. At this time this includes V-Class and Superdome systems. HP recommends that these systems only be opened by a qualified HP Engineer.
PCI Card OL* Overview and Concepts Important Terms and Concepts Important Terms and Concepts Table 1-1 Term Terms and Meanings Meaning OL* All aspects of On-line Addition (OLA) and On-line Replacement (OLR) of PCI & PCI-X interface cards. On-line Delete (OLD) is not supported. Power Domain A grouping of 1 or more interface card slots that are powered on or off as a unit. Current systems have each slot in a separate power domain.
PCI Card OL* Overview and Concepts Planning and Preparation Planning and Preparation For the most part, these tools prevent you from performing OL* procedures that would adversely affect other areas of the server. This section provides you with important information that can help minimize errors or problems when performing OL* procedures. Card Compatibility Online Addition When adding an interface card online, the first issue that must be resolved is whether the new card is compatible with the system.
PCI Card OL* Overview and Concepts Planning and Preparation This is particularly important if there is no online fail-over or backup card to pick up those functions. For example: • Which mass storage devices will be temporarily disconnected when the card is shut down? • Will a critical networking connection be lost? A critical resource is one that could cause a system crash or loss of data if the slot were suspended or disconnected.
PCI Card OL* Overview and Concepts OL* Methods OL* Methods Each of the three methods has similarities and differences and a chapter is devoted to each method, as well as an additional chapter with flowcharts showing all of the methods together for comparison and to act as a quick reference. “Mixing OL* Methods” on page 88 includes a table, which details the consequences of mixing OL* methods.
PCI Card OL* Overview and Concepts OL* Methods • A Fast Web interface is light on the network and can be used in places where an X-Windows interface is not available or does not provide equivalent speed. • Additional Web Security provides a secure, encrypted connection between the Web browser and the host system. Attention Button OL* compatible slots feature an OLX Divider that contains a power LED, an attention LED, and an Attention Button.
PCI Card OL* Overview and Concepts Important Considerations Important Considerations This section presents other situations that you are likely to encounter when performing OL* operations, and how to handle them accordingly: • “Power Domains” • “Multi-port Cards” • “Virtual Ports” • “Firmware Patch Information” • “Shared Slots” • “Frequency Mismatch” Power Domains A power domain is a grouping of 1 or more interface card slots that are powered on or off as a unit.
PCI Card OL* Overview and Concepts Important Considerations WARNING If a card with a shared slot is added or replaced, a frequency or bus-mode mismatch could cause the OL* operation to fail. The following example would fail. Step 1. Suspend a PCI-X card Step 2. Resume or add a PCI card Table 1-2 Slot 1 Frequency Matching Scenarios for Shared Slots Slot 2 Comments Add empty No frequency issue. The slot/card operates at an optimum frequency. empty Add No issue.
PCI Card OL* Overview and Concepts Important Considerations 22 Chapter 1
2 pdweb - Peripheral Device Tool Web Interface Chapter 2 23
pdweb - Peripheral Device Tool Web Interface Understanding How the Tool Works Understanding How the Tool Works The Peripheral Device Tool graphical user interface (GUI) is powered by the pdweb and waconf commands introduced in HP-UX 11i v2. These commands are used to invoke the necessary Web tools and the GUI. This tool uses the olrad (1M) command as well as other existing commands such as ioscan (1M), insf (1M), and diskinfo (1M) to gather data and perform actions on the system.
pdweb - Peripheral Device Tool Web Interface Security Security The Peripheral Device Tool uses SSL for all communications between the Web server and the browser. This prevents eavesdroppers on the network from gleaning any passwords entered into the Peripheral Device Tool. Additionally, SSL keeps anyone with the ability to inject packets on your network from hijacking your session. When you access pdweb from a Web browser, you log on using the secure HTML log-on screen.
pdweb - Peripheral Device Tool Web Interface Starting and Stopping the pdweb Server Starting and Stopping the pdweb Server This topic describes the supporting Web-based components of the Peripheral Device Tool, and ways to start and stop pdweb. The pdweb Server and Client Components The Peripheral Device Tool consists of two parts: pdweb server The pdweb server component runs within the HP Apache-based Web Server (also referred to herein as HP Apache).
pdweb - Peripheral Device Tool Web Interface Starting and Stopping the pdweb Server NOTE If you are starting pdweb from SAM, you do not need to manually start the pdweb server as it is started automatically when Cards and Devices is selected. Refer to “Using SAM” on page 29 for more information. Stopping or Restarting the pdweb Server You must have superuser capability to start the pdweb server. Restarting stops the pdweb server, then starts it again.
pdweb - Peripheral Device Tool Web Interface Accessing pdweb Accessing pdweb The Peripheral Device Tool can be accessed in any of the following ways: • from the command line, using the pdweb command; • from a Web browser, using the URL of a pdweb server that has already been started; • from the pdweb autostart option; • from the HP Servicecontrol Manager (SCM); • from the Cards and Devices area of the System Administration Manager (sam (1M)).
pdweb - Peripheral Device Tool Web Interface Accessing pdweb To narrow the list of nodes displayed in the nodes list, select a node group from the Nodes tab menu instead of All Nodes if appropriate. Step 6. Select the target system (node) using the adjacent check box. The Tools tab menu replaces the Nodes tab menu after you select the target system (node). Step 7. From the Tools tab menu, expand the appropriate tool category and select the Peripheral Device Tool (pdweb).
pdweb - Peripheral Device Tool Web Interface Using pdweb With Bastille Using pdweb With Bastille HP Bastille is a security hardening/lockdown tool which enhances the security of a UNIX host. It configures daemons, system settings, and firewalls to be more secure. It turns off unnecessary services such as pwgrd and printing, and it configures client software such as rcp and rlogin to be more secure.
pdweb - Peripheral Device Tool Web Interface Logging In and Out Logging In and Out You Have to Login as root You must be logged in as root to perform a hardware scan, reinstall device files, or any OL* tasks on slots. For viewing peripheral device, you can log in as any user. The login screen is presented whenever you access the Peripheral Device Tool (pdweb) GUI via a Web browser and is not required if accessing the tool through SAM or SCM.
pdweb - Peripheral Device Tool Web Interface Logging In and Out Logging Off Log off from the Peripheral Device Tool GUI when your work is complete. This prevents someone from accessing your active session and avoids a potential breach in security. Session Timeout The Peripheral Device Tool GUI session will time out if you do not keep it active. A pop-up message appears to alert you that you are about to be logged off. To return to the tool, click [OK].
pdweb - Peripheral Device Tool Web Interface Navigating pdweb Navigating pdweb In order to get the most out of the Peripheral Device Tool, it is helpful to understand the graphical user interface (GUI). Learning about the GUI design aids you in working more efficiently with the system. The basic features of the Peripheral Device Tool GUI are described in the sections that follow.
pdweb - Peripheral Device Tool Web Interface Navigating pdweb Lengthy lists may require more than one page to display all of the items. If the list contains more than 50 items, arrow buttons appear, above the list on the right, to facilitate paging through the list 50 items at a time. These buttons have the following abilities: Table 2-1 pdweb List Navigation Buttons Sets the list to the beginning. Sets the list forward by 50 items. Sets the list backward by 50 items. Sets the list to the end.
pdweb - Peripheral Device Tool Web Interface Navigating pdweb TIP Figure 2-5 An ellipsis (...) at the end of an action indicates that there is an underlying process. When selected, a another page appears and the underlying process begins. These actions are safe to explore as you will be given a chance to change your mind and cancel the action.
pdweb - Peripheral Device Tool Web Interface Navigating pdweb The OLRAD Cards Tab The columns that comprise the list of slots are self-explanatory and provide basic information about each slot. However, it is useful to note that an indication of “N/A” in the Suspended column means that either there is no card in the slot, or that the card is not OL* capable. There are graphic indicators that appear in the list of slots and on the mini-tabs to help you quickly identify the state of each slot.
pdweb - Peripheral Device Tool Web Interface Navigating pdweb To see a detailed view of a slot, simply click anywhere in the row where the slot appears in the list. Once a selection is made, the detailed view of the slot appears below the tabular list, presenting all available information about the selected slot.
pdweb - Peripheral Device Tool Web Interface Navigating pdweb I/O Tree Tab To enable you to quickly and easily view all of the I/O devices (or I/O Tree) on your system, the Peripheral Device Tool uses information from the last hardware scan and presents the results in an easy-to-read, tabular format. The Hardware (H/W) Path, Class (or type), and a brief Description of each device found on the host system is listed. The last hardware scan date and time appear to the left of the [Refresh].
pdweb - Peripheral Device Tool Web Interface Navigating pdweb To see a detailed view of a device, both internal and leaf nodes, simply click anywhere in the row where the device appears in the list. Once a selection is made, the detailed view of the device appears, below the tabular list, presenting all available information about the selected device. The detailed information displayed may vary for each device as this data is dependent on the information retrieved during the hardware scan.
pdweb - Peripheral Device Tool Web Interface Navigating pdweb Changing Views Changing the View by Device Class Changing the way you view the list of devices enables you to: isolate a device category from the entire list, shorten long lists by filtering, or locate a particular device. The view can be changed using the Class list control, which filters the devices list based on your selection. The filter choices are the major device classes: disk, tape, autochanger (autoch), and lan.
pdweb - Peripheral Device Tool Web Interface Navigating pdweb TIP Step 3. Click For example, you could use the default class All and the search text ba to view only bus adapter devices. to view the resulting list of devices that match your search criteria. If no devices are displayed, you may wish to modify your search text and/or selection in the Class list.
pdweb - Peripheral Device Tool Web Interface Navigating pdweb Reinstall Device Files It may be necessary or desirable to reinstall special files for a particular device if the files are missing, corrupt, or out of date. This action is only available to root. Reinstalling device files executes in the background as the possibility exists that it may take several minutes to run the insf command depending on the type of node selected, internal or leaf. To reinstall special device files for a device: Step 1.
pdweb - Peripheral Device Tool Web Interface Navigating pdweb Viewing Slot Information To enable you to view easily all of the slots on your system with OL* capability, the Peripheral Device Tool uses the olrad command and presents the results in an easy-to-read, tabular format in a web browser.
pdweb - Peripheral Device Tool Web Interface Navigating pdweb Table 2-3 pdweb Slot Detail Information Tabs (Continued) Tab Device Files Description All special devices files that are associated with the selected slot are displayed. The details presented can vary for each slot and are dependent on the information gathered by the olrad command. Refer to the olrad (1M) manual page for data object specifics.
pdweb - Peripheral Device Tool Web Interface Navigating pdweb Step 1. Enter the information you want to search for in the box adjacent to Search. Ensure you spell your search criteria correctly as the search facility is case sensitive. TIP Step 2. Click For example, you could use the search text yes to view only slots that are Occupied or Suspended. Alternatively, if you use the search text off, only those slots that are currently powered off are displayed.
pdweb - Peripheral Device Tool Web Interface Critical Resource Analysis Critical Resource Analysis Critical Resource A critical resource is one that could cause a system crash or loss of data if the slot were suspended or disconnected. For example, if a SCSI adapter to be replaced connects to un-mirrored root disk or swap space, the system will crash when the card is replaced.
pdweb - Peripheral Device Tool Web Interface Critical Resource Analysis You are returned to the OLRAD Cards tab.
pdweb - Peripheral Device Tool Web Interface Adding a Card Online Adding a Card Online Adding a new card to a slot is made easy with the three-step process provided by the Peripheral Device Tool. This action is active only when the selected slot is capable of a card addition. Before beginning, be sure to familiarize yourself with the OL* concepts in “Important Terms and Concepts” on page 15.
pdweb - Peripheral Device Tool Web Interface Adding a Card Online Step 1. Start adding the card by clicking [Run CRA]. A critical resource analysis (CRA) is run on the system and the results are displayed in Step 1 of the Add Card process.
pdweb - Peripheral Device Tool Web Interface Adding a Card Online The results of the CRA determine the action to be taken in Step 2. You are presented with these result driven choices: Table 2-4 CRA Result Success pdweb Adding a Card CRA Results Available Actions [Power Off] Suggested Course of Action Continue to add the new card.
pdweb - Peripheral Device Tool Web Interface Adding a Card Online • Figure 2-19 Chapter 2 If any other buttons are chosen, you are returned to the OLRAD Cards tab and the state of the target slot is unchanged.
pdweb - Peripheral Device Tool Web Interface Adding a Card Online CAUTION Do not push the Attention Button on the slot, if it exists, as this causes the slot to be powered on and an attempt to bring the card online prematurely is executed by the system. IMPORTANT Only add a card to a slot when the Power LED is OFF. At the system, locate the target slot then confirm that the green power LED is off, and that the amber attention LED is flashing before proceeding.
pdweb - Peripheral Device Tool Web Interface Replacing a Card Online Replacing a Card Online Replacing an existing card to a slot is made easy with the three-step process provided by the Peripheral Device Tool. This action is active only when the selected slot is capable of an OL* card replacement. IMPORTANT You must replace an existing card with the same type of card. In other words, the card that you want to use as a replacement must use the same drivers as the existing card.
pdweb - Peripheral Device Tool Web Interface Replacing a Card Online The Replace Card Online page appears describing the three-step process. As you progress through the defined steps, each step is checked off successively letting you know that all is well. You can choose to end this process, leaving the system unchanged, at any time by clicking [Cancel]. Figure 2-21 pdweb Replace Card Example Step 1. Start the card replacement by clicking [Run CRA].
pdweb - Peripheral Device Tool Web Interface Replacing a Card Online A critical resource analysis (CRA) is run on the system and the results are displayed in Step 1 of the Replace Card process. Figure 2-22 pdweb Replace Card CRA Example The results of the CRA determine Step 2. For the list of possible results and the suggested course of action, see Table 2-5.
pdweb - Peripheral Device Tool Web Interface Replacing a Card Online Table 2-5 pdweb Replace a Card CRA Results (Continued) CRA Result Available Actions Suggested Course of Action System Critical Warning [Done] Terminate the card replacement as it would be detrimental to the system. Error [Done] Terminate the card replacement as a problem exists that should be investigated using the information provided in the CRA. Step 2. Click the button appropriate to your course of action.
pdweb - Peripheral Device Tool Web Interface Replacing a Card Online At the target slot, physically remove the existing card and then install the new card in the target slot. Refer to the Host Bus Adapter (HBA) documentation for details on card installation. Figure 2-23 pdweb Bring Card Online Step 3. You can choose to: • Bring the card online now by clicking [Bring Card Online] to complete the process.
pdweb - Peripheral Device Tool Web Interface Replacing a Card Online — the amber attention LED is set to steady OFF These events activate the target card and bring it online in the target slot. When the system has completed the process, a confirmation page appears identifying the results. Click [Done] to return to the OLRAD Cards tab and see that the card that was replaced is listed in the target slot with the updated information.
pdweb - Peripheral Device Tool Web Interface Bringing a Card Online Bringing a Card Online If you have previously postponed the completion of adding or replacing a card in a slot or experienced an error in the last step of a card replacement, you can complete the process and bring the card online with this feature. All slots that have cards that are eligible to be brought online are identified with a yes and in the Suspended column of list of cards on the OLRAD Cards tab.
pdweb - Peripheral Device Tool Web Interface Bringing a Card Online These events activate the target card and bring it online in the target slot. When the system has completed the process, a confirmation page appears identifying the results. Click [Done] to return to the OLRAD Cards tab and see that the card that was brought online is listed in the target slot with the updated information. Should an error occur, refer to the “Messages from pdweb Actions” on page 90 for additional information.
pdweb - Peripheral Device Tool Web Interface Turning Attention LED to BLINK or OFF Turning Attention LED to BLINK or OFF This feature allows you to control the amber Attention LED of a slot, by setting it to blinking or off, to aid you in physically locating a slot. It is not necessary for the slot to be occupied to use this feature. IMPORTANT In addition to the amber attention LED, each slot has a green power LED that indicates the power state of the slot.
pdweb - Peripheral Device Tool Web Interface Turning Attention LED to BLINK or OFF The Turn On/Off LED page is displayed identifying the selected slot. Figure 2-26 • pdweb Turn On/Off LED Select the button appropriate for your task: — [Turn LED On] to set the LED to the Locate State, Blinking. — [Turn LED Off] to set the LED to the Normal state, steady OFF. — [Cancel] to leave the slot LED unchanged and return to the OLRAD Cards tab.
pdweb - Peripheral Device Tool Web Interface Localized Content Localized Content The Peripheral Device Tool GUI and the help are localized however, in most cases, the commands and associated manual pages (manpages) are not. Display of content in a specific language depends on: • The language files being installed on the system • The language selected in your Web browser Not all components are localized into all languages as defined in the following table.
pdweb - Peripheral Device Tool Web Interface Localized Content Step 6. If offered in your version of browser, select a character coding from the Default Character Coding listbox. Step 7. Click [OK] to close the Add Languages dialog. Step 8. Click [OK] to complete your language changes. Selecting the Language in Internet Explorer If you are using Internet Explorer, you can select the language by following this procedure: Step 1. Select Tools > Internet Options... The Internet Options dialog is presented.
pdweb - Peripheral Device Tool Web Interface Additional Information about pdweb Additional Information about pdweb This section provides references to manual pages referenced, and additional information about the Peripheral Device Tool. If you're looking for assistance in using the pdweb online help system, select using help from the navigation links at the left.
pdweb - Peripheral Device Tool Web Interface Additional Information about pdweb Technical Support and Developer Information • HP Servers Technical Support • HP IT Resource Center (ITRC) • search ITRC forums • HP Developer and Solution Partner Portal (DSPP) • HP-UX Bastille 66 Chapter 2
3 Attention Button - Direct Slot Control Chapter 3 67
Attention Button - Direct Slot Control Introduction to the Attention Button, Power LED, & Attention LED Introduction to the Attention Button, Power LED, & Attention LED OL* compatible slots have key hardware features of a power LED, an attention LED, the Attention Button, and a Manual Release Latch, all contained on an OLX Divider. The Attention Button is also the name of the method for hardware triggered Hot-Plug operations, with minimum or no console interactions.
Attention Button - Direct Slot Control Introduction to the Attention Button, Power LED, & Attention LED See “hotplugd Daemon and Logfile” on page 73 for log file information to diagnose errors. The Attention Button is a momentary-contact push button, located adjacent to each hot-plug slot, that is pressed by the user to initiate a hot-insertion or hot-removal at that slot. Pressing the Attention Button corresponding to a powered-on, populated slot will initiate a hot-removal operation.
Attention Button - Direct Slot Control Using the Attention Button Using the Attention Button It is advised to determine the condition of all slots run the following command prior to using the Attention Button. This can be accomplished using the olrad command or through the pdweb tool. For additional details of the olrad command, see Chapter 4, “olrad - Command Line Interface,” on page 75, to view slot information using the pdweb tool, “Viewing Slot Information” on page 43.
Attention Button - Direct Slot Control Using the Attention Button Adding a Card On-Line Adding a new card to a slot is a four step process. This action is active only when the selected slot is capable of a card addition. Before beginning, be sure to familiarize yourself with the OL* concepts in Chapter 1, “PCI Card OL* Overview and Concepts,” on page 13. Prerequisites for this procedure: • Drivers for the card have already been installed. • There are no drivers associated with the slot.
Attention Button - Direct Slot Control Using the Attention Button Replacing a Card On-Line Prerequisites for this procedure: • The card to be replaced uses the same drivers and is of the same type as the card being replaced • The Power LED is steady ON. • The Attention LED is steady OFF or is BLINKing (if a user has requested a locate of the slot). • You are grounded to the chassis of the unit.
Attention Button - Direct Slot Control Attention LED and Locating a Slot Attention LED and Locating a Slot Controlling the Attention LED cannot be done from the slot itself, but can be done from either the command line using the olrad command, “Turning the Attention LED to BLINK or OFF” on page 79, or using the pdweb tool, “Turning Attention LED to BLINK or OFF” on page 61. To turn the Attention LED to the Blinking state using the olrad command.
Attention Button - Direct Slot Control Pressing the Attention Button - Possible Results Pressing the Attention Button - Possible Results The following table provides details on how pressing the Attention Button on a PCI slot would be converted to an OL* operation Table 3-3 OLX Divider - Pressing Attention Button & Potential Results Initial Conditions Press Attention Button Results Slot Occupied Slot Suspended Driver Attached Power to slot Yes Yes Yes OFF post-replace (resume) Yes N/A No OFF
4 olrad - Command Line Interface The olrad command provides the ability to perform online addition and replacement of I/O cards. olrad performs critical resource analysis of the system before performing any OL* operation. This is to ensure that the system is not left in an inconsistent state after a PCI card is added/replaced. Only users with root privileges may use this command. The olrad command replaces the rad command.
olrad - Command Line Interface Using olrad Using olrad Argument Description and Syntax The following arguments are used in the command. slot_id SLOT ID of an OLA/R capable slot. A slot ID is a list of one or more numbers separated by dashes. Each number represents a component of the physical location of the slot. The user can use the slot ID to locate the slot. The sequence of numbers in the slot ID is platform dependent. On N and L classes, the slot ID contains only the slot number.
olrad - Command Line Interface Using olrad The CRA severity levels and their meanings. CRA_SUCCESS no affected resources in use. CRA_WARNINGS resources in use on affected device(s) but none are deemed critical. CRA_DATA_CRITICAL probable data loss, only proceed with the user's permission. CRA_SYS_CRITICAL likely to bring down the user's system. CRA_ERROR some internal CRA error encountered. The syntax for this option is olrad -C slot_id. Example 4-2 CRA Reporting Success.
olrad - Command Line Interface Using olrad Result: network ports will be affected Affected Network Ports: 4/0/0/1/0 IP Address: 15.1.51.
olrad - Command Line Interface Using olrad Step 2. Prepare to replace: /usr/bin/olrad -r slot_ID A CRA is performed as part of this action. Step 3. Manually unlock the latch (if present). 1 Replace the existing card in the slot with another card. Press latch to the locked position (if present).1 The new card must use the same drivers as the replaced card. Step 4. Post Replace: /usr/bin/olrad -R slot_ID Step 5. Verify the success of the operation, slot power should be ON, driver is OLAR capable, and so on.
olrad - Command Line Interface Options, Scripts, & Logging Options, Scripts, & Logging Options Details for some options are discussed below. See the olrad (1M) manpage for a complete listing of options, usage, syntax, and details of their use. -a slot_id Prepare to add a card to system at the specified slot. Critical resource analysis is run to ensure that the current card addition onto the system will not cause disruption in the functioning of the system.
olrad - Command Line Interface Options, Scripts, & Logging There are no preface and prepare driver scripts for online add. For a given OL* operation on a slot, pref_replace driver scripts are run for the affected slots (if any) irrespective of the type of operation being performed on the given slot. An audit trail is logged onto NetTL log file whenever an OL* operation is initiated. This information is also written to standard output.
olrad - Command Line Interface Options, Scripts, & Logging 82 Chapter 4
5 Comparing and Combining OL* Methods These three tools all can perform the same tasks, but with different steps. A direct comparison of the methods can help you decide which method to use in your particular situation. This chapter provides a direct comparison of the methods. Occasionally it may be easier to start with one method and finish with another. This chapter provides information on these possibilities as well.
Comparing and Combining OL* Methods Comparing OL* Methods Comparing OL* Methods The following flowcharts shows a comparison of the different methods for performing the same task. Since these tools can control slot status both from the console using the pdweb GUI or the command line tool (olrad) and from the slot itself on the server via the (Attention Button), one method may be a better choice for performing a particular task under different circumstances.
Comparing and Combining OL* Methods Comparing OL* Methods Adding a Card Figure 5-1 Add Card Methods Comparison Flowchart Prerequisite Condition = Drivers for card installed Start state = OFF OFF Green Power LED Amber Attention LED Push Attention Button again within 5 seconds OFF Attention Button Confirm Power & Attention LED Off Install Card 1 OFF Push Attention Button Blink OFF ON OFF pdweb Select Slot Add Card Online [Run CRA] [Power Off] or OFF Blink [Bring Card Online] [Done] [Cancel
Comparing and Combining OL* Methods Comparing OL* Methods Replacing a Card Figure 5-2 Replace Card Methods Comparison Flowchart Prerequisite Condition = Card uses same drivers as previous card Attention Button Push Attention Button Blink OFF ON OFF Blink OFF Perform CRA 2 Push Attention Button again within 5 seconds ON OFF OFF Start state = ON OFF Green Power LED Amber Attention LED Push Attention Button again within 5 seconds OFF OFF OFF Push Attention Button Confirm Power & Attention
Comparing and Combining OL* Methods Comparing OL* Methods Attention LED Control Figure 5-3 Attention LED Control Methods Comparison Flowchart Attention Button User unable to affect Attention LED status using Attention Button Start state = ON Blink or or OFF OFF Green Power LED Amber Attention LED pdweb Select Slot Turn On/Off Slot LED [Cancel] Select Button Select Button no change [Turn LED Off] OFF [Turn LED On] Blink [Turn LED Off] OFF [Done] Leaves Attention LED blinking olrad olra
Comparing and Combining OL* Methods Mixing OL* Methods Mixing OL* Methods These tools allow the completion of the operation using a different method than what was used to initiate the process, but some there are some cautions to doing this, and some subsequent actions will be slightly different.
A Troubleshooting The following documents typical messages returned by the system.
Troubleshooting Messages from pdweb Actions Messages from pdweb Actions There are two types of messaging facilities provided by the Peripheral Device Tool: • Messages recording OL* activity and errors generated by commands executed by pdweb that are stored in various log files. • Error messages that occur within the Peripheral Device Tool and are displayed to the user.
Troubleshooting Messages from pdweb Actions • pg • more • cat The NetTL Log File The NetTL log file contains all errors generated by olrad except those that are generated when using view options such as -q or -c. This is a log file, not a directory. Where is the NetTL Log File Located The NetTL log file can be found in /var/adm/nettl.LOG00 How to View the NetTL Log File To view the NetTL log file, you will use the netfmt command.
Troubleshooting Messages from olrad Actions Messages from olrad Actions Logging olrad uses the NetTL subsystem to log errors and audit trail for all OL* operation performed on various slots. olrad makes use of the SYSADMIN subsystem formatter to format the log messages. The following details are not logged: • CRA report when performing OL*, • CRA report when using the -C option, • Output of view information options such as -v, -c, -g, -h, -q, and -n.
Troubleshooting hotplugd Daemon Diagnostics hotplugd Daemon Diagnostics Messages in the System Log File The following messages are logged in the system log file, /var/adm/syslog/syslog.log. If an Attention Button event occurs after the daemon has been terminated following a successful start of the daemon, the messages are logged in the system log file.
Troubleshooting hotplugd Daemon Diagnostics Messages in the hotplugd Daemon Log File The following messages are logged in the hotplugd daemon log file, defined by logfile. ioctl(DEV_OLAR_GET_ABEVENT/WAIT) error : errno = errMsg An error has occurred on the ioctl() call to get Attention Button events from the kernel in the WAIT mode. errMsg gives the reason for the error.
Troubleshooting hotplugd Daemon Diagnostics #oprnNum oprn - slot( slotId ) - time( time ) - Invalid PCI OL * operation hotplugd has received an invalid PCI OL* operation on slot slotId. oprn can be one of the following: INVALID, INVALID_INSERTION, INVALID_REMOVAL. time is the time at which the Attention Button was pressed. This could happen if INSERTION or REMOVAL is received and the slot is not in the right state.
Troubleshooting hotplugd Daemon Diagnostics 96 Appendix A
B Additional Resources Other documentation that may be of interest, and can be found at http://www.docs.hp.
Additional Resources Other documentation Other documentation The following documents available on http://www.docs.hp.com are related to OL* actions and may provide additional information. • HP System Partitions Guide: Administration for nPartitions • Writing a PCI OLAR Driver chapter in the 11.23 Driver Development Guide. • Managing Systems and Workgroups document in the System Administration section for the specific OS release version you are using.
C Advanced OL* Topics This chapter discuses various advanced topics related to OL*.
Advanced OL* Topics Attention Button Actions Attention Button Actions On pressing the Attention Button, the system would generate the POWER_OFF event under the following cases: a. Slot is occupied, no drivers are attached, AND the AB event is an “NORMAL_REMOVAL” event. b. Slot is occupied, drivers are attached to the slot, and the drivers are suspended, AND the AB event is an “NORMAL_REMOVAL” event. c.
Advanced OL* Topics Attention Button Events Attention Button Events The following are various Attention Button events: INSERTION_UNPOWERED Card inserted, slot unpowered INSERTION_POWERED Card inserted, slot powered NORMAL_REMOVAL Normal hot removal SURPRISE_REMOVAL Surprise removal, for example, the latch is opened when the power is ON FREQ_MISMATCH OL* failed because the frequency at which the card can operate is not compatible with the current bus frequency MODE_MISMATCH OL* failed because the
Advanced OL* Topics PCI OL* Events PCI OL* Events The following are the various PCI OL* events: HPD_OP_INVALID_REMOVAL could not map the NORMAL_REMOVAL AB event HPD_OP_INVALID_INSERTION could not map the INSERTION_POWERED or INSERTION_UNPOWERED AB event HPD_OP_ADD ADD operation HPD_OP_PRE_REPLACE pre-replace or suspend HPD_OP_POST_REPLACE post-replace or resume HPD_OP_SURPRISE_REMOVAL surprise removal has occurred HPD_OP_FREQ_MISMATCH frequency mismatch has occurred HPD_OP_MODE_MISMATCH bus-mode
Advanced OL* Topics OL* Driver Scripts OL* Driver Scripts At various stages throughout most OL* procedures, olrad may initiate certain actions that notify the system of the addition or replacement of an interface card. Since pdweb invokes olrad, these scripts are also run when using pdweb. The script name should be the same as the driver name.
Advanced OL* Topics OL* Driver Scripts 104 Appendix C
Glossary action A menu selection resulting in a task or command being executed by the application. affected card/slot Interface cards and the card slots they reside in which are in the same power domain as the target slot. See also OL* Affected Slots The set of PCI slots, other than the target slot, that would have their PCI bus disrupted as a result of a hot plug operation. This disruption includes anything that would interfere with bus traffic, including events like a bus reset or a loss of bus power.
Glossary OLRAD OLRAD Name of a tab in the pdweb GUI, OLRAD Cards. The “D” is for a future capability to Delete a slot. This feature is not supported at this time. tool An application, command, or script that can be executed by Peripheral Device Tool on a device or slot to perform a task. On Line Addition and Replacement (OLAR) window The main area in which application elements and controls are displayed.
Glossary tool Glossary 107