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. Troubleshooting RDP
    1. Check If RDP Is Active
    2. Restart Metric Insights Data Processor Windows Service
    3. Check System Resources on Windows Machine

NOTE: Beginning in v7.1.0, port 32550 no longer needs to open on the Local Data Processor.

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. Troubleshooting RDP

4.1. Check If RDP Is Active

The list of Remote Data Processors helps to define whether the Data Processor profile is active and the connection was established:

  • If your Remote Data Processor is active, it will be shown in default black and the column Last Heartbeat Time will have a value equal to the time you started RDP Daemon Service plus up to 2 minutes.
  • If your Remote Data Processor is not active, it will be displayed in red. The column Last Heartbeat Time will have a value with the last time it successfully connected (if have ever been before) or be empty if never connected.

4.2. Restart Metric Insights Data Processor Windows Service

On the Windows machine where RDP was installed access Services. In the list of services find Metric Insights Data Processor Daemon service, Start or Restart the service.

4.3. Check System Resources on Windows Machine

If Windows service could never start up or stops within a few minutes check if you have enough CPU and Memory on the Remote Data Processor Server so the Remote Data Processor service doesn't consume too much system resources.

If you still encounter any problems please contact [email protected] for further investigation.

If Windows service could never start or stops in a couple of minutes, check whether there is enough CPU and Memory on the Remote Data Processor Windows machine so the Data Processor Daemon service doesn't consume too much system resources.

If you encounter any other problems establishing connectivity with Remote Data Processor please contact [email protected] for further investigation.