Deployment
      Back to home
      1. Technical Information and Help Center
      2. Mobile Eye
      3. Deployment

      Sonar Endpoint

      Whether you use Sapphire Eye or Mobile Eye, Sonar by 7SIGNAL is a test endpoint for active tests, like Throughput, Packet Loss, and Jitter. You can install Sonars in multiple locations to get application performance results from both wireless and wired networks across your Enterprise. Sonar software may be installed on a dedicated server or virtual machine. 

      Ports and Protocols

      • UDP 9999
      • UDP 50000 to 50300
      • TCP 80
      • TCP 443
      • 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 IP Address Location
      east1.sonar.7signal.com 185.59.223.104 New Jersey, US
      east2.sonar.7signal.com 89.187.176.135 New York, US
      central1.sonar.7signal.com 185.93.0.180 Atlanta, US
      midwest1.sonar.7signal.com 185.93.1.59 Chicago, US
      pacific1.sonar.7signal.com 185.152.67.214 San Francisco, US
      emea1.sonar.7signal.com 89.187.169.70 Frankfurt, DE
      emea2.sonar.7signal.com 195.181.165.171 London, GB
      apac1.sonar.7signal.com 89.187.162.74 Singapore

      Installing the Docker® Container

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

      • Using Command Line, if you would like to run sonar locally from an image, you can simply run this command:
        • docker run --rm -p 80:80 -p 50000-50100:50000-50100/udp sevensignal/sonar

      This will run the latest (tag) version of the image. Images are also tagged with their actual sonar version (e.g. 8.2.3.1-1.el7).

      For example:  docker run --rm -p 80:80 -p 50000-50100:50000-50100/udp sevensignal/sonar:8.2.3.1-1.el7

      For a complete list see the 7SIGNAL repositories on docker hub: https://hub.docker.com/r/sevensignal/sonar/tags

      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

      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>

      Installing the Virtual Machine

      We recommend deploying the OVF via the vSphere Web Client. It is compatible with VMWare ESXi 5.5, 6.0, 6.5, 6.7 and 7 as well as VMware Workstation 14.

      Instruction Guides

      Download MF, OVF and VMDK Files

      For security reasons, signature files are provided, per the general VMWare readme document referenced above. The signatures may be found here.

      Sizing Requirements Matrix for Sonar VM

       

      # of Sapphire Eyes

      		 # of Mobile Eyes CPU Cores Clock Speed RAM Disk Space Disk Type LAN
      1-50 < 500 2 2.4 GHz 4 GB 20 GB HD 5400 rpm 1 GB
      51-100 < 1,000 4 2.6 GHz 4 GB 20 GB HD 5400 rpm 1 GB
      100-300 <5,000 4 2.6 GHz 8 GB 20 GB HD 5400 rpm 1 GB
      >300 >5,000 Requires Additional Sonar

      Installing the Application

      First, you must enable the sapphire-distribution yum repository by issuing the command below. Please type the command into your shell and do not copy and paste it from this page. 

      # curl -1sLf "https://dl.cloudsmith.io/public/7signal-solutions-inc/sapphire-distribution/cfg/setup/bash.rpm.sh" | sudo codename=7 bash

      Then, install Sonar with this command:

      # yum install 7signal-Sonar

      Configuration

      The 7sonar utility has several useful commands for viewing and updating settings:

      # 7sonar config
      Server name : Sonar
      Server port(s) : 80
      Max. clients : 300
      First MOS port : 50000
      Number of MOS ports : 100

      # 7sonar loglevel
      Log level is INFO

      # 7sonar config set name <new name>
      # 7sonar config set port <TCP port number>
      # 7sonar config set maxclients <number of concurrent clients>
      # 7sonar mosstart <first UDP port number>
      # 7sonar mossize <number of UDP ports>
      # 7sonar loglevel set <DEBUG, INFO, WARN, ERROR>

      Start

      Start the Sonar server with the following command:

      # 7sonar start

      Upgrade

      Sonar upgrade process:

      • SSH to sonar by using root credentials
      • Verify that the Linux operating system is CentOS / RedHat 7.x.
      • # cat /etc/redhat-release
      If Linux OS is not at minimum, CentOS / RedHat 7.x, then you should update as soon as possible because CentOS/RedHat 6.X is end-of-life and has not received any Linux security patches since November of 2020. Please note that CentOS/RedHat 6.X is no longer supported by 7SIGNAL.
      • # 7sonar and hit enter
        • If output shows 7sonar commands, proceed with upgrade
      • # yum upgrade (see example Sonar_upgrade doc)
        • You are done
      If yum is failing, and not able to reach Linux mirrors, copy and install packages manually to Sonar server (please note that future Sonar upgrades will be done with the same procedure)
      However, if output shows no 7sonar commands, uninstall the previous version first.
      • # cd /opt/7signal/Sonar
      • # ./uninstall_sonar.sh
      • Install sonar application by following the instructions at the top of this article.

      or