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