Cisco APIC Installation and ACI Upgrade and Downgrade Guide

Upgrade or downgrade the catalog software version using the NX-OS style CLI

Updated: July 12, 2026

Want to summarize with AI?

Updates or reverts the catalog software version by adding a specific catalog image to the repository and verifying the status via the CLI.

By default, upgrading or downgrading the controllers automatically upgrades or downgrades the catalog that corresponds to the controller version. That is, adding a controller image to the repository adds a catalog image into the repository as well.

You can also copy a separate catalog image and add that to the repository.

Procedure

	1.	Add the catalog image to the repository. Example: `apic1(config)# firmware apic1(config-firmware)# catalog-version aci-catalog-dk9.2.2.2e.bin`
	2.	Verify the catalog upgrade status. Example: `apic1# show catalog Catalog-version : 2.2(2e) apic1#`

Need help?

Open a support case

(Requires a Cisco Service Contract)

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.

Upgrade or downgrade the catalog software version using the NX-OS style CLI

Procedure

Example:

Example: