Submit a ticketCall us

Have You Auto Renewed? If not, you're missing out.
The SolarWinds Renewal Program comes with a host of benefits including the most recent product updates, 24/7 technical support, virtual instructor-led training and more. Experience all of this with the convenience of Auto Renewal, and never worry about missing any of these great benefits. Learn More.

Home > Success Center > Log & Event Manager (LEM) > Agent switches to set Hostname

Agent switches to set Hostname

Table of contents
Created by James Nielsen, last modified by Erica Gill on Jul 24, 2017

Views: 163 Votes: 3 Revisions: 9

Overview

Agents sometimes consume more licenses because they contain multiple nic cards. Often, this is because they are choosing the wrong nic/hostname to use. This article provides information on switches to help choose the correct hostname.

Environment

LEM with Agent

Detail

 

  1. Connect to a machine reporting duplicate entries.
  2. Navigate to C:\Windows\SysWOW64\ContegoSPOP
  3. Edit the spop.conf file.
  4. Add the switch you would like to use (either the first, or third option below, typically) to the end of the file or as a new line.
    note:  only use one of the following three options. remove the one attempted, if trying another.
  5. Save the file.
  6. Restart the Solarwinds Log and Event Manager Agent service.
  7. Delete the duplicated node from the Nodes view on the LEM.

 

For a 32 bit system the switches below need to be added to the spop.conf file located in:

C:\Windows\System32\ContegoSPOP

 

It is recomended to not use Notepad as it may not correctly read the carriage returns.

 

  1. This is typically the better option. You will want to go to those specific agents and have them use the switch to report their name by not using the hosts file.  First, have them type "hostname" (or "computername" on some OS's) on those boxes.  If this is the desired hostname to use then use this switch in the spop.conf:
    UseLocalEnvironmentVariableForLocalHost=true
    And look for this log line in the agent log:
    "Overriding local hostname to computername/hostname environment variable for local hostname: " + local_name
    or this if we could not get a valid hostname:
    "Overriding local hostname to computername/hostname environment variable failed to get a value, sticking with original local hostname value: " + local_name
  2. Otherwise, if option 1 does not yield the desired hostname to use, see if the manager can detect it for them.  Use this switch and it will prevent the agent from sending its host name.  The manager will then detect it.  FYI: If they are connecting through a firewall than it will detect the name of the firewall instead.
    UseManagerDetectionOfLocalHost=true;
    And look for this log line in the agent log:
    "Overriding local hostname to empty string to trigger manager detection of local hostname"
    NOTE: if you set UseManagerDetectionOfLocalHost (option 2) it will override whatever value is set for UseLocalEnvironmentVariableForLocalHost (option 1).
  3. One additional property that was added as of 6.1.0 agents is a way to bind to a specific ip address or hostname by using "ForcedLocalAddress".
    This could be especially helpful if laptops are mobile within an office environment, using the wireless and/or wired ethernet connection as the computer is moved.
    Example:
    ForcedLocalAddress=10.10.6.10     (fill in the IP address of the laptop/server)
    or
    ForcedLocalAddress=laptop-1     (fill in the hostname of the laptop/server)

 

 

Last modified

Tags

Classifications

Public