> ## 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.

# Maintenance

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

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 <a href={"/docs/enterprise/" + "10.1" +
  "/guides/maintenance/controller-upgrade-latest-image"}>Upgrade your Controller
  to the Latest Aviatrix Supported Images (AWS and Azure Only)</a>.

<Tabs>
  <Tab title="Controller Upgrade">
    ## 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

    <Frame>
      <img
        src={
  "/images/reference/ui/administration/maintenance-controller-upgrade.png"
}
        alt="Maintenance: Controller Upgrade"
        width="100%"
      />
    </Frame>

    * **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

    <AccordionGroup>
      <Accordion title="Run a Readiness Check">
        To run a Readiness Check:

        1. Go to **Administration** > **Maintenance** > **Controller Upgrade**.
        2. Select the **Target Version**.
        3. 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.
      </Accordion>

      <Accordion title="Enable Auto Readiness Checks">
        To enable a recurring Readiness Check schedule:

        1. Go to **Administration** > **Maintenance** > **Controller Upgrade**.
        2. Click **Settings**.
        3. 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). |
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Gateway Upgrade">
    ## 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

    <Frame>
      <img
        src={
  "/images/reference/ui/administration/maintenance-gateway-upgrade.png"
}
        alt="Maintenance: Gateway Upgrade"
        width="100%"
      />
    </Frame>

    * **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

    <AccordionGroup>
      <Accordion title="View Upgrade Groups">
        To view upgrade groups:

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

        The upgrade groups table shows gateway upgrade status by group.
      </Accordion>

      <Accordion title="Create Upgrade Group">
        To create an upgrade group:

        1. Go to **Administration** > **Maintenance** > **Gateway Upgrade** >
           **Groups**.
        2. Click **+ Upgrade Group**.
        3. 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.                                                               |
      </Accordion>

      <Accordion title="Prepare Upgrade Groups For Upgrade">
        To prepare selected upgrade groups for upgrade:

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

        The selected gateways are prepared for the upgrade.
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Back Up & Migrate">
    ## Purpose

    The **Back Up & Migrate** page configures automated backups for the Controller
    and CoPilot, and triggers backups on demand.

    ## Elements

    <Frame>
      <img
        src={
  "/images/reference/ui/administration/maintenance-backup-migrate.png"
}
        alt="Maintenance: Back Up & Migrate"
        width="100%"
      />
    </Frame>

    * **Back Up Controller**: Shows backup **Frequency** and **Backups Retained**.
      **Backup Now** button to trigger an immediate backup.
    * **Back Up CoPilot Configuration**: Shows **Frequency**, **Last Backup**, and
      **Next Scheduled Backup**. **Disable** button to turn off automated
      configuration backups.
    * **Back Up CoPilot Data**: Shows **Frequency (UTC)**, **Backups Retained**,
      **Next Scheduled Backup**, **Last Successful Backup**, and **Last Successful
      Backup Name**. **Backup Now** button to trigger an immediate backup.

    ## Actions

    <AccordionGroup>
      <Accordion title="Back Up Now">
        To trigger an immediate backup:

        1. Go to **Administration** > **Maintenance** > **Back Up & Migrate**.
        2. On **Back Up Controller** or **Back Up CoPilot Data**, click **Backup
           Now**.

        A backup starts immediately, outside the configured schedule.
      </Accordion>

      <Accordion title="Disable Automated Backup">
        To disable an automated backup:

        1. Go to **Administration** > **Maintenance** > **Back Up & Migrate**.
        2. On **Back Up CoPilot Configuration**, click **Disable**.

        Automated backups for that item stop until re-enabled.
      </Accordion>
    </AccordionGroup>
  </Tab>
</Tabs>