Maintenance

This section provides the purpose, elements, and actions performed on the Administration > Maintenance pages.

Major Upgrade Paths

Use these paths when planning multi-version upgrades:

If your Controller is 6.9 or earlier, you must first upgrade to 7.0.
If your Controller is 7.0, upgrade to 7.1.
If your Controller is 7.1, upgrade to 7.2.
For 7.2 and later, see Upgrade your Controller to the Latest Aviatrix Supported Images (AWS and Azure Only).

Controller Upgrade
Gateway Upgrade
Back Up & Migrate

Purpose

The Controller Upgrade page runs a Readiness Check against a target version before you upgrade the Controller, and lets you start the upgrade once blocking issues are resolved.

Elements

Target Version: Dropdown to select the version to check readiness against and upgrade to.
Settings: Opens the Readiness Check Scheduler dialog to enable recurring automatic Readiness Checks.
Run Readiness Check / Re-Run Readiness Check: Button to start a Readiness Check for the selected target version.
More Options: Menu with Force Upgrade Controller, to start the upgrade despite blocking Readiness Check results.
Last Run: Timestamp of the most recent Readiness Check.
Failed (Blocker), Failed (Non-Blocker), Could Not Run, Passed: Result counts for the most recent Readiness Check.
Issue list: For each failed or skipped check, shows severity, a description, and a Support link.

Actions

Run a Readiness Check

To run a Readiness Check:

Go to Administration > Maintenance > Controller Upgrade.
Select the Target Version.
Click Run Readiness Check (or Re-Run Readiness Check).

Readiness Checks run in the background. The result counts and issue list appear when the check completes.

Enable Auto Readiness Checks

To enable a recurring Readiness Check schedule:

Go to Administration > Maintenance > Controller Upgrade.
Click Settings.
In the Readiness Check Scheduler dialog, select the Check Frequency and click Enable Auto Readiness Checks.

Parameter Details

CoPilot Parameter Name	Description
Check Frequency	How often the automatic Readiness Check runs (for example, every 24 hours).

Purpose

The Gateway Upgrade page helps you keep gateways up to date with a rolling selective upgrade process. View the last upgrade or manage upgrade groups so you can upgrade gateways in logical groups and minimize disruption.

Elements

Last Upgrade / Upgrade Groups: Toggle between the last upgrade summary and the upgrade groups table.
+ Upgrade Group: Button to create a new upgrade group.
Show filters: Button to show filters for the upgrade groups table.
Select columns: Button to select columns for the upgrade groups table.
Export: Export button to download upgrade groups data.
Search: Search box for filtering table content.
Show Gateways in More Than One Group: Toggle to include gateways matched by more than one upgrade group.
Prepare For Upgrade: Button to prepare the selected upgrade groups for upgrade.

Parameter Details

CoPilot Parameter Name	Description
Order	Shows the order/priority of the upgrade group in the upgrade plan.
Name	Shows the name of the upgrade group.
Gateway Type	Shows the type of gateway (e.g., Transit, Spoke).
Gateway Instance	Shows the number of gateway instances in the upgrade group.
Account	Shows the cloud account associated with the upgrade group.
Cloud	Shows the cloud provider (e.g., AWS, Azure, GCP).
Region	Shows the cloud region where gateways in the group are located.
Upgrade Group	Shows the current status of the upgrade group (e.g., Pending, Failed).

Actions

View Upgrade Groups

To view upgrade groups:

Go to Administration > Maintenance > Gateway Upgrade > Groups.
Optionally, use Show filters, Select columns, Export, or Search to inspect groups.

The upgrade groups table shows gateway upgrade status by group.

Create Upgrade Group

To create an upgrade group:

Go to Administration > Maintenance > Gateway Upgrade > Groups.
Click + Upgrade Group.
In the dialog, enter a group Name, select matching conditions (Gateway type, cloud, region, account, gateway name, current image version, kernel version; combine with AND or OR), and set group order (e.g., Place Upgrade Group: Above, Below, Top, or Bottom). Click Save.

A notification appears and the new upgrade group is added to the upgrade plan.

Parameter Details

CoPilot Parameter Name	Description
Name	Enter a name for the upgrade group.
Matching conditions	Select criteria: Gateway type, cloud, region, account, gateway name, current image version, kernel version. Combine with AND or OR. Enable Preview to view matching gateways.
Place Upgrade Group (group order)	Select where to place the group: Above, Below, Top, or Bottom relative to existing groups; or set order number.

Prepare Upgrade Groups For Upgrade

To prepare selected upgrade groups for upgrade:

Go to Administration > Maintenance > Gateway Upgrade > Groups.
Select one or more upgrade groups in the table.
Click Prepare For Upgrade.

The selected gateways are prepared for the upgrade.

Concepts & Architecture

Guides

Reference

Major Upgrade Paths

Purpose

Elements

Actions

Parameter Details

Purpose

Elements

Parameter Details

Actions

Parameter Details

Purpose

Elements

Actions

​Major Upgrade Paths

​Purpose

​Elements

​Actions

​Parameter Details

​Purpose

​Elements

​Parameter Details

​Actions

​Parameter Details

​Purpose

​Elements

​Actions

Major Upgrade Paths

Purpose

Elements

Actions

Parameter Details

Purpose

Elements

Parameter Details

Actions

Parameter Details

Purpose

Elements

Actions