This article applies as of PRTG 21.4.73

Multi-Platform Probe step-by-step installation guide

1. Windows installation guide

1.1 Download the installation script for the NATS server and the Multi-Platform Probe

This script guides you through the installation process of the NATS server that is used for the communication between the Multi-Platform Probe and the PRTG core server. This script will also be used for the installation of the Multi-Platform Probe in 1.3, Step 1.

1. Download the installation script here: install-mpp-nats.ps1
   Note: To download the script, right-click the link, select Save link as, select the location to which you want to download the script, and click Save.

1.2 Install the NATS server

1. Run PowerShell as administrator and navigate to the file path to which you downloaded the script in 1.1, Step 1. For example, cd C:\Users\myuseraccount\Downloads.
2. Enter .\install-mpp-nats.ps1 and press Enter to run the script.
   Info: If you see the following error message: “File C:\Users\myuseraccount\Downloads\install-mpp-nats.ps1 cannot be loaded because running scripts is disabled on this system.”, follow the second note at the end of this section.
3. Enter N to select the NATS server installation process and press Enter.
4. Enter I to install the NATS server and press Enter.
5. Enter Y and press Enter if you want to change the current configuration.

A message stating that the NATS server service installation was completed will be visible.

Notes:

• If you run the NATS server on a system that is not the PRTG core server system or the probe system, you must open a port in the firewall of the system that runs the NATS server. To do so, enter the following command in PowerShell (administrator) on the system on which the NATS server runs:
  New-NetFirewallRule -DisplayName 'PRTG NATS Server' -Direction Inbound -Action Allow -Protocol TCP -LocalPort [NATS server port]
• Additional steps if the error message “File C:\Users\myuseraccount\Downloads\install-mpp-nats.ps1 cannot be loaded because running scripts is disabled on this system.” appeared:
  1. Execute the following command:
     Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine
  2. Enter Y to confirm and press Enter.
  3. Execute the install-mpp-nats.ps1 script again.

1.3 Install the Multi-Platform Probe

1. Enter .\install-mpp-nats.ps1 and press Enter to run the script.
2. Enter M to select the Multi-Platform Probe installation process and press Enter.
3. Enter I to install the Multi-Platform Probe and press Enter.
4. Edit the Multi-Platform Probe configuration according to your needs or press Enter to use the default values.
5. Open the PRTG web interface and add the Access Key under Setup | System Administration | Core & Probes in PRTG. The default access key is multi-platform-probe.

You now see the success message, that the Multi-Platform Probe installation was completed.

2. Linux installation guide

2.1 Download the installation script for the NATS server and the Multi-Platform Probe

This script guides you through the installation process of the NATS server that is used for the communication between the Multi-Platform Probe and the PRTG core server. This script will also be used for the installation of the Multi-Platform Probe in 2.3, Step 1.

1. Download the installation script here: install-mpp-nats.sh

2.2 Install the NATS server

1. Open a terminal and run the script which you downloaded the script in 2.1, Step 1. For example, by executing the following commandsudo bash ‘/home/user/Downloads/install-mpp-nats.sh’
2. Enter your password.
3. Enter 1 to select the NATS server installation process and press Enter.
4. Enter 1 to install the NATS server and press Enter.
5. Enter Y and press Enter if you want to install a systemd for the NATS server.
   1. Enter Y and press Enter if you want to start the systemd service.
6. Enter your configuration details. Press Enter to select the default values.

A message stating that the NATS server service installation was completed will be visible.

2.3 Install the Multi-Platform Probe

1. Open a terminal and run the script which you downloaded the script in 2.1, Step 1. For example, by executing the following commandsudo bash ‘/home/user/Downloads/install-mpp-nats.sh’
2. Enter 2 to select the Multi-Platform Probe installation process and press Enter.
3. Enter 1 to install the Multi-Platform Probe and press Enter.
4. Enter Y and press Enter if you want to install a systemd for the Multi-Platform Probe.
   1. Enter Y and press Enter if you want to start the systemd service.
5. Enter the configuration details. Press Enter to select the default values.
6. Open the PRTG web interface and add the Access Key under Setup | System Administration | Core & Probes in PRTG. The default access key is multi-platform-probe.

You now see the success message, that the Multi-Platform Probe installation was completed.

3 Download and install the probe adapter

1. Download the script here: install-probe-adapter.ps1
2. Open PowerShell as administrator on the PRTG core server system and navigate to the direction to which you downloaded the script. Enter for example cd C:\Users\myuseraccount\Downloads.
3. Enter .\install-probe-adapter.ps1 and press Enter to run the script.
4. Enter I to install the probe adapter and press Enter.
5. Enter the IP address of your NATS server.
6. Press Enter to apply the default NATS server settings or edit them according to your configuration.
7. Enter Y to restart the PRTG core server service and press Enter.
8. Wait until the PRTG core server service was restarted.

Notes:

• After you successfully install the probe adapter, you see a dialog box in PRTG. Click Approve to include the new probe in your device tree.
• Do not click Approve and auto-discover. The Multi-Platform Probe does not support the auto-discovery.

4 Run the NATS server or the Multi-Platform Probe on Docker

1. You can find a comprehensive guide for running the NATS server or the Multi-Platform Probe in a Docker container here.