Installing a Remote Agent on Windows Servers (v7.1.2+)

RDP has been renamed to Remote Agent in 7.1.2.

Prerequisites:

  • This article assumes you have created a Remote Agent profile in Metric Insights, as described in Configuring a Remote Agent (v7.1.2)
  • Recommend specs for host Windows server:
    • 4 cores / 16GB memory
    • 100GB disk where Remote Agent will be installed
    • Windows Server 2016+ (64-bit)

Table of contents:

  1. Download Remote Agent Installer
  2. Extract ZIP File Contents and Launch Remote Agent Installer
  3. Start Metric Insights Data Processor Windows Service
  4. Add SSL Certificate to JDK Keystore
    1. Download SSL Certificate of MI Application from Browser
    2. Save Certificate on Remote Agent Machine
    3. Access Certificate Directory
    4. Run Command to Add SSL Certificate to JDK Keystore
    5. Restart Remote Agent Service
  5. Upgrading and Troubleshooting Remote Agent

1. Download Remote Agent Installer

Access Admin > Collection & Storage > Remote Agents

The Remote Agents section lists all Remote Agent profiles along with the Last Heartbeat Time (displays the last successful connection time of the Remote Agent to the Metric Insights application).

  1. Access the previously created Remote Agent profile
  2. [Download Remote Agent Installer]

2. Extract ZIP File Contents and Launch Remote Agent Installer

Access the directory where the ZIP file content was extracted > \remote_agent directory

  1. Run installer.bat script as administrator

To perform this action you need to work as an Admin User on the Windows Machine where Remote Agent is to be installed or contact your System Administrator to proceed with the installation.

  1. Select installation directory or leave the default, then [Install]

3. Start Metric Insights Data Processor Windows Service

There are two alternative ways to start Remote Agent Windows service:

  1. Navigate to the Windows Services list and start the Metric Insights Remote Agent Daemon service
  2. Access the directory where you extracted the ZIP file and open the bin\Start Metric Insights.bat file 

4. Add SSL Certificate to JDK Keystore

NOTE: This step is required to configure Remote Agent after an upgrade to MI v7.1.0.

4.1. Download SSL Certificate of MI Application from Browser

  1. [View site information]
  2. [Show connection details]
  3. [Show certificate]
  4. [Details]
  5. [Export], save the file as server.crt

4.2. Save Certificate on Remote Agent Machine

Access the Remote Agent machine and place the downloaded certificate under C:\Program Files\Metric Insights\Remote Agent\bin\jdk-23.0.1\lib\security\server.crt

4.3. Access Certificate Directory

Open the directory with the certificate: cd C:\Program Files\Metric Insights\Remote Agent\bin\jdk-23.0.1\lib\security

4.4. Run Command to Add SSL Certificate to JDK Keystore

Run the following command to add the SSL certificate to the JDK keystore: keytool -import -trustcacerts -alias <MI_hostname> -file server.crt -keystore cacerts

  • Replace <MI_hostname> with your application's hostname

4.5. Restart Remote Agent Service

See Restart Metric Insights Data Processor Windows Service for details.

5. Upgrading and Troubleshooting Remote Agent

See the following articles on upgrading and troubleshooting the Remote Agent: