> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aviatrix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Procedures for Upgrading Aviatrix Controller and Gateways

> This section outlines the general Controller and gateway upgrade instructions.

This section outlines the general Controller and gateway upgrade instructions.

## General Controller and Gateways Upgrade Guidance

This section provides general instructions for upgrading the Controller and
Gateways.

* Upgrade the Controller before upgrading the Gateways:

* It is important to upgrade the Controller first, ensuring it is at the desired
  release version.

* Once the Controller is successfully upgraded, proceed to upgrade the Gateways.

* Upgrade from the current version to the latest release version within the
  current release:

* Verify that the latest release version is available for your current release.

* Consult the documentation specific to your current release version for
  detailed upgrade instructions.

* Follow the provided steps to upgrade both the Controller and Gateways to the
  latest release version.

* Upgrade from the current release (e.g., version N) to a higher release (N+1
  release):

* Note that neither the Controller nor the Gateways support multi-hop upgrades.

* Upgrade sequentially from one adjacent version to another.

* Determine the higher release version (N+1) to which you wish to upgrade.

* Upgrade HA (High Availability) gateways first, then upgrade primary gateways:

* To ensure proper continuity and system availability, it is recommended to
  upgrade HA gateways before upgrading primary gateways. This sequence minimizes
  any potential disruptions during the upgrade process.

<Note>
  It is recommended to schedule upgrades during a maintenance window when short
  periods of traffic disruption can be tolerated. In HA setups, the disruption
  should be minimal.
</Note>

## The Controller and Gateway Upgrade Steps

**Upgrade Steps Outline**

| Step No. | Description                                                                                       |
| :------: | ------------------------------------------------------------------------------------------------- |
|     1    | Back up Copilot and the Controller                                                                |
|     2    | Upgrade Controller to the latest release version of current release.                              |
|     3    | Upgrade HA Gateways to the latest release version of current release.                             |
|     4    | Upgrade primary gateways to the latest release version of current release.                        |
|     5    | Upgrade Controller from current release (e.g., version N) to a higher release (N+1 release)       |
|     6    | Upgrade HA Gateways from current release (e.g., version N) to a higher release (N+1 release)      |
|     7    | Upgrade primary gateways from current release (e.g., version N) to a higher release (N+1 release) |

<Note>
  There is a performance enhancement in the latest image of gateways. It is
  highly recommended to do image upgrades for Transit gateways and optional for
  spoke gateways for Controller version 7.0 and Controller 7.1.
</Note>

For detailed instructions about how to perform Controller and Gateway upgrade on
CoPilot, see:

* <a href={"/docs/enterprise/" + "10.1" + "/guides/maintenance/controller-gateway-upgrade-steps"}>Single-Version Controller and Gateway Upgrade Workflow</a>

* <a href={"/docs/enterprise/" + "10.1" + "/guides/maintenance/controller-gateway-upgrade-latest-image"}>Upgrade your Controller and Gateways to the Latest Aviatrix Supported Images
  (AWS and Azure Only)</a>

* Pre-upgrade Tasks for Controller and Gateways

* Single-Version Upgrade for Controller and Gateways