Adding and Removing Shelves and Domains | Emerson 4620 specification

Using HPI-B	Adding and Removing Shelves and Domains

Alternatively, you can use the Shelf Management Resources defined in the default domain. Any shelves that were added to the HPI environment are represented by one Shelf Management Resource with the entry ResourceCapability set to SAHPI_CAPABILITY_DOMAIN. So in order to discover shelves/domains, you simply need to parse the default domain for HPI resources with the entry ResourceCapability set to SAHPI_CAPABILITY_DOMAIN. Then you can obtain the respective domain ID by reading the entry DomainId and open a session to the shelf using the obtained domain ID.

4.3.5Adding and Removing Shelves and Domains

All shelves which are used by the HPI multishelf library are listed in the multishelf library configuration file. There are two ways of adding and removing shelves:

zManually by editing the multishelf configuration file. Changes become effective after the next restart in this case.

zDynamically by using the HPI domain management control

For a description of how to manually edit the multishelf library configuration file, refer to Configuring HPI Clients on page 20.

A description of how to dynamically add and remove shelves, is given in the following two subsections.

4.3.5.1Adding Shelves and Domains

In order to dynamically add a shelf and create a domain, you must invoke the HPI function saHpiControlStateSet() and provide the following parameters.

Parameter	Value

SessionId	Handle to session context.

ResourceId	Resource ID of the addressed resource.

CtrlNum	Number of the control for which the state is
	being set.

CtrlState	Pointer to control state as described in Table
	"Domain Management Control State" on page 29.
	In this control state, fill the field body as follows:,
	[0]	: 1 (stands for "create domain")
	[1] - [4] : IP address of shelf you want to add (little
	endian order)
	[5]	- [6] : port of shelf (little endian order)
	[7]	- [n] : Domain name

32	System Management Interface Based on HPI-B (Centellis 4620) User’s Guide (6806800D85A)

Image 32

Emerson 4620 manual Using HPI-B Adding and Removing Shelves and Domains, Parameter Value

Contents

System Management Interface Based on HPI-B Centellis Contact Address Contents Contents Related Documentation List of Tables Definition of Domain Management ResourcePage List of Figures Page Abbreviations Overview of ContentsAbout this Manual Conventions About this Manual Abbreviation DescriptionNotation Description Bold About this Manual Notation Description Summary of ChangesComments and Suggestions Page System Management Interfaces Overview IntroductionStandard Compliances Architecture HPI Library System Management Interfaces Overview HPI Library HPI Daemon High AvailabilityHPI Daemon Page Software Installation and Configuration Installing and Configuring the HPI-B DaemonOverview RPM Files for HPI-B Clients and Daemons Installing an HPI-B Daemon Configuring an HPI DaemonOverview of HPI-B Directories and Files on ATCA-F120 Directory Description Overview of HPI-B Directories and Files on Node Blades Setting Up HPI ClientsInstalling HPI Clients Configuring HPI Clients Multishelf Library Configuration File HPI Daemon EntriesIP Addresses/Ports of HPI Daemons in a Centellis 4620 Shelf Entry Description Directory Content Developing ApplicationsBuilding the Application Development RPMs Directory StructurePage Limitations Using HPI-BLimitations with Respect to HPI-B Base Specification Working with the Multishelf Library Overview Accessing HPI Domains Accessing HPI Domains Using HPI-B Using HPI-B How Domains and Shelves are Represented How Domains and Shelves are Represented How Domains and Shelves are Represented Using HPI-B Definition of Domain Management Resource Domain Management Control RDRSaHpiRptEntryT Value SaHpiRdrT Value Shelf Management Resource Domain Management ControlDomain Management Control State Using HPI-BHow Domains and Shelves are Represented Connection State RDR Discovering Shelves and Domains Domain Connection SensorDomain Connection Sensor Reading Domain Connection Sensor Events Parameter Value Using HPI-B Adding and Removing Shelves and DomainsAdding and Removing Shelves and Domains Emerson Extensions Using HPI-B Emerson Extensions Ipmi System Boot Options Support 10 Boot Option RDR11 Boot Option Control Using HPI-B HPI Controls for Domain and Shelf Management 12 Boot Option State Ipmi System Boot Options SupportUsing HPI-BGet operations Set operations Post Type Control HPI Logging Support13 Post Type HPI Control RDR 14 Post Type HPI Control Sate Values 16 Log Control HPI Logging Support Using HPI-B15 Log RDR Using HPI-BHPI Logging Support 17 Log Control State List of Supported Example Applications Example ApplicationsExample Application Source Files Example Applications List of Supported Example Applications List of Supported Example ApplicationsExample Applications Display everything #------------------------------hpifumi #------------------------------ hpihotswap String Example Applications List of Supported Example Applications Option #------------------------------ hpishelf Value Display sensors Emerson Network Power Embedded Computing Documents Related SpecificationsTable B-2 Related Specifications Related Documentation