Star Quality User Manual Ver.3.1 110316

StarQuality
User Manual
Software Version: 3.1 March 2011 P/N 215841
Document History
Document History
Changed Item
This is the first release General
Description
Version 1.0 Version 1.5 - Changed to reflect multiple server group sites. Added the following chapters:
Date
December 2008 February 2009
Network Discovery Setting Alarm Thresholds Reports

Introduction Installation Settings General Moved Counters for BreezeMAX from Introduction to Chapter 4 Viewing Measurements Added licence loading steps. Moved topics into relevant chapters. Added Solaris information Added 4Motion to the supported equipment Introduction Installation Data Structure - Hierarchy changed Added installation on Solaris Added upgrade for Windows installation Getting Started - Operations and Navigation in the Hierarchy Viewing Measurements Setting Alarm Thresholds NBI Reports Installation Measurements Hierarchy changed Activating SOAP server - new Added 4Motion set of discovery measurements; screenshorts changed Added 4Motion information New Chapter Chapter modified Added Linux as an optional OS Changed measurement definitions Added search feature for text including spaces Added Operations drop-down menu options General Installation Added BreezeACCESS VL support information Added Oracle patch installation Ver.2.5 December 2009 Ver.2.5 December 2009 February 2009 February 2009 February 2009 Ver. 2.0 June 2009
StarQuality
ii
User Manual
Document History
Changed Item
Introduction
Description
Added 4Motion ver.3.0 and BreezeMAX Extreme to the supported equipment list. Deleted Deployment Scenarios
Date
Ver.3.0 June 2010
Installation Getting Started
Revised structure
Ver.3.0 June 2010 Ver.3.0 June 2010
Operations and Navigation in the Hierarchy on page 132 - Removed the Link
option (for Alarms and Measurements) Added 4Motion and BreezeMAX Extreme information. Modified Prerequisites Generally revised
Network Discovery
Ver.3.0 June 2010
Reports Setting Alarm Thresholds
Added 4Motion and BreezeMAX Extreme information. Moved all syntax tables to Chapter 11 New Chapter, including information per device type Reformated View group options into tables and added description to the Display Deleted funcionality. Mouse hover now displays firmware changes Additional step for importing devices from AlvariSTAR Restructured section to include version management and separate sub-sections for each supported version New section New section
Ver.3.0 June 2010 Ver.3.0 June 2010 Ver.3.0 June 2010 Ver.3.0.15 September 2010 Ver.3.1.10 March 2011 Ver.3.1.10 March 2011 Ver.3.1.10 March 2011 Ver.3.1.10 March 2011 Ver.3.1.10 March 2011
Chapter 11,Device Specific Information Chapter 5, Viewing

Measurements
Chapter 5, Chart Settings Chapter 9, Adding a New

Server
4Motion Bulk Deletion for Equipment Managing Unsuccessful Measurements Managing Inactive Equipment Data Aggregation and Data Retention Settings Performance Collection Files Creating and Editing Threshold Templates
New section New section
Ver.3.1.10 March 2011 Ver.3.1.10 March 2011
New section Updates regarding threshold naming, SNMP traps, multiple variable, logical operators and trendline support
StarQuality
iii
User Manual
Document History
Changed Item Configuration Parameters StarQuality Upgrade on Solaris Installation Table 6-1 Creating a New Threshold Template Licences Table 2-1
Equipment Deletion Threshold Modification for Equipment Editing Charts for Equipment Creating and Editing Virtual Equipment Linked Equipment Customizing Display Preferences (Non-Administrator Users Only) Customizing Public (Admin only) and Private Menu Items Configuring Public and Private Charts
Description
Section completely rewritten Added information about Oracle database restart Updated Oracle Database installation procedures to include setting up the data files and redo logs. New table Replaced examples for specifying threshold attributes Added information on how to find out the database ID Added opened port for discovering StarQuality from AlvariSTAR Section removed Section removed Section removed Section removed Section removed Section removed
Date
Ver.3.1.10 March 2011 Ver.3.1.10 March 2011 Ver.3.1.10 March 2011 Ver.3.1.10 March 2011 Ver.3.1.10 March 2011 Ver.3.1.10 March 2011 Ver.3.1.10 March 2011 Ver.3.1.10 March 2011 Ver.3.1.10 March 2011 Ver.3.1.10 March 2011 Ver.3.1.10 March 2011 Ver.3.1.10 March 2011 Ver.3.1.10 March 2011
Section removed
Ver.3.1.10 March 2011
Section removed New section
Installing StarQuality on Linux Server with External Oracle Database on the Same Machine Installing StarQuality on Linux Server with External Oracle Database on the Same Machine
New section
Ver.3.1.10 March 2011
StarQuality
iv
User Manual
Legal Rights
Legal Rights
Copyright 2011 Alvarion Ltd. All rights reserved. The material contained herein is proprietary, privileged, and confidential and owned by Alvarion or its third party licensors. No disclosure thereof shall be made to third parties without the express written permission of Alvarion Ltd. Alvarion Ltd. reserves the right to alter the equipment specifications and descriptions in this publication without prior notice. No part of this publication shall be deemed to be part of any contract or warranty unless specifically incorporated by reference into such contract or warranty.
Trade Names
Alvarion, BreezeCOM, WALKair, WALKnet, BreezeNET, BreezeACCESS, BreezeLINK, BreezeMAX, BreezeLITE, BreezePHONE, 4Motion, and/or other products and/or services referenced here in are either registered trademarks, trademarks or service marks of Alvarion Ltd. All other names are or may be the trademarks of their respective owners. WiMAX Forum is a registered trademark of the WiMAX Forum. WiMAX, the WiMAX Forum logo, WiMAX Forum Certified, and the WiMAX Forum Certified logo are trademarks of the WiMAX Forum.
Statement of Conditions
The information contained in this manual is subject to change without notice. Alvarion Ltd. shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this manual or equipment supplied with it.
Warranties and Disclaimers

All Alvarion Ltd. (Alvarion) products purchased from Alvarion or through any of Alvarion's authorized resellers are subject to the following warranty and product liability terms and conditions.
Exclusive Warranty
(a) Alvarion warrants that the Product hardware it supplies and the tangible media on which any software is installed, under normal use and conditions, will be free from significant defects in materials and workmanship for a period of fourteen (14) months from the date of shipment of a given Product to Purchaser (the Warranty Period). Alvarion will, at its sole option and as Purchaser's sole remedy, repair or replace any defective Product in accordance with Alvarion' standard R&R procedure.
StarQuality
User Manual
Legal Rights
(b) With respect to the Firmware, Alvarion warrants the correct functionality according to the attached documentation, for a period of fourteen (14) month from invoice date (the Warranty Period). During the Warranty Period, Alvarion may release to its Customers firmware updates, which include additional performance improvements and/or bug fixes, upon availability (the Warranty). Bug fixes, temporary patches and/or workarounds may be supplied as Firmware updates. Additional hardware, if required, to install or use Firmware updates must be purchased by the Customer. Alvarion will be obligated to support solely the two (2) most recent Software major releases. ALVARION SHALL NOT BE LIABLE UNDER THIS WARRANTY IF ITS TESTING AND EXAMINATION DISCLOSE THAT THE ALLEGED DEFECT IN THE PRODUCT DOES NOT EXIST OR WAS CAUSED BY PURCHASER'S OR ANY THIRD PERSON'S MISUSE, NEGLIGENCE, IMPROPER INSTALLATION OR IMPROPER TESTING, UNAUTHORIZED ATTEMPTS TO REPAIR, OR ANY OTHER CAUSE BEYOND THE RANGE OF THE INTENDED USE, OR BY ACCIDENT, FIRE, LIGHTNING OR OTHER HAZARD.
Disclaimer
(a) The Software is sold on an AS IS basis. Alvarion, its affiliates or its licensors MAKE NO WARRANTIES, WHATSOEVER, WHETHER EXPRESS OR IMPLIED, WITH RESPECT TO THE SOFTWARE AND THE ACCOMPANYING DOCUMENTATION. ALVARION SPECIFICALLY DISCLAIMS ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT WITH RESPECT TO THE SOFTWARE. UNITS OF PRODUCT (INCLUDING ALL THE SOFTWARE) DELIVERED TO PURCHASER HEREUNDER ARE NOT FAULT-TOLERANT AND ARE NOT DESIGNED, MANUFACTURED OR INTENDED FOR USE OR RESALE IN APPLICATIONS WHERE THE FAILURE, MALFUNCTION OR INACCURACY OF PRODUCTS CARRIES A RISK OF DEATH OR BODILY INJURY OR SEVERE PHYSICAL OR ENVIRONMENTAL DAMAGE (HIGH RISK ACTIVITIES). HIGH RISK ACTIVITIES MAY INCLUDE, BUT ARE NOT LIMITED TO, USE AS PART OF ON-LINE CONTROL SYSTEMS IN HAZARDOUS ENVIRONMENTS REQUIRING FAIL-SAFE PERFORMANCE, SUCH AS IN THE OPERATION OF NUCLEAR FACILITIES, AIRCRAFT NAVIGATION OR COMMUNICATION SYSTEMS, AIR TRAFFIC CONTROL, LIFE SUPPORT MACHINES, WEAPONS SYSTEMS OR OTHER APPLICATIONS REPRESENTING A SIMILAR DEGREE OF POTENTIAL HAZARD. ALVARION SPECIFICALLY DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY OF FITNESS FOR HIGH RISK ACTIVITIES. (b) PURCHASER'S SOLE REMEDY FOR BREACH OF THE EXPRESS WARRANTIES ABOVE SHALL BE REPLACEMENT OR REFUND OF THE PURCHASE PRICE AS SPECIFIED ABOVE, AT ALVARION'S OPTION. TO THE
StarQuality
vi
User Manual
Legal Rights
FULLEST EXTENT ALLOWED BY LAW, THE WARRANTIES AND REMEDIES SET FORTH IN THIS AGREEMENT ARE EXCLUSIVE AND IN LIEU OF ALL OTHER WARRANTIES OR CONDITIONS, EXPRESS OR IMPLIED, EITHER IN FACT OR BY OPERATION OF LAW, STATUTORY OR OTHERWISE, INCLUDING BUT NOT LIMITED TO WARRANTIES, TERMS OR CONDITIONS OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, SATISFACTORY QUALITY, CORRESPONDENCE WITH DESCRIPTION, NON-INFRINGEMENT, AND ACCURACY OF INFORMATION GENERATED. ALL OF WHICH ARE EXPRESSLY DISCLAIMED. ALVARION' WARRANTIES HEREIN RUN ONLY TO PURCHASER, AND ARE NOT EXTENDED TO ANY THIRD PARTIES. ALVARION NEITHER ASSUMES NOR AUTHORIZES ANY OTHER PERSON TO ASSUME FOR IT ANY OTHER LIABILITY IN CONNECTION WITH THE SALE, INSTALLATION, MAINTENANCE OR USE OF ITS PRODUCTS.
Limitation of Liability
(a) ALVARION SHALL NOT BE LIABLE TO THE PURCHASER OR TO ANY THIRD PARTY, FOR ANY LOSS OF PROFITS, LOSS OF USE, INTERRUPTION OF BUSINESS OR FOR ANY INDIRECT, SPECIAL, INCIDENTAL, PUNITIVE OR CONSEQUENTIAL DAMAGES OF ANY KIND, WHETHER ARISING UNDER BREACH OF CONTRACT, TORT (INCLUDING NEGLIGENCE), STRICT LIABILITY OR OTHERWISE AND WHETHER BASED ON THIS AGREEMENT OR OTHERWISE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. (b) TO THE EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT SHALL THE LIABILITY FOR DAMAGES HEREUNDER OF ALVARION OR ITS EMPLOYEES OR AGENTS EXCEED THE PURCHASE PRICE PAID FOR THE PRODUCT BY PURCHASER, NOR SHALL THE AGGREGATE LIABILITY FOR DAMAGES TO ALL PARTIES REGARDING ANY PRODUCT EXCEED THE PURCHASE PRICE PAID FOR THAT PRODUCT BY THAT PARTY (EXCEPT IN THE CASE OF A BREACH OF A PARTY'S CONFIDENTIALITY OBLIGATIONS).
StarQuality
vii
User Manual
Important Notice
Important Notice
This manual is delivered subject to the following conditions and restrictions: This manual contains proprietary information belonging to Alvarion Ltd. Such information is supplied solely for the purpose of assisting properly authorized users of the respective Alvarion products. No part of its contents may be used for any other purpose, disclosed to any person or firm or reproduced by any means, electronic and mechanical, without the express prior written permission of Alvarion Ltd. The text and graphics are for the purpose of illustration and reference only. The specifications on which they are based are subject to change without notice. The software described in this document is furnished under a license. The software may be used or copied only in accordance with the terms of that license. Information in this document is subject to change without notice. Corporate and individual names and data used in examples herein are fictitious unless otherwise noted. Alvarion Ltd. reserves the right to alter the equipment specifications and descriptions in this publication without prior notice. No part of this publication shall be deemed to be part of any contract or warranty unless specifically incorporated by reference into such contract or warranty. The information contained herein is merely descriptive in nature, and does not constitute an offer for the sale of the product described herein. Any changes or modifications of equipment, including opening of the equipment not expressly approved by Alvarion Ltd. will void equipment warranty and any repair thereafter shall be charged for. It could also void the user's authority to operate the equipment.
StarQuality
viii
User Manual
About this Manual
About this Manual

The StarQuality User Manual comprises the following chapters: Chapter 1- Introduction - provides an overview of the StarQuality system and its functionality. Chapter 2 - Installation - describes how to install and uninstall the StarQuality application and use commands to start and stop it. Chapter 3 - Getting Started - describes the structure of the interface windows, logging in, general display options, searching, the menu system, operations and navigation, and editing of objects, Chapter 4 - Network Discovery - describes the creation of a WiMAX network and all the BTSs under it. In addition, it describes the creation of a utility network. Chapter 5- Viewing Measurements - describes browsing options, display options, viewing measurement data, searching measurements and saving items as a submenu. Chapter 6 - Setting Alarm Thresholds - describes how to create threshold templates and assigning them to equipments. Chapter 7 - Threshold Crossing Alarms - describes the alarms and how to navigate, view and filter them. It also explains how to download data to Excel files. Chapter 8 - Reports - Setting and viewing reports. Chapter 9 - General Setting Options - describes how to set the site and equipment configuration, thresholds, customizing, server configuration and management, audit trail and user administration. Chapter 10 - Northbound Interface (NBI) - describes the StarQuality Northbound Interface (NBI) functionality Chapter 11 - Device Specific Information - contains details about software compatibility, traffic and performance counters, codes for thresholds and default built-in reports Glossary - Explanation of commonly used terms
StarQuality
ix
User Manual
Contents
Contents
Chapter 1 - Introduction ........................................................................... 1
1.1 System Overview ........................................................................................................3 1.1.1 1.1.2 1.1.3 1.2 1.3 General................................................................................................................ 3 STAR Management Suite Overview.................................................................... 3 Supported Equipment.......................................................................................... 4
System Data Structure................................................................................................5 User Types and Their Settings ..................................................................................6
Chapter 2 - Installation............................................................................. 8
2.1 Introduction ...............................................................................................................10 2.1.1 2.1.2 2.1.3 2.2 Installation Types .............................................................................................. 10 General Prerequisites........................................................................................ 12 HW/SW Requirements and Disk Allocation....................................................... 12
Installing StarQuality on Windows Server with Internal Oracle Database ..........15 2.2.1 2.2.2 Pre-installation Tasks ........................................................................................ 15 Installing StarQuality.......................................................................................... 22
2.3
Installing StarQuality on Windows Server with External Oracle Database on the Same Machine32 2.3.1 2.3.2 Pre-installation Tasks ........................................................................................ 32 Installing StarQuality.......................................................................................... 40
2.4
Installing StarQuality on Windows Server with Oracle Database on a Separate Machine48 2.4.1 Pre-installation Tasks ........................................................................................ 48
StarQuality
User Manual
Contents
2.4.2 2.5
Installing StarQuality.......................................................................................... 56
Installing StarQuality on Solaris Server with Internal Oracle Database ..............64 2.5.1 2.5.2 Pre-installation Tasks ........................................................................................ 64 Installing StarQuality.......................................................................................... 65
2.6
Installing StarQuality on Solaris Server with External Oracle Database on the Same Machine72 2.6.1 2.6.2 Pre-installation Tasks ........................................................................................ 72 Installing StarQuality.......................................................................................... 74
2.7
Installing StarQuality on Solaris Server with Oracle Database on a Separate Machine81 2.7.1 2.7.2 Pre-installation Tasks ........................................................................................ 81 Installing StarQuality.......................................................................................... 83
2.8
Installing StarQuality on Linux Server with External Oracle Database on the Same Machine90 2.8.1 2.8.2 Pre-installation Tasks ........................................................................................ 90 Installing StarQuality.......................................................................................... 93
2.9
Installing StarQuality on Linux Server with Oracle Database on a Separate Machine101 2.9.1 2.9.2 Pre-installation Tasks ...................................................................................... 101 Installing StarQuality........................................................................................ 103
2.10 Running StarQuality ...............................................................................................111 2.10.1 Running StarQuality on Windows.................................................................... 111 2.10.2 Running StarQuality on Solaris ....................................................................... 113 2.10.3 Loading a StarQuality Licence......................................................................... 114 2.10.4 Configuration Parameters................................................................................ 115 2.10.5 Data Aggregation and Data Retention Settings............................................... 115 2.11 StarQuality Upgrade ...............................................................................................116
StarQuality
xi
User Manual
Contents
2.11.1 StarQuality Upgrade on Windows ................................................................... 116 2.11.2 StarQuality Upgrade on Solaris ....................................................................... 118 2.11.3 Configuration Parameters................................................................................ 118 2.12 Uninstalling StarQuality .........................................................................................120 2.12.1 Uninstalling StarQuality from Windows ........................................................... 120 2.12.2 Uninstalling StarQuality from Solaris ............................................................... 121
Chapter 3 - Getting Started .................................................................. 123

3.1 3.2 3.3 Login ........................................................................................................................125 The Structure of Interface Windows......................................................................127 The Menu System....................................................................................................128 3.3.1 3.3.2 3.3.3 3.3.4 3.4 3.5 Measurements................................................................................................. 128 Alarms ............................................................................................................. 129 Reports ............................................................................................................ 130 Settings ........................................................................................................... 131
Operations and Navigation in the Hierarchy ........................................................132 General Display Options ........................................................................................134 3.5.1 3.5.2 Scrolling or Hiding the Submenu Items ........................................................... 134 Using the Display Tabs.................................................................................... 134
3.6
Editing Objects........................................................................................................136
Chapter 4 - Network Discovery ............................................................ 137

4.1 4.2 Overview ..................................................................................................................139 Discovery of WiMAX Devices.................................................................................142 4.2.1 4.2.2 4.3 4.4 Activation/Deactivation of Data Collection....................................................... 144 Performance Collection Files........................................................................... 146
Discovery of Equipment under a Server-Health Site ...........................................148 Scheduled Configuration .......................................................................................160
StarQuality
xii
User Manual
Contents
Chapter 5 - Viewing Measurements ..................................................... 163

5.1 5.2 5.3 5.4 Introduction .............................................................................................................165 WiMAX Equipment Measurements ........................................................................167 Measurements Browsing Options .........................................................................168 Measurements Display Options.............................................................................169 5.4.1 5.4.2 5.4.3 5.5 Element Display Types.................................................................................... 169 Element Browsing Options .............................................................................. 170 Operations Drop-Down Menu Options ............................................................ 171
Viewing Measurement Data....................................................................................174 5.5.1 5.5.2 5.5.3 Setting Time Span ........................................................................................... 174 Chart Display Options...................................................................................... 174 Chart Settings.................................................................................................. 176
5.6
Searching Measurements.......................................................................................178 5.6.1 On Searching in General ................................................................................. 178
5.7 5.8
Saving Items as A Submenu ..................................................................................181 Setting Trendlines to Graphs.................................................................................182
Chapter 6 - Setting Alarm Thresholds.................................................. 185

6.1 6.2 Overview ..................................................................................................................187 Creating and Editing Threshold Templates..........................................................188 6.2.1 6.3 6.4 Creating a New Threshold Template............................................................... 188
Assigning Threshold Templates to Equipments..................................................194 Editing Thresholds..................................................................................................197 6.4.1 6.4.2 Editing an Existing Threshold Template .......................................................... 197 Editing a Template-based Threshold (Local Change) ..................................... 199
6.5
Generating the Expression Using Input Fields ....................................................200
StarQuality
xiii
User Manual
Contents
Chapter 7 - Threshold-Crossing Alarms Monitoring............................. 204

7.1 7.2 Overview ..................................................................................................................206 Navigating, Viewing and Filtering Alarms ............................................................208 7.2.1 7.2.2 7.2.3 7.3 Viewing Alarms by Time Span......................................................................... 208 Alarm View Options ......................................................................................... 208 Filtering Alarms................................................................................................ 212
Downloading Data to Excel Files...........................................................................213
Chapter 8 - Reports .............................................................................. 215

8.1 Overview ..................................................................................................................217 8.1.1 8.2 Built-in Reports ................................................................................................ 217
Report Configuration ..............................................................................................218 8.2.1 8.2.2 Regular Reports .............................................................................................. 218 On-Demand Reports ....................................................................................... 224
8.3
Viewing Reports ......................................................................................................229 8.3.1 8.3.2 Navigating Report Views ................................................................................. 229 Setting the Report Range and Display ............................................................ 229
8.4
Bulk Export Wizard - Exporting Data to XLS Files...............................................232
Chapter 9 - General Setting Options .................................................... 238

9.1 9.2 9.3 Overview ..................................................................................................................240 Search (Admin only) ...............................................................................................243 Site and Equipment Configuration ........................................................................244 9.3.1 9.3.2 9.3.3 9.4 Object Hierarchy Overview.............................................................................. 244 Site and Equipment Configuration................................................................... 245 Equipment Configuration ................................................................................. 252
Customization .........................................................................................................259
StarQuality
xiv
User Manual
Contents
9.4.1 9.5 9.6
Setting E-mail Addresses (Admin only) ........................................................... 259
Templates (admin only) ..........................................................................................261 Server Configuration and Management (Admin only) .........................................262 9.6.1 9.6.2 9.6.3 9.6.4 9.6.5 9.6.6 9.6.7 Overview ......................................................................................................... 262 Licences .......................................................................................................... 263 Device and Measurement Summary ............................................................... 266 Server Configuration........................................................................................ 266 Start/Stop/Status of Servers ............................................................................ 272 Viewing Server Events .................................................................................... 273 Collector Load ................................................................................................. 274
9.7 9.8
Audit Trail ................................................................................................................277 User Administration (Admin only).........................................................................280 9.8.1 9.8.2 9.8.3 Registering/Modifying Users............................................................................ 280 User Permissions (Rights)............................................................................... 281 High Availability Performance.......................................................................... 284
Chapter 10 - Northbound Interface (NBI)............................................. 285

10.1 Introduction .............................................................................................................287 10.2 e-mail Notifications of StarQuality Server Events ...............................................288 10.3 e-mail Notifications and Traps of Threshold Crossing Events...........................289 10.3.1 e-Mail Notifications .......................................................................................... 289 10.3.2 SNMP Trap Notifications ................................................................................. 289 10.4 SOAP Interface ........................................................................................................290
Chapter 11 - Device Specific Information............................................ 291

11.1 Introduction .............................................................................................................293 11.2 BreezeMAX FDD and TDD Equipment...................................................................294 11.2.1 Overview ......................................................................................................... 294
StarQuality
xv
User Manual
Contents
11.2.2 Network Discovery Prerequisites..................................................................... 294 11.2.3 Key Performance Indicators (KPIs) ................................................................. 295 11.2.4 Codes for Threshold Setting............................................................................ 299 11.2.5 Default Built-in Reports.................................................................................... 300 11.3 BreezeACCESS VL..................................................................................................301 11.3.1 Overview ......................................................................................................... 301 11.3.2 Network Discovery Prerequisites..................................................................... 301 11.3.3 Key Performance Indicators (KPIs) ................................................................. 301 11.3.4 Codes for Threshold Setting............................................................................ 305 11.3.5 Default Built-in Reports.................................................................................... 307 11.4 4Motion ....................................................................................................................308 11.4.1 4Motion Version Management......................................................................... 308 11.4.2 4Motion Ver.2.5 ............................................................................................... 311 11.4.3 4Motion Ver.3.0 ............................................................................................... 317 11.4.4 4Motion Ver.3.0M ............................................................................................ 330 11.4.5 Default Built-in Reports.................................................................................... 344 11.5 BreezeMAX Extreme ...............................................................................................345 11.5.1 Overview ......................................................................................................... 345 11.5.2 Network Discovery Prerequisites..................................................................... 345 11.5.3 Key Performance Indicators (KPIs) ................................................................. 345 11.5.4 Codes for Threshold Setting............................................................................ 349 11.5.5 Default Built-in Reports.................................................................................... 350
Glossary ............................................................................................... 351
StarQuality
xvi
User Manual
Tables
Tables
Table 2-1: Selecting Installation Types ....................................................................................... 11 Table 3: Requirements Based on Capacity................................................................................. 12 Table 2-1: Network Ports............................................................................................................ 15 Table 2-2: Network Ports............................................................................................................ 32 Table 2-3: Network Ports............................................................................................................ 49 Table 2-4: Network Ports............................................................................................................ 65 Table 2-5: Network Ports............................................................................................................ 73 Table 2-6: Network Ports............................................................................................................ 82 Table 2-7: Network Ports............................................................................................................. 92 Table 2-8: Network Ports.......................................................................................................... 102 Table 3-1: Setting the Tab Display Options............................................................................... 135 Table 3-2: Editing Objects ......................................................................................................... 136 Table 4-1: Scheduled Configuration.......................................................................................... 161 Table 5-1: Element Display Options.......................................................................................... 169 Table 5-2: Time Span Options .................................................................................................. 174 Table 5-3: Chart Display Options .............................................................................................. 175 Table 6-1: Threshold Name Examples...................................................................................... 190 Table 7-1: Using the Alarms List ............................................................................................... 207 Table 7-2: Time Span Options .................................................................................................. 208 Table 7-3: Alarms View Options................................................................................................ 209 Table 7-4: Filtering Types.......................................................................................................... 212 Table 8-1: Navigating Reports................................................................................................... 229 Table 9-1: Search Criteria ......................................................................................................... 256
StarQuality
xvii
User Manual
Tables
Table 9-2: Admin Registering Options ...................................................................................... 281 Table 11-1: BTS Configuration Requirements .......................................................................... 294 Table 11-2: FDD and TDD Traffic BS KPIs ............................................................................... 295 Table 11-3: FDD/TDD Performance Counters (File Collection) ............................................... 297 Table 11-4: FDD TFTP Measurements .................................................................................... 297 Table 11-5: Syntax for TDD/FDD AU Measurements .............................................................. 299 Table 11-6: Syntax for TDD/FDD SU Measurements ............................................................... 299 Table 11-7: BreezeACCESS VL Traffic Counters ..................................................................... 301 Table 11-8: BreezeACCESS VL Performance Counters .......................................................... 303 Table 11-9: Syntax for BreezeACCESS VL AU Measurements................................................ 305 Table 11-10: Syntax for BreezeACCESS VL SU Measurements.............................................. 306 Table 11-11: 4Motion KPIs........................................................................................................ 309 Table 11-12: Traffic Counters 4Motion Ver.2.5 ......................................................................... 312 Table 11-13: Common Measurements for 4Motion BTS........................................................... 314 Table 11-14: Performance Counters Per MS ........................................................................... 314 Table 11-15: Syntax for 4Motion BS Measurements................................................................. 314 Table 11-16: Syntax for 4Motion Common Measurements....................................................... 316 Table 11-17: Syntax for 4Motion SU Measurements ................................................................ 316 Table 11-18: Traffic Counters 4Motion Ver.3.0 ......................................................................... 318 Table 11-19: NPU Counters ...................................................................................................... 322 Table 11-20: MS Counters ........................................................................................................ 324 Table 11-21: 4Motion BS Threshold Codes .............................................................................. 325 Table 11-22: NPU Threshold Codes ......................................................................................... 329 Table 11-23: SU Threshold Codes............................................................................................ 329 Table 11-24: Traffic Counters 4Motion Ver.3.0M ...................................................................... 331 Table 11-25: NPU Counters ...................................................................................................... 335
StarQuality
xviii
User Manual
Tables
Table 11-26: MS Counters ........................................................................................................ 336 Table 11-27: 4Motion BS Threshold Codes .............................................................................. 337 Table 11-28: NPU Threshold Codes ......................................................................................... 342 Table 11-29: SU Threshold Codes............................................................................................ 343 Table 11-30: Traffic Counters - BreezeMAX Extreme............................................................... 345 Table 11-31: BTS KPIs ............................................................................................................. 347 Table 11-32: SU KPIs ............................................................................................................... 347 Table 11-33: BTS Codes........................................................................................................... 349 Table 11-34: SU Codes............................................................................................................. 349
StarQuality
xix
User Manual
Figures
Figures
Figure 2-1: Cygwin Net Release Setup Program window .......................................................... 16 Figure 2-2: Choose a Download Source Window ...................................................................... 17 Figure 2-3: Select Root Install Directory..................................................................................... 17 Figure 2-4: Select Local Package Directory ............................................................................... 18 Figure 2-5: Select Packages Window - All Default (Initial State)................................................ 18 Figure 2-6: Select Packages Window - All Install .................................................................... 19 Figure 2-7: Select Packages Window - Perl Version.................................................................. 20 Figure 2-8: Cygwin Installation Process ..................................................................................... 20 Figure 2-9: Cygwin Installation Completion................................................................................ 21 Figure 2-10: StarQuality Setup Wizard Window......................................................................... 23 Figure 2-11: Licence Agreement ................................................................................................ 23 Figure 2-12: Choose Components ............................................................................................. 24 Figure 2-13: StarQuality Installing .............................................................................................. 24 Figure 2-14: StarQuality Basic Installation Complete................................................................. 25 Figure 2-15: Oracle Database Install.......................................................................................... 25 Figure 2-16: Oracle Directory ..................................................................................................... 26 Figure 2-17: Installation Progress .............................................................................................. 27 Figure 2-18: StarQuality Windows Service Registration ............................................................ 27 Figure 2-19: Oracle Connection Parameters.............................................................................. 28 Figure 2-20: Oracle Connection - Tablespace Parameters........................................................ 29 Figure 2-21: Oracle Connection - User Parameters................................................................... 30 Figure 2-22: StarQuality Setup Wizard - Completing Installation ............................................... 30 Figure 2-23: Cygwin Net Release Setup Program window ........................................................ 34 Figure 2-24: Choose a Download Source Window .................................................................... 35 Figure 2-25: Select Root Install Directory................................................................................... 35 Figure 2-26: Select Local Package Directory ............................................................................. 36 Figure 2-27: Select Packages Window - All Default (Initial State).............................................. 36
StarQuality
xx
User Manual
Figures
Figure 2-28: Select Packages Window - All Install .................................................................. 37 Figure 2-29: Select Packages Window - Perl Version................................................................ 38 Figure 2-30: Cygwin Installation Process ................................................................................... 38 Figure 2-31: Cygwin Installation Completion.............................................................................. 39 Figure 2-32: StarQuality Setup Wizard Window......................................................................... 41 Figure 2-33: Licence Agreement ................................................................................................ 41 Figure 2-34: Choose Components ............................................................................................. 42 Figure 2-35: StarQuality Installing .............................................................................................. 42 Figure 2-36: StarQuality Basic Installation Complete................................................................. 43 Figure 2-37: StarQuality Windows Service Registration ............................................................ 43 Figure 2-38: Oracle Connection Parameters.............................................................................. 44 Figure 2-39: Oracle Connection - Tablespace Parameters........................................................ 45 Figure 2-40: Oracle Connection - User Parameters................................................................... 46 Figure 2-41: StarQuality Setup Wizard - Completing Installation ............................................... 46 Figure 2-42: Cygwin Net Release Setup Program window ........................................................ 51 Figure 2-43: Choose a Download Source Window .................................................................... 51 Figure 2-44: Select Root Install Directory................................................................................... 52 Figure 2-45: Select Local Package Directory ............................................................................. 52 Figure 2-46: Select Packages Window - All Default (Initial State).............................................. 53 Figure 2-47: Select Packages Window - All Install .................................................................. 53 Figure 2-48: Select Packages Window - Perl Version................................................................ 54 Figure 2-49: Cygwin Installation Process ................................................................................... 55 Figure 2-50: Cygwin Installation Completion.............................................................................. 55 Figure 2-51: StarQuality Setup Wizard Window......................................................................... 57 Figure 2-52: Licence Agreement ................................................................................................ 58 Figure 2-53: Choose Components ............................................................................................. 58 Figure 2-54: StarQuality Installing .............................................................................................. 59 Figure 2-55: StarQuality Basic Installation Complete................................................................. 59 Figure 2-56: StarQuality Windows Service Registration ............................................................ 60 Figure 2-57: Oracle Connection Parameters.............................................................................. 60
StarQuality
xxi
User Manual
Figures
Figure 2-58: Oracle Connection - Tablespace Parameters........................................................ 61 Figure 2-59: Oracle Connection - User Parameters................................................................... 62 Figure 2-60: StarQuality Setup Wizard - Completing Installation ............................................... 62 Figure 2-61: Installation on Solaris - Basic Checks.................................................................... 66 Figure 2-62: Installing Embedded Oracle Database .................................................................. 67 Figure 2-63: Installation on Solaris - Basic Checks.................................................................... 75 Figure 2-64: Installation on Solaris - Basic Checks.................................................................... 84 Figure 2-65: Server Status Window ......................................................................................... 112 Figure 2-66: StarQuality Schema Update Window................................................................... 117 Figure 2-67: Setup Message .................................................................................................... 117 Figure 2-68: Uninstalling the Oracle User ................................................................................ 120 Figure 2-69: Uninstalling StarQuality from Solaris ................................................................... 122 Figure 3-1: Flash Player Message Window.............................................................................. 125 Figure 3-2: The StarQuality User Interface .............................................................................. 126 Figure 3-3: Example of Menus, Submenu Panel and Browser (in Measurements) ................. 128 Figure 3-4: Example of Operations pull down menu ................................................................ 132 Figure 3-5: Hierarchy Path ....................................................................................................... 132 Figure 3-6: Scrolling and Hiding the Submenu......................................................................... 134 Figure 3-7: Navigation Tabs ..................................................................................................... 134 Figure 4-1: Creating a New Site - Server Group Selection ...................................................... 140 Figure 4-2: Creating New Equipments from Template - WiMAX FDD ..................................... 143 Figure 4-3: Adding Equipment from an Input File..................................................................... 144 Figure 4-4: Activating Data Collection ...................................................................................... 145 Figure 4-5: Data Collection Status ........................................................................................... 146 Figure 4-6: Creating New Equipment - AlvariSTAR ................................................................. 149 Figure 4-7: Data Collection Active............................................................................................ 150 Figure 4-8: Default Oracle Template ........................................................................................ 152 Figure 4-9: Network Discovery Results (Oracle) ...................................................................... 153 Figure 4-10: Activating Data Collection (Oracle) ...................................................................... 154 Figure 4-11: Data Collection Active (Oracle)............................................................................ 155
StarQuality
xxii
User Manual
Figures
Figure 4-12: Default Unix/Linux Template................................................................................ 156 Figure 4-13: Network Discovery Results (Unix/Linux))............................................................. 157 Figure 4-14: Activating Data Collection (UNIX) ........................................................................ 158 Figure 4-15: Data Collection Active (UNIX).............................................................................. 159 Figure 4-16: Setting Discovery to a Schedule .......................................................................... 160 Figure 4-17: Scheduled Configuration...................................................................................... 162 Figure 5-1: The Measurements Main Menu Item with the Browser and the Icon View ............ 165 Figure 5-2: Hierarchy of Sites................................................................................................... 166 Figure 5-3: Navigation between Measurements: Detailed View.............................................. 170 Figure 5-4: Measurements Operation drop-down Menu .......................................................... 171 Figure 5-5: Show History.......................................................................................................... 171 Figure 5-6: Show Links ............................................................................................................ 172 Figure 5-7: Logical BS History Window.................................................................................... 172 Figure 5-8: Measurements - Small Charts ............................................................................... 176 Figure 5-9: Display with Flash Options..................................................................................... 177 Figure 5-10: Advanced Search ................................................................................................ 179 Figure 5-11: Measurements Search Results............................................................................ 180 Figure 5-12: Setting Trendlines Window .................................................................................. 182 Figure 5-13: Examples of Trendline Settings ........................................................................... 184 Figure 6-1: Threshold Template Configuration - Template List................................................ 188 Figure 6-2: Threshold Template Configuration - New .............................................................. 189 Figure 6-3: Expression Containing Multiple Variables.............................................................. 193 Figure 6-4: Using Threshold Template..................................................................................... 194 Figure 6-5: Relevant Equipments............................................................................................. 195 Figure 6-6: Threshold Template Details ................................................................................... 196 Figure 6-7: Items to Assign The Threshold .............................................................................. 196 Figure 6-8: Threshold Template Configuration - Template List................................................ 197 Figure 6-9: Threshold Template Configuration - Editing .......................................................... 198 Figure 6-10: Message on Template-based Threshold Modification ......................................... 198 Figure 6-11: Message on Template-based Threshold Modification ......................................... 199
StarQuality
xxiii
User Manual
Figures
Figure 6-12: Threshold Configuration....................................................................................... 201 Figure 7-1: Alarms Summary at the Top Right Corner of the Window ..................................... 206 Figure 7-2: Table View of Alarms ............................................................................................. 206 Figure 7-3: Detailed Alarm Information .................................................................................... 207 Figure 7-4: Icon View of Alarms ............................................................................................... 210 Figure 7-5: List View of Alarms ................................................................................................ 210 Figure 7-6: Detailed View of Alarms......................................................................................... 211 Figure 7-7: The Equipment Level View of Alarms .................................................................... 211 Figure 7-8: Sample XLS of Alarm Table................................................................................... 213 Figure 7-9: Sample XLS File of Chart Data............................................................................. 214 Figure 8-1: Report Variables Window (Example) ..................................................................... 218 Figure 8-2: Adding a New Report Variable............................................................................... 219 Figure 8-3: Report View Configuration Window (example) ...................................................... 221 Figure 8-4: Creating a New Report View.................................................................................. 221 Figure 8-5: Configuration Page ................................................................................................ 222 Figure 8-6: Adding a New Variable .......................................................................................... 222 Figure 8-7: Creating a New Report View Using the Copy From Option ................................... 224 Figure 8-8: On-demand Reports - Types ................................................................................. 225 Figure 8-9: On-demand Reports - Search................................................................................ 225 Figure 8-10: On-demand Reports - Measurement Types ........................................................ 226 Figure 8-11: On-demand Reports - Measurement Types Settings .......................................... 227 Figure 8-12: On-demand Reports - Object Parameters ........................................................... 227 Figure 8-13: On-demand Reports - Save options .................................................................... 227 Figure 8-14: On-demand Reports - Show ................................................................................ 228 Figure 8-15: Calendar views (day, week, month and year) for selecting the time interval ....... 230 Figure 8-16: Bulk Export Wizard Window................................................................................. 232 Figure 8-17: Bulk Export Wizard - Filtering Devices................................................................. 233 Figure 8-18: Exported Entity Selection..................................................................................... 234 Figure 8-19: Export Message ................................................................................................... 234 Figure 8-20: File Download ...................................................................................................... 235
StarQuality
xxiv
User Manual
Figures
Figure 8-21: Sample xls File..................................................................................................... 235 Figure 8-22: SU Selection ........................................................................................................ 237 Figure 8-23: Export Message ................................................................................................... 237 Figure 9-1: Site and Equipment Configuration Window with Operations Drop-down Menu..... 247 Figure 9-2: Adding a New Site ................................................................................................. 248 Figure 9-3: Unsuccessful Measurements Search .................................................................... 249 Figure 9-4: Selecting Inactive Equipment................................................................................. 250 Figure 9-5: Inactive Equipment Deactivation Confirmation ...................................................... 250 Figure 9-6: Searching for Inactive Equipment .......................................................................... 251 Figure 9-7: Inactive Equipment Deletion Confirmation............................................................. 252 Figure 9-8: Equipment Discovery Message ............................................................................. 253 Figure 9-9: Equipment Modification Window............................................................................ 253 Figure 9-10: Viewing Equipment with Additional Equipment Parameters ................................ 255 Figure 9-11: Bulk Delete - Simple ............................................................................................ 256 Figure 9-12: Bulk Delete - Advanced ....................................................................................... 256 Figure 9-13: Item Selection ...................................................................................................... 258 Figure 9-14: E-mail Address Configuration .............................................................................. 259 Figure 9-15: Example of Separate Threshold Violation Notification......................................... 260 Figure 9-16: Example of Bulk Threshold Violation Notification ................................................ 261 Figure 9-17: Licence Configuration Screen.............................................................................. 264 Figure 9-18: Device and Measurement Summary.................................................................... 266 Figure 9-19: Server Configuration Window .............................................................................. 267 Figure 9-20: Editing Server Configuration ................................................................................ 269 Figure 9-21: Server Configuration - Adding New ..................................................................... 270 Figure 9-22: Adding a New AlvariSTAR -> StarQuality Module ............................................... 272 Figure 9-23: Server Status ....................................................................................................... 273 Figure 9-24: Server Events Window......................................................................................... 274 Figure 9-25: Collector Load...................................................................................................... 275 Figure 9-26: Collector Load Statistics ...................................................................................... 275 Figure 9-27: Missing Measurements at a Given Time.............................................................. 276
StarQuality
xxv
User Manual
Figures
Figure 9-28: Audit Trail Query .................................................................................................. 277 Figure 9-29: Audit Trail Entries................................................................................................. 279 Figure 9-30: Viewing the Audit Trail ......................................................................................... 279 Figure 9-31: Users List ............................................................................................................. 280 Figure 9-32: User Administration.............................................................................................. 280 Figure 9-33: User Selection...................................................................................................... 283 Figure 9-34: User Rights Modification ...................................................................................... 283
StarQuality
xxvi
User Manual
Chapter
Introduction
Introduction
In this chapter:
System Overview on page 3 System Data Structure on page 5 System Data Structure on page 5 User Types and Their Settings on page 6
StarQuality
User Manual
Introduction
System Overview
1.1
1.1.1
System Overview
General
Alvarions StarQuality is a carrier-class performance and traffic monitoring system designed for optimizing the WiMAX Network performance, identifying network problems, maximizing traffic capacity and optimizing resource allocation. StarQuality offers an end-to-end performance solution including collection, analyzing, storing and displaying of the performance data. The system provides a unified performance application for monitoring Alvarions WiMAX equipment as well as server health. StarQuality provides various sets of report types and lists through an intuitive and simple Web-GUI client. It also enables defining TCA (Threshold Crossing Alerts) mechanism: an alarm generation may be conditional to the occurrence of several rule violations. Alvarions StarQuality is an essential element for optimizing the WiMAX Network functionality, radio planning, ensuring service performance and problem identification.
1.1.2
STAR Management Suite Overview

