
ATCA FIRMWARE AND SOFTWARE UPDATE INSTRUCTIONSUSING THE RADISYS SOFTWARE MANAGEMENT FRAMEWORKApril 2012 007-03428-0003
1Introduction10System managerAsystemmanagerisahigh‐levelmanagementapplicationthatmaymanageentitiesrangingfromasingleshelftomultiple
1Introduction11Firmware toolsRadisysprovidesfirmwar etoolsthatinteractdirectlywiththehardwaretoperformsoftwaremanagementoperations.The
2Chapter12Performing Updates Using rsys_swmProcedures for update processTheproceduresforupdatingoneormoreRadisysshelvesisasfollows:1. Plan
2Performing Updates Using rsys_swm13IfyouintendtoincludeShelfManagermodulesliketheATCA‐2210intheupgrade,somefurtherplanningandprepar
2Performing Updates Using rsys_swm14Determine when to perform the updateYourplanningshouldtak eintoaccountthetimeneededtoperformtheupdate
2Performing Updates Using rsys_swm15•thedirectories/rsys/onboot.dand/rsys/onboot.dataareremovedandrepopulatedbythenewrelease,and•theconf
2Performing Updates Using rsys_swm16Create a custom preservation listYoumaywanttopreserveotherfilesthatarenotpreservedautomatically.Forex
2Performing Updates Using rsys_swm17Step 2: Prepare the update hostTheupdatehostmustbeaLinuxhostwithLANaccesstothemodulesintheshelf.A
2Performing Updates Using rsys_swm18Step 3: Determine and configure the required IP interfaces Updates to multiple modulesWhenupdatinganentireshel
2Performing Updates Using rsys_swm19IfaparticularFRUismissingfromtheversionreport,thenitsBladeHSDisnotregisteredwiththeShelfManage
Revision historyVersion Date Description-0000 March 2011 First edition.-0001 June 2011 Second edition. Updated to state that ATCA-7220 data flow mode
2Performing Updates Using rsys_swm20Sample rsyshsd.conf fileThethreeIPinterfaceparametersappearnearthebottomoftheconfigurationfile.Anexa
2Performing Updates Using rsys_swm21CPM-specific recommendationsOnCPMmodules,theinterfacesaresettothefollowingbydefault:•RSYSHSD_BASE_INTER
2Performing Updates Using rsys_swm22Updates to the Shelf Manager modulesIfyouexecutetheupgradeusingtheShelfManager’sIPaddressagainstashel
2Performing Updates Using rsys_swm23Step 4: Obtain the release ISO image from RadisysAnATCASoftwareimageisavailableatwww.radisys.com/downloads.
2Performing Updates Using rsys_swm24Iftheexportwassuccessful,youwill seethefolderlisted.4. Logontothemodule(forexample,anATCA‐2210)
2Performing Updates Using rsys_swm25Step 5: Install the software packagesLocatethefollowingpackagesandinstallthemontheupdatehostintheorde
2Performing Updates Using rsys_swm26Step 6: Define the upgrade campaign configuration fileBeforeyoucanruntheupdateprocess,youmustcreat eand
2Performing Updates Using rsys_swm27Required configurationreleaseuri tagThistagspecifiestheURIoftheupdaterepositoryontheupdatehost.Thisi
2Performing Updates Using rsys_swm28ThepossibleSDKssupportedfortheATCA‐7220sarelistedbelow:IfnoSDKisspecifiedfortheATCA‐7220,theSDK
2Performing Updates Using rsys_swm29module tag Thistagidentifiesmodulestobeupdated.SeeSupportedmodulesandcomponentsonpage 7forthelist
3Table of ContentsPreface ...
2Performing Updates Using rsys_swm30exclude tag Thistagspecifiesthecomponentstoexcludefromtheupgradeforallmodules.Thepossibleexcludeta
2Performing Updates Using rsys_swm31Configuration file syntaxTheupgradecampaignconfigurationfileusedbythersys_swmutilitymustconformtothe
2Performing Updates Using rsys_swm32Step 7: Running the rsys_swm utilityThersys_swmutilitycanperformthefollowingoperations:•Checksandverifie
2Performing Updates Using rsys_swm33‐c<config> SpeciesthepathoftheYAMLformattedupgradecampaignconfigurationfile.‐s<UpdateServer
2Performing Updates Using rsys_swm34Using rsys_swm to perform upgradesThedefaultbehaviorofthersys_swmutilityistoupgradeallentitiesunderth
2Performing Updates Using rsys_swm35Usage examplesTo perform a dry run of the upgrade campaign, enter: rsys_swm‐i192.168.16.17\‐c.
2Performing Updates Using rsys_swm36To perform an upgrade campaign on the software entities on a specific module: rsys_swm‐i10.100.18.22
2Performing Updates Using rsys_swm37Correlation between the “-s” parameter and the “releaseuri” tagThe“s”parameter,whichidentifiestheupdateserv
2Performing Updates Using rsys_swm38Callback functionThersys_swmutilityimplementsasamplecallbackfunctioninitscodethatadherestothecallba
2Performing Updates Using rsys_swm39Step 8: Verify the update was successfulReviewtheupgradereportfile“report.yml”aftertheupgradeprocessruns
4Table of ContentsAppendix C: Updating IPMI FW and FRU Data for an AMC or RTM... 56Determining the IPMI firm
2Performing Updates Using rsys_swm40Rear Transitional Modules (RTMs)•ATCA‐1200RTM(optionalRTMfortheATCA‐1200QuadAMCCarrier).•ATCA‐5200RTM(
AAppendix41Sample Configuration FilesThisappendixincludesfoursamplersys_swmupgradecampaignconfigurationfilesthatcanbeusedasguidelinesf
ASample Configuration Files42Example 1: Generic configuration fileThefollowingexampleisgenericandcontainsthetaginformationanddescriptions.#
ASample Configuration Files43‐‐‐campaign:‐releaseuri:file:///mnt/release‐4.0.0‐exclude:system‐boot,boot‐block,legacy‐fpga# skipUBoo
ASample Configuration Files44Example 2: Two phase update Inthisexample,phase1updatesalltheATCA‐7220modulesandATCA‐4500modulestogether.Ph
ASample Configuration Files45Example 3: Three phase update Inthisexample,theupdateiscompletedinthreephases.•Phase1–allATCA‐1200modulesar
ASample Configuration Files46Example 4: Three phase redundant updateInthisexample,ashelfupgradeisperformedinthreephasesandisconfiguredin
ASample Configuration Files47Other configuration file variationsYoucancreateaconfigurationfilethatonlyhasthe“releaseuri”tagspecified.Ify
BAppendix48Updating and Customizing FRU DataUsethe proceduresinthisappendixtoupdateorcustomizeFRUdataforaFRUorshelf.Radisysoccasiona
BUpdating and Customizing FRU Data49Updating FRU dataThefru_updateshellscriptcanbeusedfortwopurposes:• Updatetheportionsofthefunctional
5PrefaceAbout these update instructionsThisdocumentdescribesthersys_swmutility,whichistheupgradeutilityprovidedwiththeRadisysSoftwareM
BUpdating and Customizing FRU Data50Procedure:FromaLinuxhostwithLANaccesstotheShelfManager,updatetheFRUdatabyentering:fru_update"
BUpdating and Customizing FRU Data51Customizing FRU-specific dataThefrugen.plPerlscriptpromptsfornewvaluesfortheuser‐definable fieldsinan
BUpdating and Customizing FRU Data523. Respondtothepromptsbyenteringcustomdataorleavingfieldsblanktokeeptheexistingvalue.Pressingente
BUpdating and Customizing FRU Data53Updating FRU data on the ATCA-6006 5U 6-slot shelfImportant:FortheATCA‐6006shelftorun3.3.0andlater,thes
BUpdating and Customizing FRU Data54c. LocateandmodifytheChassisSerialNumberline:•ChassisSerialNumberisjustbelowthepartnumber.•Replace
BUpdating and Customizing FRU Data556. GenerateashelfFRUdatafilebasedonthechangedtemplatefile.a. Runfrugen.plontheATCA‐2210togenerate
CAppendix56Updating IPMI FW and FRU Data for an AMC or RTMThischapterdescribesupdatingtheAMCorRTMIPMIfirmwareusingrsys‐ipmitoolandupdatin
CUpdating IPMI FW and FRU Data for an AMC or RTM57Updating the IPMI firmwareTheIPMIfirmwareforanRTMorAMCisupdatedusingrsys‐ipmitool.Update
CUpdating IPMI FW and FRU Data for an AMC or RTM58Reviewing the outputTheoutputfromtheIPMIfirmwareupdatecommandsshouldresemblethefollowing
CUpdating IPMI FW and FRU Data for an AMC or RTM59Reverting to backup firmwareUsethisprocedureonlyifyouneedtoreverttothebackupfirmwarever
Preface6Seethefollowingdocumentsforadditionalfirmwareandsoftwareupdateinformation:•ATCA3.xto4.xFirmwareandSoftwareUpgrade/DowngradeI
CUpdating IPMI FW and FRU Data for an AMC or RTM60IPMB and IPMB-L address mappingTable 7providestheIPMBaddressesofATCAfrontmodules,PowerEntr
CUpdating IPMI FW and FRU Data for an AMC or RTM61Table 8providesthelocalIPMBaddresses(IPMB‐L)forAMCandRTMdevices,whichistheIPMBfromt
DAppendix62Updating the BIOS on the CPMsThischapterdescribestheBIOSflashupdatemethodsfortheATCA‐45xxseriesandATCA‐46xxseriesCPMs.Theu
DUpdating the BIOS on the CPMs63Building the flash update driverIftheamifldrv‐<version>.rpmisnotinthesoftwarerelease,youwillneedtob
DUpdating the BIOS on the CPMs64For ATCA-4500, ATCA-4550, and ATCA-4555 CPMs Updating the main BIOS from the Linux command line1. Verifythersysbflas
DUpdating the BIOS on the CPMs65Updating the BIOS from EFI shell1. CopyAFUEFIx64.efi,ME_BIOS.bin,update.nsh,andupdateme.nshtoaUSBflashdrive
EAppendix66Restoring Older Firmware or SoftwareIffirmwareimagecorruptionorincompatibilitiesoccurthatcannotbecorrected,itmaybenecessaryt
FAppendix67TroubleshootingIfanupdatefails,firstchecktomakesurethespecifiedURIandallcommandlineargumentsarecorrect.Forotherfailure
FTroubleshooting68RSYS_E_SML_INVALID_URI Decimalcode: 12582918Hexadecimalcode: 0xC00006Description: AspecifiedURIwasinaninvalidformat.Acti
FTroubleshooting69RSYS_E_SML_UPGRADE_TOOL_NOT_FOUND Decimalcode: 12582921Hexadecimalcode: 0xC00009Description: Thespecifiedupgradetoolcouldn
1Chapter7IntroductionSupported modules and componentsTable 1liststheATCAmodulesandcomponentsthatcanbeupdatedautomaticallybytheRadisysSo
FTroubleshooting70RSYS_E_SML_TARGET_ACTIVATION_FAILEDDecimalcode: 12582924Hexadecimalcode: 0xC0000CDescription: Thenewlyinstalledimagefailed
FTroubleshooting71RSYS_E_SML_INFO_GET_FAILEDDecimalcode: 201326612Hexadecimalcode: 0xC000014Description: TheSMLfailedtoretrieveinformationf
FTroubleshooting72RSYS_E_SML_OPERATION_INIT_FAILEDDecimalcode: 201326616Hexadecimalcode: 0xC000018Description: TheSMLoperationfailedtosetth
FTroubleshooting73RSYS_E_SML_OPERATION_INCOMPLETEDecimalcode: 201326617Hexadecimalcode: 0xC000019Description: TheSMLfailedtocompletethepos
FTroubleshooting74RSYS_E_SML_HPI_BUSYDecimalcode: 201326652Hexadecimalcode: 0xC00003CDescription: TheHPIserverisbusy.Actiontotake: Theupdat
GAppendix75Log File InformationTable 9describesthelogfilesthatcontaininformationabouttheupgradeprocess.Thefilescanbehelpfulintrouble
1Introduction8aFortheATCA‐7220PPM,thedataflowmodeselectionisnotpreservedautomatically.SeetheATCA‐7220PacketProcessingModuleReferenc
1Introduction9Overview of the Software Management Framework ThesectionsthatfollowgiveabriefdescriptionofeachSMFcomponentastheypertainto
Comentarios a estos manuales