Cisco APIC Installation and ACI Upgrade and Downgrade Guide

PDF

Cisco APIC Installation and ACI Upgrade and Downgrade Guide

Download APIC, APIC CIMC, switch and additional rules for pre-upgrade validation on APICs

Want to summarize with AI?

Log in

Learn how to download images to the Cisco APIC firmware repository from an external file server or your local machine.


This procedure downloads images to the Cisco APIC firmware repository from an external file server or your local machine. The supported image types are listed below:

  • Cisco APIC firmware image

  • Cisco ACI swtich firmware image

  • Cisco CIMC HUU image for APIC CIMC

  • External additional rules for pre-upgrade validations

If you are downgrading the software on the Cisco APICs, the process is identical to the process for upgrading the software, except that the target release that you choose will be earlier than the currently installed release. The text for dialogs, fields, buttons, and other controls in the Cisco APIC GUI specify "upgrade" even though you are downgrading the software.

Note

In the Cisco APIC release 6.0(2) and later, download both the 32-bit and 64-bit Cisco ACI-mode switch images to the Cisco APIC. Downloading only one of the images may result in errors during the upgrade process. For more information, see Guidelines and limitations for upgrading or downgrading.

In the Cisco ACI-mode switch 16.x releases, the 64-bit switch software has the same image name as the 32-bit software when installed on the switch. To verify which version is running on the switch, use the md5sum command against the image file on switch. Compare this md5sum hash to the switch image contained in the /firmware/fwrepos/fwrepo directory of the Cisco APIC. On subsequent upgrades, the 64-bit and 32-bit image names are differentiated on the switch.

Follow these steps to download APIC, APIC CIMC, switch and additional rules for pre-upgrade validation on APICs:

Procedure

1.

Download the desired target version from the Cisco Software Download site (for example, 5.2(1g) release) to your file server or local machine.

2.

On the menu bar, choose Admin > Firmware.

The Dashboard window appears, which provides general information one the controllers and the leaf and spine switches (nodes).
3.

Click Images in the left navigation bar.

The Image window appears, which shows the images that you downloaded previously.
4.

Click the Actions icon and select Add Firmware from the drop-down menu.

The Add Firmware Image popup window appears.
5.

Determine if you want to import the firmware image from a local or a remote location.

  • If you want to import the firmware image from your computer, in the Location field, click the Local radio button. Click the Choose File button, then navigate to the folder on your local system with the firmware image that you want to import. Go to StepĀ 6.

  • If you want to import the firmware image from a remote location, click either Secure copy or HTTP, depending on the method that you want to use to import the firmware image from the remote location:

    • If you selected the Secure copy radio button, enter the Secure Copy Protocol (SCP) source that you want to use to download the software image:

      1. In the URL field, enter the URL from where the image will be downloaded.

        The format for the SCP source is:

        <SCP server IP or FQDN>:/<path>/<filename>

        An example URL is 10.1.2.3:/path/to/the/image/aci-apic-dk9.6.2.1a.iso.

      2. In the Username field, enter your username for secure copy.

      3. In the Authentication Type field, select the type of authentication for the download. The type can be:

        • Password

        • Ssh Public Private Files

        The default is Password.

        • If you selected Password, in the Password field, enter your password for secure copy.

        • If you selected Ssh Public Private Files, enter the following information:

          • Ssh Key Contents: The SSH private key content.

          • Ssh Key Passphrase: The SSH key passphrase that is used for generating the SSH private key.

            Note

            Based on the provided SSH private key, the Cisco APIC internally creates a temporary SSH public key just for this transaction to establish a connection with the remote server. You must ensure that the remote server has the corresponding public key as one of the "authorized_keys". After the authentication check is performed, the temporary public key on the Cisco APIC is deleted.

            You can generate an SSH private key (~/.ssh/id_rsa) and a corresponding SSH public key (~/.ssh/id_rsa.pub) on one of the Cisco APICs by entering the following:

            ssh-keygen -t rsa -b 2048 -C "<username>@<apic_name>"

            Or you can generate them on another machine. For either method, you need to provide the generated private key for each download configuration.

    • If you selected the HTTP radio button, enter the http source that you want to use to download the software image.

      The format for the HTTP source is:

      <HTTP server IP or FQDN>:/<path>/<filename>

      An example URL is 10.1.2.3:/path/to/the/image/aci-apic-dk9.6.2.1a.iso.

6.

Click Submit.

The Cisco APICs begins downloading the specified firmware images from the configured source. The download progress is shown in the Download Status column