Alvarions STAR Management Suite offers complete and comprehensive management solution for ensuring the successful deployment of WiMAX services. The Alvarion STAR Management Suite offers a set of carrier class management tools, each tool designed to fulfill a certain management purpose. The STAR Management Suite includes: AlvariSTAR - Carrier-class Management System for managing Alvarions WiMAX Base Stations. StarACS - An Automatic Configuration Server (ACS) for managing end-user Fixed and Nomadic devices (CPE) based on TR-69 protocol. StarACS is relevant only for WiMAX 16e Networks. StarQuality - Performance monitoring system for optimizing the WiMAX network. StarReport - Powerful report generator for generating network inventory reports.
StarQuality
User Manual
Introduction
Supported Equipment
1.1.3
1.1.3.1
Supported Equipment
WiMAX
BreezeMAX FDD ver.3.5/3.6 (FDD SNMP) - Micro and Macro BTS BreezeMAX FDD ver.3.7 (FDD TFTP) - Micro and Macro BTS BreezeMAX TDD ver.4.5 and later (TDD TFTP) - Macro BTS only 4Motion ver.2.5M, 3.0 and 3.0M BreezeACCESS VL ver.6 BreezeMAX Extreme ver.1.5
1.1.3.2
Server Health
AlvariSTAR ver4.0 and up Oracle database server UNIX OS
StarQuality
User Manual
Introduction
System Data Structure
1.2
System Data Structure

The basic entities comprising the StarQuality network are: Equipment - also referred to as the device:
BTS (Base Transceiver Station) and SU for WiMAX networks AlvariSTAR, Oracle database server and UNIX machine for Server Health.
Each piece of equipment belongs to a site. Basic sampled unit:
SU, Slot/BS (n times in each BTS) for WIMAX networks, BTS for common measurements AlvariSTAR, Oracle database server and UNIX machine for Server Health.
Site collection of equipments and/or sites. Each site can contain arbitrary many sites and equipment. Each site can reside below another site. Root a virtual site collection of sites only A bare System contains only ROOT.
StarQuality
User Manual
Introduction
User Types and Their Settings
1.3

In the StarQuality, different users can have different access rights to various objects. There is always an administrator user (admin) with the highest permission level. The individual user groups are: admin user: The user named admin possesses all the rights, but cannot configure preferences, and cannot create a private virtual hierarchy and charts. The default password is admin123 at installation. This user cannot be deleted from the system. Administrator: has the same rights as the admin user, except:
Cannot create, modify and delete administrator users Cannot create, modify and delete servers or server groups, cannot view the operating system level user password on some computers Cannot change and view the actual licences used Can set preferences, and create a private virtual hierarchy and charts
Restricted administrators: similar to the normal users they can only view those objects that they have received privileges for. However the restricted administrators can modify these objects:
Only those site, equipment, measurement, threshold, threshold type and exclusion window objects for which they have received privileges Can only modify a user if it was created by themselves Can only view an entry in the audit log if the change was made by themselves Can only modify a public virtual hierarchy object or a public chart if it was created by themselves Cannot modify templates (except the exclusion windows), reports, servers, events and maps
Normal users: cannot modify the base objects in the system, and can view only those objects that they have received privileges for. They can set
StarQuality
User Manual
Introduction
preferences, create private virtual hierarchies and charts, and can modify their own passwords Limited users: Similar to normal users, but they cannot change their passwords, cannot set preferences, and cannot create private virtual hierarchies and charts Any administrator has the right to modify normal users, while only the admin user can modify administrators. Restricted administrators cannot modify a user except if it was created by themselves. No user can delete the admin user. For further information, refer to the User Administration (Admin only) on page 280.
StarQuality
User Manual
Chapter
Installation
Installation
In this chapter:
Introduction on page 10 Installing StarQuality on Windows Server with Internal Oracle Database on page 15 Installing StarQuality on Windows Server with External Oracle Database on the Same Machine on page 32 Installing StarQuality on Windows Server with Oracle Database on a Separate Machine on page 48 Installing StarQuality on Solaris Server with Internal Oracle Database on page 64 Installing StarQuality on Solaris Server with External Oracle Database on the Same Machine on page 72 Installing StarQuality on Solaris Server with Oracle Database on a Separate Machine on page 81 Installing StarQuality on Linux Server with External Oracle Database on the Same Machine on page 90 Installing StarQuality on Linux Server with Oracle Database on a Separate Machine on page 101 Running StarQuality on page 111 StarQuality Upgrade on page 116 Uninstalling StarQuality on page 120
StarQuality
User Manual
Installation
Introduction
2.1
2.1.1
Introduction
Installation Types
StarQuality can be installed on systems with internal or external databases and on systems running Windows and UNIX-like operating systems. This chapter is divided into sections according to the type of operating system and type of database installation. The following are possible installation types, depending on configuration: Installing StarQuality on Windows
with internal Oracle Database with external Oracle Database on the same machine with Oracle Database on a separate machine
Installing StarQuality on Solaris
with internal Oracle Database with external Oracle Database on the same machine with Oracle Database on a separate machine
Installing StarQuality on Linux
with external Oracle Database on the same machine with Oracle Database on a separate machine
Before starting installation, refer to Table 2-1 below to determine which type of installation to use:
StarQuality
10
User Manual
Installation
Installation Types
Table 2-1: Selecting Installation Types Operating System System Architecture Oracle database server version Oracle client version (installed on StarQuality machine) Refer to
Windows 2008 Standard
Internal database
Oracle SW and patch supplied with StarQuality DVD No Oracle client required *Version supplied with StarQuality DVD (10203_vista_w2k8_ x86_production_db)
Installing StarQuality on Windows Server with Internal Oracle Database on page 15 Installing StarQuality on Windows Server with External Oracle Database on the Same Machine on page 32 Installing StarQuality on Windows Server with Oracle Database on a Separate Machine on page 48 Installing StarQuality on Solaris Server with Internal Oracle Database on page 64 Installing StarQuality on Solaris Server with External Oracle Database on the Same Machine on page 72 Installing StarQuality on Solaris Server with Oracle Database on a Separate Machine on page 81 Installing StarQuality on Linux Server with External Oracle Database on the Same Machine on page 90 Installing StarQuality on Linux Server with Oracle Database on a Separate Machine on page 101
External database on same machine
External database on a separate machine Solaris 10 x86 Internal database
10203_vista_w2k8_x 86_production_client
Oracle SW and patch supplied with StarQuality DVD No Oracle client required
External database on same machine External database on a separate machine RedHat 5 Linux x86_32 External database on same machine External database on a separate machine
*Version supplied with StarQuality DVD (10201_database_s olx86_64) *Version supplied with StarQuality DVD (10201_database_s olx86_64)
10201_client_solx86_ 64 or 10202_client_solx86 No Oracle client required
Any Oracle 10 client compatible with 32 bit Red Had 5
* The Oracle kit included in the DVD covers the Oracle license only if it is installed together with StarQuality (internal database installation). In case of installing an external DB, purchase licence separately.
StarQuality
11
User Manual
Installation
General Prerequisites
2.1.2
General Prerequisites
The following are general prerequisites for all installation types: The computer on which the server is installed must comply with hardware and software requirements as detailed in the Release Notes. The computer on which the StarQuality Server and/or Oracle database are installed must be dedicated to running these applications. The Operating System must be freshly installed. The computers should have latest Operating System updates. The StarQuality application requires a minimum of 20 GB free disk space. Valid StarQuality license (required for initial activation after installation)
2.1.3
HW/SW Requirements and Disk Allocation

Table 3: Requirements Based on Capacity
Maximum Capacity 50 BTSs 1000 CPEs
Operating Systems Windows 2003 (64Bit)

customer upgraded
HW Requirementsfor Each Server 1 x Intel Core i7-950 at

3.06 GHz or higher
Disk Allocation 1 x 150 GB: OS +

StarQuality + Oracle
Windows 2008 (64Bit) 5 concurrent clients

Standard Edition English
8 GB RAM 3 (4) x HDD SAS 150

GB, 15000RPM
1 x 150 GB:
StarQuality Oracle Tablespace
RedHat 5 Linux
x86_32 (Enterprise English) - requires PAE kernel package for more than 4 GB RAM support.
1 x 150 GB: Oracle

Redo Log + Undo Tablespace
StarQuality
12
User Manual
Installation
Table 3: Requirements Based on Capacity Maximum Capacity 200 BTSs 10,000 CPEs 20 concurrent clients Operating Systems Windows 2008 (64Bit)
HW Requirementsfor Each Server 1 x Intel XEON E5620

(2.4 GHz)

12 GB RAM RedHat 5 Linux

x86_32 (Enterprise English) - requires PAE kernel package for more than 4 GB RAM support.
2 x 300 GB (RAID0):
4 x HDD SAS 300 GB,

15000 RPM For Solaris x86, the network card and RAID controller must be listed in their respective developer approved lists.
1 x 300 GB: Oracle

Redo Log + Undo Tablespace
SolarisX86 10 64bit
English
350 BTSs 50,000 CPEs 20 concurrent clients
Windows 2008 (64Bit)

1 x Intel XEON E5620

(2.4GHz)
1 x 300 GB: OS +
16 GB RAM SolarisX86 10 64bit

English
2 x 300 GB (RAID0):
4 x HDD SAS 300 GB,

15000 RPM For Solaris x86, the network card and RAID controller must be listed in their respective developer approved lists.
1 x 300: Oracle Redo

Log + Undo Tablespace
1000 BTSs 100,000 CPEs
SolarisX86 10 64bit English
1 x Intel XEON E5630

(2.53GHz)
1 x 500 GB: OS +
24 GB RAM 20 concurrent clients 6 x HDD SAS 500 GB,

15000 RPM The network card and RAID controller must be listed in their respective Solaris developer approved lists.
4 x 500 GB (RAID0):
1 x 500 GB: Oracle

Redo Log Assumes 15 min cycles data retention for 1 month and 1 hour averages data retention for 11 months.
StarQuality
13
User Manual
Installation
Table 3: Requirements Based on Capacity Maximum Capacity 1300 BTSs 130,000 CPEs 32 GB RAM 20 concurrent clients 7 x HDD SAS 500 GB,
15000 RPM The network card and RAID controller must be listed in their respective Solaris developer approved lists.
Operating Systems
SolarisX86 10 64bit English
HW Requirementsfor Each Server 2 x Intel XEON E5630

(2.4GHz)

5 x 500 GB (RAID0):
1 x 500 GB: Oracle

Redo Log Assumes 15 min cycles data retention for 1 month and 1 hour averages data retention for 11 months.
StarQuality
14
User Manual
Installation
Installing StarQuality on Windows Server with Internal Oracle Database
2.2
Installing StarQuality on Windows Server with Internal Oracle Database

Before beginning the StarQuality installation refer to Table 2-1 to ensure that this is the correct installation for your system, and perform all the tasks outlined in Section 2.2.1 below. This installation type involves the installation of the following components: cygwin StarQuality
2.2.1
2.2.1.1
Pre-installation Tasks
Configuring Network Ports
The following ports must be open between the server machine, client machine, managed network equipment and other NMS/OSS elements: Table 2-1: Network Ports
Use
App. server and managed equipment App. server, managed equipment and other NMS/OSS elements App. server and managed equipment App. server and client Sending requests to AlvariSTAR in order to reach KPI Setting up AlvariSTAR to discover StarQuality
Port
161 162
Protocol
SNMP SNMP
Direction
Outbound towards NE Outbound towards NMS/OSS elements From Managed equipment to StarQuality Inbound/Outbound between client and server
69 8080 16162
TFTP
SNMP
10161
StarQuality
15
User Manual
Installation
2.2.1.2
Installing Cygwin
Cygwin is a UNIX-like environment for Windows. StarQuality operation commands must always be executed from a cygwin window. The Cygwin Installation files can be downloaded from the internet (see To download and install Cygwin from the Internet: on page 21), or Alvarion FTP Server (see below).
To download and install Cygwin from the Alvarion FTP server: 1 Download the CygwinFromWwwGoh4Com.zip file from ftp://downloads.alvarion.com/StarSuite/Star Quality/Installations/ (Username and password required when connecting as alvarioncustomer) 2 3 Extract the zip file into a folder with a path that does not include spaces. From the extracted files run the setup.exe file; The Cygwin Net Release Setup Program window is displayed.
Figure 2-1: Cygwin Net Release Setup Program window 4 Click Next. The Choose a Download Source window is displayed.
StarQuality
16
User Manual
Installation
Figure 2-2: Choose a Download Source Window 5 Select Install from Local directory. Click Next.
Figure 2-3: Select Root Install Directory
StarQuality
17
User Manual
Installation
Choose settings as recommended on screen. Verify that Root directory is a local drive. Click Next.
Figure 2-4: Select Local Package Directory 7 Verify that Local Package Directory is the correct path. Click Next; The Select Packages window is displayed.
All - Default entry
Figure 2-5: Select Packages Window - All Default (Initial State)
StarQuality
18
User Manual
Installation
Click on the word Default in the main All entry (package) (see Figure 2-6) to change it to Install.
Figure 2-6: Select Packages Window - All Install 9 Verify that all the entries under the All main package have also been changed to Install (see Figure 2-7). 10 Scroll down to the Perl package and expand it using the + sign. 11 Check the sub-package under Perl. If it is other than 5.8.x.x (e.g. skip), click on it to change it to the required 5.8.x.x (see Figure 2-8).
NOTE The Perl version must be 5.8.x.x, otherwise it does not meet the StarQuality requirements. In this case, use a different cygwin installation package.
StarQuality
19
User Manual
Installation
Perl Version
Figure 2-7: Select Packages Window - Perl Version 12 Click Next; the installation proceeds until completed.
Figure 2-8: Cygwin Installation Process
StarQuality
20
User Manual
Installation
13 Click Finish.
Figure 2-9: Cygwin Installation Completion
To download and install Cygwin from the Internet: Make sure the Cygwin version you download and use includes the following packages:
Sapache bash coreutils cygutils expat gcc-core gcc-mingw-g++ less libexpat1 libiconv2 libncurses8 base-files binutils crypt cygwin findutils gcc-g++ grep libbz2_1 libexpat1-devel libintl3 libpcre0 base-passwd bzip2 cygrunsrv editrights gawk gcc-mingw-core gzip libdb4.5 libgdbm4 libintl8 libpopt0
StarQuality
21
User Manual
Installation
Installing StarQuality
libreadline6 make openssh ping termcap tzcode which
libwrap0 mingw-runtime openssl sed terminfo vim zlib
login minires perl - version 5.8.x.x tar texinfo w32api
2.2.2
2.2.2.1
Overview
This Installation type is applicable when Installing StarQuality on Windows server with internal Oracle database (refer to Table 2-1). The installation has to be performed by a local administrator user. During the installation the installer writes information into two destinations: the Details view and the log file. To display the Details view, click Show Details in the installation wizard. The log file is located in the Temp directory of the user (by default C:\Documents and Settings\<USER>\Local Settings\Temp\).
2.2.2.2
StarQuality Installation Procedure

1 2 Ensure that the pre-installation task are complete as required in Section 2.2.1 Do one of the following:
Insert the installation DVD into the DVD drive or Copy/unzip the Installation folder directly onto one of the disk drives (for example: C:/).
IMPORTANT Do not place the installation files into a folder with a long path. This is an Oracle installer limitation.
Run the installation program starquality.exe; The installation wizard is displayed.
StarQuality
22
User Manual
Installation
Figure 2-10: StarQuality Setup Wizard Window 4 Click Next; the wizard displays a license agreement. Please read the agreement carefully.
Figure 2-11: Licence Agreement 5 Click Next; the wizard displays components to install.
StarQuality
23
User Manual
Installation
Figure 2-12: Choose Components 6 Click Next; StarQuality installation starts. To view detailed information click Show Details. The content of the details view can be copied to the clipboard.
Figure 2-13: StarQuality Installing The last page indicates that the basic installation is done.
StarQuality
24
User Manual
Installation
Figure 2-14: StarQuality Basic Installation Complete 7 Click Next; the installer prompts for the Oracle installation and patch, located on the StarQuality DVD (Figure 2-15). Proceed as follows: a Select the Oracle installer folder: If required, click Browse and select the location for the files.
Figure 2-15: Oracle Database Install
StarQuality
25
User Manual
Installation
Click Next. The StarQuality Installation window is displayed (Figure 2-16) Click Browse to change the default Oracle home directory.
IMPORTANT The Oracle home directory must be on the same disk drive as the StarQuality (Cygwin) home directory.
Figure 2-16: Oracle Directory c Click Next. A command line window is displayed, showing the Oracle database installation progress (Figure 2-17).
NOTE The Oracle database installation may take 30-60 minutes, depending on the machine characteristics. During the whole time, the installation progress is displayed in the console. If the console is idle for more than 10 minutes, check for errors.
StarQuality
26
User Manual
Installation
Figure 2-17: Installation Progress 8 Fill in and confirm the required password. It is recommended to use the Windows password for the same user.
Figure 2-18: StarQuality Windows Service Registration 9 Click Next; The Oracle Connection page is displayed (Figure 2-19).
StarQuality
27
User Manual
Installation
Figure 2-19: Oracle Connection Parameters 10 Verify that the correct values are filled in the following fields: Oracle Home: Path to the Oracle Home variable. TNS: the TNS name to be used for the database connection as appears in the tnsnames.ora file on the StarQuality machine. For internal Oracle: SQ. Host and port: the host of the Oracle database server and port used for connecting to it. Port default is 1521(For internal Oracle: 1521). Host can be either:
localhost Host name IP 127.0.0.1

Service name and SID: only one of them needs to be filled in, preferably the Service name. For internal Oracle: SQ. System password and Confirm password: the password of the SYSTEM user in the database. For internal Oracle: oracle. The password is only used by the
StarQuality
28
User Manual
Installation
installer for the creation of the database user and table spaces, the installer does not save it. 11 Click Next; Oracle Connection continues with Oracle tablespace parameters. Point both CONF. and DATA tablespaces to the Oracle data computer partition cording to Table 2-1. 12 Approve the creation of CONF and DATA tablespaces.
Figure 2-20: Oracle Connection - Tablespace Parameters 13 Click Next; The Oracle user parameters are displayed.
StarQuality
29
User Manual
Installation
Figure 2-21: Oracle Connection - User Parameters 14 Click Next; The installer displays the Setup wizard and completes the installation.
Figure 2-22: StarQuality Setup Wizard - Completing Installation 15 Click Finish to close the wizard.
StarQuality
30
User Manual
Installation
16 Set up the Oracle data files and redo logs according to the expected database size and system load. For details on these procedures, check the relevant Oracle Database documentation. 17 To load a licence and run StarQuality, refer to:
Loading a StarQuality Licence on page 114 Running StarQuality on Windows on page 111.
StarQuality
31
User Manual
Installation
Installing StarQuality on Windows Server with External Oracle Database on the Same Machine
2.3
Installing StarQuality on Windows Server with External Oracle Database on the Same Machine
Before beginning the StarQuality installation refer to Table 2-1 to ensure that this is the correct installation for your system. Check that you have performed all the tasks outlined in Section 2.3.1 below. This installation type involves the installation of the following components: Oracle server (Oracle client is not required) cygwin StarQuality
2.3.1
2.3.1.1
The following ports must be open between the server machine, client machine, managed network equipment and other NMS/OSS elements: Table 2-2: Network Ports
Use
App. server and managed equipment App. server, managed equipment and other NMS/OSS elements App. server and managed equipment App. server and client Oracle communication client server Sending requests to AlvariSTAR in order to reach KPI
Port
161 162
Protocol
SNMP SNMP
Direction
Outbound towards NE Outbound towards NMS/OSS elements From Managed equipment to StarQuality Inbound/Outbound between client and server From StarQuality to Oracle and from Oracle to StarQuality
69 8080 As installed (Default: 1521) 16162
TFTP
SNMP
StarQuality
32
User Manual
Installation
2.3.1.2
Installing Oracle Server

Follow these guidelines: Consult Table 2-1 for the correct Oracle Server version. Install Oracle Server according to instructions issued by Oracle corporation. Make sure that the database is set to a minimum of 170 processes. During StarQuality installation, the Oracle server must be running, and the database connection from the StarQuality should be available. To test connectivity to the database server from the StarQuality machine, use the sqlplus utility as follows:
Assuming that the database SID is testme, and system password is

oracle, switch to the command prompt (on Windows) or use a console (on
Solaris, logged in as the Oracle user) and enter the following command: sqlplus system/oracle@testme. If the SQL prompt is displayed, connectivity to the database server is confirmed. Any error message should be reported to and resolved by the DBA.
Enter exit or quit to complete the procedure.
The following Oracle database information should be available when installing StarQuality:
Service name (SID) TNS Password for SYSTEM user
2.3.1.3
Installing Cygwin
StarQuality
33
User Manual
Installation
StarQuality
34
User Manual
Installation
Figure 2-24: Choose a Download Source Window 5 Select Install from Local directory. Click Next.
Figure 2-25: Select Root Install Directory
StarQuality
35
User Manual
Installation
Choose settings as recommended on screen. Verify that Root directory is a local drive. Click Next.
Figure 2-26: Select Local Package Directory 7 Verify that Local Package Directory is the correct path. Click Next; The Select Packages window is displayed.
All - Default entry
Figure 2-27: Select Packages Window - All Default (Initial State)
StarQuality
36
User Manual
Installation
Click on the word Default in the main All entry (package) (see Figure 2-6) to change it to Install.
Figure 2-28: Select Packages Window - All Install 9 Verify that all the entries under the All main package have also been changed to Install (see Figure 2-7). 10 Scroll down to the Perl package and expand it using the + sign. 11 Check the sub-package under Perl. If it is other than 5.8.x.x (e.g. skip), click on it to change it to the required 5.8.x.x (see Figure 2-8).
StarQuality
37
User Manual
Installation
Perl Version
Figure 2-30: Cygwin Installation Process
StarQuality
38
User Manual
Installation
13 Click Finish.
Sapache bash coreutils cygutils expat gcc-core gcc-mingw-g++ less libexpat1 libiconv2 libncurses8 base-files binutils crypt cygwin findutils gcc-g++ grep libbz2_1 libexpat1-devel libintl3 libpcre0 base-passwd bzip2 cygrunsrv editrights gawk gcc-mingw-core gzip libdb4.5 libgdbm4 libintl8 libpopt0
StarQuality
39
User Manual
Installation
libreadline6 make openssh ping termcap tzcode which
libwrap0 mingw-runtime openssl sed terminfo vim zlib
login minires perl - version 5.8.x.x tar texinfo w32api
2.3.2
2.3.2.1
Overview
This Installation type is applicable when installing StarQuality on Windows server with external Oracle database on the same machine (refer to Table 2-1). The installation has to be performed by a local administrator user. During the installation the installer writes information into two destinations: the Details view and the log file. To display the Details view, click Show Details in the installation wizard. The log file is located in the Temp directory of the user (by default C:\Documents and Settings\<USER>\Local Settings\Temp\).
2.3.2.2

1 2 Ensure that the pre-installation task are complete as required in Section 2.3.1 Do one of the following:
IMPORTANT Do not place the installation files into a long path. This is an Oracle installer limitation.
StarQuality
40
User Manual
Installation
StarQuality
41
User Manual
Installation
StarQuality
42
User Manual
Installation
Figure 2-36: StarQuality Basic Installation Complete 7 Click Next; The StarQuality Windows Service Registration window is displayed (Figure 2-37). The service will be run with the given Windows user. Fill in and confirm the required password. It is recommended to use the Windows password for the same user.
Figure 2-37: StarQuality Windows Service Registration
StarQuality
43
User Manual
Installation
Click Next; The Oracle Connection page is displayed (Figure 2-38).
Figure 2-38: Oracle Connection Parameters 9 Verify that the correct values are filled in the following fields:
Oracle Home: Path to the Oracle Home variable. TNS: the TNS name to be used for the database connection determined during the Oracle database installation. This name appears in the tnsnames.ora file on the StarQuality machine. Host and port: the host of the Oracle database server and port used for connecting to it. Port default is 1521. Host can be either:
localhost Host name IP 127.0.0.1

Service name and SID: only one of them needs to be filled in, preferably the Service name.
StarQuality
44
User Manual
Installation
System password and Confirm password: the password of the SYSTEM user in the database. The password is only used by the installer for the creation of the database user and table spaces, the installer does not save it. 10 Click Next; Oracle Connection continues with Oracle tablespace parameters. Point both CONF. and DATA tablespaces to the Oracle data computer partition. 11 Approve the creation of CONF and DATA tablespaces.
Figure 2-39: Oracle Connection - Tablespace Parameters 12 Click Next; Oracle user parameters window is displayed.
StarQuality
45
User Manual
Installation
StarQuality
46
User Manual
Installation
StarQuality
47
User Manual
Installation
Installing StarQuality on Windows Server with Oracle Database on a Separate Machine
2.4
Installing StarQuality on Windows Server with Oracle Database on a Separate Machine

Before beginning the StarQuality installation refer to Table 2-1 to ensure that this is the correct installation for your system. Check that you have performed all the tasks outlined in Section 2.4.1 below. This installation type involves the installation of the following components: Oracle server on a separate machine Oracle client on the StarQuality machine cygwin StarQuality
2.4.1
2.4.1.1
The following ports must be open between the server machine, client machine, managed network equipment and other NMS/OSS elements:
StarQuality
48
User Manual
Installation
Table 2-3: Network Ports Use

Port
161 162
Protocol
SNMP SNMP
Direction
TFTP
SNMP
2.4.1.2
Installing Oracle
Follow these guidelines: Consult Table 2-1 for the correct Oracle Server/Client versions. Install Oracle Server on a standalone Oracle machine according to instructions issued by Oracle corporation. Make sure that the database is set to a minimum of 170 processes. Install Oracle client using the Administrator type installation. When completing the Oracle client installation, use the Oracle Net Configuration Assistant to create a connection to the Database server, and test it. During StarQuality installation, the Oracle server must be running, and the database connection from the StarQuality machine should be available.
StarQuality
49
User Manual
Installation
To test connectivity to the database server from the StarQuality machine, use the sqlplus utility as follows:

Solaris, logged in as the Oracle user) and enter the following command: sqlplus system/oracle@testme.
The following Oracle database information should be available when installing the StarQuality:
Oracle Database server IP Service name (SID) TNS Password for SYSTEM use
2.4.1.3
Installing Cygwin
StarQuality
50
User Manual
Installation
Figure 2-43: Choose a Download Source Window
StarQuality
51
User Manual
Installation
Select Install from Local directory. Click Next.
Figure 2-44: Select Root Install Directory 6 Choose settings as recommended on screen. Verify that Root directory is a local drive. Click Next.
Figure 2-45: Select Local Package Directory
StarQuality
52
User Manual
Installation
Verify that Local Package Directory is the correct path. Click Next; The Select Packages window is displayed.
All - Default entry
Figure 2-46: Select Packages Window - All Default (Initial State) 8 Click on the word Default in the main All entry (package) (see Figure 2-6) to change it to Install.
Figure 2-47: Select Packages Window - All Install
StarQuality
53
User Manual
Installation
Verify that all the entries under the All main package have also been changed to Install (see Figure 2-7).
10 Scroll down to the Perl package and expand it using the + sign. 11 Check the sub-package under Perl. If it is other than 5.8.x.x (e.g. skip), click on it to change it to the required 5.8.x.x (see Figure 2-8).
Perl Version
StarQuality
54
User Manual
Installation
Figure 2-49: Cygwin Installation Process 13 Click Finish.
StarQuality
55
User Manual
Installation
Sapache bash coreutils cygutils expat gcc-core gcc-mingw-g++ less libexpat1 libiconv2 libncurses8 libreadline6 make openssh ping termcap tzcode which base-files binutils crypt cygwin findutils gcc-g++ grep libbz2_1 libexpat1-devel libintl3 libpcre0 libwrap0 mingw-runtime openssl sed terminfo vim zlib base-passwd bzip2 cygrunsrv editrights gawk gcc-mingw-core gzip libdb4.5 libgdbm4 libintl8 libpopt0 login minires perl - version 5.8.x.x tar texinfo w32api
2.4.2
2.4.2.1
Overview
This Installation type is applicable when installing StarQuality on Windows server with Oracle database on a separate machine (refer to Table 2-1). The installation has to be performed by a local administrator user. During the installation the installer writes information into two destinations: the Details view and the log file. To display the Details view, click Show Details in the
StarQuality
56
User Manual
Installation
installation wizard. The log file is located in the Temp directory of the user (by default C:\Documents and Settings\<USER>\Local Settings\Temp\).
2.4.2.2

1 Do one of the following:
IMPORTANT Do not place the installation files into a long path. This is an Oracle installer limitation.
StarQuality
57
User Manual
Installation
StarQuality
58
User Manual
Installation
Figure 2-55: StarQuality Basic Installation Complete 6 Click Next; The StarQuality Service Registration window is displayed. Fill in and confirm the required password. It is recommended to use the Windows password for the same user.
StarQuality
59
User Manual
Installation
Figure 2-56: StarQuality Windows Service Registration 7 Click Next; The Oracle Connection page is displayed (Figure 2-19).
Figure 2-57: Oracle Connection Parameters 8 Verify that the correct values are filled in the following fields:
StarQuality
60
User Manual
Installation
Oracle Home: Path to the Oracle Client Home variable on the StarQuality machine. TNS: the TNS name to be used for the database connection as appears in the tnsnames.ora file on the StarQuality machine. Host and port: IP of the Oracle database server and port used for connecting to it. Port default is 1521 Service name and SID: only one of them needs to be filled in, preferably the Service name. System password and Confirm password: the password of the SYSTEM user in the database. The password is only used by the installer for the creation of the database user and table spaces, the installer does not store it. 9 Click Next; Oracle Connection continues with Oracle tablespace parameters.
Figure 2-58: Oracle Connection - Tablespace Parameters 10 Click Next; The user parameters are displayed.
StarQuality
61
User Manual
Installation
StarQuality
62
User Manual
Installation
StarQuality
63
User Manual
Installation
Installing StarQuality on Solaris Server with Internal Oracle Database
2.5
Installing StarQuality on Solaris Server with Internal Oracle Database

Before beginning the StarQuality installation refer to Table 2-1 to ensure that this is the correct installation for your system. Check that you have performed all the tasks outlined in Section 2.5.1 below. This installation type involves configuration of the Solaris kernel parameters and then installation of StarQuality.
2.5.1
2.5.1.1
Configuring Kernel Parameters for Solaris x86
1 Add the following entries to the /etc/system file and reboot the system: set shmsys:shminfo_shmmax=4294967295 set shmsys:shminfo_shmmni=100 set semsys:seminfo_semmni=100 set semsys:seminfo_semmsl=256 2 Verify a minimum of 10 GB swap space
2.5.1.2

StarQuality
64
User Manual
Installation

App. server and managed equipment App. server, managed equipment and other NMS/OSS elements App. server and managed equipment App. server and client Sending requests to AlvariSTAR in order to reach KPI
Port
161 162
Protocol
SNMP SNMP
Direction
69 8080 16162
TFTP
SNMP
2.5.2
StarQuality can be installed on a Solaris 10 x86 operating system using the command-line installer. All operations should be done while logged in as root user.
To install StarQuality: 1 Run the installer application, StarQuality.v3.0.en.bin, either directly from the installation DVD or from a directory to which the file was transferred (using FTP). 2 The following sections describe the installation process and details.
2.5.2.1
Basic Checks
The installer checks the following details: Version of the operating system Required packages Version of Perl and the options used to build the Perl binary,
StarQuality
65
User Manual
Installation
If the application detects an error during these checks, then depending on the level of error, it either immediately terminates or asks whether it should continue or not. Always answer No and restart the installation.
Figure 2-61: Installation on Solaris - Basic Checks
2.5.2.2
License Information
When the basic checks are complete, the license agreement is displayed. To scroll down the agreement, press either the spacebar or the Enter key. Read the agreement carefully before accepting.
2.5.2.3
Installing Embedded Oracle Database

The application prompts for the operating system user utilized during the Oracle installation. This part can take up to 30 minutes depending on the computer characteristics. After providing it, the application tries to find an Oracle user on the machine. Only if such a user does not exist, will the installer prompt for the installation of internal Oracle.
StarQuality
66
User Manual
Installation
Figure 2-62: Installing Embedded Oracle Database Set up the Oracle data files and redo logs according to the expected database size and system load. For details on these procedures, check the relevant Oracle Database documentation.
2.5.2.4
StarQuality Installation Prompts

The application prompts for the following: Operating system user name to be created
StarQuality
67
User Manual
Installation
Operating system group to be created Directory below the /opt directory to be used by StarQuality, Profile file to be used Type of StarQuality installation If the user and the directory already exist but the installer cannot find a valid StarQuality installation in the directory, then it asks whether it should continue or not. If it finds a StarQuality, it stops until all StarQuality modules are stopped. The installer prompts for the installation type, that is, if you are installing an additional server. Answer No to this prompt.
------------------------------------------------------------------------WARNING: !!! YOU SHOULD ONLY ANSWER YES TO THE FOLLOWING QUESTION!!! WARNING: !!! IF YOU ARE INSTALLING AN ADDITIONAL (COLLECTOR) SERVER !!! WARNING: !!! OR YOU ARE UPGRADING SUCH AN ADDITIONAL (COLLECTOR) SERVER !!! QUESTION : Are you installing a collector server (Y/N) [N]: -------------------------------------------------------------------------
2.5.2.5
Apache Configuration
If you are not installing a data collector, the installer asks whether it should configure the Apache WEB server or you will configure it later. This question is among the few yes-no questions for which the installer stores the given answer and sets the default to your previous answer when running a second time, and can accept this default answer in silent mode automatically. If you answer Yes, the installer asks for various Apache files and the port to be used, and then configures it. The default answers given to the user during the installation represent the answers for the default Apache installation according to the operating system.
------------------------------------------------------------------------QUESTION : Do you want to configure the Apache WEB server (Y/N) [Y]: y INFO : Configuring Apache
QUESTION : On which port should Apache listen [80]: QUESTION : Where is the Apache apachectl file [/usr/apache/bin/apachectl]: QUESTION : Where is the Apache htpasswd file [/usr/apache/bin/htpasswd]:
StarQuality
68
User Manual
Installation
QUESTION : Where is the Apache pid file [/var/run/apache/httpd.pid]: QUESTION : Where is the Apache httpd.conf file [/etc/apache/httpd.conf]: INFO : Creating backup /etc/apache/httpd.conf.20090512-122852 from /etc/apache/httpd.conf INFO INFO INFO : Stopping Apache : Creating a new /etc/apache/httpd.conf : Starting Apache
-------------------------------------------------------------------------
2.5.2.6
Automatic Starting and Stopping

