Specifications
2
Performing an update using rfw-update
21
Step 5: Create a configuration file (conf.rfw)
Therfw‐updateutilityusesaconfigurationtextfiletospecifywhichmodulesshouldbe
updatedandwhethertheywillbeupdatedinparallelwithothermodulestosavetime.The
textfilecanbeanyname,butitisnamedconf.rfwinthisdocument.
Theconf.rfwfilecontainsalistofbundleswithURLpathsandalistofupdatetargetswith
Telnetconnectstrings.TheupdatetargetconnectstringcontainstheIPaddressand,if
needed,logininformationtoallowaconnectionfromthehosttotheupdatetarg et.All
updatetargetsmustbeaccessiblefromthehostrunningrfw‐update.
Theconf.rfwconfigurationfilealsoidentifiesthelocationsoftheupdatebundles.Thebundles
intheconf.rfwfile mustcontainvalidURLpathsfromeachtargettoupdatebundles
somewhereonthesystem(notnecessarilyonthehost).
Thebundlesdonotneedtobeinthesamelocationwhererfw‐updateisrunwithconf.rfw,
butthebundlesmustbeaccessiblefromtheupdatetargetusingthespecifiedURL.TheIP
connectionsareshowninthefollowingdiagram:
WARNING!DonotincludeaCPMthatisactingastheLinuxhostforrfw‐updateintheconf.rfw
configurationfile.Includingthehostasanupdatetargetwouldinterrupttheupdateprocessfor
theCPMandpotentiallyforothermodulesintheshelf.Instead,updatetheCPMmanuallyusing
rsys‐updateeitherbeforeorafterupdatingallothershelfcomponents.SeeChapter3,Using
rsys‐updateforsingle
productupdates,onpage 31.
Theconf.rfwfilecanbesetuptoruntheupdateprocessonmodulessequentiallyorin
parallel.Whenmodulesareupdatedinparallel,theyareinthesamephasegroup.
See
Setup
phasegroupsonpage 22
.
Runmanrfw‐updateforcompleteinformation.
Create conf.rfw from example.rfw
Youcangenerateconf.rfwfromtheexample.rfwtextfilethatisavailablein/usr/share/rfw‐
update/aftertherfw‐updateinstallation.Thefileiscorrectlyformattedandcontainsmostof
thek eys,soedititasneededandsavethefileasconf.rfw.
Target
module
Host running rfw-update
tftp/ftp/www server
containing update bundle
IP address
(example: 10.10.10.1)
IP address
(example:
10.10.10.2)