Specifications

4
Changing Shelf Settings Using HPI
79
How configuration files are created for a new resource
DuringHPIinitialization(whenresourcesarebeingcreatedfortheshelf,slots,andFRUs),
initialdefaultconfigurationfilesareautomaticallycreatedifnonearefoundin
/tmp/shmgr/hpi.Ifnocorrespondingsavedconfigurationfileisfoundfortheresourcein
/var/lib/shmgr,theinitialdefaultconfigurationfi leiscopiedastheinitialsavedconfiguration
file(withthe.hcf.savedsuffix).Youcanlateroverwritetheinitialsavedconfigurationfilein
/var/lib/shmgrtocreateacustomdefaultconfiguration.
Foryourconvenience,theShelfManagermodule’ssoftwareimagealsocomeswithsample
defaultconfigurationfilesforsomeoftheknownFRUsinthesystem,theslotresourcesand
theshelfresource.Thesesampledefaultconfigurationfilesresideinthe/var/lib/shmgr
directoryofthemodule’ssoftwareimage.Notethatthesampledefa ultconfigurationfilefor
slotresources,SLOTS.hcf.deflt,iscopiedasthedefaultconfigurationfileforallslotresources
thefirsttimeaShelfManagermoduleisinitialized.Themoduledoesnothaveany
configurationfilespriortofirstinitialization.
Creating a default configuration file for a new resource
IfanewFRUisinsertedintheshelfandnosampledefaultconfigurationexists(forexample,in
theunlikelyscenariothatdefaultconfigurationfilecreationfailedduringresourcecreation),
thefollowingprocedurecanbe usedtocreateone:
1. InserttheFRUintheshelfandchecktheHPIRPTforitsresource.Thiscanbedoneusing
anHPI1.1‐compliantuserapplication.
2. BeforeanychangesaremadetotheFRU,usethesaHpiParmControl()functionwith:
ResourceId=ResourceIdofthenewly‐createdresource
ParmAction=SAHPI_SAVE_PARM.
Iftheparametercontroloperationsucceeds,a newsavedconfigurationfilewillhavebeen
crea tedin/tmp/shmgr/hpi.Forexample,forresource0xB0090,asavedconfigurationfile
named000B0090.hcf.savedwillbecreated.
3. Renamethe%08X.hcf.savedfileto%08X.hcf.deflt.
Forexample,forresource0xB0090,thesavedconfigurationfile000B0090.hcf.saved
shouldberenamed
ormovedto000B0090.hcf.deflt.ThisnowbecomesthedefaultHPI
configurationfileforthenewresourceandwillbeloadedwhentheparametercontrol
actionSAHPI_DEFAULT_PARMisinvokedontheresourcebytheHPIapplication.