Prerequisites and Guidelines
This section describes how to upgrade or downgrade a 3-node Cisco ACI Multi-Site Orchestrator cluster that was deployed in Cisco Application Service Engine. If your Orchestrator cluster was deployed in VMware ESX VMs, see the Upgrading Orchestrator Deployments in VMware ESX chapter. If you deployed a single-node Orchestrator (for example, for testing purposes), the upgrade procedure differs slightly and is described in Installing Single Node Orchestrator chapter instead.
Before you upgrade your Cisco ACI Multi-Site Orchestrator cluster, you must:-
Ensure that you are running at least Cisco ACI Multi-Site Orchestrator, Release 2.2(3). If you are running an earlier release, your cluster was deployed in VMware ESX VMs and you must follow the Upgrading Orchestrator Deployments in VMware ESX chapter instead.
-
Ensure that your current Cisco ACI Multi-Site Orchestrator installation is running properly.
The following sections provide steps specific to upgrading, however the same exact procedure can be used to switch to an earlier image to downgrade your installation. Keep in mind however, the Application Service Engine deployments cannot be downgraded to a release prior to Release 2.2(3).
Cisco ACI Multi-Site and Cisco APIC Interoperability Support
Prior to Release 2.2(1), you were required to run the same APIC versions in all sites and the version of the Orchestrator that corresponded to that APIC release. During fabric upgrade you were also required to upgrade all the APIC sites first before upgrading the Multi-Site Orchestrator. For example, if you were upgrading the fabrics from APIC Release 4.0(1) to Release 4.1(1), you had to remain on Release 2.0(1) of the Orchestrator until all sites were on APIC Release 4.1(1).
Starting with Release 2.2(1), Multi-Site Orchestrator releases have been decoupled from the APIC releases. The APIC clusters in each site as well as the Orchestrator itself can now be upgraded independently of each other and run in mixed operation mode.
Mixed operation mode is supported for sites running any of the following APIC releases:
-
3.2(6) or later
-
4.0(1) or later
-
4.1(1) or later
-
4.2(1) or later
However, keep in mind that if you upgrade the Orchestrator before upgrading the APIC
clusters in one or more sites, the new Orchestrator features may not yet be
supported by an earlier APIC release. In that case a check is performed on each
template to ensure that every configured option is supported by the target sites.
The check is performed when you save a template or deploy a template. If the
template is already assigned to a site, any unsupported configuration options will
not be saved; if the template is not yet assigned, you will be able to assign it to
a site, but not be able to save or deploy the schema if it contains configuration
unsupported by the site. In case an unsupported configuration is detected, an error
message will show, for example: This APIC site version
<site-version> is not supported by MSO. The minimum
version required for this <feature> is
<required-version> or above.
The following table lists the features and the minimum required APIC release for each one:
Feature |
Minimum APIC Version |
---|---|
ACI Multi-Pod Support |
Release 3.2(6) |
Service Graphs (L4-L7 Services) |
Release 3.2(6) |
External EPGs |
Release 3.2(6) |
ACI Virtual Edge VMM Support |
Release 3.2(6) |
DHCP Support |
Release 3.2(6) |
Consistency Checker |
Release 3.2(6) |
CloudSec Encryption |
Release 4.0(1) |
Layer 3 Multicast |
Release 4.0(1) |
MD5 Authentication for OSPF |
Release 4.0(1) |
EPG Preferred Group |
Release 4.0(2) |
Host Based Routing |
Release 4.1(1) |
Intersite L3Out |
Release 4.2(1) |