Network Management

SD-WAN orchestrators failing to pair with edge devices

This topic provides details on how Meraki, Prisma, VeloCloud, or Viptela SD-WAN orchestrators are paired with edge nodes. Review the requirements and settings you might configure to address orchestrator-edge pairing issues. If orchestrators fail to pair with an edge device, you will see that the edge node in the Orchestrator Inventory widget is not marked as managed even though it is added for monitoring as an SNMP node.

First published date

10/12/2023 12:06 PM

Last published date

8/1/2025 5:01 PM

Overview

When SD-WAN orchestrators fail to pair with edge devices, review the requirements for your vendor and make sure the requirements are met.

Product section

Network Performance Monitor

Cause

The requirements for pairing SD-WAN orchestrators with edge devices are not met.

Resolution

Review the requirements for pairing SD-WAN orchestrators with edge devices and related settings.

How to pair edges after configuration change

After a configuration change, complete one of the following to pair edges with the orchestrator:
  1. On Node Details of the edge, click List Resources, and then select the SD-WAN option.
  2. On Orchestrator Details, click Discover {Vendor} Devices, and run the discovery and import results. 
Importing the results will not import new devices if the devices are already monitored, but it will pair them with the orchestrator.

Meraki

Supported devices must have SNMP SysObjectIDs from the following range: 1.3.6.1.4.1.29671.2.100 - 1.3.6.1.4.1.29671.2.200

How Meraki orchestrators are paired with edge nodes

By default, the dashboard and the node are matched by the DeviceSerial OID.

Configure the property for matching Meraki orchestrators to edge nodes (if DeviceSerial is not supported)

If the DeviceSerial OID is not supported, you can configure the matching criteria in Advanced Settings.
  1. Go to Advanced Configuration. See Access the Advanced Configuration settings in the Orion Web Console.
  2. In the Orchestrators.Meraki section, find the OrchestratorNodeMatchCondition property.
  3. In OrchestratorNodeMatchCondition, select the property you want to use for matching orchestrators to edge devices and submit your updates.
  • Default: 
    • The following three OIDs must match on the orchestrator and on the nodes - SysName, IP, and MAC.
    • If all three OIDs are not the same on the orchestrator and on the nodes, then MACs and one of the following must match: SysName or IP.
    • If neither SysName nor IP match, then MACs on the orchestrator and on the nodes must match.
  • Strict: SysName, IP, and MAC must match
  • SysName
  • IP
  • MAC
  • SystNameAndip
  • SysNameAndMac
  • IPandMac
Learn more: Monitor SD-WAN for Meraki organizations

Prisma

Supported edge devices must have one of the following SNMP SysObjectIDs: 1.3.6.1.4.1.50114.11.1.10 or 1.3.6.1.4.1.50114.11.1.11.
Prisma orchestrators are paired with edge nodes based on the SysName.
Learn more: Monitor SD-WAN for Prisma orchestrators

Velocloud

Supported edge devices must have the following SNMP SysObjectID: 1.3.6.1.4.1.45346
VeloCloud orchestrators are paired with edge nodes based on the OrchestratorNodeMatchCondition property, by default by SysName.

Configure the property for matching VeloCloud orchestrators to edge nodes

You can change the default criteria for matching VeloCloud orchestrators and edge nodes in Advanced Settings.
  1. Go to Advanced Configuration. See Access the Advanced Configuration settings in the Orion Web Console.
  2. In the Orchestrators.VeloCloud section, find the OrchestratorNodeMatchCondition property.
  3. In OrchestratorNodeMatchCondition, select the property you want to use for matching orchestrators to edge devices and submit your updates.
  4. Available node match conditions:
  • Default: 
    • The following three OIDs must match - SysName, IP, and MAC.
    • If all three OIDs do not match, then MACs and either SysName or IP must match on the edge nodes and on the orchestrator.
    • If neither SysName nor IP match, then simply MACs must match
  • Strict: SysName, IP, and MAC must match
  • SysName
  • IP
  • MAC
  • SystNameAndIp (selected by default for VeloCloud)
  • SysNameAndMac
  • IPandMac
Learn more: Monitor SD-WAN for VeloCloud orchestrators

Viptela

Supported edge devices must have the following SNMP SysObjectID: 1.3.6.1.4.1.41916

How Viptela orchestrators are paired with edge nodes

For Viptela orchestrators, the edge's unique identifier (UUID) is requested via the VIptela Orchestrator API (using GET '/dataservice/device').
From the edge node, the UUID is requested via SNMP using the following OID: 1.3.6.1.4.1.41916.4.2.5.14.0
When the UUIDs received via API and SNMP match, the orchestrator and the edges are paired.


Learn more: Monitor SD-WAN for Viptela orchestrators