Platform
      Back to home
      1. Technical Information and Help Center
      2. Platform

      Sonar Endpoint

       

      CentOS 7 is end of life in June of 2024. As a result, 7SIGNAL will no longer support these VM deployments.

      We advise you to transition to a Docker® environment and install 7SIGNAL's Sonar as a Docker container. Instructions are below.

      For more information on the benefits of Docker, refer to Docker's online documentation: https://docs.docker.com/get-started/


      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.

      FQDN Location
      east1.sonar.7signal.com New Jersey, US
      east2.sonar.7signal.com New York, US
      east3.sonar.7signal.com New York, US
      central1.sonar.7signal.com Atlanta, US
      midwest1.sonar.7signal.com Chicago, US
      pacific1.sonar.7signal.com San Francisco, US
      emea1.sonar.7signal.com Frankfurt, DE
      emea2.sonar.7signal.com London, GB
      apac1.sonar.7signal.com Singapore
      sa.sonar.cloud.com Sao Paulo, BR

      System Requirements for On-site Sonar

      • RAM: 8GB minimum, 16GB recommended.
      • Hard drive space: 30GB minimum, 50GB recommended.
      • Processor: Minimum Quad-core processor or higher recommended processor
      These system requirements are provided as general guidelines for the optimal performance of the Sonar application on a Linux server. These requirements are based on typical usage scenarios and may vary depending on specific configurations, workloads, and deployment environments.
      A typical installation supports fewer than 200 sensors or fewer than 5,000 agents per Sonar.  Adjust resources as needed to achieve the desired performance and operational efficiency.

      Installing the Sonar Docker® Container on Linux

      • We recommend using the Linux Docker container on a Linux machine.
      • Use your existing Linux Docker environment, or create one. Follow Docker's system requirements. See Install Docker Desktop on Linux | Docker Docs.
        • To install Docker on Red Hat based systems:  #sudo yum install docker
        • To install Docker on Debian based systems: #sudo apt-get install docker.io
        • Type: #docker ps to confirm it started
        • To pull the 7SIGNAL Sonar, type: sudo docker run --restart=unless-stopped -d -p 80:80 -p 50000-50300:50000-50300/udp sevensignal/sonar

      If you are asked to select an image, choose docker.io/sevensignal/sonar:latest

        • Confirm successful start: #docker ps
        • Get the server's IP address: #ip address
      • Use the IP address to configure a new Sonar in the 7SIGNAL platform

      Updating Sonar Docker Container

      • docker pull sevensignal/sonar:latest
      • docker ps  ( Lists all running container note the Sonar container id ) 
      • docker stop <container id or name>
      • docker rm <container id or name>
      • sudo docker run --restart=unless-stopped -d -p 80:80 -p 50000-50300:50000-50300/udp sevensignal/sonar

      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>