Specifications

2
Performing Updates Using rsys_swm
26
Step 6: Define the upgrade campaign configuration file
Beforeyoucanruntheupdateprocess,youmustcreat eanddefineanupgr adecampaign
configurationfile.Thisconfigurationfileis usedbythersys_swmutilityindeterminingwhich
modulesandcomponentsareupdatedandinwhatordertheupdatestak eplace.
Youcangenerateanupgradeconfigurationfromthesampletextfile“config.cfg”thatis
availablein/usr/share/rsys_swm/folder.Thefileiscorrectlyformattedandcontainsmostof
thetags,soedititasneeded,andsavethefile withanamethatwillmakeiteasilyidentifiable
astheupgradecampaignfile.Forexample,“upgrade‐campaign.yml”or“upgrade‐config. yml.”
Thefilecanhavea.ymlextensionora.cfgextension.
Thefileincludesthefollowingsections:
•Anintroductorysection,whichdescribesthedifferenttags(orparameters)inthe
document.
•Acampaignsection,whereyouenterthespecificparametersfortheupdate.
Theupgradeconfiguration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.
Seephasetagonpage 28formoreinformationaboutphases.
Figure 2belowshowsthedetailsofthecampaignspecificationsection.Foranexampleofan
upgradeconfigurationfilethatincludesthetagdescriptions,seepage 41.
Figure 2. Upgrade configuration file: campaign section example
# Upgrade campaign example
#
# This le is used for specifying the upgrade campaign.
#
---
campaign:
- releaseuri: le:///mnt/release-4.0.1
- exclude: system-boot, boot-block, legacy-fpga # skip UBoot, BIOS boot-block, &
legacy FPGAs on all modules
- phase: # Phase 0
- step:
- module: board.8 # upgrade the board in slot 8
- exclude: fru-data # skip IPMI fru data
- step:
- module: ATCA-4500.[2,5] # upgrade ATCA-4500s in slots 2 and 5
- os: wr2_32 # Use the update bundle for WR2 32 bit OS
- exclude: ipmc-, fru-data # skip ipmc components and fru data
- phase: # Phase 1
- step:
- module: ATCA-1200 # Upgrade all ATCA-1200s in the shelf
...
Update repository location
Components skipped on all modules
Module in slot 8 and ATCA-4500s in slots 2
& 5 are updated in parallel in the first phase
ATCA-4500s are expected to run the Wind River
Ver 2, 32 bit operating system.
Components skipped on the ATCA-4500s
In second phase, all ATCA-1200s are updated