Documentation forWeb Performance Monitor

Configure remote systems that host WPM Players

When deploying WPM Players to remote systems, consider how you want them to communicate with the Orion server, and if you want them to be updated automatically when new versions of the WPM Player are available.

Although a WPM Player is added to the Orion server when you first install WPM, SolarWinds recommends using a different server as the main location to play transactions. The Orion server usually serves as the Main Polling Engine for an environment, so running multiple transactions repeatedly on that server could have a negative impact.

As a best practice, host your main WPM Player location in one of these locations:

  • An Additional Polling Engine (APE),
  • A dedicated Windows server.
  • A server farm.

Note the following details about setting up WPM Players on remote systems:

  • Additional configuration may be required, depending on the transactions involved. A WPM Player uses a separate WPM Worker process to perform each step in a transaction, and each WPM Worker process requires its own SEUM-User account with the necessary permissions. After you create transactions and decide where to run them, you can adjust SEUM-User accounts so a WPM Player has adequate permissions to run transactions.
  • If a computer hosts a hypervisor or Virtual Machine Monitor (VMM) running various servers (for example, print or file servers), consider hosting the WPM Player on another server instead.
  • The Web Transaction Recorder does not save client certificates in recordings. You'll need to install them on remote systems used to create recordings, as well as remote systems that host the WPM Player where transactions will check certificates. See Add client certificates to support WPM playback.
  • Starting in WPM 2020.2.2, several Windows settings are updated during WPM Player deployment:
    • Net.Tcp Port Sharing Service: The Startup Type is set to Manual on the Orion server and any Additional Polling Engines (APEs). On remote systems, the Startup Type is set to Automatic.
    • SolarWinds WPM Playback Player service: A dependency with the Net.Tcp Port Sharing Service is added.
  • Starting in WPM 2020.2.6, open TCP port 17784 to support inter-process communication between the WPM Player service, the WPM Domain Accounts Configuration Tool, and the Player Settings Tool.
  • If you change WPM Player settings later, be sure to update the Orion server also. Click Settings > All Settings > WPM Settings > Manage Player Locations and edit settings for the player's transaction location.

For remote system requirements for WPM Players, see the WPM System Requirements.

To configure the WPM Player service:

  1. Log into the system that hosts the WPM Player service.
  2. Open the WPM Player Settings tool from the Start menu.

    Starting in WPM 2020.2.6, this tool requires that the SolarWinds WPM Playback Player service is running. If an "Unable to load player settings from Agent Service error appears," launch the Orion Service Manager from the Windows Start menu to restart that service.

  3. In the WPM Player Settings tool, select a communication method and provide values, as prompted.
    • Server-initiated communication sets the WPM Player service in passive mode to wait for requests from the Orion server on port 17781. If you select this option, configure firewall and Network Address Translation (NAT) settings on each system that hosts a WPM Player so agents can communicate with the Orion server.
    • Player-initiated communication allows the WPM Player service on remote systems to actively initiate communication with the Orion server on port 17782. Active agents can navigate the Firewall/NAT configuration and connect to polling servers using a HTTP(S) protocol. Managed Service Providers (MSPs) and larger distributed deployments may prefer this option.
  4. (Optional) Clear the "Enable automatic update" check box if you want WPM to prompt you before installing new versions of the WPM Player when they are available.
  5. Click Save.
  6. After two minutes, check logs for an entry that indicates the WPM Playback Player service is ready to receive commands from the Orion server or an Additional Polling Engine:

    INFO SolarWinds.SEUM.Agent.Service.AgentServiceApp - HTTPS Server listening at https://localhost:17781/

    The default location for WPM logs is C:\ProgramData\Solarwinds\Logs\SEUM

  7. (Optional) Configure support for proxy server authentication, as described next.
  8. (Optional) Enable FIPS by adjusting Windows OS settings.
  9. (Recommended) Exclude file paths and volumes from antivirus software scans.

Configure support for proxy server authentication on WPM Players

To configure the WPM Player service to support transactions that authenticate proxy servers: 

  1. In File Explorer, navigate to the following default folder:
    C:\Program Files (x86)\SolarWinds\Orion\SEUM\Player\
  2. Run a text editor as an Administrator and open SolarWinds.SEUM.Agent.Service.exe.config
  3. Scroll to the agentConfiguration section and "uncomment" the <proxyTrustedHosts> section, as shown in this example:

    Note the following details about updating this file:

    • The <proxyTrustedHosts> section should appear between the following tags:
      • <agentConfiguration>
      • </agentConfiguration>
    • By default, the <agentConfiguration> tag doesn't have a closing tag because it only includes attributes. The tag ends with "/>". Remove "/" from the end of the <agentConfiguration>.
    • If the file contains errors, the WPM Player ignores it during startup and uses default settings.
  4. Save changes to the config file.