Specifications

2
Performing Updates Using rsys_swm
33
‐c<config> SpeciesthepathoftheYAMLformattedupgradecampaign
configurationfile.
‐s<UpdateServerURI>
SpecifiestheURIoftheupdateserverhost.TheURIisusedbymodules
todownloadupdatebundlesfromtherepositoryontheupdatehost.
Thisparameter,alongwiththeinformationprovidedforthe
“releaseuri”inthecampaignconfigurationfileareusedbymodulesto
determinethebundledownloadpath.For
moreinformation,see
Correlationbetweenthe“‐s”parameterandthe“releaseuri”tagon
page 37.
‐v[v] Displaysthecampaigntrackingmessagesinverbosemode:
‐vdisplaysdotstoshowtheprogressoftheupgradeandalsodisplays
messagesfromthecallbackfunction.
‐vvdisplaysverboseprogressmessagesfromthecallbackfunction.
Actions:
‐‐version Displaystheversioninformationforrsys_swmandthenexitstheutility.
‐‐verify Checkstheconfigurationfileandprintsasummaryoftheupdate
configurationresults.
‐‐info Displaystheversionsofallmodulesandtheirsoftwareentitiesunder
therootentity.
‐‐upgrade Performstheupgradecampaign.Ifthesoftwareorthefirmware
versionsonanyofthesoftwareentitiesmatchtheversionscontained in
thecurrentsoftwarebundle,thesoftwareentitieswillbeskipped
duringtheupgrade.
Inaddition,twovariantsoftheupgradeoperationexist:
• Upgradecheck,whichverifiesandcomparesthepresentlyinstalled
imageversionswiththeimageversionsincludedintheupdate
bundles,butdoesnotinstalloractivatethesoftware.
• Upgradeforce,whichupdatesallprogrammabledevicesregardless
oftheversioncheckresults.I.e.,thisvariantwillperformthe
installationandtheactivationevenwhenanactiveimage
version
matchesanimageversionintheupdatebundleforamoduleora
component.
‐‐check Performsadry‐run.Usethisoptioninconjunctionwiththe‐‐upgrade
optiononly.
‐‐force Forcesanupdateonallcomponentsregardlessofversion.Usethis
optionwiththe‐‐upgradeoptiononly.