Installing a Remote Data Processor on Windows Servers

Prerequisites:

  • The Remote Data Processor is a Java-based application. To run on Windows, please install Java. The latest Java Runtime Package can be downloaded from the Java Download site. The Java installation package should correspond to your Windows operating system (32-bit or 64-bit).
  • This article assumes you have created a Remote Data Processor profile in Metric Insights, as described in Configuring a Remote Data Processor.
  • Recommend specs for host Windows server:
    • 4 cores / 16GB memory
    • 100GB disk where RDP will be installed
    • Windows Server 2016+ (64-bit)
  • For MI versions prior to v7.1.0:
    • Open Port 32550 on Local DP

Table of contents:

  1. Download RDP Installer
  2. Extract ZIP File Contents and Launch RDP 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 RDP Machine
    3. Access Certificate Directory
    4. Run Command to Add SSL Certificate to JDK Keystore
    5. Restart RDP Service
  5. Upgrading and Troubleshooting RDP

NOTES:

  • Beginning in v7.1.0, port 32550 no longer needs to open on the Local Data Processor;
  • After an update to MI v7.1.0 it is required to upgrade RDP

1. Download RDP Installer

Access Admin > Collection & Storage > Remote Data Processors

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

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

2. Extract ZIP File Contents and Launch RDP Installer

Access the directory where the ZIP file content was extracted > \data-processor 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 Data Processor 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 RDP Windows service:

  1. Navigate to the Windows Services list and start the Metric Insights Data Processor 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 RDP 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 RDP Machine

Access the RDP machine and place the downloaded certificate under C:\Program Files\Metric Insights\Data Processor\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\Data Processor\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 RDP Service

5. Upgrading and Troubleshooting RDP

See the following articles on upgrading and troubleshooting the RDP: