Register a remote server with Cisco SD-WAN Manager so that you can add locations of software images on the remote server to the Cisco SD-WAN Manager software repository and upgrade device or controller software using these software images. In multitenant Cisco Catalyst SD-WAN deployment, only the provider can register a remote server and perform software upgrade using images on the remote server.

1. From the Cisco SD-WAN Manager menu, choose Maintenance > Software Repository.

2. Click Add Remote Server.

3. In the Add Remote Server slide-in page, configure the following:

   Server Info	Server Name: Enter a name for the server. Server IP or DNS Name: Enter the IP address or the DNS name of the server. Protocol: Choose HTTP, FTP, or SCP. Port: Enter the access port number.
   Credentials	User ID: Enter the user ID required to access the server. The username can contain only the following characters: a-z, 0-9, ., _, and -. Password: Enter the password required to access the server. The password can contain only the following characters: a-z, A-Z, 0-9, _, *, ., +, =, %, and -. Note   Special characters such as /, ?, :, @, and SPACE, which are used in URLs and are needed for proper parsing of fields so files can be fetched properly with the relevant protocol, are not supported in the username and the password. The use of the valid characters is supported starting from Cisco vManage Release 20.9.1.
   Image Info	Image Location Prefix: Enter the folder path where the uploaded images must be stored. For SCP, use the absolute directory path as the Image Location Prefix; for FTP or HTTP, use the relative path from the home directory. VPN: Enter the VPN ID, either the transport VPN, management VPN, or service VPN

4. Click Add to add the remote server.

See Enable Software Updates by a Remote Repository Server.

1. From the Cisco SD-WAN Manager menu, choose Maintenance > Software Repository.

2. For the desired remote server, click …

3. To view the remote server settings, click View Details.

4. To edit the remote server settings, click Edit. Edit any of the following settings as necessary and click Save.

   Note

   You cannot edit the remote server settings if you have added locations of any software images on the remote server to the Cisco SD-WAN Manager software repository. If you wish to edit the remote server settings, remove the software image entries from the software repository and then edit the settings.

   Server Info	Server Name: Enter a name for the server. Server IP or DNS Name: Enter the IP address or the DNS name of the server. Protocol: Choose HTTP, FTP, or SCP. Port: Enter the access port number.
   Credentials	User ID: Enter the user ID required to access the server. The username can contain only the following characters: a-z, 0-9, ., _, and -. Password: Enter the password required to access the server. The password can contain only the following characters: a-z, A-Z, 0-9, _, *, ., +, =, %, and -. Note   Special characters such as /, ?, :, @, and SPACE, which are used in URLs and are needed for proper parsing of fields so files can be fetched properly with the relevant protocol, are not supported in the username and the password. The use of the valid characters is supported starting from Cisco vManage Release 20.9.1.
   Image Info	Image Location Prefix: Enter the folder path where the uploaded images must be stored. For SCP, use the absolute directory path as the Image Location Prefix; for FTP or HTTP, use the relative path from the home directory. VPN: Enter the VPN ID, either the transport VPN, management VPN, or service VPN.

5. To delete the remote server, click Remove. Confirm that you wish to remove the remote server in the dialog box.

   Note	Before deleting a remote server, remove any entries for software images on the remote server that you have added to the Cisco SD-WAN Manager software repository.

Before you can upgrade the software on an edge device, Cisco Catalyst SD-WAN Controller, or Cisco SD-WAN Manager to a new software version, you need to add the software image to the Cisco SD-WAN Manager software repository. The repository allows you to store software images on the local Cisco SD-WAN Manager server or add locations of software images stored on a remote file server.

The Cisco SD-WAN Manager software repository allows you to store images in three ways:

