Citrix SD-WAN

Deploy configuration to branches

March 12, 2021

Contributed by:

S C

After you have prepared the configuration using the configuration editor and exported the configuration package to the change management inbox, the next step is to prepare the SD-WAN Appliance Packages for distribution to the client nodes. Use the Change Management wizard in the Management Web Interface on the MCN.

There is a different SD-WAN software package for each SD-WAN Appliance model. An Appliance Package consists of the software package for a specific model, bundled with the configuration package you want to deploy. Therefore, a different Appliance Package must be prepared and generated for each appliance model in your network.

Note

If you have not already downloaded the required SD-WAN software packages to a PC connected to your network, you can do so now. For information on acquiring and downloading the software, see the section Acquiring the SD-WAN Software Packages

To upload and install the package and configuration to the MCN, do the following:

Log into the Management Web Interface on the MCN appliance.

Note

You are uploading the software packages you previously downloaded to the connected PC. For convenience, you might want to use this same PC to connect to the MCN again.
Select the Configuration tab.
In the left pane, open the Virtual WAN section, and select Change Management. The first page of the Change Management wizard, the Change Process Overview page is displayed.
Click Begin. The Change Preparation page for uploading and verifying that the specified configuration and software packages is displayed.
Upload each of the SD-WAN software packages required for your network. For each SD-WAN software package you want to deploy, do the following:
1. Click Choose File next to the Upload Item field. This opens a file browser for selecting an SD-WAN software package to upload.
2. Select an SD-WAN software package, and click OK.
3. Navigate to the SD-WAN software packages you downloaded earlier to the local PC, and select the package to upload.
4. Click Upload.
5. Repeat steps (i) through (iii) for each of the SD-WAN software packages required for your network.
In the Configuration field drop-down menu, select the new configuration package that you just exported to Change Management.
Click Stage Appliance. Appliance staging initiates the following actions:
- Transfers the selected software package and configuration to the MCN.
- Generates an Appliance Package for each appliance model identified in the selected configuration.
- Adds the new Appliance Packages to the list of available packages in the Site-Appliance table.
- Stages the new configuration and appropriate software package on the MCN.
Click Next. This proceeds to the Appliance Staging page.

When the staging operation completes, the Site-Appliance** table is populated with the newly staged Appliance Packages information.

Note

If this is an initial deployment, only the MCN is updated and staged now. If you are updating an existing deployment and the Virtual Paths are already functioning between the deployed sites, this also distributes the appropriate Appliance Packages to the deployed client nodes, and initiates staging on those nodes. However, if you are adding new client nodes to an existing Virtual WAN deployment, you still must manually upload, stage, and activate the appropriate Appliance Package on each new client, as outlined in the remaining steps in this procedure.

Select Ignore incomplete, when adding more sites to the network or if the site is in not connected state. This indicates that only the connected sites and the MCN get updated and staged. Once the sites that were in not connected state are back online, they automatically get staged and updated by MCN as part of auto-correction.
Select Revert on Error to revert to previous application package on encountering some error. For more information, see Configuration Rollback.
Click Activate Staged.

The results and next steps will differ at this point, depending on whether this is an initial configuration or you are updating or replacing an existing configuration, as follows:
- If you are updating or changing the configuration on an existing deployment.
  - If this is not an initial configuration, the new configuration and the appropriate Appliance Package on the MCN appliance is activated. The appropriate Appliance Package is then distributed to and automatically activated on each client in your SD-WAN. This may take several seconds to complete.
When the activation completes, an Activation complete status message appears, and the Done button is enabled. In addition, the Configuration Filenames status line (above the table) now displays the name of the newly activated package in the Active field.
Click Done and proceed to one of the following:
- If you are not adding any new nodes to your SD-WAN, this completes the preparation, distribution, and activation of the new Appliance Packages in your SD-WAN. You can proceed directly to Enabling the Virtual WAN Service.
- If you want to add new client nodes to your SD-WAN, proceed to Connecting the Client Appliances to Your Network.
- If you are activating an initial configuration, the new configuration package is not activated at this point, and there are more steps you must perform. The next step is to copy the configuration package to the Local Appliance Staging area, in preparation for staging and activating the configuration package on the MCN.
Do the following:
Once you click Activate Staged, the following message appears.
Click OK.
Click Activate staged.

This displays a dialog box asking you to confirm the activation operation.
Click OK.

This initiates activation of the staged configuration package. This process takes several seconds, during which a progress status message displays.

When the activation completes, a status message displays stating activation complete, and the Done button is enabled.
Click Done. This proceeds to the Management Web Interface Dashboard page, where you can view the activation results.

You have now completed the preparation of the SD-WAN Appliance Packages on the MCN. Proceed to (/en-us/citrix-sd-wan/10-2/configuration/connecting-client-appliances-to-network.html) connecting the Client Appliances to Your Network.

Tip

The Change Management wizard allows you to search the site-appliance table. This allows you to look up sites on a large network with multiple sites and download the required staged configuration. You can also search for error states, for example: ‘Fail’ or ‘Not connected’. This gives you a list of all the sites in that state.

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Deploy configuration to branches

March 12, 2021

Contributed by:

S C

March 12, 2021

Contributed by:

S C

Deploy configuration to branches

In this article