The installer application places scripts in the appropriate folder so that StarQuality can be automatically started and stopped. Automatic start/stop in this case does not include Oracle. If you are not installing a data collector server then the installer asks whether the Oracle has to be automatically started and stopped by the same script as well. You should only answer Yes if the Oracle server is running on the same machine and there is no other script to start and stop Oracle. If the Oracle server is running on the same machine but such a script already exists then you have to make sure that StarQuality starts after the Oracle server and stops before the Oracle server. This question is among the few yes-no questions for which the installer stores the given answer and sets the default to your previous answer when running a second time, and can accept this default answer in silent mode automatically.
------------------------------------------------------------------------INFO : Creating the service script, so the operating system can automatically INFO WARNING WARNING WARNING : start and stop StarQuality : !!! YOU SHOULD ONLY ANSWER YES TO THE FOLLOWING QUESTION IF !!! : !!! THE ORACLE DATABASE RUNS ON THIS SERVER AND YOU DO NOT : !!! HAVE ALREADY A START/STOP SCRIPT FOR THE ORACLE !!! !!!
QUESTION : Should this script start/stop the Oracle server as well (Y/N) [Y]: n WARNING WARNING WARNING INFO INFO : !!! IF THE ORACLE RUNS ON THIS SERVER THEN MAKE SURE THAT : !!! IT STARTS BEFORE THE APPLICATION AND STOPS AFTER THE : !!! APPLICATION : Creating sym link /etc/rc0.d/K01starquality : Creating sym link /etc/rc3.d/S99starquality !!! !!! !!!
StarQuality
69
User Manual
Installation
-------------------------------------------------------------------------
2.5.2.7
Creating the StarQuality Tablespaces in the Database and the Oracle User
The installer prompts for the following, and creates the tablespaces: Name, file name and size parameters for its configuration and data tablespaces. Leave name and size as prompted but point to the partition as defined in the required Partitioning table. Name and password for its Oracle user.
------------------------------------------------------------------------INFO INFO : Checking Oracle schema : Getting the default tablespace directory
QUESTION : StarQuality Conf tablespace name [SQ_CONF]: QUESTION : StarQuality Conf tablespace file [/export/home/oracle/oradata/SQ/SQ_CONF.dbf]: QUESTION : StarQuality Conf tablespace size [300M]: INFO INFO : Creating the tablespace SQ_CONF, this could take several minutes : Oracle tablespace SQ_CONF created
QUESTION : StarQuality Data tablespace name [SQ_DATA]: QUESTION : StarQuality Data tablespace file [/export/home/oracle/oradata/SQ/SQ_DATA.dbf]: QUESTION : StarQuality Data tablespace size [10000M]: INFO INFO INFO : Creating the tablespace SQ_DATA, this could take several minutes : Creating the tablespace SQ_DATA, this could take several minutes : Oracle tablespace SQ_DATA created
QUESTION : StarQuality Oracle user name [SQ]: QUESTION : StarQuality Oracle user password [******]: INFO INFO : Creating the Oracle schema, this could take several minutes : Oracle user SQ created
2.5.2.8
Finishing the Installation

1 The installer generates the schematic maps and exits.
-------------------------------------------------------------------------
StarQuality
70
User Manual
Installation
INFO INFO
: Redrawing schematic maps : Installer ended
-bash-3.00# -------------------------------------------------------------------------
To load a licence and run StarQuality, refer to:
Loading a StarQuality Licence on page 114 Running StarQuality on Solaris on page 113.
StarQuality
71
User Manual
Installation
Installing StarQuality on Solaris Server with External Oracle Database on the Same Machine
2.6
Installing StarQuality on Solaris Server with External Oracle Database on the Same Machine
Before beginning the StarQuality installation refer to Table 2-1 to ensure that this is the correct installation for your system. Check that you have performed all the tasks outlined in Section 2.6.1 below. This installation type involves configuration of the Solaris kernel parameters and the installation of the following components: Oracle server (Oracle client is not required) StarQuality
2.6.1
2.6.1.1
Configuring Kernel Parameters for Solaris x86
1 Add the following entries to the /etc/system file and reboot the system: set shmsys:shminfo_shmmax=4294967295 set shmsys:shminfo_shmmni=100 set semsys:seminfo_semmni=100 set semsys:seminfo_semmsl=256 2 Verify a minimum of 10 GB swap space
2.6.1.2

StarQuality
72
User Manual
Installation

Port
161 162
Protocol
SNMP SNMP
Direction
69 8080 16162
TFTP
SNMP
2.6.1.3

Follow these guidelines: Consult Table 2-1 for the correct Oracle Server version. Install Oracle Server according to instructions issued by Oracle corporation. Make sure that the database is set to a minimum of 170 processes. Set up the Oracle data files and redo logs according to the expected database size and system load. For details on these procedures, check the relevant Oracle Database documentation. During StarQuality installation, the Oracle server must be running, and the database connection from the StarQuality should be available. To test connectivity to the database server from the StarQuality machine, use the sqlplus utility as follows:

Solaris, logged in as the Oracle user) and enter the following command: sqlplus system/oracle@testme. If the SQL prompt is displayed,
StarQuality
73
User Manual
Installation
connectivity to the database server is confirmed. Any error message should be reported to and resolved by the DBA.
2.6.2
To install StarQuality (Solaris): 1 Run the installer application, StarQuality.v3.0.en.bin, either directly from the installation DVD or from a directory to which the file was transferred (using FTP). 2 Follow the next sections for installation details.
2.6.2.1
Basic Checks
The installer checks the following details: Version of the operating system Required packages Version of Perl and the options used to build the Perl binary, If the application detects an error during these checks, then depending on the level of error, it either immediately terminates or asks whether it should continue or not. Always answer No and restart the installation.
StarQuality
74
User Manual
Installation
2.6.2.2
License Information
2.6.2.3
Connection Details of External Oracle Database

The application prompts for the operating system user used during the Oracle installation. After providing it, it tries to determine the value of the ORACLE_HOME environment variable using that user, and asks for confirmation. --------------------------------------------------------------------------------------------------QUESTION : The OS user of Oracle [oracle]: INFO : Found Oracle home: "/export/home/AlvariSTAR/db/product/10.2.0/db_1" QUESTION : ORACLE_HOME environment variable [/export/home/AlvariSTAR/db/product/10.2.0/db_1]: INFO : Checking the Oracle home /export/home/AlvariSTAR/db/product/10.2.0/db_1 INFO : Oracle home /export/home/AlvariSTAR/db/product/10.2.0/db_1 seems to be OK INFO : Checking Oracle version
StarQuality
75
User Manual
Installation
INFO INFO
: Found Oracle version 10 : Detected 64-bit Oracle
QUESTION : StarQuality OS user name [starq]: INFO : Found StarQuality in /opt/starquality
INFO : Select user starq and group starq with directory /opt/starquality INFO INFO INFO INFO : Checking the environment of starq : Environment checking is done : Searching for running StarQuality modules : Oracle checking
INFO : Detected Solaris_x86 with 64 bit Oracle, so using full connect string instead of TNS names QUESTION : Oracle host name [localhost]: QUESTION : Oracle port [1721]: QUESTION : Oracle service name [BWANMS]: QUESTION : Oracle SID [BWANMS]: QUESTION : Oracle SYSTEM user password []: CONFIRM ERROR : Confirm the password: : Password mismatch
QUESTION : Oracle SYSTEM user password []: CONFIRM INFO INFO INFO BWANMS INFO : Confirm the password: : Attempting to tnsping localhost:1721 : Successful : Attempting to login to Oracle with the SYSTEM user and the SID : Successful
INFO : Attempting to login to Oracle with the SYSTEM user and the service name BWANMS INFO INFO INFO INFO : Successful : Oracle checking successful : Configuring user SSH parameters : Done
-------------------------------------------------------------------------
2.6.2.4

The application prompts for the following:
StarQuality
76
User Manual
Installation
Operating system user name to be created Operating system group to be created Directory below the /opt directory to be used by StarQuality, Profile file to be used Type of StarQuality installation If the user and the directory already exist but the installer cannot find a valid StarQuality installation in the directory, then it asks whether it should continue or not. If it finds a StarQuality, it stops until all StarQuality modules are stopped. The installer prompts for the installation type, that is, if you are installing an additional server. Answer No to this prompt.
2.6.2.5
QUESTION : On which port should Apache listen [80]: QUESTION : Where is the Apache apachectl file [/usr/apache/bin/apachectl]:
StarQuality
77
User Manual
Installation
QUESTION : Where is the Apache htpasswd file [/usr/apache/bin/htpasswd]: QUESTION : Where is the Apache pid file [/var/run/apache/httpd.pid]: QUESTION : Where is the Apache httpd.conf file [/etc/apache/httpd.conf]: INFO : Creating backup /etc/apache/httpd.conf.20090512-122852 from /etc/apache/httpd.conf INFO INFO : Stopping Apache : Creating a new /etc/apache/httpd.conf
INFO : Starting Apache -------------------------------------------------------------------------
2.6.2.6

QUESTION : Should this script start/stop the Oracle server as well (Y/N) [Y]: n WARNING WARNING WARNING INFO : !!! IF THE ORACLE RUNS ON THIS SERVER THEN MAKE SURE THAT : !!! IT STARTS BEFORE THE APPLICATION AND STOPS AFTER THE : !!! APPLICATION : Creating sym link /etc/rc0.d/K01starquality !!! !!! !!!
StarQuality
78
User Manual
Installation
INFO
: Creating sym link /etc/rc3.d/S99starquality
-------------------------------------------------------------------------
2.6.2.7
QUESTION : StarQuality Conf tablespace name [SQ_CONF]: QUESTION : StarQuality Conf tablespace file [C:\ORACLE\PRODUCT\10.2.0\ORADATA\ORCL\SQ_CONF.dbf]: QUESTION : StarQuality Conf tablespace size [300M]: INFO INFO : Creating the tablespace SQ_CONF, this could take several minutes : Oracle tablespace SQ_CONF created
QUESTION : StarQuality Data tablespace name [SQ_DATA]: QUESTION : StarQuality Data tablespace file [C:\ORACLE\PRODUCT\10.2.0\ORADATA\ORCL\SQ_DATA.dbf]: QUESTION : StarQuality Data tablespace size [10000M]: INFO INFO INFO : Creating the tablespace SQ_DATA, this could take several minutes : Creating the tablespace SQ_DATA, this could take several minutes : Oracle tablespace SQ_DATA created
2.6.2.8

StarQuality
79
User Manual
Installation
------------------------------------------------------------------------INFO INFO : Redrawing schematic maps : Installer ended
-bash-3.00# -------------------------------------------------------------------------
StarQuality
80
User Manual
Installation
Installing StarQuality on Solaris Server with Oracle Database on a Separate Machine
2.7
Installing StarQuality on Solaris Server with Oracle Database on a Separate Machine

Before beginning the StarQuality installation refer to Table 2-1 to ensure that this is the correct installation for your system. Check that you have performed all the tasks outlined in Section 2.7.1 below. This installation type involves configuration of the Solaris kernel parameters and the installation of the following components: Oracle server on a separate machine Oracle client on the StarQuality machine StarQuality
2.7.1
2.7.1.1
StarQuality
81
User Manual
Installation

Port
161 162
Protocol
SNMP SNMP
Direction
TFTP
SNMP
2.7.1.2
Installing Oracle
Follow these guidelines: Consult Table 2-1 for the correct Oracle Server/Client versions. Install Oracle Server on a standalone Oracle machine according to instructions issued by Oracle corporation. Make sure that the database is set to a minimum of 170 processes. Install Oracle client using the Administrator type installation. Set up the Oracle data files and redo logs according to the expected database size and system load. For details on these procedures, check the relevant Oracle Database documentation. When completing the Oracle client installation, use the Oracle Net Configuration Assistant to create a connection to the Database server, and test it. During StarQuality installation, the Oracle server must be running, and the database connection from the StarQuality machine should be available.
StarQuality
82
User Manual
Installation

Solaris, logged in as the Oracle user) and enter the following command: sqlplus system/oracle@testme.
The following Oracle database information should be available when installing the StarQuality:
2.7.2
To install StarQuality (Solaris): 1 Run the installer application, StarQuality.v3.0.en.bin, either directly from the installation DVD or from a directory to which the file was transferred (using FTP). 2 Follow the next sections for installation details.
2.7.2.1
Basic Checks
The installer checks the following details: Version of the operating system Required packages
StarQuality
83
User Manual
Installation
Version of Perl and the options used to build the Perl binary, If the application detects an error during these checks, then depending on the level of error, it either immediately terminates or asks whether it should continue or not. Always answer No and restart the installation.
2.7.2.2
License Information
2.7.2.3

The application prompts for the operating system user used during the Oracle installation. After providing it, it tries to determine the value of the ORACLE_HOME environment variable using that user, and asks for confirmation. --------------------------------------------------------------------------------------------------QUESTION : The OS user of Oracle [oracle]: INFO : Found Oracle home: "/export/home/AlvariSTAR/db/product/10.2.0/db_1"
StarQuality
84
User Manual
Installation
QUESTION : ORACLE_HOME environment variable [/export/home/AlvariSTAR/db/product/10.2.0/db_1]: INFO : Checking the Oracle home /export/home/AlvariSTAR/db/product/10.2.0/db_1 INFO : Oracle home /export/home/AlvariSTAR/db/product/10.2.0/db_1 seems to be OK INFO INFO INFO : Checking Oracle version : Found Oracle version 10 : Detected 64-bit Oracle
QUESTION : StarQuality OS user name [starq]: INFO : Found StarQuality in /opt/starquality
INFO : Select user starq and group starq with directory /opt/starquality INFO INFO INFO INFO : Checking the environment of starq : Environment checking is done : Searching for running StarQuality modules : Oracle checking
INFO : Detected Solaris_x86 with 64 bit Oracle, so using full connect string instead of TNS names QUESTION : Oracle host name [localhost]: QUESTION : Oracle port [1721]: QUESTION : Oracle service name [BWANMS]: QUESTION : Oracle SID [BWANMS]: QUESTION : Oracle SYSTEM user password []: CONFIRM ERROR : Confirm the password: : Password mismatch
QUESTION : Oracle SYSTEM user password []: CONFIRM INFO INFO INFO BWANMS INFO : Confirm the password: : Attempting to tnsping localhost:1721 : Successful : Attempting to login to Oracle with the SYSTEM user and the SID : Successful
INFO : Attempting to login to Oracle with the SYSTEM user and the service name BWANMS INFO INFO INFO : Successful : Oracle checking successful : Configuring user SSH parameters
StarQuality
85
User Manual
Installation
INFO
: Done
-------------------------------------------------------------------------
2.7.2.4

The application prompts for the following: Operating system user name to be created Operating system group to be created Directory below the /opt directory to be used by StarQuality, Profile file to be used Type of StarQuality installation If the user and the directory already exist but the installer cannot find a valid StarQuality installation in the directory, then it asks whether it should continue or not. If it finds a StarQuality, it stops until all StarQuality modules are stopped. The installer prompts for the installation type, that is, if you are installing an additional server. Answer No to this prompt.
2.7.2.5
StarQuality
86
User Manual
Installation
QUESTION : On which port should Apache listen [80]: QUESTION : Where is the Apache apachectl file [/usr/apache/bin/apachectl]: QUESTION : Where is the Apache htpasswd file [/usr/apache/bin/htpasswd]: QUESTION : Where is the Apache pid file [/var/run/apache/httpd.pid]: QUESTION : Where is the Apache httpd.conf file [/etc/apache/httpd.conf]: QUESTION : Authentication method to be used (BASIC, ldap, password_file, radius) [password_file]: INFO : Creating backup /etc/apache/httpd.conf.20090512-122852 from /etc/apache/httpd.conf INFO INFO : Stopping Apache : Creating a new /etc/apache/httpd.conf
INFO : Starting Apache -------------------------------------------------------------------------
2.7.2.6

------------------------------------------------------------------------INFO : Creating the service script, so the operating system can automatically INFO WARNING WARNING : start and stop StarQuality : !!! YOU SHOULD ONLY ANSWER YES TO THE FOLLOWING QUESTION IF !!! : !!! THE ORACLE DATABASE RUNS ON THIS SERVER AND YOU DO NOT !!!
StarQuality
87
User Manual
Installation
WARNING
: !!! HAVE ALREADY A START/STOP SCRIPT FOR THE ORACLE
!!!
QUESTION : Should this script start/stop the Oracle server as well (Y/N) [Y]: n WARNING WARNING WARNING INFO INFO : !!! IF THE ORACLE RUNS ON THIS SERVER THEN MAKE SURE THAT : !!! IT STARTS BEFORE THE APPLICATION AND STOPS AFTER THE : !!! APPLICATION : Creating sym link /etc/rc0.d/K01starquality : Creating sym link /etc/rc3.d/S99starquality !!! !!! !!!
-------------------------------------------------------------------------
2.7.2.7
QUESTION : StarQuality Conf tablespace name [SQ_CONF]: QUESTION : StarQuality Conf tablespace file [C:\ORACLE\PRODUCT\10.2.0\ORADATA\ORCL\SQ_CONF.dbf]: QUESTION : StarQuality Conf tablespace size [300M]: INFO INFO : Creating the tablespace SQ_CONF, this could take several minutes : Oracle tablespace SQ_CONF created
QUESTION : StarQuality Data tablespace name [SQ_DATA]: QUESTION : StarQuality Data tablespace file [C:\ORACLE\PRODUCT\10.2.0\ORADATA\ORCL\SQ_DATA.dbf]: QUESTION : StarQuality Data tablespace size [10000M]: INFO INFO INFO : Creating the tablespace SQ_DATA, this could take several minutes : Creating the tablespace SQ_DATA, this could take several minutes : Oracle tablespace SQ_DATA created
StarQuality
88
User Manual
Installation
2.7.2.8

-bash-3.00# -------------------------------------------------------------------------
StarQuality
89
User Manual
Installation
Installing StarQuality on Linux Server with External Oracle Database on the Same Machine
2.8
Installing StarQuality on Linux Server with External Oracle Database on the Same Machine
Before beginning the StarQuality installation refer to Table 2-1 to ensure that this is the correct installation for your system. Check that you have performed all the tasks outlined in Section 2.8.1 below. This installation type involves configuration of the Linux kernel parameters and the installation of the following components: Oracle server (Oracle client is not required) StarQuality
2.8.1
2.8.1.1
Configuring Kernel Parameters for Linux x86
1 Edit the /etc/sysctl.conf file and reboot the system:
# Kernel sysctl configuration file for Red Hat Linux # # For binary values, 0 is disabled, 1 is enabled. See sysctl(8) and # sysctl.conf(5) for more details.
# Controls IP packet forwarding net.ipv4.ip_forward = 0
# Controls source route verification net.ipv4.conf.default.rp_filter = 1
# Do not accept source routing net.ipv4.conf.default.accept_source_route = 0
# Controls the System Request debugging functionality of the kernel kernel.sysrq = 0
StarQuality
90
User Manual
Installation
# Controls whether core dumps will append the PID to the core filename # Useful for debugging multi-threaded applications kernel.core_uses_pid = 1
# Controls the use of TCP syncookies net.ipv4.tcp_syncookies = 1
# Controls the maximum size of a message, in bytes kernel.msgmnb = 65536
# Controls the default maxmimum size of a message queue kernel.msgmax = 65536
# Controls the maximum shared segment size, in bytes kernel.shmmax = 4294967295
# Controls the maximum number of shared memory segments, in pages kernel.shmall = 268435456
Verify a minimum of 10 GB swap space
2.8.1.2

StarQuality
91
User Manual
Installation

Port
161 162
Protocol
SNMP SNMP
Direction
69 8080 16162
TFTP
SNMP
2.8.1.3

Follow these guidelines: Consult Table 2-1 for the correct Oracle Server version. Install Oracle Server according to instructions issued by Oracle corporation. Make sure that the database is set to a minimum of 170 processes. Set up the Oracle data files and redo logs according to the expected database size and system load. For details on these procedures, check the relevant Oracle Database documentation. During StarQuality installation, the Oracle server must be running, and the database connection from the StarQuality should be available. To test connectivity to the database server from the StarQuality machine, use the sqlplus utility as follows:

oracle, use a console logged in as the Oracle user and enter the following
command: sqlplus system/oracle@testme. If the SQL prompt is
StarQuality
92
User Manual
Installation
displayed, connectivity to the database server is confirmed. Any error message should be reported to and resolved by the DBA.
2.8.2
StarQuality can be installed on a Linux x86 operating system using the command-line installer. All operations should be done while logged in as root user.
To install StarQuality (Linux): 1 Run the installer application, StarQuality.v3.0.en.bin, either directly from the installation DVD or from a directory to which the file was transferred (using FTP). 2 Follow the next sections for installation details.
2.8.2.1
Basic Checks
The installer checks the following details: Version of the operating system Required packages Version of Perl and the options used to build the Perl binary, If the application detects an error during these checks, then depending on the level of error, it either immediately terminates or asks whether it should continue or not. Always answer No and restart the installation.
StarQuality
93
User Manual
Installation
--------------------------------------------------------------------------------------------------INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO : Command line parameters: : Installer started : LOG file: /tmp/starquality.install.log : Checking perl version : Found perl: /usr/local/bin/perl : Checking OS type : Found Red Hat 5 : OS: Linux_x86 : Checking perl 32/64bit : Checking perl PerlIO : Perl was built with PerlIO : Checking perl threading : Perl threading enabled : Checking required packages : Package bash found : Package openssh found : Package grep found : Package tar found : Package gzip found : Package httpd found : Package sed found : Done : Checking required packages for the schematic map feature : Package libjpeg 32 bit found : Package freetype 32 bit found : Package libXpm 32 bit found : Package libXau 32 bit found : Package libXdmcp 32 bit found : Package libX11 32 bit found : Done : Checking the SELinux state : SELinux is disabled, OK
INFO : Keep in mind that the SELinux must not be activated when StarQuality is running
StarQuality
94
User Manual
Installation
INFO INFO INFO
: Extracting files into the temp directory: /tmp/starquality : Done : Licence information
This program contains free of charge third party Java and Perl libraries. The detailed list of components, the detailed license files and sources can be found in the third party directory on the installer CD.
By answering Y you acknowledge that your use of these software is governed by the terms of the respective program licenses.
---------------------------------------------------------------------------------------------------
2.8.2.2
License Information
2.8.2.3

The application prompts for the operating system user used during the Oracle installation. After providing it, it tries to determine the value of the ORACLE_HOME environment variable using that user, and asks for confirmation. --------------------------------------------------------------------------------------------------QUESTION : The OS user of Oracle [oracle]: INFO : Found Oracle home: "/home/oracle/oracle/product/10.2.0/client_2"
QUESTION : ORACLE_HOME environment variable [/home/oracle/oracle/product/10.2.0/client_2]: INFO : Checking the Oracle home /home/oracle/oracle/product/10.2.0/client_2 INFO be OK INFO INFO INFO : Oracle home /home/oracle/oracle/product/10.2.0/client_2 seems to
: Checking Oracle version : Found Oracle version 10 : Detected 32-bit Oracle
QUESTION : StarQuality OS user name [starq]: QUESTION : StarQuality OS user group [starq]: QUESTION : StarQuality OS user password [******]: QUESTION : StarQuality installation directory below the /opt directory [starquality]:
StarQuality
95
User Manual
Installation
INFO INFO INFO
: Creating group starq : Creating user starq with shell /usr/local/bin/bash : Setting the user password
INFO : Select user starq and group starq with directory /opt/starquality INFO : Checking the environment of starq
QUESTION : What is the profile file of the user starq [/opt/starquality/.bash_profile]: INFO : Setting the PS1 environment variable to "'[\u@\h]\$ '"
INFO : Setting the ORACLE_HOME environment variable to "/home/oracle/oracle/product/10.2.0/client_2" INFO : Setting the LD_LIBRARY_PATH environment variable to "/opt/starquality/lib:/home/oracle/oracle/product/10.2.0/client_2/lib" INFO : Setting the PATH environment variable to "/usr/local/bin:/home/oracle/oracle/product/10.2.0/client_2/bin:$PATH" INFO INFO INFO : Environment checking is done : Searching for running StarQuality modules : Oracle checking
QUESTION : TNS name []: QUESTION : Oracle host name [localhost]: QUESTION : Oracle port [1521]: QUESTION : Oracle service name []: QUESTION : Oracle SID []: QUESTION : Oracle SYSTEM user password []: CONFIRM INFO INFO INFO INFO : Confirm the password: : Attempting to tnsping db150 : Successful : Attempting to tnsping 192.168.10.101:1521 : Successful
INFO : Attempting to login to Oracle with the SYSTEM user and the TNS name db150 INFO INFO db150 INFO : Successful : Attempting to login to Oracle with the SYSTEM user and the SID
: Successful
INFO : Attempting to login to Oracle with the SYSTEM user and the service name db150 INFO : Successful
StarQuality
96
User Manual
Installation
INFO INFO INFO INFO INFO INFO
: Oracle checking successful : Configuring user SSH parameters : Done : Saving previous StarQuality config files : Untar StarQuality : Copy the define_wimax_brand.sql to the sql directory
-------------------------------------------------------------------------
2.8.2.4

------------------------------------------------------------------------WARNING WARNING : !!! YOU SHOULD ONLY ANSWER YES TO THE FOLLOWING QUESTION!!! : !!! IF YOU ARE INSTALLING AN ADDITIONAL (COLLECTOR) SERVER!!!
WARNING : !!! OR YOU ARE UPGRADING SUCH AN ADDITIONAL (COLLECTOR) SERVER!!! QUESTION : Are you installing a collector server (Y/N) [N]: -------------------------------------------------------------------------
2.8.2.5
If you are not installing a data collector, the installer asks whether it should configure the Apache WEB server or you will configure it later. This question is
StarQuality
97
User Manual
Installation
among the few yes-no questions for which the installer stores the given answer and sets the default to your previous answer when running a second time, and can accept this default answer in silent mode automatically. If you answer Yes, the installer asks for various Apache files and the port to be used, and then configures it. The default answers given to the user during the installation represent the answers for the default Apache installation according to the operating system.
------------------------------------------------------------------------QUESTION : Do you want to configure the Apache WEB server (Y/N) [Y]: INFO : Configuring Apache
QUESTION : On which port should Apache listen [80]: QUESTION : On which port should Apache listen [80]: QUESTION : Where is the Apache apachectl file [/usr/sbin/apachectl]: QUESTION : Where is the Apache htpasswd file [/usr/bin/htpasswd]: QUESTION : Where is the Apache pid file [/var/run/httpd.pid]: QUESTION : Where is the Apache httpd.conf file [/etc/httpd/conf/httpd.conf]: INFO : Creating backup /etc/httpd/conf/httpd.conf.20110309-113933 from /etc/httpd/conf/httpd.conf INFO INFO INFO INFO : Stopping Apache : Creating a new /etc/httpd/conf/httpd.conf : Using basic authentication : Starting Apache
-------------------------------------------------------------------------
2.8.2.6

The installer application places scripts in the appropriate folder so that StarQuality can be automatically started and stopped. Automatic start/stop in this case does not include Oracle. If you are not installing a data collector server, the installer asks whether the Oracle has to be automatically started and stopped by the same script as well. You should only answer Yes if the Oracle server is running on the same machine and there is no other script to start and stop Oracle. If the Oracle server is running on the same machine but such a script already exists then you have to make sure that StarQuality starts after the Oracle server and stops before the Oracle server. This question is among the few yes-no questions for which the installer stores the given answer and sets the default to
StarQuality
98
User Manual
Installation
your previous answer when running a second time, and can accept this default answer in silent mode automatically.
QUESTION : Should this script start/stop the Oracle server as well (Y/N) [Y]: WARNING WARNING WARNING INFO INFO INFO INFO : !!! IF THE ORACLE RUNS ON THIS SERVER THEN MAKE SURE THAT : !!! IT STARTS BEFORE THE APPLICATION AND STOPS AFTER THE : !!! APPLICATION : Creating sym link /etc/rc0.d/K01starquality : Creating sym link /etc/rc6.d/K01starquality : Creating sym link /etc/rc3.d/S99starquality : Creating sym link /etc/rc5.d/S99starquality !!! !!! !!!
-------------------------------------------------------------------------
2.8.2.7
QUESTION : StarQuality Conf tablespace name [SQ_CONF]: QUESTION : StarQuality Conf tablespace file [D:\ORACLE\ORADATA\DB150\SQ_CONF.dbf]:
StarQuality
99
User Manual
Installation
QUESTION : StarQuality Conf tablespace size [300M]: INFO minutes : Creating the tablespace SQ_CONF, this could take several
QUESTION : StarQuality Data tablespace name [SQ_DATA]: QUESTION : StarQuality Data tablespace file [D:\ORACLE\ORADATA\DB150\SQ_DATA_01.dbf]: QUESTION : StarQuality Data tablespace size [10000M]: INFO : Creating the tablespace SQ_DATA, this could take several minutes
-------------------------------------------------------------------------
2.8.2.8

-------------------------------------------------------------------------
To load a licence and run StarQuality, refer to Loading a StarQuality Licence on page 114
StarQuality
100
User Manual
Installation
Installing StarQuality on Linux Server with Oracle Database on a Separate Machine
2.9
Installing StarQuality on Linux Server with Oracle Database on a Separate Machine

Before beginning the StarQuality installation refer to Table 2-1 to ensure that this is the correct installation for your system. Check that you have performed all the tasks outlined in Section 2.9.1 below. This installation type involves configuration of the Linux kernel parameters and the installation of the following components: Oracle server on a separate machine Oracle client on the StarQuality machine StarQuality
2.9.1
2.9.1.1
StarQuality
101
User Manual
Installation

Port
161 162
Protocol
SNMP SNMP
Direction
TFTP
SNMP
2.9.1.2
Installing Oracle
Follow these guidelines: Consult Table 2-1 for the correct Oracle Server/Client versions. Install Oracle Server on a standalone Oracle machine according to instructions issued by Oracle corporation. Make sure that the database is set to a minimum of 170 processes. Install Oracle client using the Administrator type installation. Set up the Oracle data files and redo logs according to the expected database size and system load. For details on these procedures, check the relevant Oracle Database documentation. When completing the Oracle client installation, use the Oracle Net Configuration Assistant to create a connection to the Database server, and test it. During StarQuality installation, the Oracle server must be running, and the database connection from the StarQuality machine should be available.
StarQuality
102
User Manual
Installation

oracle, use a console logged in as the Oracle user and enter the following
command: sqlplus system/oracle@testme.
2.9.2
StarQuality can be installed on a Linux x86 operating system using the command-line installer. All operations should be done while logged in as root user.
To install StarQuality (Linux): 1 Run the installer application, StarQuality.v3.0.en.bin, either directly from the installation DVD or from a directory to which the file was transferred (using FTP). 2 Follow the next sections for installation details.
2.9.2.1
Basic Checks
The installer checks the following details: Version of the operating system Required packages Version of Perl and the options used to build the Perl binary,
StarQuality
103
User Manual
Installation
If the application detects an error during these checks, then depending on the level of error, it either immediately terminates or asks whether it should continue or not. Always answer No and restart the installation. --------------------------------------------------------------------------------------------------INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO INFO : Command line parameters: : Installer started : LOG file: /tmp/starquality.install.log : Checking perl version : Found perl: /usr/local/bin/perl : Checking OS type : Found Red Hat 5 : OS: Linux_x86 : Checking perl 32/64bit : Checking perl PerlIO : Perl was built with PerlIO : Checking perl threading : Perl threading enabled : Checking required packages : Package bash found : Package openssh found : Package grep found : Package tar found : Package gzip found : Package httpd found : Package sed found : Done : Checking required packages for the schematic map feature : Package libjpeg 32 bit found : Package freetype 32 bit found : Package libXpm 32 bit found : Package libXau 32 bit found : Package libXdmcp 32 bit found : Package libX11 32 bit found : Done : Checking the SELinux state
StarQuality
104
User Manual
Installation
INFO
: SELinux is disabled, OK
INFO : Keep in mind that the SELinux must not be activated when StarQuality is running INFO INFO INFO : Extracting files into the temp directory: /tmp/starquality : Done : Licence information
This program contains free of charge third party Java and Perl libraries. The detailed list of components, the detailed license files and sources can be found in the third party directory on the installer CD.
By answering Y you acknowledge that your use of these software is governed by the terms of the respective program licenses.
---------------------------------------------------------------------------------------------------
2.9.2.2
License Information
2.9.2.3

The application prompts for the operating system user used during the Oracle installation. After providing it, it tries to determine the value of the ORACLE_HOME environment variable using that user, and asks for confirmation. --------------------------------------------------------------------------------------------------QUESTION : The OS user of Oracle [oracle]: INFO : Found Oracle home: "/home/oracle/oracle/product/10.2.0/client_2"
QUESTION : ORACLE_HOME environment variable [/home/oracle/oracle/product/10.2.0/client_2]: INFO : Checking the Oracle home /home/oracle/oracle/product/10.2.0/client_2 INFO be OK INFO INFO INFO : Oracle home /home/oracle/oracle/product/10.2.0/client_2 seems to
: Checking Oracle version : Found Oracle version 10 : Detected 32-bit Oracle
QUESTION : StarQuality OS user name [starq]: QUESTION : StarQuality OS user group [starq]:
StarQuality
105
User Manual
Installation
QUESTION : StarQuality OS user password [******]: QUESTION : StarQuality installation directory below the /opt directory [starquality]: INFO INFO INFO : Creating group starq : Creating user starq with shell /usr/local/bin/bash : Setting the user password
INFO : Select user starq and group starq with directory /opt/starquality INFO : Checking the environment of starq
QUESTION : What is the profile file of the user starq [/opt/starquality/.bash_profile]: INFO : Setting the PS1 environment variable to "'[\u@\h]\$ '"
INFO : Setting the ORACLE_HOME environment variable to "/home/oracle/oracle/product/10.2.0/client_2" INFO : Setting the LD_LIBRARY_PATH environment variable to "/opt/starquality/lib:/home/oracle/oracle/product/10.2.0/client_2/lib" INFO : Setting the PATH environment variable to "/usr/local/bin:/home/oracle/oracle/product/10.2.0/client_2/bin:$PATH" INFO INFO INFO : Environment checking is done : Searching for running StarQuality modules : Oracle checking
QUESTION : TNS name []: QUESTION : Oracle host name [localhost]: QUESTION : Oracle port [1521]: QUESTION : Oracle service name []: QUESTION : Oracle SID []: QUESTION : Oracle SYSTEM user password []: CONFIRM INFO INFO INFO INFO : Confirm the password: : Attempting to tnsping db150 : Successful : Attempting to tnsping 192.168.10.101:1521 : Successful
INFO : Attempting to login to Oracle with the SYSTEM user and the TNS name db150 INFO INFO db150 INFO : Successful : Attempting to login to Oracle with the SYSTEM user and the SID
: Successful
StarQuality
106
User Manual
Installation
INFO : Attempting to login to Oracle with the SYSTEM user and the service name db150 INFO INFO INFO INFO INFO INFO INFO : Successful : Oracle checking successful : Configuring user SSH parameters : Done : Saving previous StarQuality config files : Untar StarQuality : Copy the define_wimax_brand.sql to the sql directory
-------------------------------------------------------------------------
2.9.2.4

------------------------------------------------------------------------WARNING WARNING : !!! YOU SHOULD ONLY ANSWER YES TO THE FOLLOWING QUESTION!!! : !!! IF YOU ARE INSTALLING AN ADDITIONAL (COLLECTOR) SERVER!!!
WARNING : !!! OR YOU ARE UPGRADING SUCH AN ADDITIONAL (COLLECTOR) SERVER!!! QUESTION : Are you installing a collector server (Y/N) [N]: -------------------------------------------------------------------------
StarQuality
107
User Manual
Installation
2.9.2.5
------------------------------------------------------------------------QUESTION : Do you want to configure the Apache WEB server (Y/N) [Y]: INFO : Configuring Apache
QUESTION : On which port should Apache listen [80]: QUESTION : On which port should Apache listen [80]: QUESTION : Where is the Apache apachectl file [/usr/sbin/apachectl]: QUESTION : Where is the Apache htpasswd file [/usr/bin/htpasswd]: QUESTION : Where is the Apache pid file [/var/run/httpd.pid]: QUESTION : Where is the Apache httpd.conf file [/etc/httpd/conf/httpd.conf]: INFO : Creating backup /etc/httpd/conf/httpd.conf.20110309-113933 from /etc/httpd/conf/httpd.conf INFO INFO INFO INFO : Stopping Apache : Creating a new /etc/httpd/conf/httpd.conf : Using basic authentication : Starting Apache
-------------------------------------------------------------------------
2.9.2.6

The installer application places scripts in the appropriate folder so that StarQuality can be automatically started and stopped. Automatic start/stop in this case does not include Oracle. If you are not installing a data collector server then the installer asks whether the Oracle has to be automatically started and stopped by the same script as well. You should only answer Yes if the Oracle server is running on the same machine and there is no other script to start and stop Oracle. If the Oracle server is running on the same machine but such a script
StarQuality
108
User Manual
Installation
already exists then you have to make sure that StarQuality starts after the Oracle server and stops before the Oracle server. This question is among the few yes-no questions for which the installer stores the given answer and sets the default to your previous answer when running a second time, and can accept this default answer in silent mode automatically.
QUESTION : Should this script start/stop the Oracle server as well (Y/N) [Y]: WARNING : !!! IF THE ORACLE RUNS ON THIS SERVER THEN MAKE SURE THAT !!! WARNING WARNING INFO INFO INFO INFO : !!! IT STARTS BEFORE THE APPLICATION AND STOPS AFTER THE : !!! APPLICATION : Creating sym link /etc/rc0.d/K01starquality : Creating sym link /etc/rc6.d/K01starquality : Creating sym link /etc/rc3.d/S99starquality : Creating sym link /etc/rc5.d/S99starquality !!! !!!
-------------------------------------------------------------------------
2.9.2.7
QUESTION : StarQuality Conf tablespace name [SQ_CONF]:
StarQuality
109
User Manual
Installation
QUESTION : StarQuality Conf tablespace file [D:\ORACLE\ORADATA\DB150\SQ_CONF.dbf]: QUESTION : StarQuality Conf tablespace size [300M]: INFO ERROR : Creating the tablespace SQ_CONF, this could take several minutes : The tablespace SQ_CONF already exists
QUESTION : The tablespace SQ_CONF already exists, do you whish to continue (Y/N) [Y]: QUESTION : StarQuality Data tablespace name [SQ_DATA]: QUESTION : StarQuality Data tablespace file [D:\ORACLE\ORADATA\DB150\SQ_DATA_01.dbf]: QUESTION : StarQuality Data tablespace size [10000M]: INFO ERROR : Creating the tablespace SQ_DATA, this could take several minutes : The tablespace SQ_DATA already exists
QUESTION : The tablespace SQ_DATA already exists, do you whish to continue (Y/N) [Y]: QUESTION : StarQuality Oracle user name [SQ]: QUESTION : StarQuality Oracle user password [******]: INFO ERROR : Creating the Oracle schema, this could take several minutes : The user SQ already exists
QUESTION : Do you want to continue with the schema creation (Y/N) [Y]: INFO : Oracle user SQ created
-------------------------------------------------------------------------
2.9.2.8

-------------------------------------------------------------------------
To load a licence and run StarQuality, refer to Loading a StarQuality Licence on page 114
StarQuality
110
User Manual
Installation
Running StarQuality
2.10
Running StarQuality
2.10.1 Running StarQuality on Windows