• On the local Cisco SD-WAN Manager server, to be downloaded over a control plane connection: Here, the software images are stored on the local Cisco SD-WAN Manager server, and they are downloaded to the Cisco Catalyst SD-WAN 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 Cisco SD-WAN Manager server might not be able to monitor the software installation on the device even though it is proceeding correctly.

  Note

  From Cisco Catalyst SD-WAN Manager Release 20.18.1, image uploads to the Cisco SD-WAN Manager repository fail when disk space limits are exceeded. In a cluster environment, the disk space is assessed on all nodes simultaneously. Even if one node is experiencing low disk space, the image upload will fail for all nodes. When the total utilized space exceeds the limit, you may delete the existing image data on the local server. If this does not resolve the issue or if there is no existing image data to delete, please contact your network administrator for further assistance in freeing up disk space. The administrator can ensure that the total used space at /opt/data/ remains below 80%.

• On the local Cisco SD-WAN Manager server, to be downloaded over an out-of-band connection: Here, the software images are stored on the local Cisco SD-WAN Manager server, and they are downloaded to the Cisco Catalyst SD-WAN 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 Cisco SD-WAN Manager server is able to monitor the software installation.

• On a remote server: From Cisco vManage Release 20.7.1, you can store software images on a remote file server that is reachable through an FTP or HTTP URL. As part of the software upgrade process, the Cisco SD-WAN Manager server sends this URL to the Cisco Catalyst SD-WAN device, which establishes a connection to the file server to download the software images. In a multitenant Cisco Catalyst SD-WAN deployment, only the provider can register a remote server with Cisco SD-WAN Manager and add locations of software images on the remote server to the Cisco SD-WAN Manager repository.

  Note	Starting from Cisco vManage Release 20.9.1, when downloading an image from a remote server manually, ensure that only the following valid characters are used: User ID: a-z, 0-9, ., _, - Password: a-z, A-Z, 0-9, _, *, ., +, =, %, - URL Name or Path: a-z, A-Z, 0-9, _, *, ., +, =, %, -, :, /, @, ?, ~

1. From the Cisco SD-WAN Manager menu, choose Maintenance > Software Repository.

2. Click Software Images.

3. Click Add New Software.

4. Choose the location for the software image:

   Note	Store NFVIS upgrade images on the local Cisco SD-WAN Manager server.

   1. To store the software image on the local Cisco SD-WAN Manager server and have it be downloaded to Cisco Catalyst SD-WAN devices over a control plane connection, choose Manager. The Upload Software to Manager 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 Cisco SD-WAN Manager server.

      2. Click Upload to add the image to the software repository.

   2. To store the image on a remote Cisco SD-WAN Manager server and have it be downloaded to Cisco Catalyst SD-WAN devices over an out-of-band management connection, choose Remote Server - Manager. The Upload Software to Remote Server - Manager dialog box opens.

      1. In the Manager Hostname/IP Address field, enter the IP address of an interface on the Cisco SD-WAN Manager 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 Cisco SD-WAN Manager server.

      3. Click Upload.

   3. If the software image is stored on a remote server, choose Remote Server (preferred). The Add New Software via Remote Server slide-in pane appears. Before choosing this option, ensure that you have registered a remote server with Cisco SD-WAN Manager.

      1. Click Image to upload a new software image, or SMU Image to upload an SMU image. The default selection is Image.

      2. From the Remote Server Name drop-down list, choose the desired remote server.

      3. Image Filename: Enter the image filename, including the file extension. For an SMU image, the file extension must be .smu.bin.

      4. For an SMU image, enter the correct SMU Defect ID and choose the correct SMU Type. An incorrect defect ID or SMU type selection can cause the software upgrade to fail.

      5. Click Save.

From the Cisco SD-WAN Manager menu, choose Maintenance > Software Respository.

The Software Repository window displays the images avaialable in the repository.

The Software Version column lists the version of the software image, and the Controller Version column lists the version of Cisco SD-WAN Control Components that is equivalent to the software version. The Cisco SD-WAN Control Components version is the minimum supported version. The software image can operate with the listed Cisco SD-WAN Control Components version or with a higher version.

The Software Location column indicates where the software images are stored, either in the repository on the Cisco SD-WAN Manager server, or in a repository in a remote location.

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

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

