7signal Sapphire Deployment Guide Release 5.0 7signal Solutions Inc., 526 S. Main Street, Akron, Ohio 44311, USA, 855-763-9526, info@7signal.com, www.7signal.
Preface i Document scope This document is aimed at people familiarizing themselves with the 7signal Sapphire system before deployment and to aid the actual deployment. After completion of this document, 7signal Sapphire is installed, up and running ready for Wireless Performance Optimization. This document does not describe how the software operates, how to configure testing or how to read the measurements.
Preface ii This device complies with Industry Canada licence-exempt RSS standard(s). Operation is subject to the following two conditions: (1) this device may not cause interference, and (2) this device must accept any interference, including interference that may cause undesired operation of the device. Le présent appareil est conforme aux CNR d'Industrie Canada applicables aux appareils radio exempts de licence.
Table of Contents iii 1 7signal solution ....................................................................................................................................1 1.1 Solution Overview ......................................................................................................................2 1.2 Hardware ...................................................................................................................................2 1.2.1 802.11a/b/g Standard Eye.................
Table of Contents iv 4.6.2 DBMS installation (Linux 32 bit and 64 bit) ................................................................... 22 4.6.3 Analyzer server installation (Linux 32 bit and 64 bit) ...................................................... 25 4.6.4 Sonar Installation (Linux 32 bit and 64 bit) ..................................................................... 27 4.6.5 Carat GUI Installation (Linux) .......................................................................................
Table of Contents v 9.1 GUI client cannot connect to Carat server ................................................................................. 62 9.2 Cannot add Eye unit ................................................................................................................. 62 9.3 No access to Sonar server, active test failed ............................................................................. 62 9.4 Analyzer client cannot connect to Carat server.....................................
1 7signal solution 1 7signal Sapphire provides you a new way to continuously and automatically measure the health and quality of a wireless network from the user's perspective. Companies and their business processes are becoming increasingly dependent on the performance and service quality of their wireless networks. Thanks to the Sapphire solution, companies can integrate the quality management of wireless networks with their existing IT and communications technology services.
1 7signal solution 2 The 7signal Sapphire quality monitoring solution consists of Sapphire Eye monitoring sensors, Sonar test servers, the Sapphire Carat management software, and Sapphire Analyzer for viewing and reporting on results. 1.2 Hardware 7signal Sapphire Eye is a wireless probe or a monitoring station that is installed in a central position within the WLAN network. Currently there are five different hardware variants: the Standard Eye supporting 802.
1 7signal solution 3 WLAN radio module, 802.11 a/b/g/n support (2.4 GHz, 5.180 GHz - 5.
2 Requirements 4 2.1 Carat server requirements The Carat server controls the Eye units and collects and stores measurement results in the database. Carat server runs on the Linux operating system and can be installed on a dedicated server or virtual environment.
2 Requirements Firewall settings The following ports should be opened in firewalls: Source IP/Mask Destination IP/Mask Protocol/Port Comments Carat server connections to Eye Carat server IP/32 Eye Ethernet IP/32 TCP/7799 Carat server IP/32 Eye Ethernet IP/32 TCP/22 1 Eye management Eye (SSH) Carat GUI connections to Carat server Carat GUI IP/32 Carat server IP/32 TCP/47777 Carat GUI IP/32 Carat server IP/32 TCP/1099 1 Carat GUI Carat GUI RMI Analyzer client (web browsers) connections to
3 7signal Sapphire Connectivity 3.1 Communication security All connections containing meaningful traffic are being encrypted. The used encryption methods are TLS and SSL. The PKI infrastructure (certificates) is being used throughout the solution. Every customer has individual set of certificates, delivered within containers called certificate packages. It is not possible to use the delivered certificates to decrypt traffic of other 7signal Sapphire systems.
4 Installing 7signal Sapphire 7 4.1 Operating System installation tips It is recommended to install the operating system by using the graphical installer. 4.1.1 Hard disk partitioning This chapter gives some guidelines for hard disk partitioning. It is assumed that readers have comprehensive knowledge about Linux file systems, RAID, LVM and disk partitioning. This chapter does not cover basic partitioning requirements, e.g. configuring boot and swap partitions are not covered.
4 Installing 7signal Sapphire 50% of space for OS installation, mount point “/” (LV1) o 50% of space for database logs, mount point “/opt/7signal/database-logs” (LV2) Physical volume on RAID5 has two logical volumes o 70% of space for databases, mount point /opt/7signal/databases (LV3) o 30% of space for database backups, mount point /opt/7signal/backups (LV4) Sapphire installation o Sapphire components are installed to /opt/7signal (on LV1) o Sapphire databases are installed to /opt/7signal/d
4 Installing 7signal Sapphire Reboot the Eye unit to make the changes effective: # reboot 4.3 Setting up Soft Eyes 4.3.1 Prerequisites CentOS/Red Hat Enterprise Linux 6 installation media Internet connection (connect to Ethernet port of the laptop) Soft Eye installer (7signal-eye-x.y-x86.bin) Certificate package file Soft Eye license (*.elic file) o License is bound to MAC address of the WLAN card 4.3.
4 Installing 7signal Sapphire 10 If the laptop has multiple WLAN cards (e.g. an internal and an USB card), rules related to network interface naming need to be checked in order to get correct names for network interfaces. Network interfaces used by Sapphire Eye Software must be “wlan0” and “wlan1”. Open file /etc/udev/rules.d/70-persistent-net.
4 Installing 7signal Sapphire Reboot the laptop 4.3.3 Install latest mainline kernel In order to get latest WLAN drivers into use, the Linux kernel must be upgraded to latest mainline kernel. Step 1: Install ELRepo repository configuration Open a console and install ELRepo repository configuration: # rpm -Uvh http://elrepo.org/elrepo-release-6-5.el6.elrepo.noarch.
4 Installing 7signal Sapphire - Use e.g. 'eth0' if Sapphire Carat will connect to Eye remotely - Use 'lo' if Sapphire Carat will connect to Eye locally Interface name: [eth0]: lo Confirm installation Install 7signal Sapphire Eye to directory /opt/7signal/Eye, management network interface lo [Y/n]? y 4.3.
4 Installing 7signal Sapphire Restart Eye software: # 7config run restart Same problem can occur also on Ethernet interface. In that case, set the interface name back to “eth0” 4.4 Setting up Micro Eyes 4.4.1 Set IP configuration Login to Micro Eye as root by using SSH client. Default IP address is 192.168.0.1 and password is “7signal”: # ssh root@192.168.0.
4 Installing 7signal Sapphire The average signal level for the managed WLAN access points are between -65dBm and 30dBm. The distance from access point should be > 10ft/3m. NOTE: Eyes must not be located too close (> 3ft/1m) to any metal objects and places surrounded by concrete walls. The best installation location is easily verified with: Site Miner: The Site Miner kit includes a Carat laptop and an Eye unit (with battery). Site Survey signal level results 4.5.
4 Installing 7signal Sapphire 15 On top of Eye unit there are three slots for screws. Insert screws (Pan Head Stainless Screw, DIN 7985 M5x12) on top of the Eye unit. The head of the screw is supposed to have few millimeters of space between the inserts on the unit top. Afix the ceiling mounting plate to the ceiling (pictured right below). Mount the Eye unit on the ceiling mounting plate by inserting the screw tops into the plate holes. Make sure that the marking ‘CABLE’ is pointed towards connectors.
4 Installing 7signal Sapphire 16 There are three elliptical holes in the wall-mount mechanics. Mount the Eye unit by pushing the screws on top of the unit through the wall-mount mechanics. From the top-side of the mechanics use the nuts to attach the unit to the mechanics. 4.5.4 Pole Mount (optional) In pole install, the wall-mount is attached to any pole by using mechanics. Screw the provided back plate to the wall-mount mechanics. Push the U bar through the back plate.
4 Installing 7signal Sapphire The Site Survey results are valuable for Eye location estimation. The Eye location is good if the Site Survey heat map shows >-80dBm signal level from all the access points. The Site Survey results are valuable for Eye location selection Verify the signal levels also from the far end access points 7signal Solutions Inc., 526 S. Main Street, Akron, Ohio 44311, USA, 855-763-9526, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 5.0 4.5.
4 Installing 7signal Sapphire 18 7signal Sapphire Deployment Guide Release 5.0 The external antenna is useful in the environment where shafts or thick walls are attenuating radio too much. 4.6 Installing 7signal Sapphire software The 7signal Sapphire software can be found from 7signal Sapphire Installation CD. Root privileges are needed for installation of Sapphire components, except for Carat GUI. 4.6.
4 Installing 7signal Sapphire # ./7signal-Carat-x.x-x.x-full-x64-installer.bin Step 2: Define the database essential parameters: Alternative 1: Carat DBMS is not installed yet As the DBMS will be running in the same host, it is recommended to use the defaults. Checking md5sum .. OK … Extracting installer, please wait ... Verifying installer, please wait ... Checksum : da5730017b795b61bd8d9c55d7c76f78 Calculated : da5730017b795b61bd8d9c55d7c76f78 Unpacking data files ... Launching installer.
4 Installing 7signal Sapphire 20 The installer asks for the maximum memory that Carat server is allowed to use. Typical amount of memory is about 30-50% of available RAM in megabytes: Please enter max. amount of memory that the Carat server can use (MB): <512-8192> IMPORTANT: Notice that maximum amount of memory that can be configured in 32 bit systems is 2048 Step 5: Install certificate package (and passwords): The certificate packages and related password are in separate delivery medium.
4 Installing 7signal Sapphire 21 Step 6: The license file location: The license file is created for each customer individually. It is in the same delivery medium with the certificate packages. The installer asks for location of the license file. Enter path and file name of the license file and press enter: Please enter location and name of Carat license file (//.lic): It is also possible to not install the license file at this point.
4 Installing 7signal Sapphire 22 Prerequisities The operating system installation may not have all the necessary components for DBMS installation. Please check the following items: IP address of the server must be resolvable to DNS name. This can be achieved by following procedures: o Server has been added to DNS o Hosts file contain the DNS name.
4 Installing 7signal Sapphire 23 2 The question above is asked if there is a 7signal Carat installation on the host . DBMS directory : /opt/7signal/dbms DB2 installation package location : .installer/v10.5fp1_linux...tar.gz Target directory : /opt/ibm/db2 untarring DB2... Creating DB user..
4 Installing 7signal Sapphire 24 The execution completed successfully. For more information see the DB2 installation log at "/tmp/db2setup.log". IBM DB2 installed. Creating uninstaller... Creating DB schema generator... Creating directory /opt/7signal/dbms/vx.x-x.x Installing 7db tool.. Installing 7signal DB backup & restore tool.. Installing 7signal DB2 library.. Installing 7signal DB2 utilities.. SQL1063N DB2START processing was successful.
4 Installing 7signal Sapphire 25 Copy 7signal-Analyzer-installer from the delivery medium to e.g. /home directory. NOTE! Do not use /tmp directory. Step 1: Change to the directory where installer was copied and install Analyzer server 32 bit systems: Issue command: # ./7signal-Analyzer-x.x-x.x-i686-installer.bin 64 bit systems: Issue command: # ./7signal-Analyzer-x.x-x.x-x64-installer.
4 Installing 7signal Sapphire 26 Step 5: Install certificate package (and passwords): The certificate packages and related password are in separate delivery medium. Alternative 1: Install certificates and passwords from separate packages Typically, certificate packages and password packages are delivered separately. Press enter when the installer asks location of 7signal-all.tar.gz certificate package: Please enter location of archive file (-7signal-all.tar.
4 Installing 7signal Sapphire 27 Updating files according to configuration ... Installing Java runtime environment... Extracting JRE... Installing JRE... JRE install directory is jre1.6.0_17 JRE already installed, checking if it is up to date Installed version: 1.6.0_17-b04 New version : 1.6.0_17-b04 JRE does not need to be updated. JRE installed to /opt/7signal/jre Copying init script ... Installing init script ... Installing 7analyzer tool ... Creating uninstaller ... Checking Carat user ....
4 Installing 7signal Sapphire 28 Enter port number for the server [80]: Checking that TCP port 80 is not in use.. Port 80 free. Number of simultaneous clients reflects to the number of Eyes running tests against this Sonar installation: Enter number of maximum simultaneous clients (1..50) [10]: VoIP tests require individual UDP port for each simultaneously running VoIP test.
4 Installing 7signal Sapphire 29 32 bit systems: Issue command: # ./7signal-Carat-Client-x.x-x.x-i686-installer.bin 64 bit systems: Issue command: # ./7signal-Carat-Client-x.x-x.x-x64-installer.bin The installer starts: Checking md5sum .. OK … Extracting installer, please wait ... Verifying installer, please wait ... … Unpacking data files ... Launching installer.
4 Installing 7signal Sapphire 30 The installer extracts and verifies required certificates from the certificate package: Validating archive.. Archive valid. Next, the installer asks for location of the password package 7signal-pwds.tar.gz. Enter the name of the directory in which the password package resides: Please enter location of certificate archive file (-7signal-pwds.tar.gz): Found file //-7signal-pwds.tar.gz.
4 Installing 7signal Sapphire Step 2: Accept the License Agreement: The distribution medium contains 7signal Sapphire Customer Terms document in the Documents folder. 7signal Solutions Inc., 526 S. Main Street, Akron, Ohio 44311, USA, 855-763-9526, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 5.
4 Installing 7signal Sapphire Step 4: Select your 7signal.truststore file and type your truststore password: The PKI encryption infrastructure requires Carat GUI to provide a certificate. The certificate is stored in a truststore file. The truststore file and the password are delivered within the product package. 7signal Solutions Inc., 526 S. Main Street, Akron, Ohio 44311, USA, 855-763-9526, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 5.
4 Installing 7signal Sapphire Step 6: Finish the installation: Finish the installation. An icon for launching the Carat GUI client should be available on the desktop. 7signal Solutions Inc., 526 S. Main Street, Akron, Ohio 44311, USA, 855-763-9526, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 5.
5 Upgrading Sapphire 5.1 Copy the latest Sapphire release to the hard disk (Linux) Step 1: Create new directory to the Carat server: # mkdir /root/SapphireXXYY Step 2: Change to the installer directory: # cd /root/SapphireXXYY Step 3: Copy the Sapphire Carat CD (X.X-Y.Y) to the install directory: # cp –r //* /root/SapphireXXYY/ IMPORTANT: When upgrading from versions prior to 5.0, certificate package file needs to be available on file system of the Carat server host. 5.
5 Upgrading Sapphire Attempting to shutdown the Apache Tomcat server... finished. Killing possible Analyzer processes.. no processes to kill 7signal Analyzer server shutdown complete 7signal Solutions Inc., 526 S. Main Street, Akron, Ohio 44311, USA, 855-763-9526, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 5.0 in /opt/7signal/Analyzer/shutdown_analyzer_server.
5 Upgrading Sapphire 36 Step 1: Change to the Carat server installer directory: # cd /root/SapphireXXYY/Carat_Server/linux Step 2: Execute Carat server installer: It is preferable to use “full” installer, as it contains in-bundled Eye software packages that make Eye software updates more easier. 32 bit systems: Start the installer by issuing the command: # ./7signal-Carat-X.X-Y.Y-i686-full-installer.bin 64 bit systems: Start the installer by issuing the command: # ./7signal-Carat-X.X-Y.
5 Upgrading Sapphire 37 The following configuration was found: -------------------------------------Used JRE : /opt/7signal/jre DB host : localhost DB port number : 7722 DB username : db7sign DB password (MD5) : 98005a88379612249f9b656a6dfe8811 Copy keystore from : /opt/7signal/Carat/v4.1-0.1/7signal/conf/carat.keystore Copy GUI truststore from : /opt/7signal/Carat/v4.1-0.1/7signal/conf/7signal.keystore Copy license from : /opt/7signal/Carat/v4.1-0.1/7signal/conf/license.
5 Upgrading Sapphire Upgrade is ready after installer finishes. 5.4 DBMS upgrade (Linux) Step 1: Change to the Carat database installer directory: # cd /root/SapphireXXYY/Carat-output/Carat_DBMS/linux Step 2: Execute DBMS installer in upgrade mode: 32 bit systems: Issue command: # ./7signal-DBMS-X.X-Y.Y-i686-installer.bin upgrade 64 bit systems: Issue command: # ./7signal-DBMS-X.X-Y.Y-x64-installer.
5 Upgrading Sapphire Do you wish to backup databases before proceeding [Y/n] Enter directory to which the backed up databases are copied [/var/opt/7signal/dbms/backups]: Do you wish to start database upgrade now [Y/n] Creating directory /opt/7signal/dbms/v5.0-0.0 connect to mgmt7 Database Connection Information Database server = DB2/LINUX 10.5.1 SQL authorization ID = DB7SIGN Local database alias = MGMT7 … Creating uninstaller... Updating version information... Database upgrade done.
5 Upgrading Sapphire Copying Carat to /opt/7signal... Installing Java runtime environment... Extracting JRE... Installing JRE... JRE install directory is jre1.6.0_17 JRE already installed, checking if it is up to date Installed version: 1.6.0_17-b04 New version : 1.6.0_17-b04 JRE does not need to be updated. Updating files according to configuration... Restoring configuration files.. Creating uninstaller... Finished. The GUI upgrade is ready when the installer finishes. 7signal Solutions Inc., 526 S.
5 Upgrading Sapphire 41 Step 1: Change to the installer directory: # cd /root/SapphireXXYY/Analyzer/linux Step 2: Execute Analyzer server installer: 32 bit systems: Start the installer by issuing the command: # ./7signal-Analyzer-X.X-Y.Y-i686-installer.bin 64 bit systems: Start the installer by issuing the command: # ./7signal-Analyzer-X.X-Y.Y-x64-installer.bin The installer starts to upgrade the Analyzer installation.
5 Upgrading Sapphire 7signal Sapphire Analyzer install process finished.
5 Upgrading Sapphire Starting to upgrade. Stopping Sonar.. Waiting until Sonar has shut down ... Getting current configuration.. Checking that TCP port 80 is not in use.. Port 80 free. Sonar configuration: -------------------------------------------------Server name : Sonar Server port : 80 Max. clients : 10 MOS port pool start: 50000 MOS port pool size : 10 Log level : ERROR Is this configuration OK [Y/n] Copying Sonar to /opt/7signal... Configuring Sonar... Installing Java runtime environment...
5 Upgrading Sapphire Execute the windows installer Carat_GUI/win folder. The installer starts and Welcome dialog is shown: Click “Next” to proceed. 7signal Solutions Inc., 526 S. Main Street, Akron, Ohio 44311, USA, 855-763-9526, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 5.
5 Upgrading Sapphire Click “Next” to proceed. Step 4: Select the installation destination folder Browse the folder to which the Carat GUI is currently installed. Click “Next” to proceed. 7signal Solutions Inc., 526 S. Main Street, Akron, Ohio 44311, USA, 855-763-9526, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 5.
5 Upgrading Sapphire 46 Leave empty if Windows client has already been installed before Click “Install” button (the original 7signal.truststore file and truststore password will be selected automatically). 7signal Solutions Inc., 526 S. Main Street, Akron, Ohio 44311, USA, 855-763-9526, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 5.
5 Upgrading Sapphire Click “Finish” button after installation is complete: 7signal Solutions Inc., 526 S. Main Street, Akron, Ohio 44311, USA, 855-763-9526, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 5.
5 Upgrading Sapphire 48 After all components have been upgraded, start the Carat and Analyzer servers.
5 Upgrading Sapphire Select the desired installer, select “Open” - Eye software versions available is Carat are populated on the list: - Import installers for all needed platforms (Soft and Micro Eye SWs, if necessary) - Close the “Eye SW repository management” view. Step 3: Upgrade Eye software to Eye units: 7signal Solutions Inc., 526 S. Main Street, Akron, Ohio 44311, USA, 855-763-9526, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 5.
5 Upgrading Sapphire Open the “Manage | Eye Software Management | Eye software update” view - If a software update is available for some Eyes, the software version and the name of the Eye unit appear on a popup-window: - To update software version to Eye, select “OK” Software is uploaded and installed to Eye units 7signal Solutions Inc., 526 S. Main Street, Akron, Ohio 44311, USA, 855-763-9526, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 5.0 Login as configurator user.
5 Upgrading Sapphire After the installation is complete, close the “Eye software update view” 5.10.2 Eye upgrade (command line) Step 1: Change to the Eye installer directory: # cd /root/SapphireXXYY/Carat_CD/Eye Step 2: Copy the SW to Eye unit: 802.11a/b/g unit: # scp 7signal-eye-v0X.YY-APU2–installer.bin root@:/nand 802.11a/b/g/n unit: # scp 7signal-eye-v0X.YY-APU3–installer.bin root@:/nand Soft Eye: # scp 7signal-eye-v0X.YY-x86–installer.
5 Upgrading Sapphire Step 5: Restart: 802.11a/b/g unit and 802.11a/b/g/n units: [root@Eye]# reboot Soft Eye: [root@Eye]# service 7signalEye restart Micro Eye: [root@Eye]# systemctl restart 7signalEye.service 5.11 Start Automated Testing Automated testing is in stopped state after the Sapphire has been upgraded. Step 1: Start Carat GUI: Step 2: Start Automated Testing: Select “Tools | Start Automated Testing”. 7signal Solutions Inc., 526 S.
6 Uninstalling Sapphire 53 6.1 Uninstall Analyzer server (Linux 32 bit and 64 bit) Step 1: Stop Analyzer server: Login to Carat host and stop the Analyzer server by issuing the command: # 7analyzer stop Step 2: Uninstall Analyzer server: Change to Analyzer installation directory: # cd Uninstall the Analyzer server by issuing the command: # ./analyzer_server_uninstall.sh The uninstaller script starts.
6 Uninstalling Sapphire 6.3 Uninstall DBMS (Linux 32 and 64 bit) The Carat and Analyzer servers must be uninstalled before DBMS can be uninstalled. See chapters 6.1 and 6.2. Login to Carat host and change to DBMS installation directory. It is the parent directory of former Carat 3 installation : # cd / Uninstall the DBMS by issuing the command: # ./uninstall-dbms.sh The uninstaller script starts.
6 Uninstalling Sapphire Task #2 start Description: Configuring DB2 instances Estimated time 300 second(s) Task #2 end The execution completed successfully. For more information see the DB2 installation log at "/tmp/db2idrop.log.15436". Required: Review the following log file also for warnings or errors: "/tmp/db2idrop_local.log.*" DBI1070I Program db2idrop completed successfully. Dropping DAS... DBI1070I Program dasdrop completed successfully. Running DB2 uninstaller...
6 Uninstalling Sapphire 7signal Sapphire Carat client will be removed. Are you sure [y/N]? y The uninstaller script starts to uninstall the Carat server: Removing files... Done. The uninstallation is finished when the script is ready. 6.5 Uninstall Carat GUI (Windows) Open Start Menu, browse to “7signal Sapphire Carat Client” submenu. Choose “Uninstall”: The uninstaller starts. Confirm uninstallation by clicking “Yes”: The uninstaller uninstalls the Carat GUI. Click “Ok” when uninstaller has finished.
6 Uninstalling Sapphire # ./sonar_uninstall.sh The uninstaller script starts. Confirm uninstall by entering “y”: 7signal Sonar will be removed. Are you sure [y/N]? y The uninstaller script starts to uninstall the Sonar server: Stopping 7signal Sonar.. Shutting down 7signal Sonar: 7signal Sonar is not running Removing init script.. Removing files... Done. The uninstallation is finished when the script is ready. 6.
7 Log Settings 58 All 7signal Sapphire elements have logging capability. 7.1 Carat server log The log file - server.log - is located in /opt/7signal/Carat/7signal. The directory contains older log files as well named server.log.* where by default the asterisk (*) is in range of 1..5. Altogether, there is one active log file named server.log and five files for circulating the files. The oldest logs do get overwritten.
7 Log Settings 59 # logread The logging can be directed to rotating log files instead of the ring buffer with 7config log – command. Name and location of the log files depends on Eye hardware version: Eye for 802.11a/b/g: /nand/syslog Eye for 802.
7 Log Settings and for continuous monitoring: # 7analyzer log -f 7.6 Sonar log (Linux) The log file - sonar-server.log - is located by default in //Sonar/log. 7signal Solutions Inc., 526 S. Main Street, Akron, Ohio 44311, USA, 855-763-9526, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 5.
8 Sapphire Process Management 61 8.1 Carat Carat is a service in Linux systems. However, the Carat process is supposed to be used by 7signal tool called 7carat: # 7carat o o o o start stop restart status 8.2 Analyzer Analyzer is a service in Linux systems. However, the Analyzer process is supposed to be used by 7signal tool called 7analyzer: # 7analyzer o o o o start stop restart status 8.
9 Troubleshoot 9.1 GUI client cannot connect to Carat server 1. 2. 3. 4. 5. Check that username and password are correct in the GUI Check that Carat server is running a. run 7carat status b. read the Carat server log c. if necessary, issue command 7carat start and go to b) Check that GUI port 47777 (default) is open in the firewall of the GUI host Check that RMI port 1099 (default) is open in the firewall of the GUI host Check that the Carat server RMI address is the right one in the GUI host a.
9 Troubleshoot 63 In order to find out the Eyes IP address, the MAC (Ethernet) address of the Eye must be known. 1. 2. Connect Eye to a Carat host directly with an Ethernet cable (i.e. Carat and Eye have to be in the same LAN). Use the 7edp utility (part of the Carat installation) to find out Eye’s IP address.
10 Command-line utility for Eye 64 10.1 Overview 7config is a command line utility for configuring various things in Eye unit. Commands are divided into thematic command groups so that each group contains one or more commands. A command may also have an argument and a value. Currently supported command groups are the following: ip: IP address management. keys: Key storage management. ap: Access point configuration storage management. conn: Connection management.
10 Command-line utility for Eye 65 Examples: Setting IP address of the management interface: # 7config ip set addr Setting network mask of the management interface: # 7config ip set mask Setting port of the management interface: # 7config ip set port Create backup from current IP configuration: # 7config ip backup create Restore IP configuration from a backup: # 7config ip backup restore Show current IP configuration: # 7config ip show 10.
10 Command-line utility for Eye Examples Install certificate from certificate package: # 7config conn cert install Install password from password package: # 7config conn pwd install 10.6 Run command group This command group contains commands for managing Eye software run-state.
10 Command-line utility for Eye 67 Restart the Eye software: # 7config run restart List installed Eye softwares: # 7config run list Reconfigure the Eye: # 7config run reconfig 10.7 Txp command group This command group contains commands for showing and setting of TX power related parameters. Currently supported operations are showing of TX power settings, setting default TX power, setting gain of an external antenna and setting cable loss of the external antenna.
10 Command-line utility for Eye 68 show which shows the current log configuration. set o level which sets the current level of logging o default which sets default level of logging at system start-up o target which sets logging target, ring buffer or NAND. Log level set by 'set level' command remains active until restart of the system. Default log level after installation is "ERROR". Log levels are the following: CRIT - Critical messages ERROR - Error messages WARN - Warning messages.
10 Command-line utility for Eye # 7config log set target persistent 7signal Solutions Inc., 526 S. Main Street, Akron, Ohio 44311, USA, 855-763-9526, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 5.
11 Command-line tool for database management 70 7db command is a tool for Carat database. It supports limited data retrieval, general management and database backup administrator for both immediate and automatic backups. It is recommended that database backups should be taken regularly.
11 Command-line tool for database management restore Recovery command workdir Configure working directory used in backup and restore operations.
11 Command-line tool for database management Show status of the tables in the SECUR7 database # 7db show tabstatus secur7 Show status of the CARAT7.ap_ftp_qos_test table in the MEAS7 database # 7db show tabstatus meas7 ap_ftp_qos_test Show configuration of the database # 7db show conf 11.4 Reinit command group Empty the database and resume initial state of the system.
11 Command-line tool for database management 7signal Solutions Inc., 526 S. Main Street, Akron, Ohio 44311, USA, 855-763-9526, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 5.
12 Command-line tool for carat server 74 7carat command is a tool for Carat server management. It supports process management, loglevels, license and database integrity.
13 Updating encryption certificates 75 Sometimes it is necessary to update encryption certificates used throughout Sapphire solution. Certificates can be updated from certificate package file in Linux, separate truststore file and truststore password are needed in Windows (see certificates CD/DVD). 13.1 Updating Carat server certificates Step 1: Login to Carat server host as root user Step 2: Use 7carat tool to update certificate # 7carat certificate set /path_to_package/mycerts-7signal-all.tar.
13 Updating encryption certificates 13.4 Updating Carat GUI certificates (Windows) Step 1: Locate 7signal Sapphire Carat Client installation directory Typically, it is found under “Program files (x86)” directory. Step 2: Copy new 7signal.truststore file Copy new 7signal.truststore file to 7signal\conf directory. Overwrite existing truststore file Step 3: Open run_client.bat file in editor and change truststore password Open run_client.
14 Removing old measurement data 77 Sometimes it is necessary to remove old measurement data by using command line tool. This is necessary, for example, if large amounts of data needs to be removed. Performance of command line tool is much better than GUI tool, as data removal approach is different (database export/load vs. SQL delete statements). Step 1: Resolve Eye ID ID of one Eye in the network topology is needed. Login to Analyzer and check topology tree on the left side of the browser window.
14 Removing old measurement data 78 7signal Solutions Inc., 526 S. Main Street, Akron, Ohio 44311, USA, 855-763-9526, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 5.0 Wait until command finishes. Notice that with large databases, data removal may take several ours, even days.
14 Removing old measurement data 79 Sapphire elements and their logical connections are in the picture below: • Eye – a WLAN probe with both WLAN interface (WLAN client and analysis functions) and Ethernet interface (management functions). • Sonar – Server software emulating various business services for testing purposes. Deployment method is two-fold as follows: 7signal Solution: the application is running in hosts chosen by the customer.
14 Removing old measurement data 80 Eye Sonar TCP testing client TCP/x MOS downlink server UDP/9999 MOS uplink client UDP/x Conn ID 1 Description Data content Test management and typical test connection Test control message and pseudo-data 1 TCP testing server TCP/80 MOS downlink client UDP/x MOS uplink server UDP/50000 UDP/50001 ... UDP/50009 3 2 Listening port(s) TCP/80 Remarks Traffic is properly encapsulated HTTP. Uses Eye WLAN interface.
14 Removing old measurement data 81 MOS test connections MOS test is a license-controlled feature and not used in every environment. MOS test requires additional ports to be used. MOS traffic is special-purpose traffic with identical fingerprint than any VoWLAN call would have. Sonar may serve numerous Eyes concurrently and therefore it is able to listen numerous UDP ports for incoming VoIP calls. Ports are listened in per-need basis.
14 Removing old measurement data 82 Carat GUI Conn ID 1 Carat server RMI client TCP/x TLS client TCP/x Description Data content RMI service RMI service protocol RMI server 1 TLS server 2 Listening port(s) TCP/1099 TCP/1099 TCP/47777 Remarks Discovery service for conn #2. Typically not changed.
14 Removing old measurement data 83 Carat server RMI client TCP/x 1 RMI server TCP/1099 TLS client TCP/x 2 TLS server TCP/47777 JDBC client TCP/x JDBC client TCP/x 3 4 JDBC server TCP/7722 DB2 database Conn ID 1 Description Data content RMI service. RMI service protocol Listening port(s) TCP/1099 Remarks Discovery service for conn #2. Typically not changed. 2 3 4 Analyzer web-app connecting as a client to a Carat server.
14 Removing old measurement data 84 Analyzer – internet browser connection Web browser Analyzer server 1 HTTP(S) client HTTP server redirect TCP/x 2 Conn ID 1 2 Description Data content Standard HTTP connection. Standard HTTP traffic for creating a HTTPS connection. Standard HTTPS connection for measurement requests and responses. TCP/80 Secure HTTP. Report and chart requests and responses. HTTPS server Listening port(s) TCP/80 Configurable during Analyzer deployment.
14 Removing old measurement data 85 NOTE: the volume estimates are estimates and vary based on the configuration. 14.1.1 Eye – Sonar From To Medium Eye Sonar WLAN Sonar Eye WLAN Traffic motivator Automated test engine and interactive testing by users. Volume estimate Major factor Low, each request is a few hundred bytes. The test profile that the Eye is running. Responses to client. Typically pseudodata that varies based on the test parameters.
14 Removing old measurement data 86 14.1.3 Carat server – Carat GUI From To Medium Carat GUI GUI Carat Ethernet Ethernet Traffic motivator User Responses to client. Volume estimate Very low. 300 kB/minute Major factor User activity, expected low. Spectrum Analysis and MOS test results may contain significant amount of data. There is no continuous interaction, all activities are initiated by the user. The amount of traffic depends completely on user-decisions.