Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

OS Images (Devices)

In preparation for NOS upgrade, you must register the new OS image.

Register OS Image

  1. Obtain the OS image from the device vendor.
  2. From the left navigation menu, navigate to Devices > System Agents > OS Images and click Register OS Image (top-right).
  3. Select the platform from the drop-down list (EOS, CUMULUS, NXOS, SONIC, JUNOS) and enter a description.
  4. Proceed by either uploading the image directly to the Apstra server or by providing a URL download link pointing to an image file on an accessible HTTP server (described in sections below).

Method One: Upload Image

  1. Select Upload Image, then either click Choose File and navigate to the image on your computer, or drag and drop the image from your computer into the dialog window and click Open.
  2. Add a checksum (optional) (described in section below).
  3. Click Upload to upload and register the image with the Apstra software.
  4. If the (optional) checksum can't be verified, the upgrade stops before rebooting the device.

Method Two: Provide Image URL

If another HTTP server is accessible to the devices being upgraded via their network management port, you can register the OS Image instead of uploading it. Only HTTP URLs are supported. HTTPS, FTP, SFTP, SCP and others are not.

  1. Select Provide Image URL.
  2. Enter the URL that's pointing to the image on the other server.
  3. Add a checksum (optional) (described in section below).
  4. Click Register to register the image with the Apstra software.
  5. If the (optional) checksum can't be verified, the upgrade stops before rebooting the device.

Add Checksum (Optional)

The type of checksum is determined by the platform:

  • Juniper Junos - MD5 (32 characters)
  • Enterprise SONiC - MD5 (32 characters)
  • Cisco NX-OS - SHA512 (128 characters)
  • Arista EOS - SHA512 (128 characters)
  • Cumulus Linux - MD5 (32 characters)

If the device vendor provides a checksum file, we recommend that you download it and copy it to the Checksum field. If a checksum file is not available, you can generate a checksum with the Linux md5sum or shasum commands, as applicable, or with equivalent programs.

Edit OS Image

To prevent failure, make sure to disable AAA authentication before proceeding with new image upgrades.

  1. From the left navigation menu, navigate to Devices > System Agents > OS Images and click the Edit button for the OS Image to edit.
  2. Make your changes.
  3. Click Update to update the OS image.

Delete OS Image

  1. From the left navigation menu, navigate to Devices > System Agents > OS Images and click the Delete button for the OS Image to delete.
  2. Click Delete to delete the OS image.