Sonar Endpoint

 

Sonar by 7SIGNAL is a test endpoint for active tests, like Throughput, Packet Loss, and Jitter. It is recommended that you use one of the 7SIGNAL Cloud Sonars provided with the solution.  If you choose to install local Sonars, it will require your own IT system and network administrators to install and support a customer installed Sonar.  You may also choose to purchase a 7SIGNAL Service package to assist you, contact your 7SIGNAL representative. 

 

Required Ports and Protocols

• UDP 9999
• UDP 50000 to 50300
• TCP 80
• ICMP

Cloud Sonars

7SIGNAL Sonar endpoints in the cloud are available to 7SIGNAL customers only. Depending upon your location in the world, you can select the appropriate Sonar. Below is a list.

System Requirements

Sonar is a Linux application that requires a Linux machine or VM.  example of Debian 12 requirements Chapter 2. System Requirements (debian.org).

The following are the minimum system requirements for Debian. But it can vary based on what type of box you want to set up.  Follow your company policy on System and security requirements for server/VM administration.

Docker Desktop system requirements documentation for the specific Docker Desktop platform version you will be using.  Default recommendation using Linux and the same VM/machine system to ease installation of Sonar on Linux system. 

Combining Linux and windows is not recommended with Docker as there are known issues documented on Docker.  Example Linux container on Window hosts has known issues.

The performance of a customer's Sonar can vary based on the customer's network and container resources. Adjust these parameters as necessary to enhance performance.  A typical installation supports fewer than 200 sensors or fewer than 5000 Agents per Sonar.  Adjust resources as needed to achieve the desired performance and operational efficiency.

Installing the Docker® Container

It’s the simplest way to get Sonar up and running. 

• Go to https://docker.com (See Docs) or https://docs.docker.com/get-docker/  to download the Docker Desktop platform version you will use in your environment.
• Use existing or create a platform of choice using Docker system requirements to install Docker.  Example for Linux OS see Install Docker Desktop on Linux | Docker Docs
• Once installed on the server, search for the "sevensignal" Docker container and "pull" the latest version. When finished, press the ESC key to close the window.

• Next, open a CMD or Terminal window, and using the the command line, type...

docker run --rm -p 80:80 -p 50000-50300:50000-50300/udp sevensignal/sonar

• Close your CMD/Terminal window. 
• You should see your Sonar Docker container running.
• Keep with window open or minimize the GUI so that it continues running.

Customize When Running

Environment variables can be passed to the container when running. These will modify the configuration (for that run) for end-user customization:

MAX_CLIENTS - Default: 300 - Configures the maximum number of clients which can concurrently connect to the sonar

MOS_PORT_START - Default: 50000 - Configures the starting port for MOS testing

MOS_PORT_SIZE - Default: 100 - Configures the number of ports that will be allocated. Consider adding 300 ports for larger deployments.

These can be passed as “environment” variables to the container when running:

Examples:

Run with an alternate port:

docker run -p 8000:80 -p 50000-50100:50000-50100/udp sevensignal/sonar

Run with a higher max client size:

docker run -e MAX_CLIENTS=600 -p 80:80 -p 50000-50100:50000-50100/udp sevensignal/sonar

Run with higher max client size and MOS Ports

docker run -e MAX_CLIENTS=600 -e MOS_PORT_SIZE=600 -p 80:80 -p 50000-50600:50000-50600/udp sevensignal/sonar

Kill a running container:

docker ps (to list containers) and docker kill <container id>