Specifications

2
Performing Updates Using rsys_swm
38
Callback function
Thersys_swmutilityimplementsasamplecallbackfunctioninitscodethatadherestothe
callbackAPIprototypepublishedintheSMLheaderfile
rsys_swm_api.handdefinedinthe
APIdocumentation(rsys_sml_api_reference.doc)generatedbytheSMLlibrarycode.By
default,thesamplecallbackonlytrackstheupgradecampaign’sprogressanddisplaysiton
screeninverbosemode.
Youcaneditthesamplecallbackcodeandconstructmorecomplexcallbacksthatperform
operationslikeShelfManager
andapplicationswitchovers,orcommissionupdatedmodules
aftermoduleactivation.
Thersys_swmutilitycaneitherignorethecallbackeventsorex ecutecustomoperationslike
performingaswitchoverbetweenphasesorcommissioningupdatedmodulesaftermodule
activation.
ThecallbackfunctioniscalledatthesepointsduringtheupgradeforthecallbackAPI
prototype:
•Discoverystage1:Anupgrade‐capablemoduleisfound.Theentitypathisprovided.
•Discoverystage2:Anupgrade‐capablesoftwareentityisfound.Theentitypathis
provided.
•Phase:Aphaseisstartedorcompleted.Thephaseindexisprovided.
• Upgradeoperation1:Anupgradeoperation(e.g.,installation,activation,etc.)starts,
completes,orfailsonamodule.Theentitypathandtheoperationtypeareprovided.
• Upgradeoperation2:Theupgradeoperationstarts,completes,orfailsonasoftware
entity.Theentitypathandoperationtypeareprovided.
Performing the upgrade on one module
Toperformtheupgradeonasinglemoduleratherthananentireshelf,youcandoanythe
following:
•Runrsys_swmagainstacampaignconfigurationfilethathasonlyonemodulelistedinits
specification.
•Runrsys_swmagainstashelflevelcampaignconfigurationfileandusetheoption
‐ito
specifythetargetmodule’sBladeHSDIPaddressastheHPIserverIPaddress.
•Runrsys_swmagainstashelflevelcampaignconfigurationfileanduseoption‐ito
specifytheShelfManager’sIPaddressandoption‐etonamethespecificmoduleyou
wanttheutilitytoupgrade.