Information about Configuration Consistency across Cisco Catalyst SD-WAN Controllers
Minimum Supported Version: Cisco Catalyst SD-WAN Control Components Release 20.18.1
Configuration consistency across Cisco SD-WAN Controllers is a process that:
-
ensures configuration consistency across all Cisco SD-WAN Controllers in the cluster for single tenants,
-
ensures configuration consistency only for Cisco SD-WAN Controllers that are part of the tenant,
-
employs a multi-stage approach to implement configuration changes,
-
uses an error-handling mechanism to rollback changes when failures occur, and
-
prevents issues arising due to Cisco SD-WAN Controllers operating on different configurations.
This process applies to Cisco SD-WAN Controllers in both single tenant and multitenant deployments.
Multi-stage Approach for Configuration Consistency across Cisco Catalyst SD-WAN Controllers
Minimum Supported Version: Cisco Catalyst SD-WAN Control Components Release 20.18.1
The multi-stage approach is a two-stage process for validating and applying configuration changes across Cisco SD-WAN Controllers using Cisco SD-WAN Manager. This approach ensures uniformity in configuration across Cisco SD-WAN Controllers in a network.
The multi-stage approach includes the following stages:
-
Stage 1: Validate Configuration
During this stage, Cisco SD-WAN Manager instructs Cisco SD-WAN Controllers to perform various validation checks on the configuration.
-
Resource validation
-
Syntax validation
-
Semantic validation
-
-
Stage 2: Apply Configuration
Upon successful completion of Stage 1, Cisco SD-WAN Manager instructs all Cisco SD-WAN Controllers to apply the configuration. The Cisco SD-WAN Controllers perform another resource validation check before committing the configuration. -
Stage 3: Rollback Configuration
This is an optional stage. Cisco SD-WAN Manager initiates this stage only when Stage 2 fails. This stage involves rollback of configuration changes on all Cisco SD-WAN Controllers if one or more controllers are unable to accept or apply the configuration. Cisco SD-WAN Manager rolls back the configuration changes on all devices on which it is deployed successfully. Rollback prevents partial implementation of configurations and ensures uniformity in configuration across Cisco SD-WAN Controllers in a network.
Interim Acknowledgements(ACKs) and Handling Timeouts
During Stage 1 and Stage 2 in the multi-stage approach, Cisco SD-WAN Manager sends requests to validate and apply configuration changes to Cisco SD-WAN Controllers. To keep the communication open and active with Cisco SD-WAN Manager, Cisco SD-WAN Controllers send periodic interim ACKs back to the Cisco SD-WAN Manager. This communication serves two primary purposes:
-
Status display: It allows the Cisco SD-WAN Manager to display the ongoing status of validation and application of configuration through task logs.
-
Task or activity timer management: It helps in adjusting the task or activity timer for an operation and prevents Cisco SD-WAN Manager from timeout.
Rolling Timeouts
Rolling timeout is an important mechanism in the multi-stage approach. It is a dynamic timeout mechanism where the timeout period is continuously reset based on successful communication between Cisco SD-WAN Controller and Cisco SD-WAN Manager. The rolling timeout period of 25 minutes starts after Cisco SD-WAN Manager receives the last successful interim ACK from any Cisco SD-WAN Controller. If a timeout occurs, Cisco SD-WAN Manager terminates applying configuration changes to all the Cisco SD-WAN Controllers in the network. When applying configuration changes fails, Cisco SD-WAN Manager initiates a rollback. This mechanism ensures that there is no inconsistency in the configuration across Cisco SD-WAN Controllers.