Citrix SD-WAN

Configure Rollback

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

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.

Configure Rollback

In this article