7signal Sapphire Deployment Guide Release 3.1 7signal Ltd, Panuntie 6, FI-00620 HELSINKI, FINLAND, +358 40 777 7611, info@7signal.com, www.7signal.
Preface Document scope This document is aimed for people familiarizing themselves with 7signal Sapphire before deployment and to aid the actual deployment. After completion of this document 7signal Sapphire is installed, up and running ready for Wireless Quality Advancement. This document does not describe how the software operates, how to configure testing or how to read the measurements.
Preface ii Contact us at 7signal by mail: by email: by phone: report defects by email: any other request: Panuntie 6, FI-00620 Helsinki, Finland info@7signal.com +358 40 777 7611 (exchange) defect-report@7signal.com support@7signal.com 7signal Ltd, Panuntie 6, FI-00620 HELSINKI, FINLAND, +358 40 777 7611, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 3.
Table of Contents iii 1 7signal WQA solution ........................................................................................................1 1.1 Solution Overview ........................................................................................................... 2 1.2 Hardware......................................................................................................................... 2 1.2.1 802.11a/b/g .........................................................................
Table of Contents iv 5.2.1 Eye upgrade (GUI) .............................................................................................. 34 5.2.2 Eye upgrade (command line) ............................................................................. 36 5.3 Stop Sapphire solution (Linux) ...................................................................................... 37 5.4 Carat server upgrade (Linux) ......................................................................................... 38 5.
Table of Contents v 9.5 Eye IP address forgotten ............................................................................................... 57 10 Command-line utility for Eye ......................................................................................... 58 10.1 Overview ..................................................................................................................... 58 10.2 IP command group ................................................................................
1 7signal WQA solution 1 Welcome to learn about 7signal Sapphire that provides you a new way to continuously and automatically measure the health and quality of a wireless network from the user's perspective. A commonly used term here is wireless quality assurance, or WQA. Companies and their business processes are becoming increasingly dependent on the performance and service quality of their wireless networks.
1 7signal WQA solution 2 The 7signal Sapphire quality monitoring solution consists of Sapphire Eye monitoring stations, Sonar test servers, the Sapphire Carat management software, and Sapphire Loupe 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 two versions of the Eye: version supporting 802.11a/b/g standards and version supporting 802.
1 7signal WQA solution Electrical compass GPS receiver1 2 1.2.2 802.11a/b/g/n 802.11a/b/g/n version of Eye has the following main features (partly optional): 1 2 Mechanical parts injection molded polycarbonate plastic Linux computer, 1GB Flash memory WLAN radio module, 802.11 a/b/g/n support (2.4 GHz, 4.9 GHz-5.
2 Requirements 4 2.1 Carat server requirements Carat server controls Eye units and collects measurement results to the database. Carat server runs on Linux operating system and can be installed to dedicated server or virtual environment.
2 Requirements 5 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/77993 Eye management Carat server IP/32 Eye Ethernet IP/32 TCP/22 Eye (SSH) Carat GUI connections to Carat server Carat GUI IP/32 Carat server IP/32 TCP/477773 Carat GUI Carat GUI IP/32 Carat server IP/32 TCP/1099 Carat GUI RMI Loupe client (web browsers) connections to Carat server Browse
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 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 100% of space for OS installation, mount point “/” (LV1) Physical volume on RAID5 has two logical volumes o 80% of space for databases, mount point /opt/7signal/databases (LV2) o 20% of space for database log files, mount point /opt/7signal/databaselogs (LV3) Sapphire installation o Sapphire components are installed to /opt/7signal (on LV1) o Sapphire databases are installed to /opt/7signal/databases (on LV2) and database logs are directed to /opt/7signal/databas
4 Installing 7signal Sapphire 9 Mount Sapphire Eye in the most centralized location of the WLAN area. Eye can be installed on the ceiling, wall or mast.
4 Installing 7signal Sapphire 10 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. Mount the install plate on the ceiling (pictured right below). Mount the Eye unit in the roof 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 11 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.3.3 Pole Install (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 12 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 Ltd, Panuntie 6, FI-00620 HELSINKI, FINLAND, +358 40 777 7611, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 3.1 4.3.
4 Installing 7signal Sapphire 13 7signal Sapphire Deployment Guide Release 3.1 The external antenna is useful in the environment where shafts or thick walls are attenuating radio too much. 4.4 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.4.
4 Installing 7signal Sapphire 14 Alternative 2: Carat DBMS is already installed Since the DBMS is already installed, the Carat installer can determine DB configuration automatically. Defaults values should be applied. … Extracting installer, please wait ... Verifying installer, please wait ... … Unpacking data files ... Launching installer. … Checking previous installations...
4 Installing 7signal Sapphire 15 Next, the installer asks for location of the certificate package 7signal-certs.tar.gz. Enter the name of the directory in which the certificate package resides: Please enter location of certificate archive file (-7signalcerts.tar.gz): Found file //-7signal-certs.tar.gz. Do wish to use it [Y/n]? The installer extracts and verifies required certificates from the certificate package: Validating archive..
4 Installing 7signal Sapphire 16 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 license file at this point.
4 Installing 7signal Sapphire 17 Prerequisities The operating system installation may not have all the necessary components for DBMS installation.
4 Installing 7signal Sapphire 18 # ./7signal-DBMS-with-DB2-x.x-x.x-installer.bin The installer starts to install 7signal DBMS: … Extracting installer, please wait ... Launching installer. … Using installer. Checking host reachability.. OK. Trying to locate existing installation... Locating 7signal Sapphire Carat installation. Please wait ... Carat installation found at /opt/7signal/Carat.
4 Installing 7signal Sapphire 19 The database location defaults to the /home file system just like the database logs that are configured below. This default database location is not recommended, if the /home file system is not backed up or otherwise replicated, or does not have enough disk space. The logs and the actual database should always reside in separate file systems, preferably on RAIDed, separate physical devices.
4 Installing 7signal Sapphire 20 Copy 7signal-Loupe-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 Loupe server by issuing the command: # ./7signal-Loupe-x.x-x.x-installer.bin Step 2: The installation directory: Give the location in the file system to install the Loupe server: Extracting installer, please wait ... Launching installer. Checking previous installations ...
4 Installing 7signal Sapphire 21 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.gz): Next, the installer asks for location of the certificate package 7signal-certs.tar.gz.
4 Installing 7signal Sapphire Validating archive.. Archive valid. Extracting files.. Extracting passwords.. Step 6: Starting of Loupe server: It is possible to start the server immediately. The requirement is that the database is up and running at the Loupe start-up: Updating files according to configuration ... Finding JRE ... found at /opt/7signal/jre Copying init script ... Installing init script ... Installing 7loupe tool ... Creating uninstaller ... Loupe install process finished.
4 Installing 7signal Sapphire 23 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 24 Installing Sonar on Windows platform is possible. However, performance of the Sonar server might not be optimal on Windows platform, due to implementation of Windows TCP/IP stack. Note: Version number of Sonar used in these instructions may not be the one that is going to be installed. However, the instructions are applicable to all Sonar versions. Step 1: Execute Carat GUI installer: 7signal Ltd, Panuntie 6, FI-00620 HELSINKI, FINLAND, +358 40 777 7611, info@7signal.
4 Installing 7signal Sapphire Step 2: Accept the License Agreement: The distribution medium contains 7signal Sapphire Customer Terms document in the Documents folder. Step 3: Choose the components: This is informative step only: it is mandatory to select both JRE and the Sonar server itself. The client install should not be selected. 7signal Ltd, Panuntie 6, FI-00620 HELSINKI, FINLAND, +358 40 777 7611, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 3.
4 Installing 7signal Sapphire 26 7signal Sapphire Deployment Guide Release 3.1 Step 4: Choose the location for installation: 7signal Ltd, Panuntie 6, FI-00620 HELSINKI, FINLAND, +358 40 777 7611, info@7signal.com, www.7signal.
4 Installing 7signal Sapphire 27 Step 5: Server configuration: One should see the connectivity section above if one needs or wants to change the defaults for the communication and networking settings. 7signal Ltd, Panuntie 6, FI-00620 HELSINKI, FINLAND, +358 40 777 7611, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 3.
4 Installing 7signal Sapphire Step 6: Finish the installation: Finish the installation. An icon for launching the Sonar server should be available on the chosen start-folder. 4.4.6 Carat GUI install (Linux) Copy 7signal-Carat-GUI-installer from the delivery medium e.g. to /home directory. NOTE! Do not use /tmp directory. 7signal Ltd, Panuntie 6, FI-00620 HELSINKI, FINLAND, +358 40 777 7611, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 3.
4 Installing 7signal Sapphire 29 # ./7signal-Carat-Client-x.x-x.x.installer.bin The installer starts: … Extracting installer, please wait ... Launching installer. … Step 2: Choose destination folder: Enter the path for the desired destination folder: Enter location to which 7signal Sapphire Carat client will be installed [/opt/7signal]: Step 3: Install certificate package (and passwords): The certificate packages and related password are in separate delivery medium.
4 Installing 7signal Sapphire 30 Please enter location of certificate archive file (-7signalpwds.tar.gz): Found file //-7signal-pwds.tar.gz. Do wish to use it [Y/n]? The installer extracts and installs required certificates and passwords from the certificate and password packages: Validating archive.. Archive valid. Extracting files.. Extracting passwords..
4 Installing 7signal Sapphire A double-click on the icon launches the following panel: Step 2: Accept the License Agreement: The distribution medium contains 7signal Sapphire Customer Terms document in the Documents folder. 7signal Ltd, Panuntie 6, FI-00620 HELSINKI, FINLAND, +358 40 777 7611, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 3.
4 Installing 7signal Sapphire 32 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 Ltd, Panuntie 6, FI-00620 HELSINKI, FINLAND, +358 40 777 7611, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 3.
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 Ltd, Panuntie 6, FI-00620 HELSINKI, FINLAND, +358 40 777 7611, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 3.
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/ 5.2 Eye upgrade 5.2.1 Eye upgrade (GUI) NOTE: Eye SW can be upgraded also after the other elements with command line.
5 Upgrading Sapphire - Select the Eye and new software version in the Eye unit Select Activate and Execute … o The new Eye software will be activated and the Eye unit will be rebooted - Carat GUI confirms software activation: “Are you sure, you want to activate selected eye software to the selected eye(s).” Select OK - 7signal Ltd, Panuntie 6, FI-00620 HELSINKI, FINLAND, +358 40 777 7611, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 3.
5 Upgrading Sapphire 5.2.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.
5 Upgrading Sapphire [root@Eye]# ./7signal-eye-v0X.YY-APU2–installer.bin 802.11a/b/g/n unit: [root@Eye]# ./7signal-eye-v0X.YY-APU3–installer.bin Step 5: Reboot the Eye: [root@Eye]# reboot 5.3 Stop Sapphire solution (Linux) NOTE: All Sapphire components running on the Carat server must be stopped before upgrade.
5 Upgrading Sapphire 38 7signal Sapphire Deployment Guide Release 3.1 5.4 Carat server upgrade (Linux) Step 1: Change to the Carat server installer directory: # cd /root/SapphireXXYY/Carat_Server/linux Step 2: Execute Carat server installer: Start the installer by issuing the command: # ./7signal-Carat-X.X-Y.Y-installer.bin The installer starts and finds an existing installation: Extracting installer, please wait ... Launching installer. Checking previous installations...
5 Upgrading Sapphire When upgrading to the next major version, the installer asks for location of the new license file. Enter path and file name of the license file and press enter: Please enter location and name of Carat license file (//.lic): Installing license file... Installing 7carat tool... Modifying file permissions... Creating uninstaller... Saving configuration. Done. Upgrade is ready after installer finishes. 5.
5 Upgrading Sapphire 40 JRE location Java location : /opt/7signal/jre : /opt/7signal/jre/bin/java 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] Copying aggregation view template generator and templates to /home/db7sign/ Installing 7db tool.. Installing 7signal DB backup & restore tool.. Updating version information...
5 Upgrading Sapphire 41 Step 1: Change to the installer directory: # cd /root/SapphireXXYY/Loupe/linux Step 2: Execute Loupe server installer: Start the installer by issuing the command: # ./7signal-Loupe-X.X-Y.Y-installer.bin The installer starts to upgrade the Loupe installation. Confirm the upgrade and apply default values for questions asked by the installer: Extracting installer, please wait ... Launching installer. Checking previous installations ...
5 Upgrading Sapphire 42 To learn more about the 7loupe-command, simply type command '7loupe' without any parameters. The Loupe server upgrade is ready when the installer finishes. 5.8 Sonar upgrade (Linux) Step 1: Create install directory to the Sonar server: # mkdir /root/SapphireXXYY/ Step 3: Copy the Sapphire Sonar CD (X.X-Y.
5 Upgrading Sapphire The Sonar server upgrade is ready when the installer finishes. 5.9 Carat GUI upgrade (Windows) Step 1: Install the installation CD to the Windows host: Step 2: Execute Carat GUI installer: Execute the windows installer Carat_GUI/win folder: The installer starts and Welcome dialog is shown: Click “Next” to proceed. 7signal Ltd, Panuntie 6, FI-00620 HELSINKI, FINLAND, +358 40 777 7611, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 3.1 New version : 1.
5 Upgrading Sapphire Click “Next” to proceed. Step 4: Define the installation destination folder Browse the folder to which the Carat GUI is currently installed. Click “Next” to proceed. 7signal Ltd, Panuntie 6, FI-00620 HELSINKI, FINLAND, +358 40 777 7611, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 3.
5 Upgrading Sapphire 45 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 Ltd, Panuntie 6, FI-00620 HELSINKI, FINLAND, +358 40 777 7611, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 3.
5 Upgrading Sapphire Click “Finish” button after installation is complete: 7signal Ltd, Panuntie 6, FI-00620 HELSINKI, FINLAND, +358 40 777 7611, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 3.
5 Upgrading Sapphire 47 After all components have been upgraded, start the Carat and Loupe servers.
6 Uninstalling Sapphire 6.1 Uninstall Loupe server (Linux) Step 1: Stop Loupe server: Login to Carat host and stop the Loupe server by issuing the command: # 7Loupe stop Step 2: Uninstall Loupe server: Change to Loupe installation directory: # cd Uninstall the Loupe server by issuing the command: # ./loupe_server_uninstall.sh The uninstaller script starts. Confirm uninstall by entering “y”: 7signal Sapphire Loupe server will be removed (/opt/7signal/Loupe).
6 Uninstalling Sapphire 49 7signal Sapphire Carat, related user account and home directory will be removed. Are you sure [y/N]? y The uninstaller script starts to uninstall the Carat server: Stopping Shutting running Removing Removing Removing Done. 7signal Sapphire Carat.. down 7signal Sapphire Carat: 7signal Sapphire Carat is not init script.. files... user account and group... The uninstallation is finished when the script is ready. 6.
6 Uninstalling Sapphire Running DB2 uninstaller... Removing files... Removing service definitions.. DB2 uninstalled. Removing database users.. Removing product information.. Removing remaining directories .. Done. The uninstallation is finished when the script is ready. 6.4 Uninstall Carat GUI (Linux) Login to host and change to Carat GUI installation directory (directory ClientGUICarat on installation path): # cd / Uninstall the DBMS by issuing the command: # .
6 Uninstalling Sapphire 6.6 Uninstall Sonar (Linux) Step 1: Stop Sonar server: Login to Sonar host and stop the Sonar server by issuing the command: # service 7signalSonar stop Step 2: Uninstall Sonar server: Change to Sonar installation directory (e.g. /opt/7signal/Sonar): # cd / Uninstall Sonar by issuing the command: # ./sonar_uninstall.sh The uninstaller script starts. Confirm uninstall by entering “y”: 7signal Sonar will be removed.
7 Log Settings 52 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 53 NOTE: as this is Eye logging, all the commands are to be given in the prompt of the monitoring station, not in Carat or Sonar server. The Eye unit has an in-memory circular log that can be followed real-time with the following command: # logread -f Without any arguments the command shows of the whole log and returns immediately: # logread The logging can be directed to rotating log files instead of the ring buffer with 7config log – command.
7 Log Settings The log file - sonar-server.log - is located by default in //Sonar/log. 7signal Ltd, Panuntie 6, FI-00620 HELSINKI, FINLAND, +358 40 777 7611, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 3.1 7.
8 Sapphire Process Management 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 Loupe Loupe is a service in Linux systems. However, the Loupe process is supposed to be used by 7signal tool called 7loupe: # 7loupe o o o o start stop restart status 8.
9 Troubleshoot 56 9.1 GUI client cannot connect to Carat server 1. Check that username and password are correct in the GUI 2. 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) 3. Check that GUI port 47777 (default) is open in the firewall of the GUI host 4. Check that RMI port 1099 (default) is open in the firewall of the GUI host 5. Check that the Carat server RMI address is the right one in the GUI host a.
9 Troubleshoot 57 Loupe and Carat are both run in the Carat host machine. 1. 2. 3. 4. 5. Check that username and password are correct Check Loupe log for error messages a. Run command 7loupe log Check that loupe server is running a. Run command 7loupe status Check Carat log for error messages a. Run command 7carat log Check that carat server is running a. Run command 7carat status 9.5 Eye IP address forgotten In order to find out the Eyes IP address, the MAC (Ethernet) address of the Eye must be known.
10 Command-line utility for Eye 58 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 59 Set DHCP on/off VALUE = on|off 'show' command arguments: none 'backup' command arguments: create Create backup from existing IP configuration. restore Restore IP configuration from backup.
10 Command-line utility for Eye 60 7config conn [VALUE] 'cert' command arguments: set Set management connection encryption certificate file. VALUE = Certificate file name. File must reside in /nand/etc/certificates directory. show Show current encryption certificate file name. install Install certificate from certificate archive. VALUE = Archive name (-7signal-certs.tar.gz) 'pwd' command arguments: set Set encryption certificate password. install Install password from password archive.
10 Command-line utility for Eye 61 Query status of the Eye software: # 7config run status Start the Eye software: # 7config run start Stop the Eye software: # 7config run stop 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.
10 Command-line utility for Eye 62 # 7config txp show cable Set external antenna gain to 10 dBi: # 7config txp set ext 10 10.8 Log command group This command group contains commands for configuring log production of the Eye. Logs can be produced either to a ring buffer on RAM (this is the default, can be read by logread command), or to persistent storage on NAND flash. In 802.11a/b/g, the persistent log resides in folder /nand/ as files named syslog*, and in 802.
10 Command-line utility for Eye 'show' Show log configuration. 'set' command arguments: level Set log level. VALUE = CRIT | ERROR | WARN | INFO | DEBUG default Set default log level. This log level will be active when 7signal software starts. VALUE = CRIT | ERROR | WARN | INFO | DEBUG target Set logging target.
11 Command-line tool for database management 64 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 Creates instant and automatic database backups. NOTE: the backup policy should be well-planned. Please see the 7signal Sapphire User Guide for further discussion on backup and the options available. Backup commands: show Show automatic backup configuration remove Remove automatic backup configuration set Configure automatic backup o o daily weekly = Mon, Tue, Wed, etc.
11 Command-line tool for database management # 7db backup now /mnt/backups online Set working directory for backup and restore (highly recommended for larger databases) # 7db backup workdir set /opt/largefilesystem Restore a known-to-be-good system state # 7db backup restore 11.4 Show command group Shows the status and configuration of the database Show commands: tabstatus o all o conf Show the status of the tables. Show configuration of the database.
11 Command-line tool for database management Delete data from the database tables # 7db delete NOTE: use reinit to reset 7signal Sapphire, delete merely does what it says: it deletes table contents and does not guarantee that Sapphire is usable after the command. The user must know how to restore some sound and complete state of the system before issuing this command. 11.6 Reinit command group Empty the database and resume initial state of the system.
11 Command-line tool for database management 68 7signal Sapphire Deployment Guide Release 3.1 7signal Ltd, Panuntie 6, FI-00620 HELSINKI, FINLAND, +358 40 777 7611, info@7signal.com, www.7signal.
11 Command-line tool for database management 69 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.
11 Command-line tool for database management 70 7signal Sapphire Deployment Guide Release 3.
11 Command-line tool for database management 71 ESSID – test parameter to connect to a particular wireless network. WLAN encryption Network keys – pre-shared keys, certificates or similar - are stored in Eye file system by Carat application. To be observerd: the target wireless network may be configured to have MAC address preventions so the MAC address of WLAN interface of the Eye unit must be white-listed as a network client. Eye does not act as an access point of the wireless network.
11 Command-line tool for database management 72 7signal Sapphire Deployment Guide Release 3.1 Carat server – Carat GUI connection 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.
11 Command-line tool for database management 73 7signal Sapphire Deployment Guide Release 3.1 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 Loupe web-app connecting as a client to a Carat server. RMI calls TCP/47777 IBM DB2 database service for Loupe. JDBC traffic. Configurable during Carat GUI deployment TCP/7722 JDBC traffic.
11 Command-line tool for database management 74 7signal installers contain the installation medium for DB2 and the setup of DB2 is automated by 7signal DBMS installer. It is possible to change the defaults during installation time. Loupe – internet browser connection 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. Secure HTTP.
11 Command-line tool for database management 75 NOTE: the volume estimates are estimates and vary based on the configuration. 11.6.1 Eye – Sonar From To Medium Eye Sonar WLAN Sonar Eye WLAN Traffic motivator Automated test engine and interactive testing by users. Volume estimate Low, each request is a few hundred bytes. Responses to client. Typically pseudo-data that varies based on the test parameters. Eye acts as one WLAN end-user would do, one operation per minute.
11 Command-line tool for database management 76 Naturally the number of Eyes is directionally proportional the traffic load as each Eye connection are independent and concurrent. One single Eye typically executes a test in one minute in the average. However, there are tests that finish in 10 seconds (practical minimum) and few tests run few minutes. The communication protocol is both minimal and binary so the traffic from Carat to Eye is very economic.
11 Command-line tool for database management To Medium localhost localhost IP stack Traffic motivator Interoperable server processes. Volume estimate N/A Major factor The amount of Eyes in the network. Data is transferred in the core memory of the host. 7signal Ltd, Panuntie 6, FI-00620 HELSINKI, FINLAND, +358 40 777 7611, info@7signal.com, www.7signal.com 7signal Sapphire Deployment Guide Release 3.