Specifications

2
Performing an update using rfw-update
22
Create conf.rfw from samples in the appendix
Theconf.rfwfilecanalsobecreatedbyreferringtosamplesdocumentedinAppendixA,
Sampleconf.rfwfile,onpage 78.Asimpleexampleisprovidedforreferenceandgeneraluse,
andthedetailedexamplecanbeusedtoproduceacompletemoduleupdatelist.
Compose and verify the configuration file
1. Useatexteditortocreateaconfigurationfile.RefertoAppendixA,Sampleconf.rfwfile,
onpage 78foratemplate.SeeConfigurationfilesyntaxonpage 78forfilesetupdetails.
2. Savetheconfigurationfileasconf.rfwtoaneasilyaccessibledirectoryandinalocation
thatcanbeaccessedbytheLinuxhostsystemwhererfw‐updatewillexecute.
3. Usethefollowingcommandstoverifytheformatandtestthestructureandsyntaxof
conf.rfw,theconnectionstoeachmoduleandbundle,andversionsofboth.
Toseeanoverviewoftheupdateorderasyoudeveloptheconf.rfwfile:
rfw‐update‐‐parse‐only<path_to_conf.rfw>/conf.rfw
Verifythesyntaxoftheconfigurationfileandtesttheconnectionstoeachmodule:
rfw‐update‐‐quick‐check<path_to_conf.rfw>/conf.rfw
Verifythateachtarg etcanaccessthebundlesfromthemodule.Thiscommandshowsthe
versionsofallbundlesandmodules:
rfw‐update‐‐versions<path_to_conf.rfw>/conf.rfw
Set up phase groups
Theconf.rfwfilecanbesetuptoruntheupdateprocessonmodulessequentiallyorin
parallel.Whenmodulesareupdatedinparallel,theyareinthesamephasegroup.Aparallel
updateisshowninFigure 2onpage 23.Thegraybarsinthediagram showhowrfw‐update
performsoperationsonthenodemodulessimultaneouslyindifferentstagesoftheupdate
process.
Youcanplaceanyupdatetargetintoaspecificphasegroupusingthephaseoptioninconf.rfw.
Ifaphasegroupisnotspecifiedfortheupdatetarget,thetargetisplacedinitsownunique
phasegroupandthetargetisupdatedsequentially.
WARNING!Placeanymodulethatprovidesnetworkconnectivitytoothermodulesinitsown
phasegroup.Otherwise,whenthemoduleisrebooted,theupdateprocessfortheothermodules
maybedisrupted.
Youcanseeanoverviewoftheupdateorderasyoudeveloptheconf.rfwfilewiththe‐‐
parse‐only
option.Forexample:
rfw‐update‐‐parse‐onlyconf.rfw