Submit a ticketCall us

WebinarUpcoming Webinar: Should I Move My Database to the Cloud?

So you’ve been running an on-premises SQL Server® for a while now. Maybe you’ve moved it from bare metal to a VM, and have seen some positive benefits. But, do you want to see more? If you said “YES!”, then this session is for you, as James Serra will review the many benefits that can be gained by moving your on-prem SQL Server to an Azure® VM (IaaS). He’ll also talk about the many hybrid approaches, so you can gradually move to the cloud. If you are interested in cost savings, additional features, ease of use, quick scaling, improved reliability, and ending the days of upgrading hardware, this is the session for you.

Register now.

Home > Success Center > Network Performance Monitor (NPM) > Change the default port using SolarWinds.AgentManagement.ServiceCore.dll.config and SolarWinds.Agent.Service.exe.config

Change the default port using SolarWinds.AgentManagement.ServiceCore.dll.config and SolarWinds.Agent.Service.exe.config

Table of contents
Created by Milton Harris, last modified by Milton Harris on Jun 14, 2017

Views: 2,283 Votes: 2 Revisions: 26


This article describes how to change the default port used by Orion to accept connections from remote agents by using the SolarWinds.AgentManagement.ServiceCore.dll.config, to adjust the Agent Management service, and how to adjust agents by either editing SolarWinds.Agent.Service.exe.config or using the Orion Agent Settings tool.


NPM v11.5.2 and earlier


To manually modify the default port used by the Agent Management service:

  1. Go to C:\Program Files (x86)\SolarWinds\Orion\AgentManagement\ and backup the file SolarWinds.AgentManagement.ServiceCore.dll.config to another location.
  2. Then open the file SolarWinds.AgentManagement.ServiceCore.dll.config in a text editor. The top portion of the document contains the following:
    <?xml version="1.0" encoding="utf-8"?>

    <section name="log4net" type="System.Configuration.IgnoreSectionHandler" />
    <section name="agentManagementServiceConfiguration" type="SolarWinds.AgentManagement.ServiceCore.Configuration.AgentManagementServiceConfiguration, SolarWinds.AgentManagement.ServiceCore" />
    <section name="SolarWinds.BusinessLayerHost" type="System.Configuration.IgnoreSectionHandler" />
    <section name="entityFramework" type="System.Data.Entity.Internal.ConfigFile.EntityFrameworkSection, EntityFramework, Version=, Culture=neutral, PublicKeyToken=b77a5c561934e089" requirePermission="false" />
    <agentManagementServiceConfiguration messagingPort="17778" />
  3. Change the value of messagingPort="17778" to your preferred port value, and then save the file. This will set the Orion server to listen on the port 17778 for agent connections.
  4. Restart the SolarWinds Orion Module Engine service to apply the changes.

This change will persist across runs of the Configuration Wizard however upgrades and repairs may revert the change.



Next agents which are using agent initiated communication method, where the agent is connecting to the Orion server, must be configured with the new port configuration.


It is possible to reconfigure agents using the Orion Agent Settings interface.


To use the Orion Agent Settings to modify the communication settings of an agents:

  1. Open Windows Control Panel.
  2. Open the Orion Agent Settings.
  3. Input the preferred Agent communication settings.
  4. Click on OK to apply the settings.


Or the agents can be set by editing the agent's SolarWinds.Agent.Service.exe.config file.

  1. To manually set the agent to connect to this newly configured port go to C:\Program Files (x86)\SolarWinds\Agent\ and backup the SolarWinds.Agent.Service.exe.config file
  2. Open the SolarWinds.Agent.Service.exe.config file in a text editor. The document contains the following lines:
  3. Change <port0>17778</port0> to your preferred port value, and then save the file.

  4. Restart the SolarWinds Agent service to apply the changes.



Last modified