The ... option for a desired software version provides the option to delete the software image from the repository.

In Cisco vManage Release 20.6.1 and earlier releases, when two or more software images have the same software version but are uploaded with different filenames, the images are listed in a single row. The Available Files column lists the different filenames. This listing scheme is disadvantageous when deleting software images as the delete operation removes all the software images corresponding to a software version.

From Cisco vManage Release 20.7.1, when two or more software images have the same software version but are uploaded with different filenames, each software image is listed in a separate row. This enables you to choose and delete specific software images.

1. From the Cisco SD-WAN Manager menu, choose Maintenance > Software Repository.

2. Click Virtual Images.

3. Click Add New Virtual Image and choose one of the following options:

   • Remote Server (preferred): Choose this option to link to an image that has been uploaded to a remote server.

     Note	Before choosing this option, ensure that you have registered a remote server with Cisco SD-WAN Manager. For more information on how to register a remote server, see Register Remote Server.

     The Add Virtual Image with Remote Server Details slide-in pane appears. (This option does not store the image on the local Cisco SD-WAN Manager server).

     For Cisco vManage Release 20.11.1 and later, follow these steps:

     1. Click Add New Virtual Image and choose Remote Server (preferred).

     2. In the Image Name field, enter the file name of the image.

     3. In the Image description field, enter a description of the image.

     4. (Optional) Click the Add Tags field and choose tags for the virtual image file.

     5. In the Select service type field, choose App-Hosting.

        The following applications are supported:

        • UTD-Snort-Feature

        • DRE-Optimization-Feature

        • ThousandEyes-Enterpeise-Agent

        • Cybervision-Enterprise-Agent

        For standard filenames, Cisco SD-WAN Manager automatically displays the attributes of the image file.

        For non-standard filenames, enter the following manually:

        • App type: Choose an application type from the drop-down list.

        • Enter version: Enter the version as free text.

          Cisco SD-WAN Manager automatically chooses the x86_64 architecture. You can choose a different architecture if necessary from the drop-down list.

     6. Click the Remote Server Name field and choose a remote server.

     7. In the Image File Path field, enter a path from the root directory of the remote server.

        If you do not enter a path, Cisco SD-WAN Manager uses the root directory.

     8. (Optional) To provide another server that contains the image, click Add Remote Server, and enter the details of the additional server.

     9. Click Add.

   • Manager: Choose this option to upload a file to the local Cisco SD-WAN Manager repository using a control-plane connection. This option is useful for uploading small files.

     The Upload VNF’s Package to Manager dialog box opens.

     1. Drag and drop the virtual image file to the dialog box or click Browse to select the virtual image file from a directory on the local Cisco SD-WAN Manager server.

     2. In the Description field, enter the description.

     3. In the drop-down list, choose Image Package or Scaffold.

     4. Click the Add Tags field and choose tags for the virtual image file.

     5. Click Upload to add the virtual image file to the repository.

   • Remote Server - Manager: Choose this option to store the virtual image file on a remote Cisco SD-WAN Manager server and download the virtual image file to Cisco Catalyst SD-WAN devices over an out-of-band management connection.

     The Upload VNF’s Package to Remote Server - Manager dialog box opens.

     1. In the Manager Hostname/IP Address field, enter the IP address of an interface on the Cisco SD-WAN Manager server that is in a management VPN (typically, VPN 512).

     2. Drag and drop the virtual image file to the dialog box or click Browse to select the virtual image file from a directory on the local Cisco SD-WAN Manager server.

     3. In the Description field, enter the description of the virtual image file.

     4. In the drop-down list, choose Image Package or Scaffold.

     5. Click the Add Tags field and choose tags for the virtual image file.

     6. Click Upload.

Note	To upload virtual images using the Manager or Remote Server - Manager options, use files with extensions, .tar, .gz, .tar or .qcow2. For more information on the steps to upload virtual images with extensions .tar, gz, .tar or .qcow2, see Upload VNF Images