To start the server following initial installation: 1 Open a Cygwin shell and enter the command (by default it is not required to start it manually): /usr/sbin/apachectl start
NOTE If the Apache is started this way, the Cygwin shell should remain open. Closing it will cause the Apache service to shut down.
2 3
Open a web browser and go to http://<ip or hostname>/. Enter User Name and Password. The default admin users credentials are: admin admin123 The StarQuality opening window is displayed for a few seconds and then the main interface window opens.
From Settings select Servers > Licenses. The Licences Configuration window is displayed. The entries marked red indicate missing or invalid licences that should be replaced.
If necessary, load a new license file using the WEB GUI (See To load a licence: on page 114.)
Do one of the following: In the computer service management window (myComputer > Manage > Services) start the services 'CYGWIN sshd' and 'StarQuality service'.
In the WEB GUI, from Settings select Servers > Start/Stop/Status, click [start all]. Wait for the list to refresh. Return to the cygwin shell and enter the command:
StarQuality
111
User Manual
Installation
Running StarQuality on Windows
/opt/starquality/bin/start_stop_pvsr start 7 In the WEB GUI, from Settings select Server > Start/Stop/Status, click [check all], wait for all the entries to refresh and verify that all the entries are green.
Figure 2-65: Server Status Window
To stop the StarQuality server: 1 Do one of the following:
In the computer Service Management window (myComputer > Manage > Services) stop the service 'CYGWIN sshd'. Open a Cygwin shell and enter the commands: /usr/sbin/apachectl stop /opt/starquality/bin/start_stop_pvsr stop In the WEB GUI, from Settings select Servers > Start/Stop/Status, click [stop all]. Wait for the list to refresh.
StarQuality
112
User Manual
Installation
Running StarQuality on Solaris
In the WEB GUI, from Settings select Servers > Start/Stop/Status, click [check all], wait for all the entries to refresh and verify that all the entries are red.
2.10.2 Running StarQuality on Solaris

To start the server following initial installation: 1 While logged in as root user enter the command (by default it is not required to start it manually): /usr/apache/bin/apachectl start Actual path may vary according to the Apache configuration. See Apache Configuration on page 68. 2 3 Open a web browser and go to http://<ip or hostname>/. Enter User Name and Password. The default admin users credentials are: admin admin123 The StarQuality opening window is displayed for a few moments and then the main interface window opens. A message alerting a missing licence may appear, click OK and load a licence (see Step 5). 4 From Settings select Servers > Licenses. The Licences Configuration window is displayed. Check that all the entries are not marked red, which indicates invalid licences that should be replaced. 5 If necessary, load a new license file using the WEB GUI (see Loading a StarQuality Licence on page 114) 6 Do one of the following:
Return to the StarQuality server machine console and enter the command: /etc/init.d/starquality start In the WEB GUI, from Settings select Servers > Start/Stop/Status, click [start all]. Wait for the list to refresh.
StarQuality
113
User Manual
Installation
Loading a StarQuality Licence
In the WEB GUI, from Settings select Servers > Start/Stop/Status, click [Check all], wait for all the entries to refresh and verify that all the entries are green.
To stop the server: 1 While logged in as root user enter the command: /usr/apache/bin/apachectl stop Actual path may vary according to the Apache configuration. See Apache Configuration on page 68. 2 Do one of the following:
Return to the StarQuality server machine console and enter the command: /etc/init.d/starquality stop In the WEB GUI, from Settings select Servers > Start/Stop/Status, click [stop all]. Wait for the list to refresh. 3 In the WEB GUI, from Settings select Servers > Start/Stop/Status, click [check all], wait for all the entries to refresh and verify that all the entries are red.
2.10.3 Loading a StarQuality Licence

To load a licence: 1 2 Place the licence file on the computer from which you activated the client. From Settings select Servers > Licenses. The Licences Configuration window is displayed. 3 4 5 6 Click [Add new] and browse for the file containing the license. Click OK. A list detailing the licenses is displayed. Verify that none of the entries in the license list are colored red. Press Ctrl-C on the keyboard, followed by Enter.
StarQuality
114
User Manual
Installation
Configuration Parameters
2.10.4 Configuration Parameters

If you are using 4Motion devices, depending on their versions, you may need to set up StarQuality accordingly. For details, see 4Motion on page 308. Choose wether StarQuality should store the raw XML performance collection files generated by WiMAX devices. See Performance Collection Files on page 146 for details. Keep in mind that the maximum number of measurements for a single collector is 370,000. See Activation/Deactivation of Data Collection on page 144 for details on running the collectors. Contact Alvarions customer service for more information.
2.10.5 Data Aggregation and Data Retention Settings

By default, StarQuality stores measurements received in the performance collection files in 15 minutes cycles for 31 days. After that, data is archived in hourly averages. The hourly averages are deleted after 340 days. In high load scenarios, it is recommended to perform custom database sizing and configuration. For details, please contact Alvarion Professional Services.
StarQuality
115
User Manual
Installation
StarQuality Upgrade
2.11
StarQuality Upgrade
The upgrade has to be performed by an administrator user. For information on available upgrade paths, see the Release Notes. Stop the StarQuality service and processes prior to upgrade.
IMPORTANT If you are running an upgrade, the installer may not keep the StarQuality files or existing collected data. Therefore, prior to upgrade, make sure to check the Release Notes for version specific information.
2.11.1 StarQuality Upgrade on Windows

To upgrade StarQuality (Windows): 1 Perform Stop Services as follows: a b c 2 On the desktop right-click My Computer and select Manage . Select Services and Applications > Services. Right-click on StarQuality Service and select Stop
Follow the installation instructions on the screen. The wizard runs as in the regular installation procedure until it reaches the StarQuality Schema Update window, which indicates that this is an upgrade. Click Next.
StarQuality
116
User Manual
Installation
StarQuality Upgrade on Windows
Figure 2-66: StarQuality Schema Update Window
Figure 2-67: Setup Message 4 Click OK to the Setup message and wait for the installation to complete. Click Finish. 5 Proceed as in regular installation:
Load a new licence that matches the new version (see To load a licence: on page 114)
NOTE Depending on what license is present before the upgrade, the new license might deactivate the collection on certain collectors; Click Reactivate eqs in the Licence Configuration Window to start the collection on all devices (see Figure 2-66). A message will appear showing how many devices were activated.
Start the servers (see To start the server following initial installation: on page 111)
StarQuality
117
User Manual
Installation
StarQuality Upgrade on Solaris
2.11.2 StarQuality Upgrade on Solaris

The upgrade has to be performed by an administrator user. Upgrade is available between immediate/adjacent versions only. Stop the StarQuality service and processes prior to upgrade. This also stops the Oracle database, so you must start the database back manually prior to upgrade.
To upgrade StarQuality (Solaris): 1 Perform Stop Services as follows: a While logged in as root user enter the command: /usr/apache/bin/apachectl stop Actual path may vary according to the Apache configuration. See Apache Configuration on page 77. b Enter the command: /etc/init.d/starquality stop 2 3 Run the installer application, StarQuality.v3.1.en.bin Press Ctrl-C on the keyboard, followed by Enter.
2.11.3 Configuration Parameters

4 Follow the installation prompts and enter:
OS user of Oracle ORACLE_HOME environment variable StarQuality OS user name Oracle host name [localhost]: Oracle port Oracle service name Oracle SID Oracle SYSTEM user password
StarQuality
118
User Manual
Installation
Configuration Parameters
The system runs DB update scripts.
StarQuality
119
User Manual
Installation
Uninstalling StarQuality
2.12
Uninstalling StarQuality
2.12.1 Uninstalling StarQuality from Windows

During the uninstallation the application asks whether it should delete the different components. If you want to keep a module which is dependent on another module, the application will not even ask to remove the other module. For example if you do not want to remove the bash symbolic link, it will not remove the Cygwin installation. The only exception to this rule is the Oracle user: you can choose to keep it, but nevertheless the application will be uninstalled. The uninstaller only drops the Oracle user and the tablespaces.
To uninstall StarQuality from Windows: 1 Run the UninstallStarQuality.exe in the Cygwin root directory or select Start > Settings > Control Panel > Add or Remove Programs. 2 Fill in the SYSTEM password (oracle) and click Uninstall.
Figure 2-68: Uninstalling the Oracle User
StarQuality
120
User Manual
Installation
Uninstalling StarQuality from Solaris
2.12.2 Uninstalling StarQuality from Solaris

To uninstall StarQuality from Solaris: 1 2 Log on to the StarQuality machine as root. Stop any running StarQuality module: a b 3 From Settings select Servers > Start/Stop/Status. Click [stop all] and wait untill all the entries of the list are red.
In a command window, run UninstallStarQuality from the StarQuality installation directory (default /opt/starquality).
The application prompts for various confirmations. Follow the instructions and questions on the screen.
StarQuality
121
User Manual
Installation
Uninstalling StarQuality from Solaris
Figure 2-69: Uninstalling StarQuality from Solaris
StarQuality
122
User Manual
Chapter
Getting Started
Getting Started
In this chapter:
Login on page 125 The Structure of Interface Windows on page 127 The Menu System on page 128 Operations and Navigation in the Hierarchy on page 132 General Display Options on page 134 Editing Objects on page 136
StarQuality
124
User Manual
Getting Started
Login
3.1
Login
10 working clients may simultaneously use the system. Using the system is possible with the following web browsers: Microsoft Internet Explorer Mozilla Firefox
To start a client session with StarQuality: 1 2 Open a web browser and go to http://<ip or hostname>/. Enter User Name and Password. The default admin users credentials are: admin admin123 The StarQuality opening window is displayed for a few moments and then the main interface window opens (see Figure 3-2). If Flash Player is not installed on the machine from which the client is opened, the following message appears:
Figure 3-1: Flash Player Message Window You can install Flash to display data with Flash functionality. If you do not install Flash, the data is displayed without Flash features. 3 You can proceed with discovering the network (see Network Discovery on page 137), modify settings or start monitoring the equipment.
StarQuality
125
User Manual
Getting Started
Login
Alarm Overview and Log Out Main menu Submenu panel
Browser
Work Area
Figure 3-2: The StarQuality User Interface
StarQuality
126
User Manual
Getting Started
The Structure of Interface Windows
3.2
The Structure of Interface Windows

The interface of the StarQuality application divides the browser window into several panels (see Figure 3-2): Alarm overview bar - displays current alarms, grouped by their severity level. This also acts as a shortcut to the alarm screens. The application displays only alarms that the user has permissions to view. If access to alarms is unavailable, the bar is completely missing. The main menu - contains the main operation tasks of the system: Alarms, Measurements, Reports, and Settings. Selecting each item on this menu opens various submenus and groups displayed in the submenu panel and in the browser. For detailed structure, refer to The Menu System on page 128. Submenu panel - the submenus under the selected menu item are displayed on the adjoining right hand side panel. This panel can be scrolled (up and down) using the arrows on its right edge. The submenu structure displayed here can be customized in order to accelerate the execution of frequently repeated navigation steps. The browser - located on the bottom left side of the user interface. The browser can contain further submenu items and special menu groups based on the chosen menu items in the upper menu system. Non-administrator users can only view those alarms/pieces of equipment/sites for which they have permissions. Refer to User Types and Their Settings on page 6. The user name and type appears in the title of the web browser window.
StarQuality
127
User Manual
Getting Started
The Menu System
3.3
The Menu System

