HP-UX WBEM LAN Indication Provider Datasheet, April 2010

ManualsBrandsHP ManualsSoftwareHP-UX 11i WBEM Software

Page 1 of 8

Created on 5/26/10

UX LAN Indication Provider

CIM Indication Provider for

Ethernet LAN interfaces

Provider

Overview

The

LAN

Indication

Provider

delivers

indications

for

events that occur on

Ethernet interfaces

This

provider instruments the HP_DeviceIndication class.

Client applications can subscribe to HP_DeviceIndication and start receiving indications based on events

generated by Ethernet interfaces.

The currently supported indications are:

 Link down due to hardware failure

 Link down due to loss of connection with link partner

 Link down due to administrative actions

 Link down for unknown reasons

 Link up

Description

Requirements The provider requires HP WBEM Services for HP-UX.

Notes for 11iv2: installation of DLPI patch PHNE_35545 is recommended.

Installation of this patch will allow the provider to give better information as to why a

link state change occurred -- all events from table 3 below will be possible. Without

this patch, only event ID 5 from table 3 below is possible.

In addition, installation of PHNE_35545 will allow the LAN indication provider to

run without impacting the results of Critical Resource Analysis (CRA). CRA is

executed before doing PCI online card replacement through SAM, olrad, or the PCI

attention button.

If PHNE_35545 is not installed and this provider is running, CRA will return a result

of ‘potentially data critical’. See below for how to proceed in this situation.

Notes for 11iv1: Determination of the reason a link state has changed is not

available in 11iv1. In 11iv1 only event ID 5 from table 3 below is possible.

In addition, performing an Online Replace of a PCI Ethernet NIC through the SAM

or PCI attention button interface will return a Critical Resource Analysis (CRA) result

of ‘potentially data critical’.

How to proceed an PCI online replace: Review the CRA report and determine if an

online operation on the slot will be safe for the systems operation. If the output of

'lanadmin -p <ppa>' shows only 'cimprovagt' for the affected ppa's then it is safe to

use the 'force' option to proceed with the operation. Note that for 11iv2 if patch

PHNE_35545 is installed there will be no impact on PCI online operations.

Summary of content (8 pages)

PAGE 1
HP-UX LAN Indication Provider - CIM Indication Provider for Ethernet LAN interfaces Provider Overview The HP-UX LAN Indication Provider delivers indications for events that occur on Ethernet interfaces. This provider instruments the HP_DeviceIndication class. Client applications can subscribe to HP_DeviceIndication and start receiving indications based on events generated by Ethernet interfaces.
PAGE 2
Supported managed resources Setting Up This Provider Installing this provider Managed systems running HP WBEM Services for HP-UX. This provider only supports HP Ethernet-based LAN interface products for HP-UX. The LAN Indication Provider filesets are contained within the Software Distributor bundle WBEMP-LAN-00. The LAN Indication Provider filesets are:   LANP-IP-RUN which contains: o LAN indication provider module shared library: libHPUXLANIndProviderModule.so.
PAGE 3
Using This Provider Schema supported by this provider This provider supports the HP_DeviceIndication class. Tables 1 through 3 describe the properties and methods supported by the provider. Table 1: HP_DeviceIndication properties Table 1 describes the properties of the HP_DeviceIndication class. It has three columns.
PAGE 4
Property name Property Inheritance Property Value (and data source) uint32 EventTimeWindow Inherited from HP_AlertIndication Always 0 uint32 ActualEventThreshold Inherited from HP_AlertIndication Always 1 uint32 ActualEventTimeWindow Inherited from HP_AlertIndication Always 0 boolean ClusterWideEvent Inherited from HP_AlertIndication Always 0 string ProviderVersion Inherited from HP_AlertIndication ex. “B.11.23.
PAGE 5
Method Name Description Exceptions Thrown EnableIndications The provider will start delivering Indications CIM_ERR_FAILED DisableIndications The provider will stop delivering Indications None createSubscription No operation done None ModifySubscription No operation done None DeleteSubscription No operation done None Initialize Initializes data CIM_ERR_FAILED Terminate Free’s provider resources None  Indications generated by this provider Table 3: Event Descriptions Severity Proba
PAGE 6
0 – Unknown 26 – LAN Error “lan link has gone down.” “The link has gone down for an unknown reason.” [“If the interface does not return back to its normal operating state on its own try these other actions, in the order listed here, until the problem is resolved.”]k 5 [“Verify that the link partner is operating normally.”] [“Verify that the link settings on this adapter are compatible with the corresponding settings on its link partner.
PAGE 7
 Managed resource documentation Information regarding the HP supported HP-UX Ethernet cards can be found at http://docs.hp.com (the I/O cards and Networking Software section).  Client information This provider is designed to work with any WBEM aware client that subscribes and handles HP_DeviceIndications. Please refer to client specific documentation for information on how to enable HP_DeviceIndications.
PAGE 8
For additional information on HP products and services, visit us at http://www.hp.com. For the location of the nearest sales office, call: United States: +1 800 637 7740 Canada: +1 905 206 4725 Japan: +81 3 3331 6111 Latin America: +1 305 267 4220 Australia/New Zealand: +61 3 9272 2895 Asia Pacific: +8522 599 7777 Europe/Africa/Middle East: +41 22 780 81 11 For more information, contact any of our worldwide sales offices or HP Channel Partners (in the U.S., call 1 800 637 7740).