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 software repository table. By default, all columns are displayed.
  • Software repository table—List the images in the vManage software repository.

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.

Add Software Image

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 a software image 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 Software Image

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.
  • Was this article helpful?