Document toolboxDocument toolbox

Upgrade Groups and Schedules

Consider the following when you import upgrade groups and their distribution and upgrade schedules:

  • The appliance imports a new upgrade group only when both the distribution and upgrade schedules are inactive.
  • You can modify members and the comment field of an existing upgrade group only when both the distribution and upgrade schedules are inactive.
  • You can modify distribution related fields of an existing upgrade group only when the distribution schedule is inactive.
  • You can modify upgrade related fields of an existing upgrade group only when the upgrade schedule is inactive.
  • The Grid Master is the only member of the Grid Master group. You cannot move it to another upgrade group.
  • You cannot change the members of the Reporting Member group nor move them to another upgrade group.
  • When you remove a member from its original group, it will be placed in the Default group. You may notice additional members in the Default group if you remove members from any upgrade groups.
  • When you specify both dependency and distribution or upgrade time for an upgrade group, dependency takes precedence.

Note: When you import an upgrade group and its distribution and upgrade schedules, you cannot control the activation and deactivation of the schedules. You can activate and deactivate the schedules through the GUI after the import.


Field NameData TypeRequired (Yes/No)Associated GUI FieldAssociated PAPI MethodUsage and Guidelines
Header-upgrade_groupStringYes
UpgradeGroupExample: UpgradeGroup
nameStringYesName
Example: UpgradeGp
commentStringNoCommentcommentAdd this field to overwrite the comment you entered for the upgrade group.
membersGrid member listNoMember Assignment NamemembersEnter a list of Grid members separated by commas. Use the FQDNs of the Grid members. Enclose the entire string in double quotes.
Example:
“corp100.mktg.com,corp100.dev
.com”
time_zone StringNoTime Zonetime_zoneThe value in this field applies to both distribution_time and upgrade_time. If you do not specify a time zone, the Grid level time zone is used.
distribution_dependent_groupStringNoNamedistribution_dependent_groupEnter the name of the preceding upgrade group that this group depends on during a distribution.
distribution_policy StringNoDistribute to Membersdistribution_policyValid values are: SIMULTANEOUSLY or SEQUENTIALLY.
distribution_timeTimeNoStart Distribution (Date/Time)distribution_timeEnter the distribution start date and time in YYYY-MM-DDTHH:MM:SS format.
upgrade_dependent_groupStringNoNameupgrade_dependent_groupEnter the name of the upgrade group that this group depends on during an upgrade.
upgrade_policyStringNoUpgrade Membersupgrade_policyValid values are: SIMULTANEOUSLY or SEQUENTIALLY.
upgrade_timeTimeNoStart Upgradeupgrade_timeEnter the upgrade start date and time in YYYY-MM-DDTHH:MM:SS format.