Specifications

4
Changing Shelf Settings Using HPI
58
TorunanyHPIapplicationthatlinkswiththeRadisysHPIclientlibrary,libhcl.so,considerthe
following:
•TheSaHpi.hheaderfileandtheHCLsupportHPIB.03.02andarebackwardcompatible
withHPIB.02.01andHPIB.01.01.RadisysrecommendsrecompilingyourHPIapplications
withthenewheaderfile.
•Ensurethe
run‐timeenvironmentisproperlysetupsothatapplicationscanfindtheHPI
clientlibrary.Dothisbycompletingeitherofthefollowingtasks:
•BuildandinstalltheHPIclientlibrary,libhcl.so,andnotetheinstallationlocation.Build
instructionsareprovidedintheHPIclientlibraryandapplicationpackageincludedon
theRadisysFTPsite.
•SettheLD_LIBRARY_PATHenvironmentvariabletothelocationofthelibhcl.so.
YoumustconverttheIPv4addresstoabinaryformatbecausetheDomainIdisdefinedas
a32‐bitunsignedintegerandwouldnotbeabletoacceptanASCII‐formattedIPv4
address.HPIapplicationscanusetheLinuxlibraryfunctioninet_addr()toconvertthe
IPv4‐basedShelfManagerAddresstoabinaryformat.
•ToopensessionstoaremoteHPIserverusingthedefaultDomainId
SAHPI_UNSPECIFIED_DOMAIN_ID,settheenvironmentvariable
SAHPI_UNSPECIFIED_DOMAIN_IDtotheIPaddressoftheShelfManager.Thisshould
normallybethededicatedShelfManagerIPaddressthatisboundtotheactiveShelf
Manager.Forexample,thefollowingBourneshellcommandcreat esandexportsthe
environmentvariableSAHPI_UNSPECIFIED_DOMAIN_IDtotheShelfManagerIPaddress
XX.XX.XX.XX
.
exportSAHPI_UNSPECIFIED_DOMAIN_ID=XX.XX.XX.XX
TheHCLsearchesforthisenvironmentvariablewhenarequesttoopenasessionusing
thedefaultdomainidentifierisreceived.Ifthisvariableisnotset,theHCLwilluse
127.0.0.1todeducetheDomainId.
IfnoHPIserverrespondsatthespecifiedIPaddress,saHpiSessionOpen()willreturnthe
error
code:SA_ERR_HPI_INVALID_DOMAIN.
•WhenrunningtheHPIapplicationremotely,itmightbenecessarytosetupanewroute
fortheShelfManager’sIPaddresssothatcommunicationcanbeestablishedbetweenthe 
remotemachinehostingtheHPIapplicationandtheHPIserver.