Help & Documentation
Open Support Ticket

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. 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: Beginning in v7.1.2, certificates placed in C:\Program Files\Metric Insights\Remote Agent\bin\certificates are automatically added to the Remote Agent's Java cacerts truststore.

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 <MI_hostname>.crt
    • Example: If your MI hostname is example.metricinsights.com, the certificate filename must be example.metricinsights.com.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\certificates\<MI_hostname>.crt

4.3. 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: