What is this?

This knowledgebase contains questions and answers about PRTG Network Monitor and network monitoring in general. You are invited to get involved by asking and answering questions!

Learn more

PRTG Network Monitor

Intuitive to Use. Easy to manage.
More than 500,000 users rely on Paessler PRTG every day. Find out how you can reduce cost, increase QoS and ease planning, as well.

Free Download

Top Tags


View all Tags

How can I use the Multi-Platform Probe on Docker?

Votes:

0

Your Vote:

Up

Down

How can I run the Multi-Platform Probe and NATS server used by it with Docker?

docker linux nats probe prtg

Created on Dec 23, 2021 3:04:40 PM by  Greg Campion [Paessler Support]



3 Replies

Accepted Answer

Votes:

0

Your Vote:

Up

Down

This article applies as of PRTG 21.4.73

Running the NATS server and the Multi-Platform Probe in a Docker container

Follow the instructions below to run the NATS server and the Multi-Platform Probe in one or more Docker containers.

Content

1. Disclaimer

2. NATS server setup

3. Multi-Platform Probe setup

4. Run NATS server and Multi-Platform Probe setup on the same system


1. Disclaimer

Important: The Multi-Platform Probe is currently in the alpha phase. Unexpected issues can occur. We do not recommend that you use the feature on your production system.


2. NATS server setup

Configuration hints and information:

  • We recommend that you use Linux containers. To run a Linux container on Windows, follow the instructions here.
  • If you want to run a Multi-Platform Probe on the same Docker, follow the instructions under 4. NATS server and Multi-Platform Probe setup on the same system below.
  • If the Multi-Platform Probe runs on another system, you must open the corresponding port on the system that runs the NATS server.
  • We recommend that you use port 23561 as NATS client interface port and PRTG as user name and password. If you change them, you must also change them in the probe adapter and in the Multi-Platform Probe.
  • If you do not want to use credentials in the docker run-command, you can create a configuration file according to the NATS documentation or create it with the installation script. For more information, see 2.2. Advanced command below.

2.1. Basic command

Execute the following command to start the NATS server container:

docker run -d --name prtg-nats -p 23561:23561 nats:2.4 --user PRTG --pass PRTG –p 23561

2.2. Advanced command

You can also start the NATS server with a configuration file and logs:

docker run -d --name prtg-nats -p 23561:<port_used_in_nats_config> \ --mount type=bind,src=<docker_dir_path>,dst=/etc/nats/ \ nats:2.4 \ --config /etc/nats/prtg-nats.config \ --log /etc/nats/prtg-nats.log

You can find more information in the official NATS documentation here or on docker hub here.


3. Multi-Platform Probe setup

Configuration hints and information:

  • The PRTG Multi-Platform Probe container image is only available for Linux. To run a Linux container on windows, follow the instructions here.
  • Download the docker container image .tar-file here.

3.1. Setup

1. Execute the following command to load the container image in Docker:

  • Bash:

docker load < prtgmpprobe_debian.tar

  • PowerShell:

docker load --input prtgmpprobe_debian.tar

2. Execute the following command to copy the container image ID of the newly added image:

docker images

3. Execute the following command to start the Multi-Platform Probe container:

docker run -d --name prtg-multiplatform-probe <your_prtgmpprobe_image_id> --nats-ip <ip-of-nats-server>

Note: You can either provide the arguments as follows --nats-ip like in the example above or as described here.

  • Execute the following command to see all Multi-Platform Probe CLI arguments and the corresponding environment variables:

docker run -t <your_prtgmpprobe_image_id> --help


4. Run NATS server and Multi-Platform Probe setup on the same system

You can run the NATS server and the Multi-Platform Probe on the same system. However, this can cause performance issues and is therefore only recommended for test environments.

Follow the steps below:

1. Execute the following command to create a new Docker container for PRTG only:

docker network create --subnet 172.200.0.0/16 prtg

Note: This is necessary because Docker containers can only communicate with each other if they are in the same network.

2. Execute the following command to run the container with a fixed IP address in the network that you have created:

docker run -d --name prtg-nats --net prtg --ip 172.200.0.200 -p 23561:23561 nats:2.4 --user PRTG --pass PRTG -p 23561

3. Execute the following command to start the Multi-Platform Probe

docker run --net prtg -d <container_image_id> --nats-ip 172.200.0.200

4. Execute the following command to verify that all components are running:

docker ps

Created on Dec 23, 2021 3:05:53 PM by  Greg Campion [Paessler Support]

Last change on Mar 23, 2022 3:52:06 PM by  Greg Campion [Paessler Support]



Votes:

0

Your Vote:

Up

Down

Hello do you plan to provide the Linux native arm64 docker image? The download link specifies only amd64 image. Would be good to be able to run docker probe under Raspberry PI.

As a side note. Can we expect the images to be published to docker hub/other repositories instead of manual download?

Created on May 6, 2022 8:00:43 AM by  Jakub Čábera (4) 1



Votes:

1

Your Vote:

Up

Down

Yes we do plan to provide ARM versions of the image soon.

We are also looking into how best we can publish these to some kind of public registry and will post more information here when we figure out what we'll do.

Thanks so much for the feedback!

Created on May 6, 2022 8:10:50 AM by  Greg Campion [Paessler Support]



Please log in or register to enter your reply.


Disclaimer: The information in the Paessler Knowledge Base comes without warranty of any kind. Use at your own risk. Before applying any instructions please exercise proper system administrator housekeeping. You must make sure that a proper backup of all your data is available.