Specifications
4
Changing Shelf Settings Using HPI
78
HPI server parameter control configuration files
Eachresourcehastwoconfigurationfiles:onefordefaultsettingsandoneforcustomsaved
settings.
Thefollowingarethefilenameformats:
%08X.hcf.deflt–Defaultconfigurationfilenameformat
%08X.hcf.saved–Savedconfigurationfilenameformat
%08XrepresentstheResourceIdin4‐bytehexadecimalformat.
Forexample,aresourcewithID0x70082willhaveconfigurationfiles00070082.hcf.defltand
00070082.hcf.saved.
Allconfigurationfilesarehuman‐readableandmaybeupdatedusinganystandardtexteditor.
However,Radisysrecommendsthatmanualmodificationsnotbemadetoconfigurationfiles
duetothepossibilityofhumanerror.Whiledefaultconfigurationfilesshouldnotneedtobe
updated,thepreferablemethodofupdatingsavedconfigurationfilesistofirstmakethe
necessarychangesintheresourceandthenusetheHPIcallsaHpiParmControl()tosavethe
updatedstateoftheresource.
How configuration files are stored
ThedefaultandsavedconfigurationfilesarestoredinthevolatileRAMfilesystemdirectory
/tmp/shmgr/hpiforfasterreadandwriteaccess.TheHPIserverloadstheconfigurationfi les
fromthisdirectory,whichiscreatedduringShelfManagerstartup.
InadditiontostoringthefilesintheRAMfilesystem,apersistentcopyofallconfiguration
filesisstoredingzippedarchiveformatinthenon‐volatilelocation/var/lib/shmgronthe
ShelfManagermodule.DuringShelfManagerstartupwhentheHPIserverdaemonisgetting
initialized,thegzippedconfigurationarchiveiscopiedfrom/var/lib/shmgrtothe
/tmp/shmgr/hpidirectoryandunzipped.IftheHSD_LOAD_SAVED_CONFIGURATION
parameterissettoYinthe/etc/shmgr.conffile,theHPIserversubsequentlyloadsallsaved
configurationfileswhenitcreatestheassociatedresources.
Everytimeanewconfigurationissavedforaresource,itsassociatedsavedconfigurationfile
isupdatedintheRAMfi lesystem.Theupdatedconfigurationfileisalsoappendedtothe
persistentconfigurationfilearchivein/var/lib/shmgr.Thispreservestheconfigurationfiles
forreusewhentheShelfManagerisrebooted.