Configuring a Remote Data Processor on Windows Servers
Requirements: 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 Collector/Processor.
Recommend specs for host Windows server:
- 4 cores / 16G memory
- 100G disk where RDP will be installed
- Windows Server 2016+ (64-bit)
Before installing Data Processor on the Remote Machine, make sure you have all the necessary ports opened to establish connectivity between the MI server and the RDP.
On the MI server, the components involved are data-processor (listening on port 2550) and seed (listening on port 2551). On the RDP side, remote data-processor uses one of the following ports:
- In the Start Menu, start typing Control Panel, open this panel
- Within the System and Security section, find and open Windows Firewall
- Select Advanced Settings
On the Windows Server where you plan to install the Data Processor, access your Metric Insight application from a web browser. Go to Admin > Collection & Storage > Remote Data Processors.
The Remote Data Processors section lists all your Remote Data Collector profiles along with the Last Heartbeat Time (displays the last successful connection time of the RDP to the Metric Insights application).
Access the editor of the RDP you want to install on your Windows server. Make sure that the Hostname parameter value matches the Windows server IP to install RDP on and click [Download ZIP file] button. While downloading the ZIP file, you might get a warning message that the file can be harmful for your computer. Skip this warning and proceed with downloading.
Within the directory where the ZIP file content was extracted, open
\data-processor directory and run the
installer.bat script as an 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.
Select installation folder or leave the default, then press "Install" button.
Navigate to the Windows Services list and start the Metric Insights Data Processor Daemon service or run
bin\Start Metric Insights.bat file
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.
On the Windows machine where Data Processor was installed access Services. In the list of services find Metric Insights Data Processor Daemon service >> Start or Restart the service.
On Windows machine where Remote Data Processor is installed open Command Prompt (from Windows Start Menu type
commant prompt) and try the following commands (replace
22.214.171.124 with the private IP address of your MI server):
ping 126.96.36.199 telnet 188.8.131.52 2551
If you have an orchestrated environment, check port 32551 using
Connect to your MI app linux server, in Command Line execute
ping 0.0.0.0 telnet 0.0.0.0 2551
0.0.0.0 with the RDP Windows server private IP address.
If there are any errors on connection attempt contact your System Administrator to open access to the relevant server.
On Windows RDP machine in the Command prompt execute
You should see the installed Java version in the output.
Open Windows Settings, search for Environmental Variables, in the Properties pop-up click the Environmental Variables button to open the list of Environmental Variables.
You need to be logged in as Admin User to edit the Environmental Variables.
JAVA_HOME variable is specified with the correct path to the directory where Java is installed.
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 serice 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 recources.
If you encounter any other problems establishing connectivity with Remote Data Processor please contact [email protected] for further investigation.