Network Management

How to change SolarWinds agent interface priority

This article provides a resolution to an issue that occurs when deploying an agent on a server with multiple NICs (or interfaces) and the SolarWinds agent does not use the expected IP address.

First published date

11/12/2018 7:18 PM

Last published date

1/21/2026 5:23 PM

Overview

This article provides a resolution to an issue that occurs when deploying an agent to a server with multiple Network Interface Cards (NICs) or interfaces and the SolarWinds agent does not use the expected interface IP Address.  For example, the agent may detect the local IP address instead of the virtual IP address for a VPN tunnel.

Product section

Orion Platform

Cause

To resolve this issue, interface priority needs to be changed via PowerShell commands.

Resolution

Here are some examples of PowerShell commands.

Step 1: Get interface details 

To get the interface details, run the PowerShell command:

Get-NetIPInterface

Table of results:   

IFINDEXINTERFACEALIASADDRESSFAMILYNLMTU(BYTES)INTERFACEMETRICDHCPCONNECTIONSTATEPOLICYSTORE
4blueIPv4150040DisabledDisconnectedActiveStore
15LanIPv4140050DisabledDisconnectedActiveStore
10Wi-FiIPv4150050EnabledDisconnectedActiveStore
1Loopback 1IPv4429496729550DisabledConnectedActiveStore

Determine which interface to change the Interface Metric (or priority).  In this example, we are changing the interface metric for Wi-Fi (or IfIndex of 10) and make this the prioritized interface.


Step 2: Change InterfaceMetric 

Run the following command:

Set-NetIPInterface -InterfaceIndex 10 -InterfaceMetric 20

In this example, we are changing the InterfaceMetric to 20 for Wi-Fi interface (InterfaceIndex of 10) to ensure it is the lower number compared to the other interfaces.


Step 3: Confirm InterfaceMetric was changed

Get-NetIPInterface

Table of results:  

IFINDEXINTERFACEALIASADDRESSFAMILYNLMTU(BYTES)INTERFACEMETRICDHCPCONNECTIONSTATEPOLICYSTORE
4blueIPv4150040DisabledDisconnectedActiveStore
15LanIPv4140050DisabledDisconnectedActiveStore
10Wi-FiIPv4150020EnabledDisconnectedActiveStore
1Loopback 1IPv4429496729550DisabledConnectedActiveStore