The following sections describe the main menu, the submenus under it and the menu items and groups appearing in the browser. These items vary depending on the selected item in the main menu. For example: Time Span is displayed only when selecting Measurements or Alarms in the main menu (see Figure 3-3.
3.3.1
Main menu Tabs
Measurements
Sub-menus
Items in Browser
Figure 3-3: Example of Menus, Submenu Panel and Browser (in Measurements) Items in the submenu panel:
Search for sites, equipments, measurements and charts on the basis of sites/equipment names (see Searching Measurements on page 178) Root - root directory navigation startpoint If defined, public and private menu items for viewing the measurements under the chosen menu item
StarQuality
128
User Manual
Getting Started
Alarms
Items in the Browser:
View menu group: Selecting the mode of display for the measurements (see Measurements Display Options on page 169) Time Span: Selecting the time range to display measurements:
from time/date to time/date day/week/month/year real time view - auto refresh view
Chart Settings - displaying the measurement values Elements menu group: This menu contains a list of the sites, equipments and measurement types. The root of the hierarchy is determined by the originally selected menu item (see Viewing Measurement Data on page 174).
Element name, e.g. <FDD Network> - If the list contains too many
elements, they are grouped by the system, using links pointing to the sub-lists.
Measurement Types - for filtering the measurements by their types
3.3.2
Alarms
Items in the submenu panel:
Root - root directory navigation startpoint If defined, public and private menu items for viewing the alarms under the chosen menu item
StarQuality
129
User Manual
Getting Started
Reports
Time Span: Selecting the time range to display alarms (see Viewing Alarms by Time Span on page 208):
from time/date to time/date day/week/month/year real time view - auto refresh view
View menu group: Choosing the display mode for the alarms (see Alarm View Options on page 208) Filters menu group: Filtering of the alarms to be displayed (see Filtering Alarms on page 212)
3.3.3
Reports
Items in the submenu panel:
On-demand report - setting a new report (see On-Demand Reports on page 224) Bulk export wizard - exporting reports to Excel (see Bulk Export Wizard Exporting Data to XLS Files on page 232) Direct links to the built-in reports (see Built-in Reports on page 217)
Calendar: The reports are displayed with respect to the time interval selected in the calendar. Settings: appear only when displaying reports, include:
Type Show date column

Refer to Setting the Report Range and Display on page 229
StarQuality
130
User Manual
Getting Started
Settings
3.3.4
Settings
For each item in the submenu panel, different items appear in the Browser. For non-administrator users, the submenus used to make changes are not displayed, and the other submenus are displayed selectively based on the access rights of the user. Search: Searching the configured objects based on sites/equipment names [see Search (Admin only) on page 243). Site and equipment configuration: Configuring basic and virtual sites and equipment objects Thresholds (admin only): Setting alarm threshold parameters (see Setting Alarm Thresholds on page 185). Scheduled configurations (admin only): Automatically scheduled configurations that the Job queue module could not yet execute successfully (see Scheduled Configuration on page 160) Reports (admin only): Setting and viewing system reports (see Reports on page 215 Customization: editing of public objects refers to the administrator users, while editing of private objects refers to the rest of the users (Customization on page 259): Templates (admin only): Editing various system templates (see Creating and Editing Threshold Templates on page 188) Servers (admin only) (see Server Configuration and Management (Admin only) on page 262): Audit trail (admin only): Displaying the individual configuration modifications (see Audit Trail on page 277) User: Managing user settings (see User Administration (Admin only) on page 280)
StarQuality
131
User Manual
Getting Started
Operations and Navigation in the Hierarchy
3.4

In Alarms, Measurements and Reports pages (and also under the Settings > Site and Equipment Configuration submenu) there are three elements at the top of the page. These fields are always visible (even if the page is scrolled): The Operations pull down menu (located at the top-right), contains different options depending on the current object and menu item (see Figure 3-4):
Fast navigation between the menu items while keeping the actual location within the hierarchy; for example, immediate opening of the measurement charts form the equipment configuration.
A Print option for Alarms, Measurements and Reports, because this is the only possible way to print the full content of the main display area (the basic print function of the browser is not suitable for this)
For Measurements, an option to save the current object as a menu item
Figure 3-4: Example of Operations pull down menu A path (at the top-left) showing the current location within the hierarchy. It is always possible to click on the elements of this list, except for the last one, and return to a higher hierarchy level.
Figure 3-5: Hierarchy Path
StarQuality
132
User Manual
Getting Started
If during the navigation you access an equipment through one of its virtual sites then after any equipment modification you cannot get back to that point in the virtual hierarchy, because the application will modify the current location according to the normal hierarchy, i.e. it will show the equipment under its parent site. Notice that by using the fast navigation between the menu items (see the above bullet), the current location within the hierarchy might change: although the page will show the selected object, the path shown to the root object might be incorrect.
StarQuality
133
User Manual
Getting Started
General Display Options
3.5
3.5.1
General Display Options

Scrolling or Hiding the Submenu Items
If the name of a menu item is too long to display, it is abbreviated. To view the entire text as a tooltip, move the mouse pointer over it. To hide the entire menu system, click on the icon at the top-right corner of the panel (Figure 3-6). In this case the component can only be viewed if the mouse pointer is placed above it. To cancel the automatic hiding of the panel, click on the hiding icon again.
Hiding submenu
Scrolling submenu
Figure 3-6: Scrolling and Hiding the Submenu
3.5.2
Using the Display Tabs

You can work with several open pages at the same time. The current page or pages currently in use are displayed as tabs. You navigate the opened pages with the tabs on the top of the pages. The selected page always comes up in the front. The tabs can also be scrolled horizontally.
Minimize/maximize tab area
Tabs
Tabs navigation
Figure 3-7: Navigation Tabs
StarQuality
134
User Manual
Getting Started
Using the Display Tabs
When a page is put in the background, the browser window stores its content that is subsequently restored when the user chooses to display that page again. If you select a menu item, the requested page is displayed instead of the current page. However, it is also possible to load the new page in a new tab. This is the default option when using the Alarms fast menu, while in the configurable menus you can select whether the new page should be displayed in a new or in an already existing tab.
To set the tab display options: Use the following options to set the tabs display: Table 3-1: Setting the Tab Display Options To
Select the tab display mode
Do this:
Right-click on the menu items and select either Open in a new tab or Open in tab: <already existing_tab_name>. Click the tab title, type the name and press Enter. Use the icon at the top-right corner (see Figure 3-7)
Rename the tab Maximize/minimize the page to entire window
StarQuality
135
User Manual
Getting Started
Editing Objects
3.6
Editing Objects
This section explains the general editing principles of the system. The various possibilities of editing different kinds of objects are discussed in detail in the corresponding sections. The list of editable objects is displayed in a table that, with the exception of the Site-equipment-measurement Configuration page, contains the most important attributes of the objects. In the Settings menu you can edit the various objects of the system.
To edit objects: Use one of the following options, when available: Table 3-2: Editing Objects To
Delete an object (only if it has no sub-elements)
Do this:
Click [del]
Comments
The system always prompts to confirm the action before it is executed. Click OK or Cancel
Modify an oblect Create a new simple object Create objects based on a template Create objects based on another object Perform other editing operations
Click [edit] and modify the parameters Click [add new] Click [from template] Click [copy from] Use the pull down menu available on the screen
Applicable in case of normal and virtual sites.
StarQuality
136
User Manual
Chapter
Network Discovery
Network Discovery
In this chapter:
Overview on page 139 Discovery of WiMAX Devices on page 142 Discovery of Equipment under a Server-Health Site on page 148 Scheduled Configuration on page 160
StarQuality
138
User Manual
Network Discovery
Overview
4.1
Overview
At first login, the system contains only a ROOT site. You build your new network (sites) under the ROOT to be able to start monitoring your equipment performance using the StarQuality. Mapping the network in StarQuality can be done using various structures, such as by geographical locations, by topics, etc. This section explains the creation of a a WiMAX network and all the BTSs under it, and creating a utility network. Following are available site types: WiMAX-equipment
WiMAX FDD SNMP - FDD versions 3.5/3.6, SNMP data collection. Up to 10 SUs per BTS can be measured WiMAX FDD TFTP - FDD version 3.7, TFTP data collection WiMAX TDD - TDD versions 4.5 and later, TFTP data collection 4Motion - version 2.5M, 3.0 and 3.0M BreezeACCESS VL - version 6.0. Up to 10 SUs per BTS can be measured Extreme - version 1.5
Server Health
AlvariSTAR Version 4.0 and later Oracle UNIX
The measurements can be viewed not less than 30 minutes following the initial collection for each device. For more information on configuration, refer to Chapter 9 - General Setting Options on page 238.
StarQuality
139
User Manual
Network Discovery
Overview
To create a WiMAX network site under ROOT: 1 2 From Settings select Site and Equipment Configuration. From the Creation drop-down menu select Create New Site. Fill in the site name (free text), and its description (optional). 3 4 Select a corresponding icon. Select a Server Group (see Figure 4-1):
For FDD 3.5/3.6 network - WiMAX FDD For FDD 3.7 network - WiMAX FDD TFTP For TDD network - WiMAX TDD For 4Motion (ver.2.5) network - WiMAX 4Motion For Extreme network - WiMAX Extreme For VL network - WiMAX VL
Figure 4-1: Creating a New Site - Server Group Selection 5 6 Click OK; The network site is created under the ROOT. Proceed with discovery of devices according to the site type you created: refer to Discovery of WiMAX Devices on page 142.
StarQuality
140
User Manual
Network Discovery
Overview
To create a Server Health site under ROOT: 1 2 From Settings select Site and Equipment Configuration. From the Creation drop-down menu select Create New Site. Fill in the site name (free text), and its description (optional). 3 4 5 6 Select a corresponding icon. Select the SNMP Server Group (see Figure 4-1). Click OK; The site is created under the ROOT. Proceed with discovery of devices according to the site type you created: refer to Discovery of Equipment under a Server-Health Site on page 148
StarQuality
141
User Manual
Network Discovery
Discovery of WiMAX Devices
4.2

This section describes how to add BTSs to the network. Data collection is automatically activated after discovery, except for equipments collected by SNMP, for which data collection has to be activated manually.
To perform actual discovery: 1 2 From Settings select Site and Equipment Configuration. Enter the site matching the equipment type to be discovered, by clicking its icon. 3 From the Creation drop down menu select Add Equipments (plural) from Template. 4 Select the template upon which to base the equipment setup:
For FDD ver3.5/3.6 - WiMAX FDD SNMP For FDD ver3.7 - WiMAX FDD TFTP For TDD - TDD For 4Motion - WiMAX 4Motion For VL - WiMAX VL For Extreme - WiMAX Extreme
A basic setup template page is displayed.
NOTE Each discovery can include a single equipment type. Equipment with names or IP addresses that is already monitored is not rediscovered.
StarQuality
142
User Manual
Network Discovery
Figure 4-2: Creating New Equipments from Template - WiMAX FDD 5 6 In the Creation section make sure the Equipment option is selected. In the Discover Equipments field select either:
No - to add equipments manually (see Step 8) Input File - to upload a text file (See Step 9)
The Yes option is not applicable for WiMAX equipment. 7 In the Community section, override the Read community setting with the relevant one for your network. 8 If you selected No: a b c Click OK ; the system returns to the main network list. Click [Add new] to add as many equipments as required. In each line enter: BTS name (free text up to 46 characters), site name, description and IP address (see Figure 4-3). Name and IP address are mandatory.
NOTE
Searching and displaying of devices in StarQuality is done by names only, therefore it is advised
to keep a systematic naming convention, for example, it is recommended to name each device by its IP.
StarQuality
143
User Manual
Network Discovery
Activation/Deactivation of Data Collection
If you selected Input File: a Prepare a text file, in which each line signifies a BTS. Each line entry includes three columns in the following order: equipment name, equipment description (optional); IP address and Site name (optional). Allowed delimiters: semicolon (;) or tab. Save it as a .txt type file. b c In the StarQuality application click Browse to select this file. Click OK; the system returns the imported equipment into an editable table as shown below:
Figure 4-3: Adding Equipment from an Input File d Make any adjustmens by editing the table. You can add new entries, delete existing entries or modify their content. 10 Click OK; the system searches and discovers each existing and online BTS. For each discovered BTS a success message appears; For each unsuccessful discovery an error massage is displayed and the system continues to the next device. 11 When the discovery is complete, click Back to return to the network site. 12 Verify that all the equipments are not colored red, which means that their data is being collected. 13 Verify that for each BTS, a matching site has been created, named as the BTS with the postfix SUs (i.e, <btsname SUs>). 14 In case of BTS SNMP collection (FDD 3.5/3.6 or BreezeACCESS VL), this SU site is colored red, which means that no SU under it are being collected yet. In this case, activate Data Collection for up to 10 SUs as described in Section 4.2.1 below.
4.2.1

When you create a site, data collection is by default activated for all AUs and SUs (except for SNMP - FDD ver3.5/3.6 and BreezeACCESS VL SUs).
To activate or deactivate data collection for any equipment type:
StarQuality
144
User Manual
Network Discovery
1 2
Click the site icon to enter the site. For each equipment repeat the following: a Click [edit] next to the equipment you want to activate. The following window is displayed (measurement types themselves may vary according to the specific equipment: SU, BTS, Server Health element):
Figure 4-4: Activating Data Collection b Select or deselect the Collect Data checkbox at the bottom of the upper table. c Select or deselect the measurements you want to activte/deactivate in the lower table . d e Click OK. Go back one level in the navigation path and verify that the equipment line line is no longer red (acivated) or is red if deactivated (Figure 4-5).
StarQuality
145
User Manual
Network Discovery
Performance Collection Files
Navigation path
Collection Not Activated
Collection Activated
Figure 4-5: Data Collection Status
4.2.2

WiMAX devices generate performance collection files in cycles of 15 minutes. To set up wether StarQuality should keep the performance collection files: 1 2 Go to /opt/starquality/etc/ and open the CONFIG_INI.pm file. Set the $WIMAX_KEEP_XML_FILES parameter to 1 to enable performance files or to 0 to disable them (default). 3 4 Save the CONFIG_INI.pm file. Restart all the collectors.
Each XML performance collection file is kept in the /opt/starquality/tmp/xml_archive directory.
4.2.2.1
Setting the Delay Parameter on 4Motion Base Stations

On 4Motion base stations, the Delay parameter establishes a time span between the moment a cycle ends, and the time it can be imported into StarQuality instead of the previous cycles file. For instance, if the delay is set to 2 minutes, the cycle that ended at 16:15 is read by StarQuality at 16:17. Until then, StarQuality only reads the 16:00 cycle. The purpose of this setting is to compensate for any delays
StarQuality
146
User Manual
Network Discovery
the device may have in building the performance collection file. All the time values are in reference to the equipments time. You can set both a generic delay for all equipment and specific delays for individual devices if you wish to override the generic delay: To set a generic delay parameter, in the CONFIG_INI.pm file, set the
$WIMAX_4Motion_DELAY parameter to the desired delay duration expressed in
seconds. In the example above, the 2 minutes delay is set as: $WIMAX_4Motion_DELAY=120 By default, the $WIMAX_4Motion_DELAY parameter is set to 0 (no delay). To set the delay parameter for a specific device: 1 2 3 4 5 Go to Settings > Site and equipment configuration Click the site icon to enter the site. Click edit next to the equipment you wish to configure. Fill in the Delay (sec) parameter with the desired value. Click OK.
4.2.2.2
Setting the Timeout and Retry Parameters for 4Motion TFTP

For 4Motion TFTP devices, you may set generic timeout and retry parameters for importing the performance collection files. The Retry parameter indicates for how many times StarQuality reattempts to import the file in case of failure after the initial attempt (a value of 3 means 1 try and maximum 3 retries for a maximum total of 4 attempts). The Timeout parameter indicates for how many seconds to wait between consecutive retries. These parameters are set in the CONFIG_INI.pm file: $WIMAX_4Motion_TFTP_INTERVAL - Timeout interval in seconds. The default value is 80. $WIMAX_4Motion_TFTP_RETRY - Number of retries. The default value is 3. The parameters above are generic. If you set different timeout and retries values for specific base stations, from their corresponding edit screens, these values override the settings in the CONFIG_INI.pm file.
StarQuality
147
User Manual
Network Discovery
Discovery of Equipment under a Server-Health Site
4.3

This section describes how to add equipment related to server health to the StarQuality and initiate the data collection from them. For these equipment types, only a single device is discovered each time; that is, there is no multiple discovery. You can use a template or create new equipment from scratch. The procedures in this section describe the recommended way of creating equipment from templates. For more information refer to Site and Equipment Configuration on page 244, and Discovery of WiMAX Devices on page 142.
To add AlvariSTAR server: 1 Make sure the following prerequisites are available:
Setup and configuration:
Network connection between StarQuality and AlvariSTAR machines AlvariSTAR ver4.0 and later
Information:
AlvariSTAR machine IP address Read community of AlvariSTAR SNMP server (if not changed, default is:
public) 2 3 4 5 6 From Settings select Site and Equipment Configuration. Click the Server Health icon to enter its site. From the Creation drop down menu select Add Equipment from Template. Select the template upon which to base the equipment setup: AlvariSTAR. Click OK. A basic setup template page is displayed.
StarQuality
148
User Manual
Network Discovery
Figure 4-6: Creating New Equipment - AlvariSTAR 7 Fill in the required information (for parameter information and description refer to Discovery of WiMAX Devices on page 142):
Name and description - free text IP address: <ip address>:<16162> Community: public Leave all other fields with their default values.
Click OK; Discovery is running and can take up a few minutes. The following window is displayed. The green field means that collection is activated by default.
StarQuality
149
User Manual
Network Discovery
Figure 4-7: Data Collection Active 9 If you wish to edit the specific counters collected, select Modify Equipment from the Operations drop-down menu. 10 choose specific measurements or all measurements by selecting the corresponding check-boxes. 11 Scroll down and click OK to implement changes.
StarQuality
150
User Manual
Network Discovery
To add an Oracle database server: 1 Make sure the following prerequisites are available:
Network connection between StarQuality and Oracle machines
Information:
Oracle TNS name - in case StarQuality and Oracle are on the same
machine: Oracle server TNS; in case StarQuality and Oracle are on separate machines: Oracle client TNS (TNS name is defined in the file tnsnames.ora placed in the directory: ORACLE_HOME\NETWORK\ADMIN
Password of Oracle SYSTEM user

2 3 4 5 6 From Settings select Site and Equipment Configuration. Click the Server Health icon to enter its site. From the Creation drop-down menu select Add Equipment from Template. Select the template upon which to base the equipment setup: Default Oracle. Click OK. A basic setup template page is displayed.
StarQuality
151
User Manual
Network Discovery
Figure 4-8: Default Oracle Template 7 Fill in the required information (for parameter information and description refer to Discovery of WiMAX Devices on page 142):
Name and description - free text Connection: <TNS name> User: system Password: SYSTEM password Right: SYSDBA/SYSOPER/Normal, according to security preferences Leave all other fields with their default values
Click OK; Discovery is running and can take up a few minutes. The following window is displayed. Red fields mean that collection is not activated by default.
StarQuality
152
User Manual
Network Discovery
Figure 4-9: Network Discovery Results (Oracle) 9 To start collecting select from the Operations drop-down menu Modify Equipment. The following window is displayed.
StarQuality
153
User Manual
Network Discovery
Figure 4-10: Activating Data Collection (Oracle) 10 Change Server Group to Oracle, and choose specific measurements or all measurements by selecting the corresponding check-boxes. 11 Scroll down and click OK to implement changes. The Server field turns green which indicates that collection is active.
StarQuality
154
User Manual
Network Discovery
Figure 4-11: Data Collection Active (Oracle)
To add equipment under the UNIX/Linux site: 1 Make sure the following prerequisites are available:
Network connection between StarQuality and UNIX machines
Information:
IP address of UNIX machine UNIX user name and password. The prompt for the user used for
discovery must have the following pattern: end with a space or have a >, #, %, or $ character followed by a space. 2 3 From Settings select Site and Equipment Configuration. Click the Server Health icon to enter its site.
StarQuality
155
User Manual
Network Discovery
4 5
From the Creation drop down menu select Add Equipment from Template. Select the template upon which to base the equipment setup: Default Unix/Linux.
Click OK. A basic setup template page is displayed.
Figure 4-12: Default Unix/Linux Template 7 Fill in the required information (for parameter information and description refer to Discovery of WiMAX Devices on page 142):
Name and description - free text IP address: <ip address> User: <root> Password: <root password> Leave all other fields with their default values
Click OK; Discovery is running and can take up a few minutes. The following window is displayed. Red fields indicate that collection is not activated by default.
StarQuality
156
User Manual
Network Discovery
Figure 4-13: Network Discovery Results (Unix/Linux)) 9 To start collecting select from the Operations drop-down menu Modify Equipment. The following window is displayed.
StarQuality
157
User Manual
Network Discovery
Figure 4-14: Activating Data Collection (UNIX) 10 Change Server Group to Unix/Linux, and choose specific measurements or all measurements by selecting the corresponding check-boxes. 11 Scroll down and click OK to implement changes. The Server field turns green which implies that collection is active.
StarQuality
158
User Manual
Network Discovery
Figure 4-15: Data Collection Active (UNIX)
StarQuality
159
User Manual
Network Discovery
Scheduled Configuration
4.4
In case the equipment is not available when you edit the configuration (discovery), you can display the configuration details using the Scheduled Configuration page from Settings. Restricted administrators can view or edit a scheduled configuration only if they have permission to its parent site.
To set the equipment for scheduled discovery: 1 Follow the steps in To perform actual discovery: on page 142, with the following change:
Figure 4-16: Setting Discovery to a Schedule 2 In the Creation section select either:
Job - the system creates scheduled jobs based on the parameters but does not run them Job creation and run - the system creates scheduled jobs based on the parameters and runs them immediately. If the equipment creation for a job is not successful, it is not deleted, and therefore the Job queue server component can try it later.
3 4
Define the Run Cycle. In the Discover Equipments field select No - to add equipments manually.
StarQuality
160
User Manual
Network Discovery
5 6
Define the Community. Click OK.
To use the Scheduled Configuration: 1 From Settings select Scheduled Configuration; The Scheduled Configuration table is displayed, with the following columns: Table 4-1: Scheduled Configuration Item
Links
Description [edit] - the entry can be edited [del] - the entry can be deleted
[now] - the system is trying to instantiate the configuration belonging to the entry immediately and does not wait for the next cycle
Site name Template name Equipment name Equipment description IP address Community Keep data for days Default interval Next run Run cycle (minutes)
The equipment will be placed to this site The system will instantiate the equipment using this template The same name as in the manual creation of the equipment The same as in the manual creation of the equipment equipment IP address Equipment read SNMP community The value of the appropriate equipment parameter The value of the appropriate equipment parameter The next time the system will try to configure the the equipment In case of an unsuccessful attempt, the time period (in minutes) before retrying
StarQuality
161
User Manual
Network Discovery
Figure 4-17: Scheduled Configuration 2 Do one if the following:
To modify the task parameters, click [edit]; The same parameters (except for the retrying time) can be modified as at template based creation. The IP address, SNMP Community and SNMP version fields are also displayed.
To delete a scheduled task, click [del] To try and execute the entry immediately and not wait for the next run, click [now].
StarQuality
162
User Manual
Chapter
Viewing Measurements
In this chapter:
Introduction on page 165 WiMAX Equipment Measurements on page 167 Measurements Browsing Options on page 168 Measurements Display Options on page 169 Viewing Measurement Data on page 174 Searching Measurements on page 178 Saving Items as A Submenu on page 181 Setting Trendlines to Graphs on page 182
StarQuality
164
User Manual
Introduction
5.1
Introduction
Viewing measurements is available using a configurable quick menu at the top panel for displaying and navigation. New elements can be added to the page using the Settings > Customization menu (see Customization on page 259). The Browser is also available for displaying, navigation and filtering in the site-equipment-measurement hierarchy, and it shows the measurements according to the measurement type. Only those objects (sites, equipments, or measurements) for which the user has permissions are accessible. The figure below shows the Browser and the Icon view of the selected hierarchy level (Root).
Figure 5-1: The Measurements Main Menu Item with the Browser and the Icon View The structure of sites is illustrated in the following figure:
StarQuality
165
User Manual
Introduction
Figure 5-2: Hierarchy of Sites
StarQuality
166
User Manual
WiMAX Equipment Measurements
5.2
WiMAX Equipment Measurements

KPIs (Key Performance Indicators) exist for three types of entities: Slot (also referred to as AU, sector, BS) SU (also referred to as MS, CPE) NPU (also referred to as BTS, in common measurements) For specific device information refer to Chapter 11.
StarQuality
167
User Manual
Measurements Browsing Options
5.3
Measurements Browsing Options

You can find a specific device data using three methods: Navigating the path from the Measurement menu - click ROOT or Network/Monitored SUs sites and then click the equipment icons. Searching for a specific equipment - see Searching Measurements on page 178 Creating a specific sub-menu as a shortcut - see Saving Items as A Submenu on page 181
StarQuality
168
User Manual
Measurements Display Options
5.4
5.4.1
Measurements Display Options

Element Display Types
Click one of the icons in the View group to set the element display options in the View group (Figure 5-10): Table 5-1: Element Display Options Icon Tooltip
Icons
Description
The elements of the hierarchy level under the selected item appear with a big icon and name, up to 5 items in a row (as in Figure 5-1). Click on the icons to continue the navigation The elements appear with a small icon and name, thus allowing many objects on a small screen. Elements are listed under each other with a small icon, name and description. Adds to the currently displayed measurements:
List
Detailed
Display Deleted
Measurements from deleted devices Measurements that were deleted or modified (formula
or unit) between StarQuality versions
StarQuality
169
User Manual
Element Browsing Options
View Group
Figure 5-3: Navigation between Measurements: Detailed View
5.4.2
Element Browsing Options

The Elements group in the Browser orderly displays the elements. The elements appear in a list, marked with a mini icon and a symbol. If there are too many pieces of equipment on the current level, the Browser automatically groups them. Therefore the elements in the main part of the display and in the Elements group of the Browser pane are not necessarily corresponding.
To browse elements: Do one of the following: Click on the name of the object to continue the navigation on the left side. Click on the symbol to browse to the selected site or equipment. The elements under the selected equipment also appear in the currently active tab.
StarQuality
170
User Manual
Operations Drop-Down Menu Options
In case of many equipments, click on a group to expand it. The system stays at the same level, so clicking does not mean a hierarchy level has changed. Click Measurement Types to navigate the hierarchy and display only the elements that include the selected measurement type.
5.4.3

The following functions are available for viewing measurement data (see Figure 5-4):
Figure 5-4: Measurements Operation drop-down Menu Print Page - sends the page to printer Show history - the application tracks the navigation of the user in the Measurements and in the Alarms menu and builds a history log from it. Each tab has its own log and each log entry contains the visited object, along with the used submenu and the selected date and time period. You can view this history log and either go back to a previous entry by clicking on the [view] link or open it in a new tab by right-clicking on the [view] link.
Figure 5-5: Show History
StarQuality
171
User Manual
Show links - Displays three links, which jump directly to the currently viewed object when a new browser window is opened. The difference between the three links are the level of settings stored in them:
Object only - stores only the location of the object itself Object with date and time - stores the selected date and time interval or
the real-time display state
Object with every setting - stores every setting made in the Browser
area.
Figure 5-6: Show Links Go to Alarms - jumps to the Alarms main menu items while keeping the selected hierarchy item. Logical BS History (for 4Motion only) - Displays the BSs to which the a CPE (SU) has been connected during mobility, within the measured time (see Figure 5-7).
Figure 5-7: Logical BS History Window
StarQuality
172
User Manual
Go to Configuration - jumps to the Settings > Site and System Configuration page. Save as submenu - adds a submenu item at the top panel (see Saving Items as A Submenu on page 181).
StarQuality
173
User Manual
Viewing Measurement Data
5.5
Viewing Measurement Data

After reaching the equipment level using one of the navigation methods described above, the measurement results can be reviewed in chart format by selecting the concrete equipment. You can export the measurement data to Excel by clicking the Export to XLS link at the top-right corner of each chart.
5.5.1
Setting Time Span

Click one of the icons to define the time span of measurements to be displayed: Table 5-2: Time Span Options Icon Tooltip
Realtime view
Description
The data is updated periodically
Historical view by date
A calendar is displayed. Select the desired day, week, month, and year to dispaly measurements for that time span Specify the time interval (hours, seconds, etc.)
Historical view by time
Click on a given point of the graph to display the data in finer detail (zoom in to a selected time instant). Click before the left edge or after the right edge of the graph, respectively to move the selected time interval backwards and forwards.
5.5.2
Chart Display Options

Because of minimizing the required chart drawings, StarQuality draws only the first 20 charts, and the others are visible only when scrolling down the page.
StarQuality
174
User Manual
Chart Display Options
Click one of the icons to set the chart display options in the View group (Figure 5-8): Table 5-3: Chart Display Options Icon Tooltip
Large Charts
Description
The charts appear in one column
Medium Charts
The charts appear in two columns
Small Charts
The charts are arranged in a three column table
Display Deleted
Adds to the currently displayed measurements:
Measurements from deleted equipments After StarQuality upgrade - measurements from previous
versions. Charts of previous versions are marked with a special suffixa in their names.
a. A chart always uses the whole available area, that is, if you hide the menu system using the expand page icon, or change the shape of the Browser window, StarQuality redraws the chart(s) accordingly.
StarQuality
175
User Manual
Chart Settings
Figure 5-8: Measurements - Small Charts
5.5.3
Chart Settings
The following chart settings are available: Flash - allows displaying the following options (see Figure 5-9):
View or hide specific measurements by clicking their check-box Mouse-point on a spot displays the date, time and measurement values. Mouse-point on [Show details] displays the average, last, min. and max. values of the measurement. It also displays any firmware changes for the device.
Right-click and set a trendline calculation for any element.
StarQuality
176
User Manual
Chart Settings
Figure 5-9: Display with Flash Options Peak - Default Yes No Resolution - Medium Small Large Minimum, Maximum values Click OK to activate your settings.
StarQuality
177
User Manual
Searching Measurements
5.6
5.6.1
Searching Measurements
On Searching in General
Search strings are entered frequently in the StarQuality application in order to search by text or to filter the results. There are two types of searching methods: the complex search system, accessed from the Search menu item, and the simple filter system, used in other places. For the Search menu item, the StarQuality application performs character based, case insensitive whole text matching. Four special characters can be used in the search string: _ (underline) or ? (question mark): matches an arbitrary character % (percentage) or * (asterisk): matches zero or more arbitrary characters Therefore, for example, the _apple% search string results in all names whose second to sixth characters are apple (regardless of case), followed by an arbitrary string of characters, that is, for example Xapple123, aApPle, 1AppleTree, etc. In other cases (filtering, charts editing, etc.), the StarQuality distinguishes small and capital letters, but the [?] and [*] characters do not have the special meaning mentioned above. In order to search for text that includes a space, include the space in the string for search. For example, <space>SU will result in all names including SU with a space proceeding it. For more information, refer to Search (Admin only) on page 243 (in Chapter 9) Search is relevant to names of sites, equipment, etc. but not to IPs. You can use the Measurements > Search menu item for displaying actual measurements. After searching, use the [view] link next to the equipment to view the measurement charts.
To start searching for a measurement: Specify a searching string, using one of the following methods:
StarQuality
178
User Manual
1 2
Simple search: type the string directly in the input field, and click OK. Click Advanced Search; an advanced window is displayed, which facilitates the construction of the searching string and contains the following insert fields: a Search to parent name (Yes/No): If you select yes the search finds those objects whose parent name meets the conditions (e.g. the parent is the containing site for a piece of equipment). b Name: Name of the object to be searched. The _ and ? characters match an arbitrary single letter, while % and * match an arbitrary string. The expressions in separate lines will be in OR relation with each other. c Without: Characters to be ignored by the system (the format is the same as above) d Type: The type of the object to be searched. Subtype can also be given for equipment, equipment template and measurement type. e Display deleted: Specify whether to add to the currently displayed measurements the measurements from deleted equipments or measurements from previous versions. f Results count: Maximum number of results
Figure 5-10: Advanced Search 3 Click OK; The results are displayed as well as the searching string as it could be given at simple search.
StarQuality
179
User Manual
Figure 5-11: Measurements Search Results
To use the Search results in Measurements: 1 2 To display the found objects click [view]. If the results contain only measurements or charts, to display them together, click on the [view all] link; A page containing the charts is displayed. 3 To create a virtual equipment containing the displayed list of measurements or charts, click [Save as Virtual Equipment].
NOTE This method can substitute the manual selection of measurements and charts under the Customization menu item.
StarQuality
180
User Manual
Saving Items as A Submenu
5.7
Saving Items as A Submenu

You can create a submenu item under the Measurements menu in order to have a shortcut to a selected item. This may save navigation time and searching for data.
To create a submenu item: 1 2 3 Click the equipment icon you want to create a shortcut to. From the Operations drop-down menu select Save As Submenu. Specify if this menu item should appear in Measurement or Alarms or both menus. 4 Click OK; the item appears in the Measurements/Alarms menu.
StarQuality
181
User Manual
Setting Trendlines to Graphs
5.8

When working in Flash mode, StarQuality enables defining trendlines for displayed measurements. You can also define thresholds using the trendline values.
To set trendlines: 1 When viewing a result table in Flash mode, right-click on the table itself and select Set trendline. The Set Trendline page is displayed. The parameters in this page may vary depending on the equipment type and measurements
Figure 5-12: Setting Trendlines Window
StarQuality
182
User Manual
For every entry, select one of the following trendline types from the drop-down list:
Linear Polynomial (x^2) to (x^6) Difference - The difference between the current value and the previous value are shown Limits - Specify a condition value (e.g. > 10M) and a sample time (e.g the last hour). The following limit trendlines are available:
Limit counter - The number of times the condition was true in the time
sample is shown as a trendline.
Limit indicator - A transparent red area is shown when at least one

time the condition was true in the time sample
Limit sum - The sum of the measurement values based on the same
time interval
Average and deviation - three trend lines are displayed, showing the average of the element as well the plus and minus deviation. The following trendlines are available:
Average and one deviation Average and two deviations Average and three deviations
The following figure shows a few examples of setting trendlines.
StarQuality
183
User Manual
Linear trendline
Polynomial (x^2) trendline
Polynomial (x^6) trendline
Difference trendline
Average and one Deviation trendlined
Figure 5-13: Examples of Trendline Settings
StarQuality
184
User Manual
Chapter
Setting Alarm Thresholds
In this chapter:
Overview on page 187 Creating and Editing Threshold Templates on page 188 Assigning Threshold Templates to Equipments on page 194 Editing Thresholds on page 197 Generating the Expression Using Input Fields on page 200
StarQuality
186
User Manual
Overview
6.1
Overview
Setting alarm thresholds is available for Admin users only. Thresholds are defined in the StarQuality system in order to trigger alarms when the values exceed the threshold. The defined thresholds can be complex expressions using different measurements of the same equipment. You can also use templates to build thresholds. This manual describes creating normal measurement templates and assigning them to equipments. The process of adding, viewing and modifying thresholds depends on whether it is initiated from the menu (Settings > Thresholds > Configuration), or from the Equipment Configuration page. The difference between these options is the sets of displayed thresholds and selectable objects, and the displayed measurement names. This chapter focuses on creating threshold templates and assigning them to equipment.
StarQuality
187
User Manual
Creating and Editing Threshold Templates
6.2
Creating and Editing Threshold Templates

Creating thresholds using a template enables the creation of more thresholds, even for the same measurement. First you create the template and then you assign it to equipment. You can also configure the assigned threshold locally.
6.2.1
Creating a New Threshold Template

This section describes how to create a new template (not based on an existing one) and how to configure it.
To create a new threshold template: 1 From Settings select Templates > Threshold Templates; The Threshold Template Configuration list is displayed.
Figure 6-1: Threshold Template Configuration - Template List 2 Click [add new]; The Threshold Configuration editor displays an empty template table.
StarQuality
188
User Manual
Figure 6-2: Threshold Template Configuration - New 3 Fill in the fields with the following information:
Name: Template name: For example: FDD SNMP OCCUPATION too low Threshold name: A unique and meaningful name that contains the names of the individual thresholds that will be created. At least one of the following notations should be added:
<equip[number]>: the name of the equipment of the measurement that corresponds to the variable with the given number <var[number]>: the name of the measurement that corresponds to the variable with the given number
StarQuality
189
User Manual
Table 6-1: Threshold Name Examples Threshold Name In Template

<var1> CPE drop <equip1>
Actual Threshold Names

BS 0.0.131.8.131.1 Active MS Qty CPE drop Browns Hill BS 0.0.131.8.144.3 Active MS Qty CPE drop Audet
<equip1> too many HO <var1>
Audet too many HO BS 0.0.131.8.144.1 Successful Ho Attempts Sainte-Francoise too many HO BS 0.0.131.8.79.2 Successful Ho Attempts
Measurements within the same equipment: If checked, when a threshold is created based on the template, the parameters value defined in the template acts as a default value for the same parameter inside the threshold. Expression: The threshold format. The application displays the expression in text format, while editing the expression is displayed in its original form in case of normal thresholds, and as different input fields for grouped alarms. See Step 3 below. Level: The possible threshold values in decreasing severity levels:
Critical (red background) Major (orange background) Warning (yellow background) Minor (cyan background)
Type: Not applicable. E-mail: The e-mail address(es) to which the application should send a message if there is threshold violation. Select one or more e-mail addresses by highlighting (and using the CTRL and Shift keys) the required address(es) from the predefined list (refer to Setting E-mail Addresses (Admin only) on page 259). A prerequisite for the actual e-mail notifications is activating the SMTP server (see Northbound Interface (NBI) on page 285) SNMP Trap: The list of addresses where the system should send SNMP traps in case of threshold violation. The addresses should be separated by commas. There are two basic options for address: 1 IP address only - The trap is sent with the default credentials of public community and port 162.
StarQuality
190
User Manual
According to the following format: [community@]computer_name[:port]
Command: Not applicable Continuous alert: If selected, at each violation the appropriate e-mail and/or SNMP trap is sent. If not selected, this will be done only if there was no violation during the previous measurement. In both cases, the system will send an e-mail and/or SNMP trap when the threshold violation is ended. When: Which time period template is used for the threshold. The possible options are set in Settings > Templates > Exclusion Window Templates. 3 Specify the threshold attributes in the Expression section: The threshold syntax contains 4 parts, separated by a [#] key. That is: <value(VARx)> <comparators (=><)> <reference value> <frequency>. You can also have relations between expressions: Or/ And. Examples:
Expression 1 #VAR1.O#4029 > 5000.0#1#1# or #VAR2.O#4030 > 5000.0#1#1# Verified Expression (Variable1[WiMAX 4Motion: Successful Ho Attempts (Table)] > 5000.0) 1x in 1 sample or (Variable2[WiMAX 4Motion: Failed Ho Attempts (Table)] > 5000.0) 1x in 1 sample
Expression 2 #VAR1.O#4AST.OUT < 50.0#3#3# or
StarQuality
191
User Manual
#VAR2.O#4AST.IN < 50.0#3#3# Verified Expression (Variable1[WiMAX 4Motion: Average Sector Throughput (Table)].Downlink < 50.0) 3x in 3 sample or (Variable2[WiMAX 4Motion: Average Sector Throughput (Table)].Uplink < 50.0) 3x in 3 sample
Trendline Expression #TREND_LINE_DIFF:2:0:VAR1.O#4021 <= -5#1#1# Verified expression: (Variable1[WiMAX 4Motion: Active MS Qty (Table)] Trend Difference <= -5) 1x in 1 sample
For lists of syntax elements for thresholds, refer to Chapter 11.
Usually only the following part of the Perl syntax is necessary:
and: and expression or: or expression +, -, *, /: mathematical operations (,): punctuation !: logical negation <, <=, ==, >=, >: value comparators
StarQuality supports multiple variables and logical operators as shown below:
StarQuality
192
User Manual
Figure 6-3: Expression Containing Multiple Variables When using multiple variables, their names should be differentiated: var1, var2, etc. Also, all the variables must belong to the same equipment. Alternatively you can create the template without expression and later edit the threshold locally using input field. See detailed information in Generating the Expression Using Input Fields on page 200. 4 Click Validate. If the syntax is red, fix it according to the above. Note that if the validation does not succeed, the system does not pinpoint the exact source of the problem. 5 Click OK; A new threshold template is added to the system.
StarQuality
193
User Manual
Assigning Threshold Templates to Equipments
6.3

To assign a threshold template to multiple equipments: 1 From Settings select Threshold > Configuration. The threshold list is displayed. 2 3 Click [from template]. Choose a threshold template from the drop-down list. The Threshold Configuration editor displays the attributes of the template.
Figure 6-4: Using Threshold Template 4 If required, edit the values in the template. If the threshold contains references to multiple variables, check the Measurements within the same equipment and the Measurements with the same description checkboxes.
StarQuality
194
User Manual
Click OK to view the list of relevant equipments for this threshold template. All are checked by default, and you can select the equipment(s).
Figure 6-5: Relevant Equipments 6 Click OK; The system creates the selected thresholds.
To assign a threshold from template to a specific BTS: 1 Access the Site and Equipment Configuration in one of the following methods:
From Measurements, select the equipment and from the Operations pull-down menu select Go To Configuration. From Settings select Site and Equipment Configuration.
Scroll down to the Threshold section and click [From Template], or choose New Threshold from Template from the operations drop down menu.
Select a template from the list to assign to the threshold and click OK; the system displays the threshold template details. You can modify the attributes as required.
StarQuality
195
User Manual
Figure 6-6: Threshold Template Details 4 Click OK; The system finds items (AUs or SUs) belonging to this BTS to which to assign the template.
Figure 6-7: Items to Assign The Threshold 5 Select the AUs/SUs to assign the threshold to and click OK. The threshold is added to the list of thresholds for the equipment.
StarQuality
196
User Manual
Editing Thresholds
6.4
6.4.1
Editing Thresholds
Editing an Existing Threshold Template
When you edit an existing template on which active thresholds are based, all these thresholds are automatically affected. The system identifies and lists these potentially affected thresholds for approval.
To edit a threshold template: 1 Do one of the following:
From Settings select Templates > Threshold Templates. The Threshold Template Configuration list is displayed. From Settings select Site and equipment configuration. Navigate to the equipment holding the threshold to be edited. Scroll down to the thresholds list. 2 Click [edit] next to the threshold template to be modified.
Figure 6-8: Threshold Template Configuration - Template List
StarQuality
197
User Manual
Editing an Existing Threshold Template
Figure 6-9: Threshold Template Configuration - Editing 3 Modify the required threshold attributes (see detailed information in Creating a New Threshold Template on page 188). 4 Click OK to save your modification to the template. If no thresholds are based on this template, the modifications are saved and the list of threshold templates reappears. If there are thresholds based on this template, the Threshold Configuration editor displays the modified attributes and lists these potentially affected thresholds for approval (Figure 6-10).
Figure 6-10: Message on Template-based Threshold Modification
StarQuality
198
User Manual
Editing a Template-based Threshold (Local Change)
The settings made here will override any local change in each of these thresholds. To avoid loosing such local changes, you may consider modifying the template and not the threshold itself. Clock OK to save the modification; the list of threshold templates reappears.
6.4.2
Editing a Template-based Threshold (Local Change)

Editing the threshold template itself will override any local change in thresholds. To avoid loosing such local changes, you may consider modifying the template and not the threshold itself.
To edit a template-based threshold: 1 From Settings select Threshold > Configuration. The Threshold list is displayed. 2 Select a specific threshold and click [edit]; the following message appears:
Figure 6-11: Message on Template-based Threshold Modification 3 4 Click OK; the Template Configuration window is displayed. Modify the required threshold attributes. You can use the input fields as described in Generating the Expression Using Input Fields on page 200. 5 Click OK to save your modification to the threshold.
StarQuality
199
User Manual
Generating the Expression Using Input Fields
6.5

This section provides basic rules for creating threshold expressions using input fields. Input files are not available when creating or editing threshold templates. You can use the input fields in the Threshold Configuration window (Figure 6-12) available in the following cases: Creating or editing a threshold that is not template-based Locally modifying a template-based threshold (see Editing a Template-based Threshold (Local Change) on page 199)
To generate a threshold expression: 1 Access the Threshold Configuration window (Settings > Thresholds > Configuration.
StarQuality
200
User Manual
Input fields
Figure 6-12: Threshold Configuration 2 In the Threshold Configuration page fill in or select the following fields as required. The available parameters may differ depending on the equipment type and measurements:
The site and equipment of the measurement drop-down fields are displayed only when opening the threshold editor from the main page. If you edit the thresholds from the Equipment page, you can choose the measurements belonging only to that specific one.
The measurement to be selected. This may be an actual value or a trendline value (linear, polynomial, difference etc.). Operator:
A relational operator within the expression like: ==, !=, <, <=, >, >=. A condition like Successful or Unsuccessful. In this case the second
operand in the expression is irrelevant.
Compare value - This is the second operand of the relational expression (relevant only if a relational operation is used):
StarQuality
201
User Manual
Static value: interpreted with the same measurement unit as the one
displayed on the measurement chart. If there is a single measurement in the sub-expression, the application draws a horizontal line on the measurement chart at the compare value.
Baseline value: the average of the measured values calculated with the
specified cycle and resolution + or a multiple of the standard deviation
Frequency In how many samples Based on the last x cycles Match in sample Sample size
Click the [Add to] link; The application inserts the required element at the current cursor position in the text, which can be of one of the following two types depending on the values of the fields:
If the compare value is filled, the application inserts a complete sub-expression element, namely:
#selected_measurement_code operator compare_value#frequency#in how many#
If the compare value is not filled, the application inserts only the code of the selected measurement.
Anytime during the editing process you can click on the [Validate link] to check whether the expression has the required syntax. If the syntax is invalid, an error message is displayed, and if it is valid, the user readable format of the expression is displayed in the validate field.
StarQuality
202
User Manual
Usually only the following part of the Perl syntax is necessary:
and: and expression or: or expression +, -, *, /: mathematical operations (,): punctuation !: logical negation <, <=, ==, >=, >: value comparators
The list of Thresholds syntax elements is in Table 11-6.
StarQuality
203
User Manual
Chapter
Threshold-Crossing Alarms Monitoring
In this chapter:
Overview on page 206 Navigating, Viewing and Filtering Alarms on page 208 Downloading Data to Excel Files on page 213
StarQuality
205
User Manual
Overview
7.1
Overview
Viewing Alarms is performed similarly to viewing measurements: a configurable quick menu at the top panel is used for displaying and navigation, and also new elements can be added to it using the Settings > Customization menu. The alarms are displayed on the most prominent parts of the user interface to provide quick accessibility. The color-coded summary of the currently active alarms are displayed at the top-right corner of the window. The alarms can be navigated by selecting the Alarms item on the main menu.
Figure 7-1: Alarms Summary at the Top Right Corner of the Window By default, only the Root highest level group is listed. The list view of alarms is displayed in the following figure:
Figure 7-2: Table View of Alarms
StarQuality
206
User Manual
Overview
To use the Alarms list: Use the following operations in the alarms list: Table 7-1: Using the Alarms List To
Move to next page/entries on the list Sort the list by column entries Sort in ascending/descending order Download the table Obtain detailed information of an entry Acknowledge an alarm
Do this
Use the arrows (< >) at the top of the list Click on the column header Click the up/down arrows under the column header Click the [view xls] link Click the [view] link Click the [ack] link
Comments
The numbers indicate the order
the corresponding measurement values are displayed in a chart. if the alarm has already been acknowledged, the time and name of the user that acknowledged are displayed in the table. If the alarm is not a threshold violation but is from an event definition, and the event has not yet been closed, a [del] link appears.
Delete (close) an alarm
Click the [ack] link (if available)
Deleting an alarm is necessary, for example, if there is no closing event in the definition or a trap has been lost, or if the alarm is not relevant anymore. In this case, if the alarm has not been acknowledged yet, then it becomes acknowledged as well.
Figure 7-3: Detailed Alarm Information
StarQuality
207
User Manual
Navigating, Viewing and Filtering Alarms
7.2
Navigating, Viewing and Filtering Alarms

The browser, at the left-hand side of the user interface under the main menu, is used to filter and arrange the alarms. There are three groups in the Browser, each controls the display of alarms. The individual groups can be expanded or collapsed and by clicking on the button on the left edge next to them, which can be useful since this panel has no scroll bar. A tooltip is also displayed if the mouse pointer is moved above the group icon. Filtering of alarms can only be set with these groups if a set of alarms is already selected on the top part of the screen. The following sections explain in details the individual groups.
7.2.1
Viewing Alarms by Time Span

You can define the time span of alarms to be displayed. The following view options are available in this group: Table 7-2: Time Span Options Icon Tooltip
Realtime view
Description
The currently active alarms are displayed
Historical view by date
A calendar is displayed. Select the desired day, week, month, and year to dispaly alarms during that time Specify the time interval (hours, seconds, etc.)
Historical view by time
7.2.2
Alarm View Options

The way the alarms are displayed can be changed using the second group of controls.
7.2.2.1
Main View Options

The following view options are available in this group:
StarQuality
208
User Manual
Alarm View Options
Table 7-3: Alarms View Options Icon Tooltip

Table view
Description
The alarms are displayed in a list table. This is the default view. Refer to Overview on page 206, and Figure 7-2. The current site hierarchy is displayed with icons instead of the table of alarms. The color of icon indicates the most severe alarm existing for this item. See detailed description of this view below (Object View Options on page 209). The number of active alarms are displayed in a graphical form (see Chart View on page 212).
Object view
Chart view
7.2.2.2
Object View Options

By selecting the Object view icon, the current site/virtual site hierarchy is displayed with icons instead of the table of alarms. Only those sites for which there is an active alarm are visible. The icons are colored by the color code of the most severe alarm of the contained equipment: for example, if under a site there is an equipment with am active Critical alarm, the color of the sites icon is red; if the most severe active alarm of the equipment under the given site is Major, then its color is orange, and so forth. During navigation the navigation path is displayed in the top line above the middle viewing area (under the name of the tab), which can be used to quickly navigate up to higher levels by clicking on its segments. In the Object view, three further icons are available, which are used to further simplify the object view: Icon view: The sites containing alarms are displayed with large, easy-to-see icons, up to five in a row.
StarQuality
209
User Manual
Alarm View Options
Figure 7-4: Icon View of Alarms List view: The sites containing alarms are displayed with smaller icons (up to five in a row) allowing more icons to be displayed on a single screen. Icons with alarms can easily be identified based and their color codes.
Figure 7-5: List View of Alarms Detailed view: The site/equipment icons are listed one under another (still colored) together with their names and descriptions
StarQuality
210
User Manual
Alarm View Options
Figure 7-6: Detailed View of Alarms In each of these views, you can navigate to a site by clicking on its icon, in which case the contained sites and equipment are displayed in a similar view. Tracking the hierarchy downwards you can reach the equipment causing the alarm, and then by clicking on the icon of this equipment the name of the violated threshold and the chart of the referenced measurement values are displayed. On this lowest level you can also choose a threshold that is currently not violated in order to check the settings of the threshold value. If the alarm is not threshold but event based, then the StarQuality displays the time of alarm on the chart with superimposed transparent red rectangles.
Figure 7-7: The Equipment Level View of Alarms
StarQuality
211
User Manual
Filtering Alarms
7.2.2.3
Chart View
This view can only be selected if the current time interval is not the real-time/Auto refresh view (that is, for historical time intervals that do not contain the current time instant).
7.2.3
Filtering Alarms
In the alarms browser, the third group Filters allows the specification of filter-conditions of alarms. Filtering is available using the following types: Table 7-4: Filtering Types Type
Name
Description
The name of the threshold (which typically contains the name of the corresponding equipment, such as E1909 low availability). The usual % and _ characters can be used here. Most useful in the List view. A dropdown list, used to filter on the severity level: Critical, Major, Warning, Minor). A dropdown list, used to filter on the threshold type. A dropdown list, used to set whether the normal and/or the grouped alarms should be displayed. Display acknowledged alarms - Yes/No
Level Type Grouped Acknowledged
StarQuality
212
User Manual
Downloading Data to Excel Files
7.3

You can download the displayed data in XLS format. The generated XLS file containing the measurement data also includes the name of the threshold, and the background color of the data cells that violate the threshold matches the color code of its severity level. If threshold violation occurred, but that value was not taken into account in the current alarm, then the background color of the cell is set to cyan. If a public or private (as opposed to normal) chart is exported to an XLS file, the generated file differs in the following aspects:
The number of columns and their names are the same as in the chart definition Regardless of the chart definition the values are not aggregated The resolution of rows follows the smallest time interval of the measurement data, thus infrequent measurement data are stored sparsely in the table
To save data to Excel:
To save the alarms table click [view xls]; open or save the file.
Figure 7-8: Sample XLS of Alarm Table To save the chart data, click [Export to XLS] above the chart. The first few lines of a sample exported XLS file are:
StarQuality
213
User Manual
Figure 7-9: Sample XLS File of Chart Data
StarQuality
214
User Manual
Chapter
8
Reports
Reports
In this chapter:
Overview on page 217 Report Configuration on page 218 Viewing Reports on page 229 Bulk Export Wizard - Exporting Data to XLS Files on page 232
StarQuality
216
User Manual
Reports
Overview
8.1
Overview
StarQuality enables the following types of reports: Built-in and configurable reports Filtered data exported to .xls format
8.1.1
Built-in Reports
These reports are variable evaluations on a chosen set of sampled objects (AUs, SUs, measurements) in the system. Administrator users can configure selected subsets, variables and reports views. Each report can be one of the following: Predefined reports - The system is installed containing the same set of four reports for most device types:
BottomN Uptime TopN Air Link Utilization (not applicable to BreezeACCESS VL and Extreme) TopN Sector Throughput TopN Number of Connected SUs (not applicable to 4Motion 3.0M)
For details on device specific information, refer to Chapter 11. Regular reports - Each report-view is manually configured following the definitions of its variables, and begins collecting data from its creation time and on. Refer to Regular Reports on page 218 On-demand reports - Creation and generation of reports referring to data already existing in the database. Refer to On-Demand Reports on page 224
StarQuality
217
User Manual
Reports
Report Configuration
8.2
Report Configuration
The configuration of reports (Settings > Reports), is available to admin users only.
8.2.1
Regular Reports
Report creation consists of the following steps: Defining the variables which will be the building blocks of the reports. Only measurements performed after defining them as variables will be available for the reports. Refer to Section 8.2.1.1. Sorting the created variables in various combinations into report views. Refer to Section 8.2.1.2.
8.2.1.1
Defining Report Variables

Reports are based on the system existing measurements.
To start defining report variables: 1 From the Settings menu select Reports > Report Variables; The Report Variable Configuration starting page contains a table showing the active (currently monitored) and inactive report variables. In a new system, the table contains the variables used for the predefined reports.
Figure 8-1: Report Variables Window (Example)
StarQuality
218
User Manual
Reports
Regular Reports
To create a report variable: 1 Click [add new]; the following window is displayed:
Figure 8-2: Adding a New Report Variable 2 Enter a unique and meaningful name for the variable. The name should reflect the device type as well as the measurement. For example: TDD Utilization. 3 Select a Measurement Name from the drop-down list. The list is based on measurements per collector/equipment type. Make sure to select the measurement from the correct collector. 4 5 6 7 Leave Detailed summary at equipment level unchecked. Verify that the Active check-box is selected. Leave the interval of 15min. When: Select the required timeframe for collection from the drop-down menu or leave the value as non stop. 8 Click OK; the report variable is added to the list.
StarQuality
219
User Manual
Reports
Regular Reports
To edit an existing report variable: 1 Click [edit] next to the variable to be changed; the Report Variable Configuration window is displayed (see Figure 8-2). 2 3 4 Edit the variable name as required. Select if to activate the variable calculation using the Active check-box. Click OK; the report variable is updated in the list.
NOTE
An active report variable consumes computer resources. Therefore, it is recommended to define

only the required variables and deactivate redundant ones.
The only way to disable a variable is to set it as inactive. You cannot delete a report variable.
8.2.1.2
Defining Report Views

Report view is the display method of the report variables. Report views have three types: Table, TopN and Chart (not applicable). The first two are table-arranged report variables; The difference between TopN and Table reports is that for TopN reports it is impossible to navigate among the sites.
To Start Report View Configuration: 1 From the Settings menu select Reports > Report Views; The Report View Configuration starting page contains a table showing the active report views. On a new system, this table contains the predefined reports.
StarQuality
220
User Manual
Reports
Regular Reports
Figure 8-3: Report View Configuration Window (example)
To create a new report view: 1 2 3 4 5 6 7 Click [add new]; a setting page is displayed (see Figure 8-4). Enter a meaningful name (free text). Select a type: Tabular or TopN. Leave the Top Level? check-box selected. Set the First Hierarchy Level to: measurements. Set the result window size. Click OK; The new view is added to the list of views.
Figure 8-4: Creating a New Report View
StarQuality
221
User Manual
Reports
Regular Reports
In the Report View Configuration window (see Figure 8-3) click on the [tables] link. The configuration page is displayed (empty in a new report):
Figure 8-5: Configuration Page 9 In the upper section, select the hierarchy level: Additional Measurements.
10 Click [add new] to add variables to the report view. Add as many variables as necessary. The following window is displayed per each variable:
Figure 8-6: Adding a New Variable
StarQuality
222
User Manual
Reports
Regular Reports
11 Repeat for each variable: a Set the order. Assign the same order to variables you want to group. Grouped variables share variable-.name and name; they differ by subname. b Select a variable name from the drop-down list of your pre-defined variables (See To create a report variable: on page 219.) c
NOTE In cases it is applicable, the name should specify if the measurement is an uplink or downlink value.
Enter a meaningful name for the order group.
Enter a meaningful subname for the subcolumn; it is only visible on the report, if there are at least two grouped columns. Example of grouping according to steps a - d:
Common Measurement name: Utilization Common Name: Utilization Downlink Subname: Min. for one variable, Max. for the other
e From the Field drop-down list select the required field value. Make sure that the field matches the names given above.
NOTE In applicable cases, First formula always represents uplink; Second formula represents downlink.
f g
Leave Div with is null. Leave the Precision value at 0. Set Weekly-monthly aggregation according to the value selected in the Field.
Enter the Weekly-monthly-yearly summary postfix: The application appends this text to the name of the column if the field is specified and it is not a daily report.
i j
Leave all the next fields unedited. Click OK. The Report View Configuration page is displayed.
StarQuality
223
User Manual
Reports
On-Demand Reports
12 In the upper right side of the page, select the report order using the Order by Column drop-down list. 13 Click Back in the upper right corner to save changes and return to the report view list.
To edit an existing report view: 1 2 3 4 From Settings select Reports > Report Views. Click [tables] next to the report view you want to edit. In the upper section, select the hierarchy level: Additional Measurements. Click [add new], [edit] or [delete].
To create a new report view based on an existing view: 1 Click [copy from]; a setting page is displayed. (see Figure 8-7).
Figure 8-7: Creating a New Report View Using the Copy From Option 2 3 4 5 Enter a new name for the report view. Select the report name to base the new report view from the drop-down list. Click OK. Edit the new report as described above.
8.2.2
On-Demand Reports
By using the On-demand reports the system creates and generates reports referring to data already existing in the database. It is recommended to specify limited amount of data for the report as processing large amounts of data causes system overload.
StarQuality
224
User Manual
Reports
On-Demand Reports
To create an On-Demand report: 1 From Reports select On Demand Reports; the On-demand selection path and settings window is displayed. The items in the selection path become available as you specify the settings:
Selection path
Figure 8-8: On-demand Reports - Types In the Report Type section, choose either:
By Equipment Level By Measurement. In this case, select wether to group measurements together.
When: Which time period is used for the report 2 Click Search in the selection path; the Search settings window is displayed:
Figure 8-9: On-demand Reports - Search 3 Specify the Search:
StarQuality
225
User Manual
Reports
On-Demand Reports
parent attribute:
No - to search by equipment attribute Yes - to search by parent attribute
Field: Leave Name Search - enter strings to be searched. All rules are applied as in On Searching in General on page 178. Without - enter strings to exclude from the search. Type: Equipments, choose a specific equipment type Select the number of requested results in the report.
NOTE The message Not all matching rows returned! may appear at the bottom of the table if there are more results than selected counts.
Click OK at the top-right of the window; The list of results is displayed (Figure 8-10).
To narrow or improve the filtering, edit the title line and click OK. Repeat until the requested results are returned.
Title line
Figure 8-10: On-demand Reports - Measurement Types
StarQuality
226
User Manual
Reports
On-Demand Reports
Click Measurement Types in the selection path; a list of available measurement types and calculations is displayed:
Figure 8-11: On-demand Reports - Measurement Types Settings 7 Select the measurement (s) at the left column, and the calculation (min., max. avg. etc) on the right column. 8 Click Object Parameters in the selection path; a list of parameters is displayed. These parameters will be the columns of the report. Some of the parameters are already selected.
Figure 8-12: On-demand Reports - Object Parameters 9 Select the Measurement name check-box; the Show and Save options are enabled at the selection path. 10 Click Save to save the report settings (optional); the following window is displayed. Specify the report name and choose if to include the search settings
Figure 8-13: On-demand Reports - Save options
StarQuality
227
User Manual
Reports
On-Demand Reports
11 Click Show to display the report in a regular report format, including the option to specify time frame and export to *xls format.
Figure 8-14: On-demand Reports - Show
StarQuality
228
User Manual
Reports
Viewing Reports
8.3
Viewing Reports
The reports are displayed in the Reports viewing menu about an hour after defining the variables.
8.3.1
Navigating Report Views

Use the following buttons: Table 8-1: Navigating Reports Button/Link Description
Go to the first and previous page, respectively Go to the next and last page, respectively Page x out of total number of pages. Jump directly to the required page by entering its number in the text field and pressing the enter key. Up and down arrows for ordering all results on the given level. The current ordering is indicated by a blue rectangle around the selected arrow Export current table to XLS Export all data to XLS Filter Exports the currently displayed entries to an XLS file. Exports the all the entries to an XLS file, including entries which are not currently displayed. Filters entries by equipment name or measurement name. The rules for special characters are the same as for search (see Search (Admin only) on page 243) Entries with underline, serve as links, and jump to the specific equipment measurement, with the properly selected date and time interval.
8.3.2
Setting the Report Range and Display

While viewing the report results, the calendar at the Browser is used for setting the time interval of the report. The selected report view is displayed to the right of the calendar. You can also set what type of reports to view and whether to display the date in a column.
StarQuality
229
User Manual
Reports
To use the calendar: 1 Click on the arrow buttons in the two top corners of the calendar to change the month. Alternatively, select a month and year using the drop-down menus (see Figure 8-15). 2 To change the type of time interval, click on the Day/Week/Month/Year text links at the bottom. 3 Select the actual time interval by clicking on one of the displayed days, months or years.
NOTE Time intervals starting in the future cannot be selected with the calendar.
Figure 8-15: Calendar views (day, week, month and year) for selecting the time interval
StarQuality
230
User Manual
Reports
To set report display options: 1 In the Settings area at the bottom of the Browser, select the type of report from the Type drop-down list:
Table only Grouped Separated Sort by
Select the Show Date in Column option to display (if the report includes dates)
NOTE These settings do not affect the export of reports to xls files
StarQuality
231
User Manual
Reports
Bulk Export Wizard - Exporting Data to XLS Files
8.4

The Bulk Export is a wizard driven utility used for exporting data from the StarQuality database into xls files according to the following user defined cross sections: Timeframe: up to one week Network elements:
Type: SU, AU or common BTS data (number of exported lines is limited to 65,000) Technology: FDD, FDD SNMP, TDD, 4Motion (Ver.2.5M, 3.0 and 3.0M), VL, Extreme
The system enables choosing specific elements from the list of NEs matching the above conditions. The xls file can be viewed or saved on the client machine at any location.
To export AU or common BTS data: 1 From Reports select Bulk Export Wizard; The Bulk Export Wizard window is displayed.
Selection Path
Figure 8-16: Bulk Export Wizard Window 2 Specify meaningful name and description (free text) to the report.
StarQuality
232
User Manual
Reports
Select a time frame, using the input fields or the calendar button: Specify maximum one week. Longer type results in an error message when trying to proceed to the next stage.
NOTE Seconds are ignored; minutes are regarded as the closest quarter of an hour
4 5
Select NE Type: BTS and any technology required. Click BTS Selection in the path at the top of the work area (see Figure 8-16); the filtering criteria screen is displayed.
Figure 8-17: Bulk Export Wizard - Filtering Devices 6 Enter the following criteria. (All categories are optional; That is, if left empty, no filtering is performed. Also all input is according to the search rules described in On Searching in General on page 178): Site name BTS name BTS Address (IP) Site ID (as exists in the database) 7 Click OK; a list of network elements matching the filter criteria is displayed. You can repeat the filtering until getting the desired results.
StarQuality
233
User Manual
Reports
Select the check-boxes of BTSs you wish to export data from, or use the topmost check box to select all the elements.
NOTE The Select All check box refers only to the currently displayed page. For selecting all the results in all pages, select the checkbox separately on each page.
Click Type Selection in the selection path (Figure 8-16); the Exported Entity choice window is displayed.
For AU/BS data select Logical BS measurements (default) For common BTS data select Common measurements
Figure 8-18: Exported Entity Selection 10 Click Export in the selection path (Figure 8-16). The following message is displayed:
Figure 8-19: Export Message 11 Click OK; In certain cases a second message is displayed informing that the data may exceed 66,000 lines. Click OK; A standard File Save/Download window is displayed.
StarQuality
234
User Manual
Reports
Figure 8-20: File Download The default file naming format is: StarQuality<Report Name><Date><Time>. Report name is defined in Step 2.
Figure 8-21: Sample xls File
StarQuality
235
User Manual
Reports
To export SU data: 1 From Reports select Bulk Export Wizard; The Bulk Export Wizard window is displayed (see Figure 8-16). 2 3 Specify meaningful name and description (free text). Select a time frame, using the input fields or the calendar button: Specify maximum one week. Longer type results in an error message when trying to proceed to the next stage.
NOTE Seconds are ignored; minutes are regarded as the closest quarter of an hour.
4 5
Select NE Type: SU, and any technology required. Click BTS Selection in the path at the top of the work area (see Figure 8-16); the filtering criteria screen is displayed (see Figure 8-17).
Enter the following criteria. (All categories are optional, which means if left empty, no filtering is performed. Also all input is according to the search rules described in On Searching in General on page 178):
Site name BTS name BTS Address (IP) Site ID (as exists in the database)
Click OK; a list of network elements matching the filter criteria is displayed (see Figure 8-17). You can repeat the filtering until getting the desired results.
Select the check-boxes of BTSs you wish to export data from, or use the topmost check-box to select all the BTSs.
Click Sector Selection in the selection path (see Figure 8-16); A list of all the sectors belonging to the BTSs chosen in Step 8 is displayed.
10 Click SU Selection in the selection path; A list of all the SUs belonging to the sectors chosen in Step 9 is displayed.
StarQuality
236
User Manual
Reports
Figure 8-22: SU Selection

NOTE For Steps 8 through 10, the Select All check box refers only to the currently displayed page. For selecting all the results in all pages, select the checkbox separately on each page.
11 Click Export in the selection path. The following message is displayed.
Figure 8-23: Export Message 12 Click OK; In certain cases a second message is displayed informing that the data may exceed 66,000 lines. Click OK; A standard File Save/Download window is displayed. The default file naming format is: StarQuality<Report Name><Date><Time>. Report name is defined in Step 2.
StarQuality
237
User Manual
Chapter
General Setting Options
In this chapter:
Overview on page 240 Search (Admin only) on page 243 Site and Equipment Configuration on page 244 Customization on page 259 Templates (admin only) on page 261 Server Configuration and Management (Admin only) on page 262 Audit Trail on page 277 User Administration (Admin only) on page 280
StarQuality
239
User Manual
Overview
9.1
Overview
The Settings item in the main menu contains many options for changing the StarQuality configuration. For each item in the submenu panel, different items appear in the Browser. For non-administrator users, the submenus used to make changes are not displayed, and the other submenus are displayed selectively based on the access rights of the user. This chapter describes some general setting options available in the StarQuality application. These settings are: Search - Setting the searching parameters Customization - editing of public objects refers to the administrator users, while editing of private objects refers to the rest of the users
Public/Private charts: Configuring charts Public/Private menu items: Defining menu items for the submenu panel External links (admin only): Setting the external links to display for basic or virtual site and equipment objects Preferences (non-administrator users only): Configuring displaying preferences E-mail addresses: A list of the e-mail addresses of the users
StarQuality
240
User Manual
Overview
Servers
Licences: Displaying and configuring the currently used and available licences Device and measurement summary: Viewing the list of all basic equipments, and the number of objects in the system for each measurement type
Server groups: Configuration of individual measuring groups Server configuration: Modifying the measurement servers and other servers Start/Stop/Status: Remote management of individual servers Server events: Viewing the events that occurred during self-testing Collector load: Viewing the load of the collectors and listing the unsuccessful measurements at a given date.
Maps (admin only): Not applicable Audit Trail (admin only): Displaying the individual configuration modifications User
User admin (admin only): Adding, deleting and modifying users User rights (admin only): Configuring which privileges/permissions the users should possess Password: Changing password
Other settings that are directly involved with the main system functionality are described in the relevant chapters. Such settings appear in the following list of menu items in the Settings section, with a reference to the exact location of their description: Site and equipment configuration - also in Chapter 3, Getting Started on page 123
StarQuality
241
User Manual
Overview
Scheduled configuration (admin only) - Automatically scheduled configurations - in Chapter 3, Getting Started on page 123 Thresholds - in Chapter 7, Threshold-Crossing Alarms Monitoring on page 204 Reports (admin only)- in Chapter 8, Reports on page 215
Report variables: Defining the variables used for reports Report views: Creating reports by selecting variables Scheduled reports: Setting scheduled report delivering
Templates - in Chapter 6, Setting Alarm Thresholds on page 185
StarQuality
242
User Manual
Search (Admin only)
9.2
Search (Admin only)

Searching is done only by names of sites and equipment. Under the Settings > Search menu item you can search the stored objects in the system. This menu is only accessible to the administrator and restricted administrator users.
To start searching for an object: Specify a searching string, using one of the following methods: 1 2 Simple search: type the string directly in the input field, and click OK. Click Advanced Search; an advanced window is displayed, which facilitates the construction of the searching string and contains the following insert fields: a Search to parent name (Yes/No): If you select yes the search finds those objects whose parent name meets the conditions (e.g. the parent is the containing site for a piece of equipment). b Name: name of the object to be searched. The _ and ? characters match an arbitrary single letter, while % and * match an arbitrary string. The expressions in separate lines will be in OR relation with each other. c Without: characters to be ignored by the system (the format is the same as above) d Type: the type of the object to be searched. Subtype can also be given for equipment, equipment template and measurement type. e 3 Results count: maximum number of results
Click OK; The results are displayed as well as the searching string as it could be given at simple search.
StarQuality
243
User Manual
Site and Equipment Configuration
9.3

The following topics are covered in this section: Object Hierarchy Overview on page 244 Site and Equipment Configuration on page 245 Equipment Configuration on page 252
9.3.1
9.3.1.1
Object Hierarchy Overview

Non-virtual Objects
There are three non-virtual object types in the system obeying the following three rules: Sites: Each site has a name and an optional descriptive text. Each site can contain arbitrary many sites and equipments. Each site may reside below another site, and this relation can be modified during the existence of the site. The initial site (ROOT) is an exception to this rule and can only contain sites and cannot be modified or deleted. The name of the site has to be unique only inside the site containing it, although it is recommended to keep it globally unique. Equipment: Each piece of equipment belongs to a site. This relation can be modified during the existence of the equipment. The name of the equipment has to be unique in the whole system globally. Measurements: The equipments contain the measurements which cannot be moved to another piece of equipment.
9.3.1.2
Virtual Objects
In the StarQuality system the administrator and the restricted administrator users can create sites, equipments and measurements. These items are immediately available for authorized users too: they appear under for example the Measurements menu item, where the individual elements are displayed in the same division and in the same way as the administrators have specified during creation.
StarQuality
244
User Manual
This initial hierarchy and its objects are called basic or normal objects. Parallel to this structure both administrators and normal users can develop their own structures; moreover, administrators can create public structures as well. Each level of the basic hierarchy has its parallel equivalent: Virtual site: corresponds to a site object; can be placed under any basic or virtual site, and can contain virtual sites, virtual equipment and linked basic equipments Virtual equipment: corresponds to an equipment object; can be placed under any basic or virtual site, and can contain measurements and private/public charts Private/public charts: correspond to the measurement object; in contrast to that, however, it can contain not only one or two measurement values but also arbitrary measurements and report summaries of an arbitrary piece of equipment. It can be placed under virtual equipments manually. It can automatically appear under basic equipment too if it contains a measurement running on the given equipment or a report summary for that equipment This parallel structure is used, according to the settings under the Preferences menu item, for the display of both measurements and thresholds filtered by site or equipment. Contrary to this, for the Reports menu item one can move along only the basic hierarchy. Virtual sites and equipments can be private or public objects:
Administrator users can create both types Admin users can only create public objects, Other users can only create private objects Restricted administrators can modify a public object if they created it. The configuration follows the same principles and there is only one restriction: only public virtual sites, equipments and measurements can be placed under public virtual sites, while only the private ones under private virtual sites.
9.3.2

The administration of the (basic and virtual) sites, (basic and virtual) equipments and measurements is performed under the Site and equipment menu item
StarQuality
245
User Manual
(Settings > Site and equipment configuration). You can also configure threshold settings (limited to measurement thresholds on a single equipment only, otherwise use the Settings > Threshold menu item, see Customization on page 259), and charts (of measurements from the same equipment in the hierarchy only, otherwise use the Settings > Customization > Public Charts (admin only) or Private Charts menu items). In the Site and Equipment Configuration the path showing the actual location within the hierarchy appears at the top of the page, and stay visible even if the page is scrolled (see Figure 9-1). To return to a higher hierarchy level, click on the elements of the list, except the last one.
NOTE If you navigate to an equipment through one of its virtual sites, then after any equipment modification you cannot return to that point in the virtual hierarchy, since the application modifies the current location according to the normal hierarchy, i.e. it will show the equipment under its parent site.
9.3.2.1

The following functions are available for viewing site data (see Figure 9-1):
Go to measurements and Go to alarms - jump to these main menu items by keeping the selected hierarchy item. Modify equipment, Modify equipment without discovery, Deactivate data collection - For non-virtual equipment, accessing different equipment modification modes (see Equipment Modification on page 252).
New threshold, New group threshold, New threshold from template For non-virtual equipment, accessing the threshold configuration pages (refer to Setting Alarm Thresholds on page 185).
Edit public charts - For non-virtual equipment, accessing and private or public chart template configuration pages (see. WiMAX inventory report - Displays a table of all the CPEs in the site, from a single BTS to the whole network. The information includes BTS no., BTS name (by StarQuality), Serving BS, and CPE MAC address.
StarQuality
246
User Manual
Operations Drop-down Menu
Figure 9-1: Site and Equipment Configuration Window with Operations Drop-down Menu
9.3.2.2
Adding and Editing Sites

You can create objects by selecting the kind of object from the scroll down menu in the table header under the basic or virtual site (see Figure 9-2).
To add or edit a site: 1 2 Select Settings > Site and Equipment Configuration. Select the site that should contain the new one, then from the Creating drop-down menu select New Site. 3 Fill in the site name, its description and choose the corresponding icon and server group. Click OK. 4 To modify a site, click either [edit] or [del]) next to the site. Only empty sites can be deleted.
StarQuality
247
User Manual
Figure 9-2: Adding a New Site
9.3.2.3
Creating and Editing Virtual Sites

The creation and editing of virtual sites is performed similarly to non-virtual sites (See above). When adding a virtual site, select the New public or New private site item from the pull down menu. The main difference is that under virtual sites, basic sites or equipment cannot be created (the latter can be only linked), therefore no server groups can be specified.
9.3.2.4
Managing Unsuccessful Measurements

StarQuality allows you to search for inactive equipment and unsuccessful measurements to either delete or deactivate. Thus, StarQuality will not waste resources by attempting to collect data that is unavailable. Such situations may appear, for instance, if StarQuality cannot contact a base station or download a TFTP file. Another possible occurrence would be a case of mismatch between a measurement version and its device version (for instance a 4Motion v.2.5 specific measurement or a new 4Motion 3.0M measurement on a 4Motion v.3.0 device). A piece of equipment is considered inactive (unsuccessful) if none of its measurements are successful. Equipment can either be deleted or deactivated. Measurements can only be deleted.
To manage unsuccessful measurements: 1 Select Settings > Site and Equipment Configuration > Unsuccessful measurements. The Search screen is displayed.
StarQuality
248
User Manual
Figure 9-3: Unsuccessful Measurements Search 2 Fill in your search criteria:
Check Inactive equipments if you are searching for inactive equipment or Unsuccessful measurements if you are searching for individual unsuccessful measurements,

3 4
Use the Server group drop box to select a collector group for your search. Use the Time span drop box to select for how long the items you are searching for must have been unsuccessful.
Click Search. The equipment or measurements that match your search criteria are listed below the search box. Use the check boxes in the first column to select the items you wish to delete or deactivate.
StarQuality
249
User Manual
Figure 9-4: Selecting Inactive Equipment 5 Select Deactivate data collection if you wish to deactivate the items you selected or Delete if you wish to delete them. Measurements can only be deleted. Equipment can either be deleted or deactivated. If you delete, you can also choose to Delete empty parent objects. This means that when, as a result of a deletion, a parent object remains empty, it is deleted as well. The empty parent deletion propagates upward through the hierarchy (if the parents parent is now empty, it is also deleted and so forth). 6 Click Next. A confirmation page is displayed listing the equipment or measurements that will be deactivated or deleted.
Figure 9-5: Inactive Equipment Deactivation Confirmation
StarQuality
250
User Manual
To change your selection, click Prev to return to the previous step. To continue, click the Deactivate data collection or Delete button (depending on your previous selection) to finalize the process.
9.3.2.5
Managing Inactive Equipment

StarQuality allows you to search for inactive equipment to either reactivate or delete.
To manage inactive equipment: 1 Select Settings > Site and Equipment Configuration > Inactive equipments. The Search screen is displayed.
Figure 9-6: Searching for Inactive Equipment 2 Click Search. The equipment or measurements that match your search criteria will be listed below the search box. 3 Use the check boxes in the first column to select the items you wish to delete or activate. 4 Select Activate data collection if you wish to activate the items you selected, or Delete if you wish to delete them. If you delete, you can also choose to Delete empty parent objects. This means that when, as a result of a deletion, a parent object remains empty, it is deleted as well. The empty parent deletion propagates upward through the hierarchy (if the parents parent is now empty, it is also deleted and so forth). 5 Click Next. A confirmation page is displayed listing the equipment that will be activated or deleted.
StarQuality
251
User Manual
Equipment Configuration
Figure 9-7: Inactive Equipment Deletion Confirmation 6 To change your selection, click Prev to return to the previous step. To continue, click the Activate data collection or Delete button (depending on your previous selection) to finalize the process.
9.3.3
9.3.3.1
Creating New Equipment from Template
The only templates available are either those not assigned to any site (general templates), or templates that are assigned to the current site (specific templates). If there is more than one available template, you choose the proper one. Then the system orders the templates so that the ones belonging to the data collector type of the current site are listed at the beginning. Refer to Discovery of WiMAX Devices on page 142.
9.3.3.2
Equipment Modification
To modify a piece of equipment: Use one of the following methods for equipment modification: Equipment Modification in Settings: a Click [Edit] next to the equipment name, or click the equipment icon and select Modify Equuipment from the Operations pull down menu; the system rediscovers the list of measurements that can be carried out on the equipment. The following notice appears on the page:
StarQuality
252
User Manual
Figure 9-8: Equipment Discovery Message The following page is displayed:
Figure 9-9: Equipment Modification Window b Modify each parameter and click OK; The equipment configuration page is displayed. Equipment modification from the site: when viewing sites, use the [edit] link in the equipment lines, or select Modify Equipment from the Operations pull down menu to display the same page as in the previous item with the only difference that after the modification the system returns to the site page. Equipment modification without discovery: During Equipment Modification, only the equipment parameters are modified, and not measurements. Accordingly, the StarQuality does not carry out the
StarQuality
253
User Manual
equipment discovery, and consequently the modifications can be performed faster, provided you modify equipment parameters only Activating/deactivating data collection: In the Operations pull down menu, either Activate or Deactivate data collection appears, depending on the equipment status. The turning on and off Data Collection operations corresponds to the setting and clearing of the Collect data check-box in Equipment Modification page (see Figure 9-9). After turning off the data collection, the StarQuality does not collect data from the equipment until the switch is turned back, but it does not delete the equipment either. Therefore, the equipment is displayed similarly to other equipment under the Measurements and Alarms menu items, and its threshold and charts definitions are also retained.
9.3.3.3
Viewing the Equipment Configuration

To view the equipment configuration, click on the icon of the equipment in the list; a page with similar structure is displayed, with the following differences: Only the active measurements are displayed, and they cannot be modified On this page the threshold settings related to the equipment is displayed, which can also be modified from here.
StarQuality
254
User Manual
Figure 9-10: Viewing Equipment with Additional Equipment Parameters
9.3.3.4
Bulk Deletion for Equipment

To delete multiple elements by using the Bulk Deletion wizard: 1 From the Operation pull-down menu select Bulk Deletion. This displays a Search screen where you can enter search rules for filtering the elements you wish to delete. There are two search interfaces available: simple and advanced. The simple interface requires you to type in your search rules, while the advanced interface uses graphical controls. You can toggle between them by clicking on Simple Search and Advanced Search respectively.
StarQuality
255
User Manual
Figure 9-11: Bulk Delete - Simple
Figure 9-12: Bulk Delete - Advanced 2 Fill in your search criteria, according to the following table: Table 9-1: Search Criteria Criterion
Search by parent attribute Field
Description
Select Yes to restrict your search to equipment that has the parent attribute enabled and No to disregard the parent attribute. Select the field based on which you wish to filter your results.
StarQuality
256
User Manual
Table 9-1: Search Criteria Criterion

Search Without Type Results count
Description
Type in a value that must apply to the field you selected. You can use ? and * metacharacters to replace a single character or a string of characters. Type in a value that must not apply to the field you selected. You can use ? and * metacharacters to replace a single character or a string of characters. Always choose Equipment Limits the maximum number of results. You can choose various amounts between 10 and 500 results.
The following checkmarks allow you to select how the deletion is applied and how it propagates through the hierarchy:
Delete non-empty sites - The process will make no exceptions if you attempt to delete sites that are not empty, erasing the site and everything below it.
Delete empty parent objects - If by deleting an object, its parent is left empty, the parent object is deleted as well. The deletion keeps propagating upward in the hierarchy (if the parents parent is left empty as a result, it is also deleted and so forth). Empty equipment objects are not affected by this command, requiring distinct confirmation.
Delete empty equipments - If by deleting an object, its parent equipment is left empty, the parent equipment is deleted as well.
Click OK. This lists all the items that fulfill your search criteria. You can adjust the search results by entering new search criteria and running a new search.
From the list, select each item you wish to delete by checking its corresponding checkmark in the first column.
StarQuality
257
User Manual
Figure 9-13: Item Selection 6 Click Select to finalize.
StarQuality
258
User Manual
Customization
9.4
Customization
In this menu item (Settings > Customization) you can make user-specific settings (non-administrator users) and system level settings (admin users).
9.4.1
Setting E-mail Addresses (Admin only)

All users (except limited ones) may set up one or more e-mail address to which the system can send notifications on threshold violations. A prerequisite to the actual e-mail sending is that the StarQuality server has been configure with an active SMTP server.
To set an e-mail address: 1 From Settings > Customization select E-mail Addresses; A list of addresses appears. 2 Click [add new]; The E-mail Address Configuration window is displayed.
Figure 9-14: E-mail Address Configuration 3 Specify the following:
Name: It must be unique for each user. This name will appear in the selection list for in the Thresholds Configuration window. E-mail: The e-mail address to where the messages should be sent. Multiple threshold violations in one mail: In case of a single sampling interval in which multiple threshold violations occurred, it is possible to send the notification in a single e-mail (bulk) instead of sending them separately. The bulk mail is less detailed than the separate e-mail.
StarQuality
259
User Manual
Setting E-mail Addresses (Admin only)
Figure 9-15: Example of Separate Threshold Violation Notification
StarQuality
260
User Manual
Templates (admin only)
9.5
Templates (admin only)
Figure 9-16: Example of Bulk Threshold Violation Notification
MIB upload: Not applicable. Measurement type definitions: Not applicable. Equipment templates: Not applicable. Threshold templates: Editing threshold templates (see Setting Alarm Thresholds on page 185) Chart templates: Not applicable. Editing chart templates. Exclusion window template: Defining time frames in which thresholds can be activated/deactivated
StarQuality
261
User Manual
Server Configuration and Management (Admin only)
9.6
Server Configuration and Management (Admin only)

The following topics are covered in this section: Overview on page 262 Licences on page 263 Device and Measurement Summary on page 266 Server Configuration on page 266 Start/Stop/Status of Servers on page 272 Viewing Server Events on page 273 Collector Load on page 274
9.6.1
Overview
Server configuration and management refers to two server types: Default server: e.g. the application manager or the report counting server. The number of servers cannot be extended or limited. Measurement servers: arbitrary number of these can exist and each must belong to a measurement server group. There are three types of measurement servers matching the types given for the measurement server groups:
Active and discoverable: the measurements are actively made by the StarQuality application through the available API. The measurements supported by discoverable equipment can be discovered or queried through a suitable management protocol: e.g. the list of interfaces on network equipment or the list of disk partitions on a UNIX server. These are discovered and automatically monitored by the StarQuality (e.g. it automatically deletes them if the measurement has ended or the measurement name has changed). Even though the StarQuality automatically searches the measurements in such a case, they can also be manually recorded. If such a measurement is created, subsequent
StarQuality
262
User Manual
Licences
automatic discovery will not occur. Accordingly, if the measured object is deleted from the active equipment, it will not disappear from the StarQuality. This type of measurement will again be monitored automatically only if a new manual discovery is performed on the equipment through the web interface and it is saved afterwards. For certain discoverable servers there are measurement types (e.g. servers measuring IPSec) where no discovery is performed.
Active but non-discoverable: the measurements are actively made by the StarQuality application through the available API, but it is impossible to discover and monitor the measurements of the equipment. This is typical when parameters need to be set for the measuring system in order to start the measurements (e.g. one or more WEB server addresses should be given to measure HTTP services).
Passive and optionally capable of auto-discovery: the StarQuality only collects files containing measurement values in certain defined formats, and optionally records and deletes the pieces of equipment and measurements based on the collected data.
The Servers menu includes five submenus, described herein.
9.6.2
9.6.2.1
Licences
Overview
The licence for StarQuality is an encrypted file which defines: Validity period - either unlimited or temporary. Number of collector Network Elements (NEs) of any type - BTSs only (disregarding the number of AUs under each BTS. No. of SUs is unlimited, except for FDD 3.5/3.6: 10 SUs per BTS). The installation CD includes a temporary licence file for a limited period of time and limited number of NEs. To acquire the permanent licence, access the Alvarion on-line feature licence application (refer to Getting Feature Licenses Guide). You will be required to provide the Oracle database ID. You can find it by accessing Settings > Servers > Licenses. The database ID will be displayed at the top of the page, as shown in Figure 9-17.
StarQuality
263
User Manual
Licences
Figure 9-17: Licence Configuration Screen
9.6.2.2
Managing Licences
The Licences submenu is available only for admin users. You can edit the license table and compare the number of available and required licences. If there are fewer licences available than required for operating the system, or any of the licenses has expired, then users receive a warning message during the login process. Licence data can only uploaded and deleted but not edited. The individual columns are: Editing links:
[add new]: adding a new licence file [del]: deleting a licence entry
Name: Name of the licence
StarQuality
264
User Manual
Licences
End date: Expiration date of the given licence. If it is unlimited, then use never Quantity: Quantity of licences in the system. Can be unlimited. Needed: Quantity required to operate the system Error type: In those rows where the licence is invalid an error message is shown and the row is displayed in red. Possible error messages:
Wrong checksum: invalid line since someone directly modified the licence entry Expired: licence was valid for a limited period only which has expired No licence found: the given licence entry is required but not found Low licence quantity: the quantity of the given licence is not enough for the system
A licence can be added by providing a licence file. During this process the application keeps the already existing licence entries or modifies them if they exist in the file.
To add a new licence: 1 2 3 4 5 6 Place the licence file on the computer from which you activated the client. From Settings select Servers; the Servers tab is displayed. Select Licences. The Licences Configuration window is displayed. Click [add new] and browse for the file containing the license. Click OK. A list detailing the licenses is displayed. Verify that the entry in the license list is not colored red.
StarQuality
265
User Manual
Device and Measurement Summary
9.6.3
Device and Measurement Summary

You can display a list of all basic equipments, and for each measurement type the number of objects in the system.
To use the summary list: From Settings select Servers > Device and Measurement Summary; A table of all devices is displayed, indicating the site and equipment name, IP address, F H C A and total number of measurements.
Figure 9-18: Device and Measurement Summary
9.6.4
Server Configuration
Server configuration is available for the admin users only. You can add new servers, or delete and modify existing servers.
To access the Server Configuration: 1 2 From the main menu select Settings. From the Settings panel select Servers > Server Configuration; A list of all configured servers is displayed.
StarQuality
266
User Manual
Figure 9-19: Server Configuration Window The following information is displayed in the table: ID: unique identifier of the server. It is used when starting and halting the server from the command line, or when displaying the summary of the collected data for the measurement servers. Name: the name of the server Status: status of the server: running, not running, or unknown; Refer to Editing Server Configuration on page 269 Type: the type of the server; or the type of the server group for collector servers: SOAP, Manager, Event Server group: for a measurement server the name of its group Host: the host computer of the server Login: the user name used to login to the machine
StarQuality
267
User Manual
Pwd: user password. If it is not set, the application can still log in if SSH key-based authentication is configured Directory: the directory of the StarQuality application. The name of the directory should be an absolute path (i.e. it should started with /) Param1 and Param2: Further parameters depending on the type of the server, displayed with the appropriate name.
Measurement server:
Persistent SSH and SFTP connection (Param1): Whether the SQLLDR

and the MANAGER server can keep a persistent SSH and SFTP connection with the measurement server or not. Persistent connection is strongly recommended since nonessential logins and logouts can be avoided. There is only one case when non-persistent connection is necessary: in the case of certain former SSH implementations the established SFTP connection has fully utilized the CPU of the target machine, even when no operation was executed
How many seconds should the system wait for collector result if it is not
running (Param2).
Application manager:
Cycle (in sec): The number of seconds waited between server monitoring Number of files: During self-testing the system checks the number of
files in the tmp/done directory that executes the data loading component. If this is higher than the value specified here, the system generates a server event and notifies the operator.
Data compression and moving and partition creation: the time of running (HH:MM): These servers execute operations once a day (though they are continuously running). Partition creation is an exception since the daily operation is executed immediately at startup.
Threshold procession and report creation: the maximum time period (in hours) of former data to be processed at startup. At startup both of these servers determine the time up to which the individual thresholds as well as report variables were processed, and if the hour of the last processing is smaller than the current hour minus the specified time period, then they consider the processing to be done up to the current hour minus the specified time period. For example: if the five-minute thresholds were
StarQuality
268
User Manual
processed by the server up to 8:55, and it is restarted at 18:05 (same day), and the set value is 6, then processing will only be continued from 12:00
9.6.4.1
Editing Server Configuration

During the configuration of the servers the following fields can be modified: name, host, login, password and the optional parameters. The host, login and directory parameters can only be modified if the given server is not running.
To edit a server configuration: 1 Click [edit] next to one of the entries; the Server Configuration editing window is displayed.
Figure 9-20: Editing Server Configuration 2 Specify the required information: name, host, login, password and the optional Param1 and Param2. 3 Click OK.
9.6.4.2
Adding a New Server

Adding and deleting a server is possible for measurement, SOAP, secondary application manager and secondary event receiver servers. When a measurement server is added, a server group is also added to the table in the Server Configuration window.
StarQuality
269
User Manual
To add a new server: 1 In the Server Configuration window, click [add new]; The server Configuration editing window is displayed.
Figure 9-21: Server Configuration - Adding New 2 Specify the required information: Name, type, host, login, password and directory. 3 Click OK.
9.6.4.2.1
AlvariSTAR -> StarQuality Device Discovery

For the AlvariSTAR -> StarQuality device discovery functionality, there are some specifics: The AlvariSTAR server must be on. Use the Start/Stop/Status control in the taskbar to start the server. Port 10161 must be opened. Only one AlvariSTAR -> StarQuality module can be created. You must fill in fields for the SOAP URL, the AlvariSTAR server and for the site under which the base stations will be imported, in addition to the regular StarQuality server module parameters: name, type, host, login, password and directory.
StarQuality
270
User Manual
If the base station already exists in StarQuality, the name, timeout, retry and community values are synchronized. StarQuality waits an hour after each cycle. After each successful cycle, a summary is saved in the /opt/StarQuality/logs folder, in the AS2SQ.YYYYMMDD.log.Logs file, where YYYY stands for the year, MM for the month and DD for the day. The module allocates sites below the specified site based on collector type: 4Motion, Extreme, BreezeACCESS, etc. If the right collector type is already defined, the site will be added to it. Otherwise, a corresponding collector type will be created. AlvariSTAR SOAP URL can be one of the following: http://IP.address:8080/bwanmsws/ http://IP.address:8080/bwanmsws/entitymanager/ http://IP.address:8080/bwanmsws/configurationservice/ The AlvariSTAR license must contain the Web Services NBI feature
NOTE Forwarding threshold crossing alarms from StarQuality to AlvariSTAR requires configuring the SNMP trap parameter for the respective alarms.
StarQuality
271
User Manual
Start/Stop/Status of Servers
Figure 9-22: Adding a New AlvariSTAR -> StarQuality Module
9.6.5
Start/Stop/Status of Servers
This feature is available for the admin and administrator users only. The page displays the current status of servers by color coding. The columns of the table are identical to the table in Server Configuration on page 266 (except for password). You can start and stop the servers and check for their status manually, in addition to the automatic server check of the application manager. The page is continuously refreshed. After starting and stopping server(s) the subsequent refreshing also checks their status. The servers can be in three different statuses: Running, Not running and Unknown. Unknown status means that it cannot be determined whether the server is running or not: for example it is impossible to login with the specified data to the computer running the server. Only measurement servers with running status will be assigned to measure
equipments. A server may be configured to the equipment, and another server is modified to be a secondary measurement server. Each measurement server measures all those pieces of equipment where it is a primary or secondary server, and after a certain period it deletes secondary server registrations where it is the primary server. Due to this algorithm no measurement would be omitted even if, for example in a measurement server group, one of the servers is started when another server has already been run: even though load balancing transfers a certain part of the equipment, both of them will measure the transferred pieces of equipment temporarily.
StarQuality
272
User Manual
Viewing Server Events
To use the Server Start/Stop/Status window 1 From Settings select Servers > Start/Stop/Status. A list of all servers is displayed. Running servers are colored green, Not running servers are colored red.
Figure 9-23: Server Status 2 Click either Start or Stop to change the status, or Check to manually check and refresh the status.
9.6.6
Viewing Server Events

The application manager module (or modules if the secondary application manager is also installed) periodically performs different verifications in connection with the database and the machines running StarQuality. You can view the results of these verifications and the log entries created when modules are started or stopped.
To access the Event Server list: From Settings select Servers > Server Event; The server events list is displayed.
StarQuality
273
User Manual
Collector Load
Figure 9-24: Server Events Window
9.6.7
Collector Load
This feature is available for the admin and administrator users only. You can view results for all possible measurement times, and the list of measurements that were unsuccessful at a given time.
To use the Collector Load Information: 1 From Settings select Servers > Collector Load; The list of measurement servers is displayed, with the following information:
General information: name, type, status and group Size of the data files created by the server Total number of equipments connected Total number of measurements performed. The maximum number of measurements for a single collector is 370,000. F H C A - identifies the type of the measurement: F for traffic, H for error, C Deprecated and A for Alvarion measurements.
StarQuality
274
User Manual
Collector Load
Figure 9-25: Collector Load 2 You can use the scroll down menu in the Import Statistics column to display results for all possible measurement times, independently from the fact whether a measurement of that interval currently belongs to the given measurement server or not (since the query examines data collected earlier, too). As a hint the current time interval is indicated in green, with the number of measurements running with that interval. If you select a different interval, the Statistics page is automatically displayed. 3 Click the [view] link in the first column; A page identical to the one displayed from Settings > Measurements > Summary is displayed, filtered by the selected measurement server.
Figure 9-26: Collector Load Statistics 4 You can view the list of measurements that were unsuccessful at a given time by clicking on the [view] link: The list of devices and measurements are
StarQuality
275
User Manual
Collector Load
displayed together with another link that opens to the configuration panel of the device.
Figure 9-27: Missing Measurements at a Given Time
StarQuality
276
User Manual
Audit Trail
9.7
Audit Trail
The application records each configuration modification equipment, site, measurement creation, modification, deletion, modification of reports and thresholds, etc. that can be displayed under the Audit Trail menu item. The administrators are allowed to view every change, the restricted administrators are allowed to view only those changes which were made by themselves. The other users do not have access to this functionality. It also saves the name of the user who made the modification. It either equals to the user name at the WEB interface or it is a system value, if it was an automatic modification (e.g. an interface was cancelled in the equipment).
To start an audit trail query: 1 From Settings select Audit trail; The Audit Trail query page is displayed (Figure 9-28).
Figure 9-28: Audit Trail Query
StarQuality
277
User Manual
Audit Trail
Enter the filter conditions:
Object type: Select a type from a scroll down menu. Possible values:
All: no type based filtering Other: only the operations for the object types adequate for the
selection appear
Parent name: The name of the parent object; it can contain values only for equipments, measurement reports and chart elements Name: Object name Modified by: Name of the modifier. It is displayed only for the administrator users since the restricted administrators cannot view a change if it wasnt made by themselves.
From and To: When it was modified (from-till) All results: Maximum number of displayed results. Mandatory to fill in
Click OK; The query produces a table with columns similar to the search results with the following additional items:
Operation: Insert, Modification or Delete Object type Name Parent name Modified by Modification time
StarQuality
278
User Manual
Audit Trail
Figure 9-29: Audit Trail Entries 4 For update type changes, the first column also contains a [view] link; Click it to display the exact description that contains, the modified value in addition to the above elements.
Figure 9-30: Viewing the Audit Trail
StarQuality
279
User Manual
User Administration (Admin only)
9.8
User Administration (Admin only)

The administrator user can manage the list of users and their permissions, and add new users to the system. Every administrator has the right to modify normal users, while only the admin user can modify administrators. Restricted administrators cannot modify a user except if it was created by themselves. No user can delete the admin user.
9.8.1
Registering/Modifying Users
To add or modify users: 1 From the Settings menu select User. The browser displays a list of user administration tasks. The Users tab displays a list of existing users.
Figure 9-31: Users List 2 Select either [add new] or [edit] to modify a user (select [delete] to delete a user from the list); the following user definition fields are displayed.
Figure 9-32: User Administration
StarQuality
280
User Manual
User Permissions (Rights)
Specify the following parameters for the added or modified user:
Name: The name of the user, e.g. First-name Family-name Login: The user will be able to login with this name. It is suggested to use the small case letters of the English alphabet. The given value must be unique
Password: An initial password. If you do not specify a new password, then only the name and the admin fields are modified. Admin: This option is only available if you are logged in with the admin user. The options are:
)
Table 9-2: Admin Registering Optionsa Option

Yes Restricted No
Description
Provide the registered user with administrator rights Provide the registered user with restricted administrator rights Provide the registered user with normal or restricted rights based on the value of the next parameter
a. Refer to User Types and Their Settings on page 6 for more information
Can modify own settings: The user can only modify their password, preferences, own virtual hierarchy and charts if this field is checked. For administrator and restricted administrator users this is always set automatically.
9.8.2
9.8.2.1

Overview
For normal users, the access rights can be changed in four different levels: Site, equipment, measurement: These three objects are in a tree hierarchy, in which you can choose the items that the user can view. If you appoint one of these objects, then all objects below it can also be accessed by the user. For example, if the user has the access rights to the ROOT item (zero level site), all the objects in the system are accessible. If the user has access rights to one site, then all sites, equipment and measurements below it are accessible; however if access rights are provided only for the equipment, then
StarQuality
281
User Manual
only that equipment and its measurements are accessible; access right to the measurement only makes only that measurement accessible. Note that the rights are given only for the base hierarchy, and not for a virtual site, equipment or public chart, since the system calculates the permissions for these from the corresponding base objects. Chart: For each individual chart it can be specified whether the user can view it or not. Report: For each individual report, the user access can be set independently, which will be later combined with the access rights specified for the related site-equipment, so for example in a chart containing sites, only those rows for which the user has the rights are displayed. Threshold: Specifies if the user may view the threshold violations or not. If yes, then the system calculates also the domain of the viewable thresholds automatically based on the privileges of the base object. This entry is missing for the restricted administrators because they have always the right to see (and edit) thresholds.
9.8.2.2
Modifying User Rights

If you modify a user as a restricted administrator then you can grant rights only for those objects for which you have right as well. Later on an administrator can grant more right to the user. However, if the right setting for a restricted administrator is edited (even if there was no change), then the system automatically checks all users created by that restricted administrator and revokes the rights for all objects for which that restricted administrator does not have right. The user can view certain measurements without any special settings, those that belong to some of the agents. This is true only if the user can view the equipment, and the measurement of the agent is the same as the name of the equipment, or starts with that name and is followed by a space. The set of visible public virtual sites, pieces of equipment and charts are determined automatically based on the measurement objects accessible by the user. For example: The users can only view a public virtual site if they have the right to view its real or virtual parent site
StarQuality
282
User Manual
The user scan view a virtual piece of equipment if they have the right to see all charts of that equipment. The user can view a public chart if they can view all measurements displayed on the chart.
To modify user rights: 1 From Settings > User select User Rights; The User Rights window is displayed.
Figure 9-33: User Selection 2 Select the user type and select whether the equipments and the measurements should also be included in the list of displayed objects. 3 Click OK; The User Rights modification window is displayed. The elements that cannot be accessed by the user are displayed on the left-hand side, while those that can be viewed on the right-hand side.
Figure 9-34: User Rights Modification
StarQuality
283
User Manual
High Availability Performance
Select one or more items from either of these lists and move them to the other side by clicking on the appropriate arrow. The program automatically filters out the elements whose parent already available in the hierarchy above is present. For example if you mark all basic equipment and sites and move them to the right hand side of the window, after saving the modification only the ROOT object (the topmost) will remain in the right list.
9.8.3
High Availability Performance

StarQuality is able to provide high availability as a result of using measurement server groups. Different strategies must be applied depending on the number of machines serving StarQuality and its Oracle database. However, for all strategies except the non-measuring server components, it is recommended to install all components on the same machine with Oracle. The report and threshold modules can be relocated to another machine if there is enough capacity.
StarQuality
284
User Manual
Chapter
10
Northbound Interface (NBI)
In this chapter
Introduction on page 287 e-mail Notifications of StarQuality Server Events on page 288 e-mail Notifications and Traps of Threshold Crossing Events on page 289 SOAP Interface on page 290
StarQuality
286
User Manual
Introduction
10.1
Introduction
The StarQuality Northbound Interface (NBI) functionality provides the following capabilities: Sending e-mail notifications to any number of recipients regarding server management events Sending e-mail notifications to any number of mail recipients and/or SNMP traps to any number of upper level management system (OSS) regarding threshold crossing events. Performing operations using the SOAP interface.
StarQuality
287
User Manual
e-mail Notifications of StarQuality Server Events
10.2
e-mail Notifications of StarQuality Server Events

The StarQuality server can be configured to send e-mail notifications to a list of recipients about various events occurring within the system. For example: server up/down, collection failure. A prerequisite for the actual e-mail sending is the configuration of the StarQuality server with an active SMTP server.
StarQuality
288
User Manual
e-mail Notifications and Traps of Threshold Crossing Events
10.3
e-mail Notifications and Traps of Threshold Crossing Events
10.3.1 e-Mail Notifications

A prerequisite to the actual e-mail sending is that the StarQuality server has been configured with an active SMTP server (PVSR_EMAIL_ADDRESS is not mandatory).
To set e-mail notifications: 1 In order to receive e-mail notifications, define the address list as described in Setting E-mail Addresses (Admin only) on page 259. 2 From the list, select the specific recipients for each threshold or threshold template as described in Setting Alarm Thresholds on page 185.
10.3.2 SNMP Trap Notifications

StarQuality Threshold Crossing Alerts (TCA) mechanism provides an interface From which SNMP traps can be sent to other management systems, in cases of actual threshold crossing events. The traps are constructed according to the designated StarQuality MIB supplied with the installation CD, ready for uploading to any trap receiving management system. Trap can be sent to one or more recipients and with different timetables. Refer to Setting Alarm Thresholds on page 185.
StarQuality
289
User Manual
SOAP Interface
10.4
SOAP Interface
StarQuality SOAP interface enables various NBI operations via third party applications. A prerequisite for enabling SOAP operations is activation of the StarQuality SOAP server. For description and instructions on available operations, refer to the StarQuality SOAP Manual.
StarQuality
290
User Manual
Chapter
1 1
Device Specific Information
In this chapter:
Introduction on page 293 BreezeMAX FDD and TDD Equipment on page 294 BreezeACCESS VL on page 301 4Motion on page 308 BreezeMAX Extreme on page 345
StarQuality
292
User Manual
Introduction
11.1
Introduction
This chapter provides device specific information regarding software compatibility and limitations, traffic and performance counters, codes for thresholds and default built-in reports. This information may help you focus on the details required for each equipment type when using StarQuality. KPIs (Key Performance Indicators) exist for three types of entities: Slot (also referred to as AU, sector, BS) SU (also referred to as MS, CPE) NPU (also referred to as BTS, in common measurements)
StarQuality
293
User Manual
BreezeMAX FDD and TDD Equipment
11.2
BreezeMAX FDD and TDD Equipment
11.2.1 Overview
The information in this section is common to the following equipment types:
BreezeMAX FDD SNMP BreezeMAX FDD BreezeMAX TDD
SW Compatibility:
FDD - 3.5/3.6 (SNMP based collection) FDD 3.7 TDD - 4.5/4.6
Refer to the Release Notes for specific Firmware versions. Collector type
FDD 3.5/3.6 - WiMAX FDD SNMP FDD 3.7 - WiMAX FDD TFTP TDD - WiMAX TDD
11.2.2 Network Discovery Prerequisites

Table 11-1: BTS Configuration Requirements Requirement
Collection Interval Setting (rbCollectionStatisticsInterval) StarQuality registered as Authorised Manager (Traps disabled) PM/TM Collection Activated
FDD SNMP
900 sec. +
FDD TFTP
TDD
+ +
+ + (Mode: Basic
StarQuality
294
User Manual
Key Performance Indicators (KPIs)
Table 11-1: BTS Configuration Requirements (Continued) Requirement

PM/TM Collection Contents
FDD SNMP
FDD TFTP
TDD
11.2.3 Key Performance Indicators (KPIs)

11.2.3.1 BS KPIs
Each of the following is available for both Downlink (DL) and Uplink (UL): Table 11-2: FDD and TDD Traffic BS KPIs Counter
Air Link Utilization (%)
Description
The utilization of available wireless link resources: Total used symbols during the collection period as a percentage of total symbols available.
Total symbols Qty used Air Link Utilization% = 100 -------------------------------------------------------Total symbols available Subscription (%) Subscription (%) = The throughput (based on the total traffic rate taking into account the unusable gap period in each frame) as a percentage of total provisioned MIR. The higher this value, the higher is the actual utilization by users of the provisioned MIR.
If Constant throughput >0

then Throughput Const throughput 100 -------------------------------------------------------------------------- CIR&MIR
Otherwise
Throughput 100 -------------------------------- CIR&MIR
Constant throuput = Throuput CIR&MIR
MIR+CIR Allocated (bits per second)
The total Maximum Information Rate (MIR for all BE and NRT services and CIR for RT and CG services) provisioned to connected SUs.
StarQuality
295
User Manual
Table 11-2: FDD and TDD Traffic BS KPIs Counter Description

Stop_time_quarter Provisioned MIR for BE and nRT registered + Provisioned CIR for RT & CG registered 1000 ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- Stop_time Start_time ------------------------------------------------------ bps Start_time_quarter 15min The Committed Information Rate (CIR for NRT, RT and CG services) provisioned to SUs connected to the AU/FDD Micro Base Station.
MIRCIR =
CIR Allocated (bits per second)
CIR =
Stop_time_quarter Provisioned CIR for nRT and CG registered 1000 -------------------------------------------------------------------------------------------------------- Stop_time Start_time ------------------------------------------------------ bps Start_time_quarter 15min Total symbols used.
Throughput (bits per second)
Total symbols used in bytes considering rate 8 Rate = Throughput = ---------------------------------------------------------------------------------------------------------------------------------------------------------------------Stop_time Start_time ------------------------------------------------------ Total symbols available T_symbol bps 15min Total Used Capacity Rate (bps) Calculation formula per each rate: Stop_time_quarter Symbols[Ra] b 8 --------------------------------------------------------------------------------------------------- Total symbols available T_symbol [bps] Start_time_quarter When: a - modulation rate b - bytes per symbol for this modulation rate Number of connected SUs SUs with active services Throughput of each MCS for the uplink and downlink directions
11.2.3.2
SU KPIs
Performance KPIs include the uplink/downlink RSSI (Received Signal Strength Indicator), SNR (Signal to Noise Ration) and modulation rate (from rate 1 (BPSK 1/2] to rate 8 [64QAM 3/4]) measurements for all SUs. Note the following regarding FDD ver3.5/3.6 SUs (SNMP based data collection):
StarQuality
296
User Manual
The number of SUs is limited to 10 per BTS Only a single value per each counter is displayed according to its value at the time of sampling.
Table 11-3: FDD/TDD Performance Counters (File Collection) Counter

Uplink RSSI Average/Max/Min (dBm)
Description
The average/maximum/minimum RSSI value of the signal from the SU measured at the AU/FDD Micro Base Station for the past 15 minutes. In TDD there is only Average. The average/maximum/minimum RSSI value of the signal from the AU measured at the SU (and reported over the air to the Base Station equipment) for the past 15 minutes. In TDD there is only Average.. The average/maximum/minimum SNR value of the signal from the SU measured at the AU/FDD Micro Base Station for the past 15 minutes. The Average/maximum/minimum SNR value of the signal from the AU measured at the SU (and reported over the air to the Base Station equipment) for the past 15 minutes. From rate 1 (BPSK 1/2) to rate 8 (64QAM 3/4) From rate 1 (BPSK 1/2) to rate 8 (64QAM 3/4) BTS uptime in seconds
Downlink RSSI Average/Max/Min (dBm)
Uplink SNR Average/Max/Min (dB)
Downlink SNR Average/Max/Min (dB)
Uplink Rate Average/Max/Min Downlink Rate Average/Max/Min Uptime
Table 11-4: FDD TFTP Measurements Counter

Drop Ration (%)
Members DL w ARQ UL w ARQ UL w/o ARQ
Acknowledged Bytes (Bytes)
Uplink Downlink
CRC Errors (Count) Discard Bytes in ARQ (Bytes) Drop Bytes (Bytes) Duplicate Discard Bytes (Bytes)
Uplink Uplink Downlink Uplink
StarQuality
297
User Manual
Table 11-4: FDD TFTP Measurements Counter

Rate Average (Rate)
Members Uplink Downlink
Rate Max (Rate)
Uplink Downlink
Rate Min (Rate)
Uplink Downlink
Received Bursts (Count) Retransmitted Bytes (Bytes) RSSI Average (dBm)
Uplink Downlink
Uplink Downlink
RSSI Max (dBm)
Uplink Downlink
RSSI Min (dBm)
Uplink Downlink
SNR Average (dB)
Uplink Downlink
SNR Max (dB)
Uplink Downlink
SNR Min (dB)
Uplink Downlink
Throughput (bps)
Uplink Downlink
Total Discard Bytes (Bytes) Transferred Bytes (Bytes)
Uplink
Uplink Downlink
Uptime (Hours)
Value
StarQuality
298
User Manual
Codes for Threshold Setting
11.2.3.3
Common/BTS KPIs
Uptime
11.2.4 Codes for Threshold Setting

Table 11-5: Syntax for TDD/FDD AU Measurements Description Parameter FDD 35 (SNMP)
Total Used Capacity Rate 1 Total Used Capacity Rate 2 Total Used Capacity Rate 3 Total Used Capacity Rate 4 Total Used Capacity Rate 5 Total Used Capacity Rate 6 Total Used Capacity Rate 7 Total Used Capacity Rate 8 Subscription Air Link Occupation CIR Allocated MIR+CIR Allocated Throughput Number Of Connected SUs WCR1 WCR2 WCR3 WCR4 WCR5 WCR6 WCR7 WCR8 WMP WOCC WPC WPM WT WCS
FDD TFTP
FCR1 FCR2 FCR3 FCR4 FCR5 FCR6 FCR7 FCR8 FMP FOCC FPC FPM FT FCS
TDD
TCR1 N/A TCR3 TCR4 TCR5 TCR6 TCR7 TCR8 TMP TOCC TPC TPM TT TCS
Table 11-6: Syntax for TDD/FDD SU Measurements Description Parameter FDD 35 (SNMP)
Rate max Rate average Rate min SNR max SNR average SNR min WSU1 WSU3
FDD TFTP
FSU8 FSU9 FSU7 FSU5 FSU6 FSU4
TDD
TSU6 TSU7 TSU5 TSU2 TSU3 TSU1
StarQuality
299
User Manual
Default Built-in Reports
Table 11-6: Syntax for TDD/FDD SU Measurements Description Parameter FDD 35 (SNMP)
RSSI max RSSI average RSSI min WSU2
FDD TFTP
FSU2 FSU3 FSU1
TDD
TSU4
11.2.5 Default Built-in Reports

BottomN Uptime TopN Air Link Utilization TopN Throughput TopN Number of Connected SUs
StarQuality
300
User Manual
BreezeACCESS VL
11.3
BreezeACCESS VL
11.3.1 Overview
SW Compatibility: Version 6.0. (Up to 10 SUs per BTS can be measured) Collector type - WiMAX VL

StarQuality registered as Authorised Manager (Traps disabled) PM/TM Collection Activated

11.3.3.1 BS KPIs
Table 11-7: BreezeACCESS VL Traffic Counters Counter
Concatenated Frames Received (frames per second)
Description
The total number of concatenated frames received from the wireless medium, including duplicate frames. There are also separate counts for concatenated frames that include one frame (Single), two frames (Double) or more than two frames (More). The total number of concatenated frames transmitted successfully to the wireless medium, excluding retransmissions. There are also separate counts for concatenated frames that include one frame (Single), two frames (Double) or more than two frames (More).
Concatenated Frames Transmitted (frames per second)
StarQuality
301
User Manual
Table 11-7: BreezeACCESS VL Traffic Counters (Continued) Counter

Errors Received (frames per second)
Description Phy - The number of Physical errors (unidentified signals). CRC - The number of frames received from the wireless
medium containing CRC errors.
Overrun - The number of frames that were discarded because

the receive rate exceeded the processing capability or the capacity of the Ethernet port.
Decrypt - The number of frames that were not received properly

due to a problem in the data decryption mechanism.
Other - Errors other than previous counters. Duplicate Frames Discarded - The number of data frames
discarded because multiple copies were received. If an acknowledgement message is not received by the originating unit, the same data frame can be received more than once. Although duplicate frames are included in all counters that include data frames, only the first copy is forwarded to the Ethernet port. Errors Transmitted (frames per second)
Frames dropped (too many retries) - The number of dropped

frames, which are unsuccessfully retransmitted without being acknowledged until the maximum permitted number of retransmissions.
Underrun Events - The number of times that transmission of a

frame was aborted because the rate of submitting frames for transmission exceeds the available transmission capability.
Other TX Events - The number of frames whose transmission

was not completed or delayed due to a problem other than those represented by the other counters.
Internally discarded MIR/CIR - The number of data frames

received from the Ethernet port that were discarded by the MIR/CIR mechanism to avoid exceeding the maximum permitted information rate. Frames Received (frames per second) Frames Transmitted (frames per second) The total number of data frames received from the wireless medium, including duplicate frames. The total number of data frames submitted to the internal bridge for transmission to the wireless medium. The count does not include control and wireless management frames, or retransmissions. There are also separate counts for each priority queue through which the frames were routed (High, Mid and Low).
StarQuality
302
User Manual
Table 11-7: BreezeACCESS VL Traffic Counters (Continued) Counter

Wireless Frames Received (frames per second)
Description
The total number of frames received from the wireless medium. The count includes data frames as well as control and wireless management frames. The count does not include bad frames and duplicate frames. The number of frames transmitted to the wireless medium. The total includes one count for each successfully transmitted unicast frame (excluding retransmissions), and the number of transmitted multicast and broadcast frames, including control and wireless management frames. The sum of allocated CIR (Committed Information Rate) Downlink/Uplink values for all the SUs in the sector. The average throughput per second on the Ethernet port on Downlink/Uplink direction. The sum of allocated MIR (Maximum Information Rate) Downlink/Uplink values for all the SUs in the sector. The average Noise Floor recorded by the unit. SUs with active services The percentage of total number of retransmissions, including all unsuccessful transmissions and retransmissions, out of the total number of unicast frames transmitted over the wireless port. The average throughput per second on the Radio port on Downlink/Uplink direction. BS uptime in hours
Wireless Frames Transmitted (frames per second)
CIR Allocated (Bits per second) Ethernet Throughput (bits per second) MIR Allocated (bits per second) Noise Floor (dBm) Number of Connected SUs Retransmission (%)
Throughput (bits per second) Uptime (hours)
11.3.3.2
SU KPIs
Table 11-8: BreezeACCESS VL Performance Counters
Counter
Concatenated Frames, Receive (frames per second)
Description
The total number of concatenated frames received from the wireless medium, including duplicate frames. There are also separate counts for concatenated frames that include one frame (Single), two frames (Double) or more than two frames (More). The total number of concatenated frames transmitted successfully to the wireless medium, excluding retransmissions. There are also separate counts for concatenated frames that include one frame (Single), two frames (Double) or more than two frames (More).
Concatenated Frames ,Transmit (frames per second)
StarQuality
303
User Manual
Table 11-8: BreezeACCESS VL Performance Counters (Continued) Counter

Errors Received (frames per second)
Description Phy - The number of Physical errors (unidentified signals). CRC - The number of frames received from the wireless
medium containing CRC errors.
Overrun - The number of frames that were discarded because

the receive rate exceeded the processing capability or the capacity of the Ethernet port.
Decrypt - The number of frames that were not received properly

due to a problem in the data decryption mechanism.
Other - Receive errors other than previous counters. Duplicate frames discarded -The number of data frames
discarded because multiple copies were received. If an acknowledgement message is not received by the originating unit, the same data frame can be received more than once. Although duplicate frames are included in all counters that include data frames, only the first copy is forwarded to the Ethernet port. Errors Transmitted (frames per second)
Frames dropped (too many retries) - The number of dropped

frames, which are unsuccessfully retransmitted without being acknowledged until the maximum permitted number of retransmissions.
Underrun Events - The number of times that transmission of a

frame was aborted because the rate of submitting frames for transmission exceeds the available transmission capability.
Other TX Events - The number of frames whose transmission

was not completed or delayed due to a problem other than those represented by the other counters.
Internally discarded MIR/CIR - The number of data frames

received from the Ethernet port that were discarded by the MIR/CIR mechanism to avoid exceeding the maximum permitted information rate. Ethernet Throughput (bits per second) Frames Received (frames per second) Frames Submitted (frames per second) The average throughput per second on the Ethernet port on Downlink/Uplink direction. The total number of data frames received from the wireless medium, including duplicate frames. The total number of data frames submitted to the internal bridge for transmission to the wireless medium. The count does not include control and wireless management frames, or retransmissions. There are also separate counts for each priority queue through which the frames were routed (High, Mid and Low).
StarQuality
304
User Manual
Table 11-8: BreezeACCESS VL Performance Counters (Continued) Counter

Noise Floor (dBm) Retransmission (%)
Description
The average Noise Floor recorded by the unit. The percentage of total number of retransmissions, including all unsuccessful transmissions and retransmissions, out of the total number of unicast frames transmitted over the wireless port. Downlink RSSI value as measured in the time of sampling Downlink SNR value as measured at the time of sampling Sector throughput as measured at the time of sampling CPE uptime in hours The number of frames transmitted to the wireless medium. The total includes one count for each successfully transmitted unicast frame (excluding retransmissions), and the number of transmitted multicast and broadcast frames, including control and wireless management frames.
Downlink RSSI (dBm) Downlink SNR (dB) Throughput (bits per second) Uptime (hours) Wireless Frames (frames per second)

Table 11-9: Syntax for BreezeACCESS VL AU Measurements Description
Concatenated Frames Single Concatenated Frames Double Concatenated Frames More Concatenated Frames Total Errors Receive CRC Errors Receive Decrypt Errors Receive Duplicate frames discarded Errors Receive Other Errors Receive Overrun Errors Receive Phy Errors Transmit Frames dropped (too many retries) Errors Transmit Internally discarded MIR/CIR Errors Transmit Other TX Events Errors Transmit Underrun Events Frames Received - Total
Parameter
VCFS VCFD VCFM VCFT VERC VERD VERd VERo VERO VERP VETD VETI VETO VETU VFRT
StarQuality
305
User Manual
Table 11-9: Syntax for BreezeACCESS VL AU Measurements (Continued) Description

Frames Submitted High Frames Submitted Low Frames Submitted Mid Frames Submitted Total Wireless Frames Received Wireless Frames Submitted Beacons Wireless Frames Submitted OtherMng and Data Wireless Frames Submitted Total CIR Allocated Ethernet Throughput MIR Allocated Noise Floor Number Of Connected SUs Retransmission Throughput Uptime RSSI
Parameter
VFSH VFSL VFSM VFST VWFR VWFB VWFO VWFT VCA VETH VMA VNF VCS VR VTHR VUPT VRSS
Table 11-10: Syntax for BreezeACCESS VL SU Measurements Description

Concatenated Frames Single Concatenated Frames Double Concatenated Frames More Concatenated Frames Total Errors Receive CRC Errors Receive Decrypt Errors Receive Duplicate frames discarded Errors Receive Other Errors Receive Overrun Errors Receive Phy Errors Transmit Frames dropped (too many retries)
Parameter
VCFS VCFD VCFM VCFT VERC VERD VERd VERo VERO VERP VETD
StarQuality
306
User Manual
Table 11-10: Syntax for BreezeACCESS VL SU Measurements (Continued) Description

Errors Transmit Internally discarded MIR/CIR Errors Transmit Other TX Events Errors Transmit Underrun Events Frames Received - Total Frames Submitted High Frames Submitted Low Frames Submitted Mid Frames Submitted Total Ethernet Throughput Noise Floor Retransmission RSSI SNR Throughput Uptime Wireless Frames
Parameter
VETI VETO VETU VFRT VFSH VFSL VFSM VFST VETH VNF VRSU VRSS VSNR VTHR VUPT VWF

BottomN Uptime TopN Throughput TopN Number of Connected SUs
StarQuality
307
User Manual
4Motion
11.4
4Motion
11.4.1 4Motion Version Management

StarQuality may be configured to support specific 4Motion versions (2.5, 3.0 and 3.0M). Each version is enabled/disabled in StarQuality based on a parameter stored in the CONFIG_INI.pm file in /opt/starquality/etc/. The following parameters apply: $WIMAX_4Motion_VERSIONS{25} for version 2.5 $WIMAX_4Motion_VERSIONS{30} for version 3.0 $WIMAX_4Motion_VERSIONS{3010} for version 3.0M
IMPORTANT Follow the steps below in their exact order. For all the charts and measurements to display properly, you must enable the corresponding software version in StarQuality before the unit is discovered.
To setup the desired 4Motion versions: 1 2 Stop every 4Motion collector. Go to /opt/starquality/etc/ and open the CONFIG_INI.pm file. In the CONFIG_INI.pm file, set the corresponding $WIMAX_4Motion_VERSIONS parameters to 1 for enabling the version or to 0 for disabling it. For instance, to enable versions 2.5 and 3.0M and disable version 3.0, the following values apply: $WIMAX_4Motion_VERSIONS{25}=1 $WIMAX_4Motion_VERSIONS{30}=0 $WIMAX_4Motion_VERSIONS{3010}=1 3 Go to /opt/starquality/bin and run the drop_wimax_4Motion_charts.pl script file: cd /opt/starquality/bin ./drop_wimax_4Motion_charts.pl
StarQuality
308
User Manual
4Motion Version Management
NOTE If you are running StarQuality on Solaris, it must be run as starq user (#su - starq)
Start the 4Motion collectors.
NOTE Only 4Motion version 2.5 is enabled by default in StarQuality. You must enable SW versions 3.0 and 3.0M manually using the procedure described above. If a device is going to be upgraded, you must enable the new version in StarQuality first. Always check the 4Motion versions enabled in StarQuality before upgading a 4Motion device.
11.4.1.1
4Motion Version Compatibility

This StarQuality version supports 4Motion ver. 2.5M, 3.0 and 3.0M The 4Motion NPU firmware versions supported for all BTS types (Macro Indoor, Macro Outdoor and Micro Outdoor) are: 2.5.212.7 (2.5M1), 3.0.5.14 to 3.0.5.16 (3.0) and 3.0.10.3 (3.0m) Depending on each version, the following KPIs apply: Table 11-11: 4Motion KPIs
KPI Name in StarQuality

BS KPIs MCS Distribution Downlink MCS Distribution Uplink Uplink HARQ Packet Error Rate SINR Distribution Downlink SINR Distribution Uplink Air Link Utilization MAP Size Distribution Retransmission Downlink Noise Floor Uplink Throughput Average Backaul Traffic Active MS/Idle MS Registered MS
2.5M2
3.0
3.0M
Observations
Y Y Y Y Y Y Y Y Y Y Y N
Y Y Y Y Y Y Y Y Y Y N Y
Y Y Y Y Y Y Y Y Y Y N Y 2.5 name was Average Sector Throughput From 3.0M name changed to UL Dropped HARQ sub-bursts
StarQuality
309
User Manual
4Motion Version Management
Table 11-11: 4Motion KPIs (Continued) KPI Name in StarQuality

Active/Idle MSs Out of Registered Active MS/Idle MS Ratio MS Registration MS Registration Ratio MS Registration - Service Flows BS Traffic Type Burst Error Rate Downlink Burst Error Rate Uplink Burst Error Rate Ratio Downlink Burst Error Rate Ratio Uplink MS Hand Over MS Hand Over Ratio Spectral Efficiency of all MS Average Provisioned Downlink Average Provisioned Uplink MIR + CIR Provisioned MS KPIs CINR Downlink Min CINR Downlink Max CINR Downlink Average CINR Uplink Min CINR Uplink Max CINR Uplink Average Average Spectral Efficiency MCS Downlink MCS Uplink RSSI Downlink RSSI Uplink Throughput Total Transferred Bursts Y Y Y Y Y Y Y Y Y N Y N N N N Y N N Y N Y Y N Y Y Y Y Y Y Y Y Y N Y Y Y Y Y N From 3.0M name changed to Spectral Efficiency Downlink From 3.0 name changed to SINR From 3.0 name changed to SINR
2.5M2
N N N N N N N N N N N N Y N N N
3.0
N Y Y Y N Y Y Y Y Y Y Y Y Y Y Y
3.0M
Y N Y Y Y N Y Y Y Y Y Y Y Y Y N
Observations
From 3.0M name changed to Spectral Efficiency
StarQuality
310
User Manual
4Motion Ver.2.5
Table 11-11: 4Motion KPIs (Continued) KPI Name in StarQuality

Throughput Ratio MS Burst Error Rate Downlink MS Burst Error Rate Uplink MS Burst Error Rate Ratio Downlink MS Burst Error Rate Ratio Uplink Distributed ASNGW KPIs Average Backhaul Traffic R3 Throughput R3 MIR Throughput Oversubscription R3 CIR Throughput Oversubscription R6 Throughput R6 Total MIR R6 Total CIR ASN GW - MS Registration NE Failure Ratio Authentication Reject Ratio Service Flow Usage Ratio R6 MIR Throughput Oversubscription R6 CIR Throughput Oversubscription R3 Total MIR R3 Total CIR Y N N N N N N N N N N N N N N Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y N N N N N
2.5M2
N N N N N
3.0
Y Y Y Y Y
3.0M
Y Y Y Y Y
Observations
11.4.2 4Motion Ver.2.5

11.4.2.1 Overview
SW Compatibility - Versions 2.5M1 and 2.5M1 Refer to the release notes for details. Collector type - WiMAX 4Motion
StarQuality
311
User Manual
4Motion Ver.2.5
11.4.2.2
Network Discovery Prerequisites

PM/TM Collection Contents - All Management > Performance Categories checked For MS data - check All MS Basic Data (it is not checked by default)
11.4.2.3
11.4.2.3.1

BS KPIs
Table 11-12: Traffic Counters 4Motion Ver.2.5
Counter
Air Link Utilization (%)
Members
All UL Data Zone DL Data Zone DL Map Zone
Description
The utilization of available wireless link resources: Data utilization from all slots (including MAP, not including preamble and TTG/RTG) per BS as a percentage of total slots available for the uplink and downlink directions.
MAP Size Distribution (Frames)
2 Symbols 4 Symbols 6 Symbols 8 Symbols 10 Symbols > 10 Symbols
Number of frames per number of symbols per BS for the downlink direction.
MCS Distribution Downlink (Bits per Second) MCS Distribution Uplink (Bits per Second) Retransmission Downlink (HARQ Sub Bursts)
19 MCS values from QPSK 1/2 rep 6 To 64 QAM 1/2 MIMO B Total 0 Retransmissions 1 Retransmission 2 Retransmissions 3 Retransmissions 4 Retransmissions > 4 Retransmissions
Throughput of each MCS for the uplink and downlink directions
Number of transactions with a certain number of retransmissions per BS for the downlink direction.
StarQuality
312
User Manual
4Motion Ver.2.5
Table 11-12: Traffic Counters 4Motion Ver.2.5 (Continued) Counter

SINR Distribution Downlink (%)
Members
< 3 dB 3 9 dB 9 13 dB 13 17 dB 17 21 dB > 21 dB
Description
Percentages of CPEs per SINR range for downlink per bs.
SINR Distribution Uplink (%)
< 3 dB 3 7 dB 7 11 dB 11 15 dB 15 19 dB > 19 dB
Percentages of CPEs per SINR range for Uplink per bs.
Spectral Efficiency of all MS (Bits/Bin)
Average UL Average DL Max UL Max DL
Peak and average spectral efficiency values for all MSs in a BS for both downlink and uplink directions.
Throughput (Bits per Second)
UL Throughput DL Total DL MIMO A/BF DL MIMO B
Average sector throughput per BS (each measurement represents the average throughput of the passed sampling interval of 15 minutes).
Uplink HARQ Packet Error Rate (Dropped HARQ Sub Bursts)
11 MCS values from QPSK 1/2 Rep 6 To 64 QAM 5/6 And Total
Error rate of dropped packets after HARQ of each MCS per BS for the uplink direction.
Number Of Connected SUs (Count) UL Noise (Median) (dBm)
Value
Number of SUs that have been connected to the BS, for the whole 15 minute interval proceeding the PMTM file generation. The median extracted from the actual noise flow histogram
Uplink
StarQuality
313
User Manual
4Motion Ver.2.5
11.4.2.3.2
4Motion 2.5M BTS KPIs

Table 11-13: Common Measurements for 4Motion BTS
Counter
Uptime Average Backhaul Traffic (bits per second)
Description
BTS uptime in seconds Average data throughput (user IP packets) in both the downlink or uplink direction including: backhaul, bearer, external management, internal management and cascading
11.4.2.3.3
MS KPIs
Table 11-14: Performance Counters Per MS
Counter
Average Spectral Efficiency (bits/bin) CINR (db) MCS (bits/slot) (slot efficiency) RSSI Uplink (dBm)
Description
Average spectral efficiency values for both the downlink and uplink directions. Min, max and average values for the downlink and uplink directions Min, max and average Number of bits per slot for uplink and downlink directions Min, max and average values
11.4.2.4

Table 11-15: Syntax for 4Motion BS Measurements Description
Throughput Average Spectral Efficiency all MSs DL Retransmission, Above Four Retransmissions DL Retransmission, Four Retransmissions DL Retransmission, One Retransmission DL Retransmission, Three Retransmissions DL Retransmission, Two Retransmissions DL Retransmission, Zero Retransmission DL SINR Distribution, 11dB < SINR < 13dB DL SINR Distribution, 15dB < SINR < 17dB
Parameter
4AST 4SEA 4DR6 4DR5 4DR2 4DR4 4DR3 4DR1 4SD3 4SD4
StarQuality
314
User Manual
4Motion Ver.2.5
Table 11-15: Syntax for 4Motion BS Measurements (Continued) Description

DL SINR Distribution, 19dB < SINR < 21dB DL SINR Distribution, 23dB < SINR < 25dB DL SINR Distribution, 5dB < SINR < 9dB DL SINR Distribution, SINR < 5dB DL Slot Utilization, Data Zone DL Slot Utilization, Map Zone HARQ Packet Error Rate PER 16QAM 1/2 HARQ Packet Error Rate PER 16QAM 3/4 HARQ Packet Error Rate PER 64QAM 1/2 HARQ Packet Error Rate PER 64QAM 2/3 HARQ Packet Error Rate PER 64QAM 3/4 HARQ Packet Error Rate PER 64QAM 5/6 HARQ Packet Error Rate PER QPSK 1/2 HARQ Packet Error Rate PER QPSK 1/2 Rep 2 HARQ Packet Error Rate PER QPSK 1/2 Rep 4 HARQ Packet Error Rate PER QPSK 1/2 Rep 6 HARQ Packet Error Rate PER QPSK 3/4 HARQ Packet Error Rate Percent MAP Length Eight Symbols MAP Length Four Symbols MAP Length More Than Ten Symbols MAP Length Six Symbols MAP Length Ten Symbols MAP Length Two Symbols MCS Distribution 16QAM 1/2 MCS Distribution 16QAM 3/4 MCS Distribution 64QAM 1/2 MCS Distribution 64QAM 2/3 MCS Distribution 64QAM 3/4 MCS Distribution 64QAM 5/6 MCS Distribution QPSK 1/2
Parameter
4SD5 4SD6 4SD2 4SD1 4UD1 4UD2 4E06 4E07 4E08 4E09 4E10 4E11 4E04 4E03 4E02 4E01 4E05 4E00 4MS4 4MS2 4MS6 4MS3 4MS5 4MS1 4D06 4D07 4D08 4D09 4D10 4D11 4D04
StarQuality
315
User Manual
4Motion Ver.2.5
Table 11-15: Syntax for 4Motion BS Measurements (Continued) Description

MCS Distribution QPSK 1/2 Rep 2 MCS Distribution QPSK 1/2 Rep 4 MCS Distribution QPSK 1/2 Rep 6 MCS Distribution QPSK 3/4 Max Spectral Efficiency all MSs Number Of Connected SUs Slot Utilization ALL UL Noise (99th Percentile) UL Noise (Median) UL SINR Distribution, 17dB < SINR < 21dB UL SINR Distribution, 5dB < SINR < 9dB UL SINR Distribution, 9dB < SINR < 13dB UL SINR Distribution, SINR < 5dB UL SINR Distribution, SINR > 21dB UL Slot Utilization, Data Zone UL Slot Utilization, Feedback Zone
Parameter
4D03 4D02 4D01 4D05 4SEM 4CS 4UA 4UN1 4UN2 4SU4 4SU2 4SU3 4SU1 SU6 4UU1 4UU2
Table 11-16: Syntax for 4Motion Common Measurements Description

Uptime cntNpuBckhlPort cntNpuBearer cntNpuCascPort cntNpuExtMgmt cntNpuIntMgmt
Parameter
4UPT 4NT5 4NT1 4NT4 4NT2 4NT3
Table 11-17: Syntax for 4Motion SU Measurements Description

CINR Average CINR Max CINR Min
Parameter
4SU3 4SU2 4SU1
StarQuality
316
User Manual
4Motion Ver.3.0
Table 11-17: Syntax for 4Motion SU Measurements Description

MCS Average MCS Max MCS Min Uplink RSSI Average Uplink RSSI Max Uplink RSSI Min Average Spectral Efficiency
Parameter
4SU6 4SU5 4SU4 4SU9 4SU8 4SU7 4SU0
11.4.2.5

BottomN Uptime TopN Air Link Utilization TopN Average Sector Throughput TopN Number of Connected SUs
11.4.3 4Motion Ver.3.0

11.4.3.1 Overview
SW Compatibility - Version 3.0 Refer to the release notes for details. Collector type - WiMAX 4Motion
11.4.3.2

StarQuality
317
User Manual
4Motion Ver.3.0
11.4.3.3
11.4.3.3.1

BS KPIs
Table 11-18: Traffic Counters 4Motion Ver.3.0
Counter
Active MS / Idle MS / Registered MS (count)
Members
Registered MSs Qty Idle MSs Qty Active MSs Qty
Description
The MSs are sampled at the end of the 15 Min sample period
Active MS / Idle MS Ratio (%) Air Link Utilization (%)
Idle MSs Ratio Active MSs Ratio All UL Data Zone DL Data Zone DL Map Zone
Ratio of gauges mentioned above
The utilization of available wireless link resources: Data utilization from all slots (including MAP, not including preamble and TTG/RTG) per BS as a percentage of total slots available for the uplink and downlink directions. Counts the provisioned DL based on registered MSs per second. The graphs are per QoS. The calculation divides the accumulated value with 900 seconds.
Average Provisioned Downlink (bits per second)
RT CIR RT MIR UGS CIR eRT CIR eRT MIR nRT CIR nRT MIR BE MIR
Average Provisioned Uplink (bits per second)
BE MIR RT CIR RT MIR UGS CIR eRT CIR eRT MIR nRT CIR nRT MIR
Counts the provisioned UL based on registered MSs per second. The graphs are per QoS. The calculation divides the accumulated value with 900 seconds.
StarQuality
318
User Manual
4Motion Ver.3.0

BS Traffic Type (%)
Members
DL MIMO A Ratio DL MIMO B Ratio DL MIMO CDD Ratio DL MIMO BF Ratio
Description
Ratio is based on number of bursts counted in the sampled period
Burst Error Rate Downlink (count)
Succeeded transfer Qty Dropped Qty Repetitions
Counts the actual numbers of bursts in the sampled period
Burst Error Rate Ratio Downlink (%)
Succeeded Transfer Ratio Drop Ratio Repetition Ratio
Burst Error Rate Ratio Uplink (%)
Burst Error Rate Uplink (count)
Succeeded transfer Qty Dropped Qty Repetitions
2 Symbols 4 Symbols 6 Symbols 8 Symbols 10 Symbols > 10 Symbols
MCS Distribution Downlink (Bits per Second) MCS Distribution Uplink (Bits per Second) MS Hand Over (Count)
19 MCS values from QPSK 1/2 rep 6 To 64 QAM 1/2 MIMO B Succeeded HO Attempts Failed HO Attempts
Throughput of each MCS for the uplink and downlink directions
Counts number handover attempts both in and out
StarQuality
319
User Manual
4Motion Ver.3.0

Hand Over Ratio (%)
Members
Succeeded Attempts Ratio HO Attempts Ratio Failed Attempts Ratio
Description
Ratio calculation of counters mentioned above
MS Registration (Count)
Created Service Flow Qty Failed Initial NE Succeeded initial NE
Number of initial network entry attempts sampled
Registration Ratio (%)
Succeeded Service Flow Ratio Failed Initial NE Ratio Succeeded initial NE Ratio
Ratio of counters mentioned above
Retransmission Downlink (HARQ Sub Bursts)
Total 0 Retransmissions 1 Retransmission 2 Retransmissions 3 Retransmissions 4 Retransmissions > 4 Retransmissions
Number of transactions with a certain number of retransmissions per BS for the downlink direction.
< 3 dB 3 9 dB 9 13 dB 13 17 dB 17 21 dB > 21 dB
StarQuality
320
User Manual
4Motion Ver.3.0

Members
< 3 dB 3 7 dB 7 11 dB 11 15 dB 15 19 dB > 19 dB
Description
Spectral Efficiency of all MS (Bits/Bin)
Average UL Average DL Max UL Max DL
Uplink HARQ Packet Error Rate (Dropped HARQ Sub Bursts)
MIR + CIR Provisioned (Bits per Second) Number Of Connected SUs (Count) UL Noise (Median) (dBm)
Uplink Downlink Value
This KPI shows aggregation of maximum provisioned traffic during the 15 minutes period. Value is calculated based on aggregation of Number of SUs that have been connected to the BS, for the whole 15 minute interval proceeding the PMTM file generation. The median extracted from the actual noise flow histogram
Uplink
11.4.3.3.2
NPU KPIs
There are KPIs that are relevant only for NPUs working in non-transparent mode. You can find the items relevant for non-transparent mode in the release notes.
StarQuality
321
User Manual
4Motion Ver.3.0
Table 11-19: NPU Counters Counter

ASN GW - MS Registration (Count)
Members
Authentication Rejections Created Service Flows Qty Failed Initial NE Max Registered MSs Min Registered MSs Registered MSs Qty Succeeded Initial NE
Description
Sample of MSs in ASNGW in 15 min Min and Max shows the tide mark in 15 min duration
Comments
ASNGW KPI
Average Backhaul Traffic (Bits per Second)
cntNpuBckhlPort in cntNpuBckhlPort out cntNpuBearer in cntNpuBearer out cntNpuCascPort in cntNpuCascPort out cntNpuExtMgmt in cntNpuExtMgmt out cntNpuIntMgmt in cntNpuIntMgmt out
Average data throughput (user IP packets) in both the downlink or uplink direction including: backhaul, bearer, external management, internal management and cascading
ASNGW KPI
Authentication Reject Ratio (%) NE failure Ratio (%)
Value
Ratio of auth. Rejection in respect of successful INE Ratio of failed INE in respect to successful INE Ratio is a calculation of average actual traffic rate over R3 in respect to total provisioned CIR in % Ratio is a calculation of average actual traffic rate over R3 in respect to total provisioned MIR in %
ASNGW KPI
Value
ASNGW KPI
R3 CIR Throughput Oversubscription (%)
Uplink Downlink
ASNGW KPI
R3 MIR Throughput Oversubscription (%)
Uplink Downlink
ASNGW KPI
StarQuality
322
User Manual
4Motion Ver.3.0
Table 11-19: NPU Counters (Continued) Counter

R3 Throughput (Bits per Second)
Members
Uplink Downlink
Description
Average total bytes transferred over R3 with the active period to show average rate over R3 Average over 15 min period based on aggregation of CIR from all served BSs Average over 15 min period based on aggregation of MIR from all served BSs Average over 15 min period based on aggregation of CIR from all served BSs Average over 15 min period based on aggregation of MIR from all served BSs Ratio is a calculation of average actual traffic rate over R6 in respect to total provisioned CIR in % Ratio is a calculation of average actual traffic rate over R6 in respect to total provisioned MIR in % Average total bytes transferred over R3 with the active period to show average rate over R6 Average over 15 min period based on aggregation of CIR from all served BSs
Comments
ASNGW KPI
R3 Total CIR (Bits per Second)
Uplink Downlink
ASNGW KPI
R3 Total MIR (Bits Per Second)
Uplink Downlink
ASNGW KPI
Uplink Downlink
ASNGW KPI
Uplink Downlink
ASNGW KPI
Uplink Downlink
ASNGW KPI
Uplink Downlink
ASNGW KPI
Uplink Downlink
ASNGW KPI
Uplink Downlink
ASNGW KPI
StarQuality
323
User Manual
4Motion Ver.3.0

R6 Total MIR (Bits per Second)
Members
Uplink Downlink
Description
Average over 15 min period based on aggregation of MIR from all served BSs Ratio shows number of service flows in respect to maximum allowed of 36000 service flows Time of system up
Comments
ASNGW KPI
Service Flow usage Ratio (%)
Value
ASNGW KPI
Uptime (hours)
NPU uptime
11.4.3.3.3
MS KPIs
Table 11-20: MS Counters
Counter
MCS Downlink (Bit/Bin) MCS Uplink (Bit/Bin)
Members
Min/Max/Average
Description
Counts bit/bin for each MS transaction. Min and max are calculated by BS. Average is calculated by dividing by number of samples Counts bit/bin for each MS transaction. Min and max are calculated by BS. Average is calculated by dividing by number of samples Counts HARQ bursts of ACK, dropped and total
Min/Max/Average
MS Burst Error Rate Downlink (Count)
Succeeded transferred Qty Dropped Bursts Qty Repetitions
MS Burst Error Rate Ratio Downlink (%)
Ratio based on above counters
Counts HARQ bursts of ACK, dropped and total
MS Burst Error Rate Uplink (Count)
Succeeded transferred Qty Dropped Bursts Qty Repetitions
RSSI Uplink (dBm)
Min/Max/Average
RSSI is sampled from each burst Min and max are calculated by BS. Average is calculated by dividing by number of samples
StarQuality
324
User Manual
4Motion Ver.3.0
Table 11-20: MS Counters (Continued) Counter

Aggregated Throughput (Bits per Second) SINR Avg (dB)
Members
Uplink Downlink Uplink Downlink
Description
Counts the bytes transferred and calculates the transferred rate normalized to the active frames MS transferred data. CINR in db average to the number of sampled bursts Total burst transmitted including MIMO B and MIMO AB
Total Transferred Bursts (Bits per Second)
Downlink
11.4.3.4
11.4.3.4.1

BS Codes
Table 11-21: 4Motion BS Threshold Codes Code
Active MS Qty Active MS Ratio Additional Provisionable Bit Rate Air Link Utilization ALL Authentication Reject Ratio Authentication Rejections Average Provisioned BE MIR Average Provisioned RT CIR Average Provisioned RT MIR Average Provisioned UGS CIR Average Provisioned eRT CIR Average Provisioned eRT MIR Average Provisioned nRT CIR Average Provisioned nRT MIR Average Sector Throughput Average Sector Throughput MIMO A/BF Average Sector Throughput MIMO-B Average Spectral Efficiency all MSs CQI channels
Parameter
#4021 #4033 #4AP #4UA #4NTh #4NTo #4041 #4037 #4038 #4034 #4035 #4036 #4039 #4040 #4AST #4AS1 #4AS2 #4SEA #4017
StarQuality
325
User Manual
4Motion Ver.3.0
Table 11-21: 4Motion BS Threshold Codes (Continued) Code

CQI channels utilization Ratio Created Service Flows Qty Created Service Flows Qty Created Service Flows Qty Ratio DL Air Link Utilization, Data Zone DL Air Link Utilization, Map Zone DL MIMO A Ratio DL MIMO B Ratio DL MIMO BF Ratio DL MIMO CDD Ratio DL Retransmission, Above Four Retransmissions DL Retransmission, Four Retransmissions DL Retransmission, One Retransmission DL Retransmission, Three Retransmissions DL Retransmission, Two Retransmissions DL Retransmission, Zero Retransmission DL SINR Distribution, SINR 13dB till 17dB DL SINR Distribution, SINR 17dB till 21dB DL SINR Distribution, SINR 3dB till 9dB DL SINR Distribution, SINR 9dB till 13dB DL SINR Distribution, SINR > 21dB DL SINR Distribution, SINR Below 3dB Drop Ratio Dropped Bursts Qty Failed Ho Attempts Failed Ho Attempts Ratio Failed Initial NE Failed Initial NE Failed Initial NE Ratio Gross Idle Entries Ho Attempts Ratio
Parameter
#4001 #4NTp #4025 #4005 #4UD1 #4UD2 #4006 #4007 #4009 #4008 #4DR6 #4DR5 #4DR2 #4DR0 #4DR3 #4DR1 #4SD4 #4SD5 #4SD2 #4SD3 #4SD6 #4SD1 #4012 #4027 #4030 #4016 #4NTn #4023 #4003 #4031 #4015
StarQuality
326
User Manual
4Motion Ver.3.0

Idle MSs Qty Idle MSs Ratio MAP Length Eight Symbols MAP Length Four Symbols MAP Length More Than Ten Symbols MAP Length Six Symbols MAP Length Ten Symbols MAP Length Two Symbols MCS Distribution 16QAM 1/2 MCS Distribution 16QAM 1/2 MIMO B MCS Distribution 16QAM 3/4 MCS Distribution 16QAM 3/4 MIMO B MCS Distribution 64QAM 1/2 MCS Distribution 64QAM 1/2 MIMO B MCS Distribution 64QAM 2/3 MCS Distribution 64QAM 2/3 MIMO B MCS Distribution 64QAM 3/4 MCS Distribution 64QAM 3/4 MIMO B MCS Distribution 64QAM 5/6 MCS Distribution 64QAM 5/6 MIMO B MCS Distribution QPSK 1/2 MCS Distribution QPSK 1/2 MIMO B MCS Distribution QPSK 1/2 Rep 2 MCS Distribution QPSK 1/2 Rep 4 MCS Distribution QPSK 1/2 Rep 6 MCS Distribution QPSK 3/4 MCS Distribution QPSK 3/4 MIMO B MIR + CIR Provisioned Max Registered MSs Max Spectral Efficiency all MSs Min Registered MSs
Parameter
#4020 #4032 #4MS4 #4MS2 #4MS6 #4MS3 #4MS5 #4MS1 #4D06 #4D14 #4D07 #4D15 #4D08 #4D16 #4D09 #4D17 #4D10 #4D18 #4D11 #4D19 #4D04 #4D12 #4D03 #4D02 #4D01 #4D05 #4D13 #4MC #4NTk #4SEM #4NTj
StarQuality
327
User Manual
4Motion Ver.3.0

NE failure Ratio Number Of Connected SUs Registered MSs Qty Repetition Ratio Repetitions Sounding Resources Sounding Resources utilization Ratio Subscription Ratio Succeed Ho Attempts Succeed Ho Attempts Ratio Succeed Initial NE Succeed Initial NE Ratio Succeed Transfer Ratio Succeed Transferred Bursts Qty UL Air Link Utilization, Data Zone UL HARQ Packet Error Rate PER 16QAM 1/2 UL HARQ Packet Error Rate PER 16QAM 3/4 UL HARQ Packet Error Rate PER 64QAM 1/2 UL HARQ Packet Error Rate PER 64QAM 2/3 UL HARQ Packet Error Rate PER 64QAM 3/4 UL HARQ Packet Error Rate PER 64QAM 5/6 UL HARQ Packet Error Rate PER QPSK 1/2 UL HARQ Packet Error Rate PER QPSK 1/2 Rep 2 UL HARQ Packet Error Rate PER QPSK 1/2 Rep 4 UL HARQ Packet Error Rate PER QPSK 1/2 Rep 6 UL HARQ Packet Error Rate PER QPSK 3/4 UL HARQ Packet Error Rate Total UL Noise (Median) UL SINR Distribution, SINR 11dB till 15dB UL SINR Distribution, SINR 15dB till 19dB UL SINR Distribution, SINR 3dB till 7dB
Parameter
#4NTg #4CS #4019 #4013 #4028 #4018 #4010 #4SR #4029 #4014 #4022 #4002 #4011 #4026 #4UU1 #4E06 #4E07 #4E08 #4E09 #4E10 #4E11 #4E04 #4E03 #4E02 #4E01 #4E05 #4E00 #4UN2 #4SI4 #4SI5 #4SI2
StarQuality
328
User Manual
4Motion Ver.3.0

UL SINR Distribution, SINR 7dB till 11dB UL SINR Distribution, SINR > 19dB UL SINR Distribution, SINR Below 3dB
Parameter
#4SI3 #4SI6 #4SI1
11.4.3.4.2
NPU Codes
Table 11-22: NPU Threshold Codes Code
R3 CIR Throughput Oversubscription R3 MIR Throughput Oversubscription R3 Throughput R3 Total CIR R3 Total MIR R6 CIR Throughput Oversubscription R6 MIR Throughput Oversubscription R6 Throughput R6 Total CIR R6 Total MIR Registered MSs Qty Service Flow usage Ratio Succeed Initial NE Uptime cntNpuBckhlPort cntNpuBearer cntNpuCascPort cntNpuExtMgmt cntNpuIntMgmt
Parameter
#4NT8 #4NT7 #4NT6 #4NTa #4NT9 #4NTd #4NTc #4NTb #4NTf #4NTe #4NTl #4NTi #4NTm #4UPT #4NT5 #4NT1 #4NT4 #4NT2 #4NT3
11.4.3.4.3
SU Codes
Table 11-23: SU Threshold Codes Code
Aggregated Throughput
Parameter
#4SUa
StarQuality
329
User Manual
4Motion Ver.3.0M

MCS Avg MCS Max MCS Min MS BF Ratio MS Drop Ratio MS Dropped Bursts Qty MS MIMO A Ratio MS MIMO B Ratio MS Repetition Ratio MS Repetitions MS Succeed Transfer Ratio MS Succeed Transferred Bursts Qty SINR Avg Total Transferred Bursts Uplink RSSI Avg Uplink RSSI Max Uplink RSSI Min
Parameter
#4SU6 #4SU5 #4SU4 #4SUe #4SUg #4SUj #4SUc #4SUd #4SUh #4SUk #4SUf #4SUi #4SU3 #4SUb #4SU9 #4SU8 #4SU7
11.4.3.5

BottomN Uptime TopN Air Link Utilization TopN Average Sector Throughput TopN Number of Connected SUs
11.4.4 4Motion Ver.3.0M

11.4.4.1 Overview
SW Compatibility - Version 3.0M Refer to the release notes for details. Collector type - WiMAX 4Motion
StarQuality
330
User Manual
4Motion Ver.3.0M
11.4.4.2

11.4.4.3
11.4.4.3.1

BS KPIs
Table 11-24: Traffic Counters 4Motion Ver.3.0M
Counter
Active MS / Idle MS / Registered MS (count)
Members
Registered MSs Qty Idle MSs Qty Active MSs Qty
Description
The MSs are sampled at the end of the 15 Min sample period
Active/Idle MSs out of registered (%) Air Link Utilization (%)
Idle MSs Ratio Active MSs Ratio All UL Air Link Utilization, Data Zone DL Air Link Utilization, Data Zone DL Air Link Utilization, First Zone
Ratio of gauges mentioned above
The utilization of available wireless link resources: Data utilization from all slots per BS as a percentage of total slots available for the uplink and downlink directions.
Average Provisioned Downlink (bits per second)
RT CIR RT MIR UGS CIR eRT CIR eRT MIR nRT CIR nRT MIR BE MIR
Counts the provisioned DL based on registered MSs per second. The graphs are per QoS. The calculation divides the accumulated value with 900 seconds.
StarQuality
331
User Manual
4Motion Ver.3.0M
Table 11-24: Traffic Counters 4Motion Ver.3.0M (Continued) Counter

Average Provisioned Uplink (bits per second)
Members
BE MIR RT CIR RT MIR UGS CIR eRT CIR eRT MIR nRT CIR nRT MIR
Description
Counts the provisioned UL based on registered MSs per second. The graphs are per QoS. The calculation divides the accumulated value with 900 seconds.
Burst Error Rate Downlink (count)
Successfully Transfered Bursts Qty Dropped BurstsQty Retransmission
Burst Error Rate Ratio Downlink (%)
Successful Transfer Ratio Drop Ratio Retransmission Ratio
Burst Error Rate Uplink (count)
Successfully Transferred Bursts Qty Dropped Bursts Qty Retransmission
Two Symbols Four Symbols Six Symbols Eight Symbols Ten Symbols More Than Ten Symbols
StarQuality
332
User Manual
4Motion Ver.3.0M

MCS Distribution Downlink (Bits per Second)
Members
19 MCS values from QPSK 1/2 rep 6 To 64 QAM 5/6 MIMO B
Description
Throughput of each MCS for the uplink direction
MCS Distribution Uplink (Bits per Second)
11 MCS velues from QPSK 1/2 Rep 6 To 64QAM 5/6
Throughput of each MCS for the downlink direction
MS Hand Over (Count)
Successful HO Attempts Failed HO Attempts
Counts number handover attempts both in and out
Hand Over Ratio (%)
Sucessful HO Attempts Ratio HO Attempts Ratio Failed HO Attempts Ratio
Ratio calculation of counters mentioned above
MS Registration (Count)
Failed Successful
Number of failed/successful initial network entry attempts
MS Registration Service Flows (Count) MS Registration Ratio (%)
Created Service Flows Qty Failed Initial NE Ratio Successful Initial NE Ratio 99th Percentile Median Total Zero Retransmission One Retransmission Two Retransmissions Three Retransmissions Four Retransmissions Above Four Retransmissions Number of transactions with a certain number of retransmissions per BS for the downlink direction. Ratio of counters mentioned above
Noise Floor Uplink (dBM) Retransmission Downlink (HARQ Sub Bursts)
StarQuality
333
User Manual
4Motion Ver.3.0M

Members
SINR less than or equal to 4dB SINR 5dB till 9dB SINR 9dB till 13 dB SINR 13 dB till 17 dB SINR 17 dB till 21 dB SINR > 21 dB
Description
SINR less than or equal to 4 dB SINR 5 dB till 9 dB SINR 9 dB till 11 dB SINR 11 dB till 15 dB SINR 15 dB till 19 dB SINR > 19 dB
Spectral Efficiency(Bits/Bin)
Average UL Spectral Efficiency Average DL Spectral Efficiency Max UL Spectral Efficiency Max DL Spectral Efficiency
Uplink Dropped HARQ sub-bursts (Dropped HARQ Sub Bursts)
StarQuality
334
User Manual
4Motion Ver.3.0M
11.4.4.3.2
NPU KPIs
There are KPIs that are relevant only for NPUs working in non-transparent mode. You can find the items relevant for non-transparent mode in the release notes. Table 11-25: NPU Counters
Counter
ASN GW - MS Registration (Count)
Members
Authentication Rejections Failed Initial NE Max Registered MSs Min Registered MSs Registered MSs Qty Successful Initial NE
Description
Sample of MSs in ASNGW in 15 min Min and Max shows the tide mark in 15 min duration
Comments
ASNGW KPI
Average Backhaul Traffic (Bits per Second)
cntNpuBckhlPort in cntNpuBckhlPort out cntNpuBearer in cntNpuBearer out cntNpuCascPort in cntNpuCascPort out cntNpuExtMgmt in cntNpuExtMgmt out cntNpuIntMgmt in cntNpuIntMgmt out
Average data throughput (user IP packets) in both the downlink or uplink direction including: backhaul, bearer, external management, internal management and cascading
ASNGW KPI
Authentication Reject Ratio (%) NE failure Ratio (%)
Value
Ratio of auth. Rejection in respect of successful INE Ratio of failed INE in respect to successful INE Ratio is a calculation of average actual traffic rate over R3 in respect to total provisioned CIR in %
ASNGW KPI
Value
ASNGW KPI
Uplink Downlink
ASNGW KPI
StarQuality
335
User Manual
4Motion Ver.3.0M

Members
Uplink Downlink
Description
Ratio is a calculation of average actual traffic rate over R3 in respect to total provisioned MIR in % Average total bytes transferred over R3 with the active period to show average rate over R3 Average total bytes transferred over R3 with the active period to show average rate over R6 Average over 15 min period based on aggregation of CIR from all served BSs Average over 15 min period based on aggregation of MIR from all served BSs
Comments
ASNGW KPI
Uplink Downlink
ASNGW KPI
Uplink Downlink
ASNGW KPI
Uplink Downlink
ASNGW KPI
R6 Total MIR (Bits per Second)
Uplink Downlink
ASNGW KPI
11.4.4.3.3
MS KPIs
Table 11-26: MS Counters
Counter
MS Burst Error Rate Downlink (Count)
Members
Successfully Transferred Bursts Qty Dropped Bursts Qty Retransmissions
Description
MS Burst Error Rate Ratio Downlink (%)
MS Burst Error Rate Ratio Uplink (%)
StarQuality
336
User Manual
4Motion Ver.3.0M
Table 11-26: MS Counters (Continued) Counter

MS Burst Error Rate Uplink (Count)
Members
Successfully Transferred Burts Qty Dropped Bursts Qty Retransmissions
Description
RSSI Downlink (dBm)
Min/Max/Avg
RSSI is sampled from each burst Min and max are calculated by BS. Average is calculated by dividing by number of samples RSSI is sampled from each burst Min and max are calculated by BS. Average is calculated by dividing by number of samples
RSSI Uplink (dBm)
Min/Max/Avg
SINR Downlink (dB)
Min Avg Max
SINR Uplink (dB)
Min Avg Max
Spectral Efficiency Downlink (Bit/Bin)
Min Avg Max
Spectral Efficiency Uplink (Bit/Bin) Throughput Ratio (%)
Min/Max/Avg MIMO A Ratio MIMO B Ratio BF Ratio
Aggregated Throughput (Bits per Second)
Uplink Downlink
Counts the bytes transferred and calculates the transferred rate normalized to the active frames MS transferred data.
11.4.4.4
11.4.4.4.1

BS Codes
Table 11-27: 4Motion BS Threshold Codes Code
Active MS Qty
Parameter
#4021
StarQuality
337
User Manual
4Motion Ver.3.0M

Active MS Ratio Air Link Utilization ALL Average Provisioned BE MIR Average Provisioned RT CIR Average Provisioned RT MIR Average Provisioned UGS CIR Average Provisioned eRT CIR Average Provisioned eRT MIR Average Provisioned nRT CIR Average Provisioned nRT MIR Average Sector Throughput Average Sector Throughput FFR Reuse 3 Average Sector Throughput MIMO A/BF Average Sector Throughput MIMO-B Average Sector Throughput Total Reuse 1 Average Spectral Efficiency Created Service Flows Qty Created Service Flows Qty Created Service Flows Qty Ratio DL Air Link Utilization, Data Zone DL Air Link Utilization, Map Zone DL Air Link Utilization, Reuse 3 Data Zone DL MIMO A Ratio DL MIMO B Ratio DL MIMO BF Ratio DL MIMO CDD Ratio DL Retransmission, Above Four Retransmissions DL Retransmission, Four Retransmissions DL Retransmission, One Retransmission DL Retransmission, Three Retransmissions DL Retransmission, Total
Parameter
#4033 #4UA #4041 #4037 #4038 #4034 #4035 #4036 #4039 #4040 #4AST #4AS3 #4AS1 #4AS2 #4AS6 #4SEA #4NTp #4025 #4005 #4UD1 #4UD2 #4UD3 #4006 #4007 #4009 #4008 #4DR6 #4DR5 #4DR2 #4DR0 #4DR0
StarQuality
338
User Manual
4Motion Ver.3.0M

DL Retransmission, Two Retransmissions DL Retransmission, Zero Retransmission DL SINR Distribution, SINR 13dB till 17dB DL SINR Distribution, SINR 13dB till 17dB All DL SINR Distribution, SINR 13dB till 17dB FFR Reuse 3 DL SINR Distribution, SINR 13dB till 17dB v2.5 DL SINR Distribution, SINR 17dB till 21dB DL SINR Distribution, SINR 17dB till 21dB All DL SINR Distribution, SINR 17dB till 21dB FFR Reuse 3 DL SINR Distribution, SINR 17dB till 21dB v2.5 DL SINR Distribution, SINR 3dB till 9dB v2.5 DL SINR Distribution, SINR 3dB till 9dB DL SINR Distribution, SINR 9dB till 13dB DL SINR Distribution, SINR 9dB till 13dB All DL SINR Distribution, SINR 9dB till 13dB FFR Reuse 3 DL SINR Distribution, SINR 9dB till 13dB v2.5 DL SINR Distribution, SINR > 21dB DL SINR Distribution, SINR > 21dB All DL SINR Distribution, SINR > 21dB FFR Reuse 3 DL SINR Distribution, SINR > 21dB v2.5 DL SINR Distribution, SINR Below 3dB v2.5 DL SINR Distribution, SINR less than or equal to 4dB DL SINR Distribution, SINR less than or equal to 4dB All DL SINR Distribution, SINR less than or equal to 4dB FFR Reuse 3 DL Spectral Efficiency Data Zone DL Spectral Efficiency FFR Reuse 3 Zone Drop Ratio Dropped Bursts Qty
Parameter
#4DR3 #4DR1 #4SD4 #4054 #4sd4 #4d08 #4SD5 #4055 #4sd5 #4d09 #4d06 #4SD2 #4SD3 #4053 #4sd3 #4d07 #4SD6 #4056 #4sd6 #4d10 #4d05 #4SD1 #4051 #4sd1 #4SED #4SEF #4012 #4027
StarQuality
339
User Manual
4Motion Ver.3.0M

Failed Ho Attempts Failed Ho Attempts Ratio Failed Initial NE Failed Initial NE Ratio Ho Attempts Ratio Idle MSs Qty Idle MSs Ratio MAP Length Eight Symbols MAP Length Four Symbols MAP Length More Than Ten Symbols MAP Length Six Symbols MAP Length Ten Symbols MAP Length Two Symbols MCS Distribution 16QAM 1/2 MCS Distribution 16QAM 1/2 FFR Reuse 3 MCS Distribution 16QAM 1/2 MIMO B MCS Distribution 16QAM 3/4 MCS Distribution 16QAM 3/4 FFR Reuse 3 MCS Distribution 16QAM 3/4 MIMO B MCS Distribution 64QAM 1/2 MCS Distribution 64QAM 1/2 FFR Reuse 3 MCS Distribution 64QAM 1/2 MIMO B MCS Distribution 64QAM 2/3 MCS Distribution 64QAM 2/3 FFR Reuse 3 MCS Distribution 64QAM 2/3 MIMO B MCS Distribution 64QAM 3/4 MCS Distribution 64QAM 3/4 FFR Reuse 3 MCS Distribution 64QAM 3/4 MIMO B MCS Distribution 64QAM 5/6 MCS Distribution 64QAM 5/6 FFR Reuse 3 MCS Distribution 64QAM 5/6 MIMO B
Parameter
#4030 #4016 #4023 #4003 #4015 #4020 #4032 #4MS4 #4MS2 #4MS6 #4MS3 #4MS5 #4MS1 #4D06 #4D25 #4D14 #4D07 #4D26 #4D15 #4D08 #4D27 #4D16 #4D09 #4D28 #4D17 #4D10 #4D29 #4D18 #4D11 #4D30 #4D19
StarQuality
340
User Manual
4Motion Ver.3.0M

MCS Distribution QPSK 1/2 MCS Distribution QPSK 1/2 FFR Reuse 3 MCS Distribution QPSK 1/2 MIMO B MCS Distribution QPSK 1/2 Rep 2 MCS Distribution QPSK 1/2 Rep 2 FFR Reuse 3 MCS Distribution QPSK 1/2 Rep 4 MCS Distribution QPSK 1/2 Rep 4 FFR Reuse 3 MCS Distribution QPSK 1/2 Rep 6 MCS Distribution QPSK 1/2 Rep 6 FFR Reuse 3 MCS Distribution QPSK 3/4 MCS Distribution QPSK 3/4 FFR Reuse 3 MCS Distribution QPSK 3/4 MIMO B MIR + CIR Provisioned Max Spectral Efficiency Number of users Registered MSs Qty Retransmission Retransmission Ratio Successful Ho Attempts Successful Ho Attempts Ratio Successful Initial NE Successful Initial NE Ratio Successful Transfer Ratio Successful Transferred Bursts Qty UL Air Link Utilization, Data Zone UL Air Link Utilization, Feedback Zone v2.5 UL HARQ Packet Error Rate PER 16QAM 1/2 UL HARQ Packet Error Rate PER 16QAM 3/4 UL HARQ Packet Error Rate PER 64QAM 1/2 UL HARQ Packet Error Rate PER 64QAM 2/3 UL HARQ Packet Error Rate PER 64QAM 3/4
Parameter
#4D04 #4D23 #4D12 #4D03 #4D22 #4D02 #4D21 #4D01 #4D20 #4D05 #4D24 #4D13 #4MC #4SEM #4050 #4019 #4028 #4013 #4029 #4014 #4022 #4002 #4011 #4026 #4UU1 #4UU2 #4E06 #4E07 #4E08 #4E09 #4E10
StarQuality
341
User Manual
4Motion Ver.3.0M

UL HARQ Packet Error Rate PER 64QAM 5/6 UL HARQ Packet Error Rate PER QPSK 1/2 UL HARQ Packet Error Rate PER QPSK 1/2 Rep 2 UL HARQ Packet Error Rate PER QPSK 1/2 Rep 4 UL HARQ Packet Error Rate PER QPSK 1/2 Rep 6 UL HARQ Packet Error Rate PER QPSK 3/4 UL HARQ Packet Error Rate Total UL Noise (99th Percentile) v2.5 UL Noise (Median) UL SINR Distribution, SINR 11dB till 15dB UL SINR Distribution, SINR 11dB till 15dB v2.5 UL SINR Distribution, SINR 15dB till 19dB UL SINR Distribution, SINR 15dB till 19dB v2.5 UL SINR Distribution, SINR 3dB till 7dB v2.5 UL SINR Distribution, SINR 5dB till 9dB UL SINR Distribution, SINR 7dB till 11dB v2.5 UL SINR Distribution, SINR 9dB till 11dB UL SINR Distribution, SINR > 19dB UL SINR Distribution, SINR > 19dB v2.5 UL SINR Distribution, SINR Below 3dB v2.5 UL SINR Distribution, SINR less than or equal to 4dB UL Spectral Efficiency, Data Zone
Parameter
#4E11 #4E04 #4E03 #4E02 #4E01 #4E05 #4E00 #4UN1 #4UN2 #4SI4 #4d14 #4SI5 #4d15 #4d12 #4SI2 #4SI3 #4SI3 #4SI6 #4d16 #4d11 #4SI1 #4SEG
11.4.4.4.2
NPU Codes
Table 11-28: NPU Threshold Codes Code
Created Service Flows Qty Failed Initial NE Max Registered MSs Min Registered MSs NE Failure Ratio
Parameter
#4NTp #4NTn #4NTk #4NTj #4NTg
StarQuality
342
User Manual
4Motion Ver.3.0M
Table 11-28: NPU Threshold Codes (Continued) Code

R3 CIR Transfer Ratio R3 MIR Transfer Ratio R3 Throughput R3 Total CIR R3 Total MIR R6 CIR Throughput Oversubscription R6 MIR Throughput Oversubscription R6 Throughput R6 Total CIR R6 Total MIR Registered MSs Qty Service Flow usage Ratio Succeed Initial NE Uptime cntNpuBckhlPort cntNpuBearer cntNpuCascPort cntNpuExtMgmt cntNpuIntMgmt
Parameter
#4NT8 #4NT7 #4NT6 #4NTa #4NT9 #4NTd #4NTc #4NTb #4NTf #4NTe #4NTl #4NTi #4NTm #4UPT #4NT5 #4NT1 #4NT4 #4NT2 #4NT3
11.4.4.4.3
SU Codes
Aggregated Throughput MCS Avg MCS Max MCS Min MS BF Ratio MS Downlink RSSI Avg MS Downlink RSSI Max MS Downlink RSSI Min
Parameter
#4SUa #4SU6 #4SU5 #4SU4 #4SUe #4SUA #4SUC #4SUB
StarQuality
343
User Manual

MS Drop Ratio MS Dropped Bursts Qty MS MIMO A Ratio MS MIMO B Ratio MS Repetition Ratio MS Repetitions MS Succeed Transfer Ratio MS Succeed Transferred Bursts Qty SINR Avg Total Transferred Bursts Uplink RSSI Avg Uplink RSSI Max Uplink RSSI Min
Parameter
#4SUg #4SUj #4SUc #4SUd #4SUh #4SUk #4SUf #4SUi #4SU3 #4SUb #4SU9 #4SU8 #4SU7

BottomN Uptime TopN Air Link Utilization TopN Average Sector Throughput
StarQuality
344
User Manual
BreezeMAX Extreme
11.5
BreezeMAX Extreme
11.5.1 Overview
SW Compatibility - version 1.5 Collector type - WiMAX Extreme

Optional - registered as Authorized manager with traps disabled - according to BreezeMAX Extreme specifications.

11.5.3.1 BS KPIs
Table 11-30: Traffic Counters - BreezeMAX Extreme Counter/Formula
CIR Allocated (Bits per Second)
Members
Downlink Uplink
Description
Aggregation of maximum provisioned traffic of CIR services during the sampled 15 minutes period.
* BS_TOTAL_DL_CIR * 1000 * BS_TOTAL_UL_CIR * 1000 CIR Related Over-Subscription Ratio (%) Uplink Downlink * (BS_TOTAL_DL_CIR/ ((BS_DL_BYTES / BS_DL_USED_SEC * 8 ) )) *100 * (BS_TOTAL_UL_CIR/ ((BS_UL_BYTES / BS_UL_USED_SEC * 8 ) )) *100 Drop Ratio (%) Uplink Downlink * SUM(CPE_DL_DROP_BURSTS) / SUM(CPE_DL_TOTAL_BURSTS + CPE_DL_DROP_BURSTS) * 100 * SUM(CPE_UL_DROP_BURSTS) / SUM(CPE_UL_TOTAL_BURSTS + CPE_UL_DROP_BURSTS) * 100
calculation of average actual traffic in respect to total provisioned CIR in %
Ratio between number of dropped bursts and total bursts (dropped and succeeded) counted in the sampled period
StarQuality
345
User Manual
Table 11-30: Traffic Counters - BreezeMAX Extreme (Continued) Counter/Formula

MIR Allocated (Bits per Second)
Members
Uplink Downlink
Description
Aggregation of maximum provisioned traffic of MIR services during the 15 minutes period.
* BS_TOTAL_DL_MIR * 1000 * BS_TOTAL_UL_MIR * 1000 MIR Related Over-Subscription Ratio (%) Uplink Downlink * (BS_TOTAL_DL_MIR/ ((BS_DL_BYTES / BS_DL_USED_SEC * 8 ) )) *100 * (BS_TOTAL_UL_MIR/ ((BS_UL_BYTES / BS_UL_USED_SEC * 8 ) )) *100
calculation of average actual traffic in respect to total provisioned MIR in %
Number of Connected SU (Count)
Value
Number of SUs that have been connected to the BS, for the whole 15 minute interval proceeding the PMTM file generation. Ratio between aggregated CPE HARQ repetitions to aggregated Total Bursts
Repetition Ratio (%)
Downlink Uplink
* ( SUM( CPE_DL_HARQ_REPETITION ) / SUM( CPE_DL_TOTAL_BURSTS) )* 100 * ( SUM( CPE_UL_HARQ_REPETITION ) / SUM( CPE_UL_TOTAL_BURSTS) )* 100
Downlink Uplink
* (BS_DL_BYTES * 8 ) / BS_DL_USED_SEC * (BS_UL_BYTES * 8 ) / BS_UL_USED_SEC Transfer Overhead (%) Downlink Uplink * SUM ( CPE_DL_HARQ_NACK ) / SUM (CPE_DL_HARQ_ACK) * 100 * SUM ( CPE_UL_HARQ_NACK ) / SUM (CPE_UL_HARQ_ACK) * 100
Ratio between aggregated CPE HARQ NACKs to aggregated CPE HARQ ACKs
StarQuality
346
User Manual
Table 11-30: Traffic Counters - BreezeMAX Extreme (Continued) Counter/Formula

Transfer Ratio (%)
Members
Downlink Uplink
Description
Ratio between aggregated CPE Total Bursts to aggregated CPE Total and Dropped Bursts.
* SUM( CPE_DL_TOTAL_BURSTS) / SUM(CPE_DL_TOTAL_BURSTS + CPE_DL_DROP_BURSTS) * 100 * SUM( CPE_UL_TOTAL_BURSTS) / SUM(CPE_UL_TOTAL_BURSTS + CPE_UL_DROP_BURSTS) * 100
11.5.3.2
BTS KPIs
Table 11-31: BTS KPIs
Counter
Uptime
Members
Uptime
Description
Time since last system boot in hours
11.5.3.3
SU KPIs
Table 11-32: SU KPIs
Counter
Rate Downlink/Uplink (Rate)
Members
Min/Average/Max
Description
Modulation Rate for each MS. The Min and max Rate sampled in the integration period of 15min. Average is calculated by dividing by number of samples RSSI is sampled from each burst. Min and max RSSI value sampled in the integration period of 15min.. Average is calculated by dividing by number of samples SNR Min and max SNR value sampled in the integration period of 15min. Average is calculated by dividing by number of samples Aggregation of maximum provisioned traffic of CIR services for each CPE during the 15 minutes period.
RSSI Downlink/Uplink (dBm)
Min/Average/Max
SNR Downlink/Uplink (dB)
Min/Average/Max
SU CIR Allocated (Bits per Second)
Downlink Uplink
* CPE_TOTAL_DL_CIR * 1000 * CPE_TOTAL_UL_CIR * 1000
StarQuality
347
User Manual
Table 11-32: SU KPIs (Continued) Counter

Su Drop Ratio (%)
Members
Downlink Uplink
Description
Ratio between number of dropped bursts and total bursts (dropped and succeeded) for each CPE, counted in the sampled period
* CPE_DL_DROP_BURSTS) / (CPE_DL_TOTAL_BURSTS + CPE_DL_DROP_BURSTS) * 100 * (CPE_UL_DROP_BURSTS) / (CPE_UL_TOTAL_BURSTS + CPE_UL_DROP_BURSTS) * 100 SU MIR Allocated (Bits per Second) Downlink Uplink * CPE_TOTAL_DL_MIR * 1000 * CPE_TOTAL_UL_MIR * 1000 SU Repetition Ratio (%) Downlink Uplink * ( ( CPE_DL_HARQ_REPETITION ) /( CPE_DL_TOTAL_BURSTS) )* 100 * ( ( CPE_UL_HARQ_REPETITION ) / ( CPE_UL_TOTAL_BURSTS) )* 100 SU Throughput (Bits per Second) Downlink Uplink * CPE_TOTAL_DL_BYTES_TRANSF ERRED * 8 / 900 * CPE_TOTAL_UL_BYTES_TRANSF ERRED * 8 / 900 SU Transfer Overhead (%) Downlink Uplink * ( CPE_DL_HARQ_NACK ) / (CPE_DL_HARQ_ACK) * 100 * ( CPE_UL_HARQ_NACK ) / (CPE_UL_HARQ_ACK) * 100
Aggregation of maximum provisioned traffic of MIR services for each CPE during the 15 minutes period.
Ratio between CPE HARQ repetitions to Total Bursts
Counts the bytes transferred and calculates the transferred rate normalized to the active frames MS transferred the counted bytes.
Ratio between CPE HARQ NACKs and CPE HARQ ACKs
StarQuality
348
User Manual
Table 11-32: SU KPIs (Continued) Counter

SU Transfer Ratio (%)
Members
Downlink Uplink
Description
Ratio between CPE Total BURSTS to CPE Total BURSTS and CPE Dropped Bursts
* ( CPE_DL_TOTAL_BURSTS) / (CPE_DL_TOTAL_BURSTS + CPE_DL_DROP_BURSTS) * 100 * ( CPE_UL_TOTAL_BURSTS) / (CPE_UL_TOTAL_BURSTS + CPE_UL_DROP_BURSTS) * 100

11.5.4.1 BTS Codes
Table 11-33: BTS Codes Code
CIR Allocated CIR related Over Subscription Ratio Drop Ratio MIR Allocated MIR related Over Subscription Ratio Number Of Connected SUs Repetition Ratio Throughput Transfer Ratio Transfer overhead Uptime
Parameter
#eBSe #eBSg #eBSb #eBSf #eBSh #eCS #eBSc #eT #eBSa #eBSd #eUPT
11.5.4.2
SU Codes
Table 11-34: SU Codes Code
SU CIR Allocated SU Drop Ratio SU MIR Allocated
Parameter
#eSUe #eSUb #eSUf
StarQuality
349
User Manual
Table 11-34: SU Codes (Continued) Code

SU RATE AVERAGE SU RATE MAX SU RATE MIN SU RSSI AVERAGE SU RSSI MAX SU RSSI MIN SU Repetition Ratio SU SNR AVERAGE SU SNR MAX SU SNR MIN SU Throughput SU Transfer Ratio SU Transfer overhead
Parameter
#eSU9 #eSU8 #eSU7 #eSU6 #eSU5 #eSU4 #eSUc #eSU3 #eSU2 #eSU1 #eSUg #eSUa #eSUd

BottomN Uptime TopN Number of Connected SUs TopN throughput
StarQuality
350
User Manual
Chapter
Glossary
Glossary
The following terms are frequently used in this manual: AU - Access Unit BS - Base Station BTS - Base Transceiver Station CIR - Committed Information Rate CINR - Carrier to Interference-plus-Noise Ratio CPE - Customer Premises Equipment Equipment - the basic sampled unit. Two types of equipment are used in the StarQuality system:
AU /Slot/ BS/Sector (in TDD or FDD only) SU/CPE/MS
HARQ - Hybrid Automatic Repeated Request MCS - Modulation Coding Scheme MIR - Maximum Information Rate MS - Mobile Subscriber NBI - Northbound Interface Public/Private objects - Public objects (sites, etc.) are created by the admin user for the whole system. Private object are created by the local user for the local system only. ROOT Site - the basic system network site, under which you can create sites and virtual sites RSSI - Received Signal Strength Indication. SINR - Signal Interference Noise Ratio
StarQuality
352
User Manual
Glossary
SNR - Signal to Noise Ratio SOAP (Simple Object Access Protocol) - interface to enable various NBI operations via third party applications Site -
Non-virtual - A base station, containing up to 7 AUs, on which measurements are collected Virtual Site - any collection of equipments, grouped by various subjects, such as areas
SU - Subscriber Unit XLS - Excel file format
StarQuality
353
User Manual

Star Quality User Manual Ver.3.1 110316

Uploaded by

Copyright:

Available Formats

Star Quality User Manual Ver.3.1 110316

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Star Quality User Manual Ver.3.1 110316

Uploaded by

Copyright:

Available Formats

StarQuality

Network Discovery Setting Alarm Thresholds Reports

Installation Getting Started

Ver.3.0 June 2010 Ver.3.0 June 2010

Ver.3.0 June 2010

Reports Setting Alarm Thresholds

Chapter 11,Device Specific Information Chapter 5, Viewing

Chapter 5, Chart Settings Chapter 9, Adding a New

New section New section

Ver.3.1.10 March 2011 Ver.3.1.10 March 2011

Ver.3.1.10 March 2011 Ver.3.1.10 March 2011

Ver.3.1.10 March 2011

Section removed New section

Ver.3.1.10 March 2011 Ver.3.1.10 March 2011

Ver.3.1.10 March 2011

Warranties and Disclaimers

About this Manual

About this Manual

System Data Structure................................................................................................5 User Types and Their Settings ..................................................................................6

Chapter 3 - Getting Started .................................................................. 123

Chapter 4 - Network Discovery ............................................................ 137

Discovery of Equipment under a Server-Health Site ...........................................148 Scheduled Configuration .......................................................................................160

Chapter 5 - Viewing Measurements ..................................................... 163

Searching Measurements.......................................................................................178 5.6.1 On Searching in General ................................................................................. 178

Saving Items as A Submenu ..................................................................................181 Setting Trendlines to Graphs.................................................................................182

Chapter 6 - Setting Alarm Thresholds.................................................. 185

Generating the Expression Using Input Fields ....................................................200

Chapter 7 - Threshold-Crossing Alarms Monitoring............................. 204

Downloading Data to Excel Files...........................................................................213

Chapter 8 - Reports .............................................................................. 215

Bulk Export Wizard - Exporting Data to XLS Files...............................................232

Chapter 9 - General Setting Options .................................................... 238

9.4.1 9.5 9.6

Setting E-mail Addresses (Admin only) ........................................................... 259

Chapter 10 - Northbound Interface (NBI)............................................. 285

Chapter 11 - Device Specific Information............................................ 291

Glossary ............................................................................................... 351

STAR Management Suite Overview

System Data Structure

System Data Structure

Each piece of equipment belongs to a site. Basic sampled unit:

User Types and Their Settings

User Types and Their Settings

User Types and Their Settings

Installing StarQuality on Solaris

Installing StarQuality on Linux

Windows 2008 Standard

External database on same machine

External database on a separate machine Solaris 10 x86 Internal database

10201_client_solx86_ 64 or 10202_client_solx86 No Oracle client required

Any Oracle 10 client compatible with 32 bit Red Had 5

HW/SW Requirements and Disk Allocation

Maximum Capacity 50 BTSs 1000 CPEs

Operating Systems Windows 2003 (64Bit)

HW Requirementsfor Each Server 1 x Intel Core i7-950 at

Disk Allocation 1 x 150 GB: OS +

Windows 2008 (64Bit) 5 concurrent clients

8 GB RAM 3 (4) x HDD SAS 150

1 x 150 GB: Oracle