Emerson 4620 User Manual
System Management Interface Based
on HPI-B (Centellis 4620)
User’s Guide
6806800D85A
July 2008
©
2008 Emerson
All rights reserved.
Trademarks
Emerson, Business-Critical Continuity, Emerson Network Power and the Emerson Network Power logo are trademarks and service
marks of Emerson Electric Co.
owners.
®
Intel
is a trademark or registered trademark of Intel Corporation or its subsidiaries in the United States and other countries.
™
and all other Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other
Java
countries.
Microsoft
Microsoft Corporation.
PICMG
PCI Industrial Computer Manufacturers Group.
UNIX
®
, Windows® and Windows Me® are registered trademarks of Microsoft Corporation; and Windows XP™ is a trademark of
®
, CompactPCI®, AdvancedTCA™ and the PICMG, CompactPCI and AdvancedTCA logos are registered trademarks of the
®
is a registered trademark of The Open Group in the United States and other countries.
©
2008 Emerson Electric Co. All other product or service names are the property of their respective
Notice
While reasonable efforts have been made to assure the accuracy of this document, Emerson assumes no liability resulting from any
omissions in this document, or from the use of the information obtained therein. Emerson reserves the right to revise this document
and to make changes from time to time in the content hereof without obligation of Emerson to notify any person of such revision or
changes.
Electronic versions of this material may be read online, downloaded for personal use, or referenced in another document as a URL to
a Emerson website. The text itself may not be published commercially in print or electronic form, edited, translated, or otherwise altered
without the permission of Emerson,
It is possible that this publication may contain reference to or information about Emerson products (machines and programs),
programming, or services that are not available in your country. Such references or information must not be construed to mean that
Emerson intends to announce such Emerson products, programming, or services in your country.
Limited and Restricted Rights Legend
If the documentation contained herein is supplied, directly or indirectly, to the U.S. Government, the following notice shall apply unless
otherwise agreed to in writing by Emerson.
Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (b)(3) of the Rights in Technical
Data clause at DFARS 252.227-7013 (Nov. 1995) and of the Rights in Noncommercial Computer Software and Documentation clause
at DFARS 252.227-7014 (Jun. 1995).
Contact Address
Emerson Network Power - Embedded Computing
Lilienthalstr. 15
85579 Neubiberg/Munich
Germany
Contents
About this Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1 System Management Interfaces Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
1.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
1.2 Standard Compliances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
1.3 Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
1.3.1 HPI Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
1.3.2 HPI Daemon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
1.4 High Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
2 Software Installation and Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
2.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
2.2 Installing and Configuring the HPI-B Daemon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
2.2.1 Installing an HPI-B Daemon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
2.2.2 Configuring an HPI Daemon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
2.3 Setting Up HPI Clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
2.3.1 Installing HPI Clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
2.3.2 Configuring HPI Clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
3 Developing Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
3.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
3.2 Building the Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
4 Using HPI-B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
4.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
4.2 Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
4.2.1 Limitations with Respect to HPI-B Base Specification . . . . . . . . . . . . . . . . . . . . . . . . . . 23
4.2.2 Limitations with Respect to HPI-B AdvancedTCA Mapping Specification . . . . . . . . . . . 24
4.3 Working with the Multishelf Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
4.3.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
4.3.2 Accessing HPI Domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
4.3.3 How Domains and Shelves are Represented . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
4.3.3.1 Domain Management Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
4.3.3.2 Shelf Management Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
4.3.3.3 HPI Domain Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
4.3.4 Discovering Shelves and Domains. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
4.3.5 Adding and Removing Shelves and Domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
System Management Interface Based on HPI-B (Centellis 4620) User’s Guide (6806800D85A)
3
Contents
4.3.5.1 Adding Shelves and Domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
4.3.5.2 Removing Shelves and Domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
4.4 Emerson Extensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
4.4.1 HPI Controls for Domain and Shelf Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
4.4.2 IPMI System Boot Options Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
4.4.3 POST Type Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
4.4.4 HPI Logging Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
A Example Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
A.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
A.2 Example Application Source Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
A.3 List of Supported Example Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
B Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
B.1 Emerson Network Power - Embedded Computing Documents . . . . . . . . . . . . . . . . . . . . . . . . 51
B.2 Related Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
4
System Management Interface Based on HPI-B (Centellis 4620) User’s Guide (6806800D85A)
List of Tables
Table 1-1 HPI-B Standards Supported by Emerson HPI-B Implementation . . . . . . . . . . . . . . . . 13
Table 2-1 RPM Files for HPI-B Clients and Daemons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Table 2-2 Overview of HPI-B Directories and Files on ATCA-F120 . . . . . . . . . . . . . . . . . . . . . . . 18
Table 2-3 Overview of HPI-B Directories and Files on Node Blades . . . . . . . . . . . . . . . . . . . . . . 19
Table 2-4 Multishelf Library Configuration File - HPI Daemon Entries . . . . . . . . . . . . . . . . . . . . . 20
Table 2-5 IP Addresses/Ports of HPI Daemons in a Centellis 4620 Shelf . . . . . . . . . . . . . . . . . . 20
Table 3-1 Development RPMs - Directory Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Table 4-1 Definition of Domain Management Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Table 4-2 Domain Management Control RDR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Table 4-3 Domain Management Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Table 4-4 Domain Management Control State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Table 4-5 Shelf Management Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Table 4-6 Connection State RDR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Table 4-7 Domain Connection Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Table 4-8 Domain Connection Sensor Reading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Table 4-9 Domain Connection Sensor Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Table 4-10 Boot Option RDR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Table 4-11 Boot Option Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Table 4-12 Boot Option State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Table 4-13 POST Type HPI Control RDR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Table 4-14 POST Type HPI Control Sate Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Table 4-15 Log RDR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Table 4-16 Log Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Table 4-17 Log Control State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Table B-1 Emerson Network Power - Embedded Computing Publications . . . . . . . . . . . . . . . . . 51
Table B-2 Related Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
System Management Interface Based on HPI-B (Centellis 4620) User’s Guide (6806800D85A)
5
List of Tables
6
System Management Interface Based on HPI-B (Centellis 4620) User’s Guide (6806800D85A)
List of Figures
Figure 1-1 Overview of HPI Usage in Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Figure 4-1 Multishelf Library - Representation of Shelves as Domains . . . . . . . . . . . . . . . . . . . . . 25
Figure 4-2 HPI Multishelf Library - Overview of Related HPI Resources and Controls . . . . . . . . . 27
System Management Interface Based on HPI-B (Centellis 4620) User’s Guide (6806800D85A)
7
List of Figures
8
System Management Interface Based on HPI-B (Centellis 4620) User’s Guide (6806800D85A)
About this Manual
Overview of Contents
This manual is divided into the following chapters and appendices.
z Chapter 1, System Management Interfaces Overview, on page 13
Provides an overview on HPI-B in Emerson AdvancedTCA systems
z Chapter 2, Software Installation and Configuration, on page 17
Describes how to install and configure HPI-B clients and HPI-B daemons.
z Chapter 3, Developing Applications, on page 21
Describes the necessary steps in order to build HPI-B client applications
z Chapter 4, Using HPI-B, on page 23
Describes in detail which HPI-B features are supported
z Appendix A, Example Applications, on page 39
Briefly describes HPI-B example applications, which are delivered as part of the Emerson
HPI-B distribution
z Appendix B, Related Documentation, on page 51
Provides references to other, related documentation
Abbreviations
This document uses the following abbreviations:
Abbreviation Description
AMC Advanced Mezzanine Module
ATCA Advanced Telecom Computing Architecture
BT Block Transfer
CGE Carrier Grade Edition
CPIO Copy In/Out
CPU Central Processing Unit
ECC Embedded Communications Computing
FRU Field Replaceable Unit
HPI Hardware Platform Interface
IA Intel Architecture
ID Identifier
IP Internet Protocol
IPMI Intelligent Platform Management Interface
System Management Interface Based on HPI-B (Centellis 4620) User’s Guide (6806800D85A)
9
About this Manual
Abbreviation Description
LAN Local Area Network
MVL Montavista Linux
OEM Original Equipment Manufacturer
PICMG PCI Industrial Computer Manufacturers Group
RMCP Remote Management Control Protocol
RPM RedHat Package Manager
SAF Service Availability Forum
SAI Service Availability Interface
SAIM Service Availability Interface Mapping
SAM Shelf Management Alarm Module
SMI Serial Management Interface
ShMC Shelf Management Controller
Conventions
The following table describes the conventions used throughout this manual.
Notation Description
0x00000000 Typical notation for hexadecimal numbers
0b0000 Same for binary numbers (digits are 0 and 1)
bold Used to emphasize a word
Screen Used for on-screen output and code related
Courier + Bold Used to characterize user input and to
Reference Used for references and for table and figure
File > Exit Notation for selecting a submenu
<text> Notation for variables and keys
[text] Notation for software buttons to click on the
... Repeated item for example node 1, node 2,
(digits are 0 through F), for example used for
addresses and offsets
elements or commands in body text
separate it from system output
descriptions
screen and parameter description
..., node 12
10
.
.
.
.. Ranges, for example: 0..4 means one of the
System Management Interface Based on HPI-B (Centellis 4620) User’s Guide (6806800D85A)
Omission of information from
example/command that is not necessary at
the time being
integers 0,1,2,3, and 4 (used in registers)
Notation Description
| Logical OR
Indicates a hazardous situation which, if not
avoided, could result in death or serious
injury
Indicates a hazardous situation which, if not
avoided, may result in minor or moderate
injury
Indicates a property damage message
No danger encountered. Pay attention to
important information
About this Manual
Summary of Changes
This manual has been revised and replaces all prior editions.
Part Number Publication Date Description
6806800D85A July 2008 Early access version
Comments and Suggestions
We welcome and appreciate your comments on our documentation. We want to know what you
think about our manuals and how we can make them better.
Mail comments to us by filling out the following online form:
http://www.emersonnetworkpowerembeddedcomputing.com/ > Contact Us > Online Form
In "Area of Interest" select "Technical Documentation". Be sure to include the title, part number,
and revision of the manual and tell us how you used it.
System Management Interface Based on HPI-B (Centellis 4620) User’s Guide (6806800D85A)
11
About this Manual
12
System Management Interface Based on HPI-B (Centellis 4620) User’s Guide (6806800D85A)
System Management Interfaces Overview
1.1 Introduction
Emerson provides an SAF Hardware Platform Interface (HPI) as part of its AdvancedTCA
platforms. HPI provides an industry standard interface to monitor and control highly available
telecommunications system platforms. The ability to monitor and control these platforms is
provided through a consistent and standard set of programmatic interfaces that are targeted for
adoption by the telecom building block industry to significantly reduce product time-to-market
and development costs while retaining or enhancing total system/network availability.
HPI provides the interface between the middleware software solution stack and the hardware
solution stack, allowing portability of middleware software building blocks across many different
hardware platforms and portability of hardware platforms across many different middleware
software building blocks.
This guide describes the HPI-B implementation targeted at the Emerson AdvancedTCA
Centellis 4620 platform.
1.2 Standard Compliances
1
The Emerson HPI-B implementation for the Centellis 4620 environment is compliant to the
following standards.
Table 1-1 HPI-B Standards Supported by Emerson HPI-B Implementation
Standard Description
SAI-HPI-B.01.02 HPI-B base specification. It abstracts hardware
SAIM-HPI-B.02.01-ATCA HPI-B-AdvancedTCA mapping specification. It
Although the standards listed above are fulfilled, some specific limitations apply. For details,
refer to Limitations on page 27.
1.3 Architecture
The Emerson HPI implementation is provided in the form of a client-server architecture. In the
Centellis 4620 system environment the server, called HPI daemon, runs on the ATCA-F120
switch blade, and the client, which is constituted by an HPI library and an application which links
that library, runs on any node within a shelf. Internally each HPI daemon is connected to a Shelf
platform characteristics into a data model
consisting of entities and resources.
provides a vendor independent hardware
platform view of an AdvancedTCA system.
System Management Interface Based on HPI-B (Centellis 4620) User’s Guide (6806800D85A)
13
F120
HPI Daemon
SAMs
SAMs
F120
HPI Daemon
HPI Daemon
F120
HPI Daemon
System Management Interfaces Overview HPI Library
Management Alarm module (SAM) in the shelf. The communication between HPI daemon and
SAM is realized via RMCP (Remote Management Control Protocol) which is an IPencapsulation of IPMI commands. The communication between HPI daemon and HPI client is
realized by an IP-based remote HPI communication protocol.
An HPI client may access one or more HPI daemons, and on the other hand, an HPI daemon
may be accessed by one or more HPI clients. The following figure illustrates this.
Figure 1-1 Overview of HPI Usage in Systems
1.3.1 HPI Library
The HPI library is the primary user interface. It is intended to be used by applications that wish
to control and monitor HPI managed components, such as ATCA shelves, blades and other
FRUs. The HPI library is delivered as shared and as static library and has to be linked with an
application.
There are two types of HPI libraries available:
z Single shelf library
z Multi shelf library
14
System Management Interface Based on HPI-B (Centellis 4620) User’s Guide (6806800D85A)
HPI Daemon System Management Interfaces Overview
The single shelf library supports the communication with one HPI daemon only. Since it is only
used internally and is not intended to be used by user applications, it will not be described any
further in this manual. The multishelf library, on the other hand, supports the communication
with one up to several HPI daemons. This becomes necessary if you wish to deploy redundancy
in one HPI-B based shelf management system or if you wish to manage several shelves. The
multishelf library is the library which you should build your applications on, it is the official
interface to customer applications.
Details about supported combinations of CPU architecture/Linux distribution are given in
Chapter 2, Software Installation and Configuration, on page 17.
1.3.2 HPI Daemon
The HPI daemon within an Centellis 4620 system runs on the ATCA-F120 blades and its main
tasks are:
z Provide a single access point to control and monitor hardware components in a shelf
z Map information provided by the underlying Shelf Manager to HPI
1.4 High Availability
The Emerson HPI-B implementation described in this manual supports the following two
redundancy options:
z Active/active
z Cold-standby
The active/active option is the default configuration. Both HPI daemons in shelf are active and
run simultaneously. Your application connects to one daemon and if the connection fails it
connects to the second daemon. Note that the current HPI-B implementation does not replicate
any data between the two daemons, this means data consistency is not guaranteed.
Alternatively you may choose to use the cold-standby redundancy option. In this configuration
your application must make sure that only one HPI daemon is active at a time. If the daemon
fails, your application starts up the second, previously inactive daemon and connects to it.
During start-up the HPI daemon scans the current system environment. This way it is ensured
that the daemon reflects the current system configuration.
System Management Interface Based on HPI-B (Centellis 4620) User’s Guide (6806800D85A)
15
System Management Interfaces Overview High Availability
16
System Management Interface Based on HPI-B (Centellis 4620) User’s Guide (6806800D85A)
Loading...