How the Manager, Controller, Validator and WAN Edge work together from a new edge's first contact to forwarding, and how to place a fault on the component that owns it.
Intermediate · 11 min read
You'll learn to follow a new WAN Edge from first contact to forwarding traffic, name the component that owns each step, and place a symptom on the right component before logging in to any device.
Technical definition
Role separation in Cisco SD-WAN means that management, control, orchestration and forwarding are done by different components: the Manager (formerly vManage), the Controller (formerly vSmart), the Validator (formerly vBond) and the WAN Edge (formerly vEdge for the older routers). Each has a narrow job, and a fault usually belongs to one of them.
Four components, one branch coming online
The control components and who talks to whom
On small screens, swipe sideways or focus the diagram and use the arrow keys.
Control traffic goes to the controllers. User traffic goes edge to edge and never passes through the Controller or Manager, which is why a lost controller leaves existing tunnels running for a while.
The lab has a Manager at 10.255.0.10, a Controller (CTRL-01) at 10.255.0.11, a Validator (VAL-01) at 10.255.0.12, and WAN Edges HUB-01, HUB-02, BR-01 and BR-02. When BR-02 is installed, each component does one thing in turn, and nobody does another's job. Following that sequence once is the best way to keep the roles apart. Each role has its own lesson; this one connects them: Manager, Controller and Validator.
A branch coming online
On small screens, swipe sideways or focus the diagram and use the arrow keys.
The sequence is the troubleshooting map.
The roles side by side
The roles side by side
On small screens, swipe sideways or focus the diagram and use the arrow keys.
Read each row across: the left box names the item, the others describe it.
A new edge, step by step
The edge comes up on a transport. It has a WAN address and a way to reach the Validator. The WAN Edge is acting alone here.
The Validator introduces it. It authenticates the edge and gives it the Controller and Manager addresses.
The edge builds its control connections. One to the Controller and one to the Manager, over DTLS or TLS (see secure control connections).
The Manager configures it. The configuration attached to the device is pushed over its Manager connection, and the device reports back.
The edge advertises over OMP. It sends its prefixes and TLOCs to the Controller.
The Controller applies policy and distributes. Other edges receive the routes and TLOCs that policy allows.
The edges build tunnels. Tunnels form between TLOCs, BFD starts, and user traffic can flow edge to edge.
The order shows dependencies. Without step 2, there are no connections. Without step 3, no configuration and no OMP. Without step 7, routes exist but cannot be used. A fault at one step shows up as a symptom at the next, which is why the cause is often one step earlier than the symptom.
A new edge, step by step
On small screens, swipe sideways or focus the diagram and use the arrow keys.
The first failed step is where to look.
Placing a symptom on a component
Place the symptom
On small screens, swipe sideways or focus the diagram and use the arrow keys.
Then check that component first.
Placing a symptom on a component
On small screens, swipe sideways or focus the diagram and use the arrow keys.
Read each row across: the left box names the item, the others describe it.
What survives when a component is lost
Because the roles are separate, losing one does not stop the others in the same way. The effect is a pattern worth knowing before a failure. Exact timers and limits depend on the release, so check yours.
What survives when a component is lost
On small screens, swipe sideways or focus the diagram and use the arrow keys.
Read each row across: the left box names the item, the others describe it.
One command, all the roles
show sdwan control connections
On a WAN Edge: the lines show which controller components the router reaches. A missing or failed line points at that component's role.
On an edge this command maps straight onto the table above. A Controller line that is up shows OMP can run. A Manager line that is up shows management works. A missing line says which role to investigate. For a symptom that is not about connections, move to the OMP table or the BFD sessions, in that order.
Mistakes to avoid
Starting troubleshooting on the device where the user noticed the problem, instead of the component that owns the function.
Treating the Controller as a forwarding path, or the Manager as part of routing.
Assuming every component is needed for traffic to flow. The data plane depends on routes and tunnels that already exist.
Checking control, data and management planes together. Check them one at a time, in the order of the workflow.
Test yourself on the workflow
Predict · scenario 1
Put these in the order a new WAN Edge meets them: Controller, Validator, Manager.
Predict · scenario 2
A prefix is present on the Controller but missing on BR-02. Which role should you investigate?
Predict · scenario 3
The Validator is unreachable for an hour. BR-01 and BR-02 are already up with Controller and Manager connections. What is the likely effect on their traffic?
Predict · scenario 4
A user cannot sign in to the Manager's web interface, but every WAN Edge forwards normally and has a healthy Controller connection. Which statement fits?
FAQ
Why split the roles instead of using one controller?
Each job has different needs. The Validator has to be reachable by devices that have not joined yet. The Controller handles routing for the whole fabric. The Manager deals with people and configuration. Separating them lets each be placed, secured and made redundant on its own terms, and a fault in one does not take down the others.
Do all four need to be separate machines?
They are separate roles. How they are deployed, whether as separate virtual machines or as part of a hosted service, depends on the deployment model and the release. Check the design guide for yours.
Which component should I check first when a branch is down?
Start from the symptom. Cannot be managed: the Manager connection. Missing routes: the Controller and OMP. Cannot join: the Validator step. Tunnels fail: the WAN Edge, its transports and TLOCs. The table in this lesson gives the rest.