Upgrading Cisco ACI and OSP

Guidelines for Upgrading Cisco APIC and OSP

The OpenStack plug-in is released with Cisco Application Policy Infrastructure ControllerAPIC releases, and therefore uses the same semantic version as Cisco APIC. For example, the 4.2(1) plug-in is provided with the Cisco APIC 4.2(1) release. Generally, the OpenStack plug-in releases are tested against the matching Cisco APIC release, as well as the previous Long Term Support (LTS) Cisco APIC release. However, a given plug-in release may be compatible with additional Cisco APIC releases. See the Cisco ACI Virtualization Compatibility Matrix to verify that the version of the plug-in used is compatible with the version of Cisco APIC.

See the Cisco ACI Virtualization Compatibility Matrix for information about compatible Cisco APIC and Red Hat OSP releases.

Upgrade Guidelines

The Cisco ACI fabric can be upgraded following the information on Cisco Application Policy Infrastructure Controller (APIC) Management, Installation, Upgrade, and Downgrade Guide at:

https://www.cisco.com/c/en/us/td/docs/switches/datacenter/aci/apic/sw/2-x/managing_ACI_fabric_upgrades_and_downgrades/b_Managing_ACI_Fabric_Upgrades_and_Downgrades/b_Managing_ACI_Fabric_Upgrades_and_Downgrades_chapter_01.html

Optionally, you can upgrade the Cisco ACI fabric without upgrading the plug-in, as long as the Cisco ACI plug-in and Cisco ACI fabric release combination is supported. For more information, see the Cisco ACI Virtualization Compatibility Matrix at:

https://www.cisco.com/c/dam/en/us/td/docs/Website/datacenter/aci/virtualization/matrix/virtmatrix.html

Upgrading the Cisco ACI Packages

The following procedure updates fully deployed Overcloud with the new version of the Cisco Application Centric Infrastructure (ACI) plug-in. The upgrade can be live.


Note
Follow the Red Hat Director documentation to upgrade the plug-in in step 4.

Procedure

Step 1

Copy the updated version of the tripeo-ciscoaci-version RPM and corresponding plug-in tarball (openstack-ciscorpms-repo) from Cisco.com to the OSP Director.

Step 2

Update the tripeo-ciscoaci-version package using yum: yum update tripleo-ciscoaci-

Step 3

Create the Cisco ACI containers by running the command /opt/ciscoaci-tripleo-heat-templates/tools/build_openstack_aci_containers.py and then pointing it to the downloaded plug-in tarball. For example: 

/opt/ciscoaci-tripleo-heat-templates/tools/build_openstack_aci_containers.py -z /home/stack/openstack-ciscorpms-repo-13.0-848.tar.gz

The command updates the Docker images and updates the /home/stack/templates/cisco_containers.yaml file.

Step 4

Follow the Red Hat upgrade procedure on the Red Hat Customer Portal.

See the Chapter 4, "Updating the Overcloud" in the article Keeping Red Hat OpenStack Platform Updated. Go to Products & Services > Product Documentation > Red Hat OpenStack Platform13 > 13. The article is in the Installing & Upgrading section.