Citrix SD-WAN

Configure Rollback

April 7, 2021

Contributed by:

The Configuration Rollback feature allows the Change Management system to detect and recover from the following software/configuration errors by reverting to the previously active software/configuration:

After a software upgrade, virtual Path is dead and the service gets disabled if the software crash happens.
After making the configuration changes, virtual Path is dead without any software crash.
If the configuration for the MCN appliance itself causes a network problem on the MCN site, it does not detect the outage and does not roll itself back. However, all the other clients in the network roll themselves back as they were unable to connect to the MCN.

The configuration rollback feature is enabled by default, to disable this feature clear Revert on Error option in the Activation tab of the Change Management wizard.

Configure rollback activation

If a system configuration error occurs on a client while activating the staged package from an MCN the client reverts to the previous software configuration and an error message appears as shown in the following screenshot.

The client generates a critical severity event for the SOFTWARE_UPDATE object if an appliance crash is detected, or generates a critical severity event for the CONFIG_UPDATE object if a network outage is detected.

Configure rollback error

If Revert on Error is enabled, the client appliances monitor itself for about 30 minutes. If the software crashes within 30 minutes, or if the network is down (unable to establish a Virtual Path to the MCN) for 30 minutes, then a rollback is triggered.

On the MCN, an error message appears as shown in the following screenshot. As the clients rejoin the network, it reports the type of error encountered. A summary count of the number of errors is displayed in the error message.

Configure rollback error summary

In the Change Management window of the MCN, you can see the state of the site appliances indicating if that site had encountered a Software Error, or a Configuration Error.

The official version of this content is in English. Some of the Citrix documentation content is machine translated for your convenience only. Citrix 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 Citrix 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 Citrix, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Citrix will not be held responsible for any damage or issues that may arise from using machine-translated content.

Configure Rollback

April 7, 2021

Contributed by:

April 7, 2021

Contributed by:

Configure Rollback

In this article