Skip to main content
Cisco SD-WAN
Support
Product Documentation
Viptela Documentation

Software Repository

Use the Software Repository screen to download software images to the vManage software repository.

Screen Elements

  • Top bar—On the left are the menu icon, for expanding and collapsing the vManage menu, and the vManage product name. On the right are a number of icons and the user profile drop-down.
  • Title bar—Includes the title of the screen, Software Repository.
  • Add New Software drop-down (on Repository screen)—Upload new software images to the vManage or remote server.
  • Search box—Includes the Search Options drop-down, for a Contains or Match string.
  • Refresh icon—Click to refresh data in the device table with the most current data.
  • Show Table Fields icon—Click to display or hide columns from the device table. By default, all columns are displayed.
  • Software repository table—List the images in the vManage software repository.

G00533.png

View Software Images

When you open the Software Repository screen, the images in the repository are displayed in the table. To filter the list, search or type a string in the Search box.

The Software Version column lists the version of the software image, and the Controller Version column lists the version of controller software that is equivalent to the software version. The controller version is the minimum supported vManage controller version. The software image can operate with the listed controller version or with a higher controller version. In the following example:

software-repository.png

The software version is 16.8.55, and the controller version is 18.1.x. Reading these two columns together tells you that software version 16.8.55 is compatible with vManage controller software versions 18.1.x and later. This means that devices running version 16.8.55 can operate with vManage servers running Releases 18.1, 18.2, and 18.3, and with later software releases, and they cannot operate with vManage servers running Release 17.2 or Release 17.1.

The Software Location column indicates where the software images are stored, either in the repository on the vManage server or in a repository in a remote location.

The Available Files column lists the names of the software image files.

The Update On column shows when the software image was added to the repository.

In the More Actions column, you can delete a software image from the repository.

Add Software Images to the Repository

Before you can upgrade the software on a vEdge router, vSmart controller, or vManage NMS to a new software version, you need to add the software image to the vManage software repository. The repository allows you to store software images on the local vManage server and on a remote file server.

The vManage software repository allows you to store images in three ways:

  • On the local vManage server, to be downloaded over a control plane connection—Here, the software images are stored on the local vManage server, and they are downloaded to the Viptela devices over a control plane connection. The receiving device generally throttles the amount of data traffic it can receive over a control plane connection, so for large files, the vManage server might not be able to monitor the software installation on the device even though it is proceeding correctly.
  • On the local vManage server, to be downloaded over an out-of-band connection—Here, the software images are stored on the local vManage server, and they are downloaded to the Viptela devices over an out-of-band management connection. For this method to work, you specify the IP address of the out-of-band management interface when you copy the images to the software repository. This method is recommended when the software image files are large, because it bypasses any throttling that the device might perform and so the vManage server is able to monitor the software installation.
  • On a remote server—Here, the software images remain on a remote file server that is reachable through an FTP or HTTP URL. As part of the software upgrade process, the vManage server sends this URL to the Viptela device, which then establishes a connection to the file server over which to download the software images.

To add software images to the vManage software repository:

  1. Click Add New Software.
  2. Select the location to store the software image:
    1. To store the software image on the local vManage server and have it be downloaded to Viptela devices over a control plane connection, select vManage. The Upload Software to vManage dialog box opens.
      1. Drag and drop the software image file to the dialog box, or click Browse to select the software image from a directory on the local vManage server.
      2. Click Upload to add the image to the software repository. The Software Repository tables displays the added software image, and it is available for installing on the devices.
    2. To store the software image on a remote server, select Remote Server. The Location of Software on Remote Server dialog box opens.
      1. In the Version box, enter the version number of the software image.
      2. In the URL box, enter the FTP or HTTP URL of the software image.
      3. Click Add to add the image to the software repository. The Software Repository tables displays the added software image, and it is available for installing on the devices.
    3. To store the image on a remote vManage server and have it be downloaded to Viptela devices over an out-of-band management connection, select Remote Server - vManage. The Upload Software to Remote Server - vManage dialog box opens.
      1. In the vManage Hostname box, enter the IP address of an interface on the vManage server that is in a management VPN (typically, VPN 512).
      2. Drag and drop the software image file to the dialog box, or click Browse to select the software image from a directory on the local vManage server.
      3. Click Upload to add the image to the software repository. The Software Repository tables displays the added software image, and it is available for installing on the devices.

Delete a Software Image from the Repository

To delete a software image from the vManage software repository:

  1. In the software repository table, select the software image.
  2. In the More actions icon to the right of the line, click Delete.

If a software image is being download to a router, you cannot delete the image until the download process completes.

  • Was this article helpful?