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 a GUI Frontend for Docker, specify this URL (no authentication required) https://hub.docker.com/r/sevensignal/sonar/ then select the “latest” tag.
- 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 the VMWare general readme for Sonar install
- Download instructions for VMWare ESXi 5.5 and 6.0
- Download instructions for VMWare ESXi 6.5
- Download instructions for VMWare ESXi 6.7
Download MF, OVF and VMDK Files
- Sonar VM Template CentOS7 SHA1-2019-05-28.mf
- Sonar VM Template CentOS7 SHA1-2019-05-28.ovf
- Sonar_VM_Template_CentOS7_SHA1-2019-05-28-disk1.vmdk
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
- # 7sonar and hit enter
- If output shows 7sonar commands, proceed with upgrade
- # yum upgrade (see example Sonar_upgrade doc)
- You are done
- # wget https://dl.cloudsmith.io/public/7signal-solutions-inc/sapphire-distribution/rpm/el/7/x86_64/7signal-Sonar-8.2.3.6-1.el7.x86_64.rpm --no-check-certificate
- # wget https://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/x/xmlstarlet-1.6.1-1.el7.x86_64.rpm --no-check-certificate
- # rpm -i xmlstarlet-1.6.1-1.el7.x86_64.rpm
- # rpm -U 7signal-Sonar-8.2.3.6-1.el7.x86_64.rpm
- # 7sonar start
- # cd /opt/7signal/Sonar
- # ./uninstall_sonar.sh
- Install sonar application by following the instructions at the top of this article.
or
- Copy and install packages manually to Sonar server (please note that future Sonar upgrades will be done with same procedure)
- # wget https://dl.cloudsmith.io/public/7signal-solutions-inc/sapphire-distribution/rpm/el/7/x86_64/7signal-Sonar-8.2.3.6-1.el7.x86_64.rpm --no-check-certificate
- # wget https://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/x/xmlstarlet-1.6.1-1.el7.x86_64.rpm --no-check-certificate
- # rpm -i xmlstarlet-1.6.1-1.el7.x86_64.rpm
- # rpm -i 7signal-Sonar-8.2.3.6-1.el7.x86_64.rpm
- If this step fails with the error that java-11-openjdk-headless is needed for 7Signal Sonar, then please follow these steps...
- # sudo yum search jdk
- # sudo yum install java-11-openjdk-headless.x86_64
- # rpm -i 7signal-Sonar-8.2.3.6-1.el7.x86_64.rpm
- # 7sonar start