Specifications

2
Performing Updates Using rsys_swm
31
Configuration file syntax
Theupgradecampaignconfigurationfileusedbythersys_swmutilitymustconformtothe
YAMLfileformat.Seehttp://pyyaml.org/wiki/LibYAMLtodownloadthelibrary(libyaml).
AdditionalinformationontheYAMLformatcanbefoundathttp://yaml.org/spec/1.1.
Formatting guidelines
TheconfigurationfilemustconformtotheseYAML1.1specifications:
• Indentationsmustbeinsertedwithspaces.Donotusetabstogeneratewhitespaceinthe
configurationfile.
• Indentationmustbeconsistentwithinlevels.
Thisexampleisincorrect:
‐releaseuri:file:///mnt/release‐4.x.x‐EI2
‐exclude:system‐boot,boot‐block,legacy‐fpga#skipUBootandBIOS
Thisexampleiscorrect:
‐releaseuri:file:///mnt/release‐4.x.x‐EI2
‐exclude:system‐boot,boot‐block,legacy‐fpga#skipUBootandBIOS
•Commentscanbeplacedinthefile,precededbya#symbol
Ifyoucopyanyofthesampleconfigurationfilesfromthisdocument(seepage 41),youwill
needtoproperlyformatthefileusingtheYAMLspecificationsothersys_swmutilitycan
parseit.Youcanverifytheconfigurationiscorrectbyissuingthefollowingbeforerunningthe
command:
rsys_swm‐i<serverip>‐c<configfile>‐‐verify
Ifaconfigurationfi leisincorrectlyformatted,youmayreceiveanerrorsimilartothis:
YAMLError:Invalidelementinmap
Code:YAML_LOAD_ERR_BAD_MAP_ELEMENT