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

Add or Delete an Image in the vManage Software Repository

You can add or delete a software image from the vManage software 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.
  1. In vManage NMS, select the Maintenance ► Software Repository screen.
  2. Click Add New Software.
  3. 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

  1. In vManage NMS, select the Maintenance ► Software Repository screen.
  2. In the software repository table, select the software image.
  3. 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.

Release Information

Introduced in vManage NMS in Release 15.2.

  • Was this article helpful?