ARRAYWIZARD User Reference Guide
Software Version 7.0 Reference Guide Edition 1
Page 2
ArrayWizard User Reference Guide 7.0 Introduction
© Copyright 2010 AIRCOM International All rights reserved ADVANTAGE, ARRAYWIZARD, ASSET, CONNECT, DATASAFE, DIRECT, ENTERPRISE, MYRIAD, AIRCOM OPTIMA, RANOPT and WEBWIZARD are recognised trademarks of AIRCOM International. Other product names are trademarks of their respective companies. Microsoft Excel , .NET™, Microsoft Office, Outlook , Vis Visu ual Bas Basiic Wi Wind ndo ows®, s®, Windows XP™, Windows Vista and Word Word are trad tradema emarks rks of th thee Micros Microsoft oft Corporation. This documentation is protected by copyright and contains proprietary and confidential information. No part of the contents of this documentation may be disclosed, used or reproduced in any form, or by any means, without the prior written consent of AIRCOM International. Although AIRCOM International has collated this documentation to reflect the features and capabilities supported in the software products, the company makes no warranty or representation, either expressed or implied, about this documentation, its quality or fitness for particular customer purpose. Users are solely responsible for the proper use of ENTERPRISE software and the application of the results obtained. An electronic version of this document exists. This User Reference Guide finalised on 15 September 2010. Refer to the Online Help for more information. This User Reference Guide prepared by: AIRCOM International Ltd Cassini Court Randalls Research Park Randalls Way Leatherhead Surrey KT22 7TW Telephone: Support Hotline: Fax: Web:
+44 (0) 1932 442000 +44 (0) 1932 442345 +44 (0) 1932 442005 www.aircominternational.com
About This Manual Change History This table shows the change history (if any) of this guide: Edition
Date
Reason
1
15 September 2010
Commercial Release
Explanation of Symbols Throughout this guide, where appropriate, some symbols are used to highlight particular pieces of text. Three different symbols are in use, and are explained as follows: Symbol
Brief Description
Full Description
Note
Signifies text that should be noted or carefully considered.
Tip
Signifies text that may help you do something in an easier or quicker way.
Warning or Important
Signifies text that is intended as a warning or something important.
Contents Chapter 1 Introduction
9
Before Before You Start ........................................ ......................................................... ................................. ................................. ....................... ...... 9 Using This Manual ........................................................................................... 10 Obtaining User Assistance ............................................................................... 10 Who is This User Reference Guide For?................................................................. For? ................................................................... .. 11 About the ENTERPRISE User Reference Guides .................................................... 11 Can You Improve Our User Assistance?................................................................. Assistance? ................................................................... .. 13 Obtaining Support ............................................................................. ...................................................................................................... ......................... 13 Obtaining Further Information a nd Services ............................................................ .............................................................. .. 15
Chapter 2 The ARRAYWIZARD User Interface
17
Opening the ARRAYWIZARD Administrator .................................................... 17 About the ARRAYWIZARD ARRAYWIZARD Main Window .................. ......... ................... ................... ................... ................... ......... 17 About the File Menu ............................................................... ................................................................................................... .................................... 18 About the View Menu ............................................................. ................................................................................................. .................................... 18 About the Database Menu .................................................................. ......................................................................................... ....................... 18 About the Project Settings Menu ...................................................... ............................................................................... ......................... 19
About the ARRAYWIZARD ARRAYWIZARD Toolbar .................. ........ ................... ................... ................... ................... ................... ......... 19 About the Map View View Window ................... ......... ................... .................. ................... ................... ................... ................... ......... 19 Permitting and Preventing Multiple Users ........................................................ 19
Chapter 3 Setting Up Agents
23
About the Agent Status Status .................. ......... ................... ................... .................. ................... ................... ................... ................... ......... 23 Adding Agents Agents ................... ......... ................... .................. ................... ................... ................... ................... ................... ................... ............ ... 24 Starting and Stopping Agents .......................................................................... 25 Monitoring Agents ............................................................................................ 26 Deleting Agents ............................................................................................... 26 Configuring Agents .......................................................................................... 26
Chapter 4 Creating Arrays Using ARRAYWIZARD
29
About Array Creation Creation .................. ......... ................... ................... .................. ................... ................... .................. ................... ............. ... 29 Opening and Closing Closing Projects Projects................... .......... ................... ................... ................... ................... .................. ................. ........ 30 Selecting an Area of Your Network .................................................................. 31 Creating Parameter Sets ................................................................................. 31 Creating 2g Analysis Parameter Par ameter Sets ......................................................... ........................................................................ ............... 32 Creating 3g Analysis Parameter Par ameter Sets ......................................................... ........................................................................ ............... 36 Creating Prediction Parameter S ets ........................................................................ .......................................................................... .. 39
Starting and Stopping Parameter Sets ............................................................. 40 Working with Parameter Sets........................................................................... 41 ArrayWizard User Reference Guide 7.0 Contents
Page 7
Changing Parameter Set Schedules ......................................................................... ......................................................................... 42 Changing Output File Formats .................................................................................. 43 Changing Output Folder and File Names .................................................................. .................................................................. 43 Generating Statistics Reports ........................................................... .................................................................................... ......................... 44 Changing the Output File Naming Convention ........................................................... ......................................................... 44 Running an Executable.................................................................................. Executable.............................................................................................. ............ 45 Deleting Old Files Before Creating Arrays................................................................. 45 About Tasks ................................................................. ............................................................................................................... .............................................. 45 Viewing and Deleting Selected Tasks ....................................................................... ....................................................................... 46 Viewing and Deleting Running Tasks ......................................................... ........................................................................ ............... 47 Deleting Tasks for a Parameter S et .......................................................................... .......................................................................... 48
Chapter 5 Configuring Settings In ARRAYWIZARD
49
Configuring 2g Display Settings ....................................................................... 49 Configuring 3g Display Settings ....................................................................... 50 Setting UTM Borders ....................................................................................... 51 Configuring Your Your GIS Coordinate System.................. ......... ................... ................... ................... ................... ......... 51 Configuring Measurement Measurement Based Prediction and Interpolation ................... ......... ................ ...... 52 Configuring Carrier Wave Measurements ........................................................ 54 About the ARRAYWIZARD ARRAYWIZARD Settings Dialog Dialog Box .................. ........ ................... ................... ................... ......... 54 Configuring Advanced Administrator Settings ........................................................... ........................................................... 55 Configuring Ad vanced Agent Age nt Settings ....................................................................... ....................................................................... 56
Enabling Large Array Support .......................................................................... 57 Optimising Performance .................................................................................. 57
Index
Page 8
59
ArrayWizard User Reference Guide 7.0 Contents
CHAPTER 1
Introduction The creation of prediction and analysis arrays can be one of the most time consuming parts of RF Planning. ARRAYWIZARD eliminates the need to create arrays manually. Using the filters you have created in ENTERPRISE and the data in your database, ARRAYWIZARD automatically generates arrays for you. ARRAYWIZARD enables you to process your data throughout a distributed PC based network. You can use ARRAYWIZARD to: Create, maintain and monitor the ARRAYWIZARD Agents which handle distributed workload Create and maintain parameter sets to control the generation of prediction and analysis arrays Adjust the production of predictions and arrays using network parameters Produce statistics reports To view the arrays that have been created by ARRAYWIZARD you use the Map View window in ENTERPRISE as described in the ASSET A SSET Help and User Reference Guide.
Before You Start To install ARRAYWIZARD, you will need: Administrator rights for the PC on which you will install ARRAYWIZARD. The correct serial number. Contact Product Support using the details in this chapter if you cannot see ARRAYWIZARD in the list of products when you install. The ENTERPRISE Installation and Administration User Reference Guide, to follow the step by step instructions for installing any of the ENTERPRISE products products including ARRAYWIZARD. Before you can start to use ARRAYWIZARD, you will need: An Oracle data source ENTERPRISE project data Filters So that you can select types of equipment and geographical areas where you can run your predictions. ArrayWizard User Reference Guide 7.0 Introduction
Page 9
Using This Manual To use ARRAYWIZARD you will need to perform the following foll owing steps which are described in this manual. To do this
Read This Chapter
Open the ARRAYWIZARD Administrator
2
Create the agents which will run the tasks that produce your arrays
3
Create the parameter sets that will determine the composition of your arrays
4
Run the tasks that produce the arrays Adjust display display settings settings and other other additional additional paramete parameters rs
5
Obtaining User Assistance Assistance Using Online Help
ENTERPRISE products come with a complete system of online Help which you can access in three ways: From the Help menu, click Help Contents. Scroll through the table of contents and choose a relevant topic to display. To search for something particular, from the Help menu, click Help Contents and using the Index tab or Search tab, type in a letter or word to start searching for relevant topics. Press F1 in a dialog box to t o view context-sensitive help (available for most dialog boxes). If you are using ENTERPRISE within a CITRIX environment, to ensure that the Help graphics are displayed, set your display settings to support more than 256 colours. Using ENTERPRISE User Reference Guides
If you prefer to read printed content, we also provide User Reference Guides. To view or print these as PDFs (Adobe Acrobat portable document format): 1
Make sure you have Adobe Acrobat Reader installed on your PC. If you do not have this, you can install it from the ENTERPRISE CD, or get it from the Adobe website. Adobe and Acrobat are trademarks of Adobe Systems, Incorporated.
2
Click Start on the taskbar, point to Programs, then AIRCOM International, then ENTERPRISE, then Docs. - or Navigate to the Docs folder in the location where you installed the product.
Page 10
ArrayWizard User Reference Guide 7.0 Introduction
If neither of these exists, please contact your administrator. 3
Double-click the PDF file that you want to view.
If you have a customer web account, you can also download the latest User Reference Guides from our website. Checking Release Notes
Each release of the ENTERPRISE software is accompanied by Release Notes, giving important information on system requirements, installation, known issues, upgrades and so on. These notes are included in the ENTERPRISE CD, or you can download them from our website. For any further documentation, such as application notes and extra reference information, please email the support team at the address described in Obtaining Support on page 13. page 13.
Who is This User Reference Guide For? The ENTERPRISE User Reference Guides are intended for different audiences, depending on the particular product. Typical prerequisites include a good understanding of the following: The appropriate telecoms technologies and the associated network planning methods (for planning software) Relational database management, and in particular Oracle database creation and administration procedures (for administrative software) The various parameters utilised for monitoring and optimising networks (for OSS software) Irrespective of the particular product, the following basic knowledge is required: Microsoft Windows concepts The functions of the Microsoft Office suite of tools, in particular Excel
About the ENTERPRISE User Reference Guides This table describes our range of User Reference Guides: This Guide
Contains Information On
What's New
The main difference between the latest versions of the ENTERPRISE suite.
ENTERPRISE Installation and Administration Administratio n
Installing and configuring ENTERPRISE, your network, and Oracle databases. Using Administrator to create users and groups, and set permissions. Also contains contains information information on on software software licensing. licensing.
ENTERPRISE Database Reference
The relationships between tables in the database and the contents of each table.
ENTERPRISE User Reference
Functionality that is common to most of the products in the ENTERPRISE suite, including how to access, view, edit and store data.
ENTERPRISE Technical Reference
File formats, as well as antenna and diffraction calculations.
ArrayWizard User Reference Guide 7.0 Introduction
Page 11
This Guide
Contains Information On
ADVANTAGE ADVANTAGE User Reference Reference
Using ADVANTAGE ADVANTAGE to plan and and optimise optimise networks networks automatically, automatically, consider consider measured data in analysis/optimisation, analyse network performance, identify problematic areas/cells, and related tasks.
ARRAYWIZARD ARRAYWIZARD User Reference
Using ARRAYWIZA ARRAYWIZARD RD to automatically automatically generate generate pathloss prediction predictionss and best server arrays, which gives you instantaneous display of coverage and interference information for pre-selected filters when loaded into ASSET.
ASSET User User Reference Reference
Using ASSET, ASSET, the network planning planning and and analysis tool, tool, to design a range of cellular networks. Includes information on hierarchical network planning, propagation modelling, service and bearer definition, coverage analysis, traffic planning, neighbour planning, measurement data analysis, detailed reporting, analysis arrays and simulation of network performance.
ASSET Technical Technical Reference Reference
Array descriptions descriptions and and information information on some of the algorithms algorithms used in ASSET.
ASSET ACP ACP User Reference Reference Guide Guide
Using ASSET ASSET ACP to to plan and and optimise optimise networks networks automatically, automatically, designed designed as an aid for day-to-day planning. (Optional add-on to ASSET.)
CONNECT User Reference
Using CONNECT, the network transmission transmiss ion and microwave link planning software for full network physical link design and logical link design. Also contains contains CONNECT-specific CONNECT-specific referen reference ce information. information.
DATASAFE User Reference
Using DATASAFE, our network configuration tool to implement both small and large scale changes to networks
DIRECT User Reference
Using DIRECT to design telecommunications telecommunic ations networks of different network layers. Explains how to plan cellular, PSTN and data networks at a both general and strategic level. Also contains contains DIRECT-specific DIRECT-specific reference reference information. information.
Financial Analysis User Reference Guide
Using the Financial Analysis module to evaluate and plan for the revenue potential of your network. (Optional add-on to ASSET and ADVANTAGE.)
ILSA User Reference Guide
Using ILSA, ASSET's automatic 2g frequency planning tool. (Optional add-on to ASSET.)
Page 12
AIRCOM OPTIMA OPTIMA User Reference Reference
Using AIRCOM AIRCOM OPTIMA OPTIMA to view performance performance data and and statistics both with with ENTERPRISE and standalone.
RANOPT User Reference
Using RANOPT to efficiently find faults in your network, optimise and validate its performance prior to commercial launch.
WEBWIZARD User Reference
Using WEBWIZARD to display GIS and report information of network data, including creating layers, regions, nodes, layer types, administering and configuring the system and using the GIS view, explorer and report viewers.
ArrayWizard User Reference Guide 7.0 Introduction
Can You Improve Our User Assistance? We are always trying to improve the online Help and User Reference Guides. If you cannot find the Help you were looking for, need more information, or have any suggestions for improvements, we would be grateful for your feedback. Also, if you are generally satisfied with these resources, we would appreciate any positive feedback. Online Questionnaire
You can help us by completing our brief online questionnaire (http://www.surveymonkey.com/s.as (http://www.surveym onkey.com/s.aspx?sm=RIRKLcrdvaCz px?sm=RIRKLcrdvaCzRnUBNx5tcQ_3d_3d). RnUBNx5tcQ_3d_3d). Alternatively, you can contact us directly at
[email protected] [email protected]. m.
Obtaining Support If you have a difficulty you cannot resolve yourself using the online Help or Reference Guides, or you have found a possible fault in the software, you can log a support request. You may also wish to contact us if you want to: Register for a customer web account to access acc ess the Support area Obtain further documentation, such as application notes and extra reference information Logging Support Requests Online
To log a support request online: 1
Go to the AIRCOM website, at www.aircominternational.com.
2
Click the link for Product Support Login.
3
Log in, using your customer web account username and password.
4
In the Technical Support pane, click Online Helpdesk.
5
Click Log New UTS Call.
6
Type the details of your request, and then click Submit.
ArrayWizard User Reference Guide 7.0 Introduction
Page 13
Contacting us via Telephone or Email
If you wish to contact us directly, directl y, here are the contact details of our regional offices: Location
Regional Office
Contact Details
Europe
United Kingdom
Tel : +44 1932 442000 Fax :+44 1932 442005
[email protected]
Middle East, Africa and Central Asia
Belgium
[email protected]
France
[email protected]
Germany
[email protected]
Italy
[email protected]
Sweden
[email protected]
United Arab Emirates
Tel : +971 4 391 2642 Fax :+971 4 391 8141
[email protected]
South Africa
Tel : +27 11 745 1475 Fax : +27 11 465 1517
[email protected]
Americas
Mexico
support@aircominte support@aircominternationa rnational.com.mx l.com.mx
USA
Tel : +1 214 576 2700 Fax : +1 214 576 2794
[email protected]
Asia and Oceania
Brazil
[email protected]
Singapore Singapore
Tel: +65 6372 0548 0548 Fax: +65 6372 0350
[email protected]
China
Tel: +86 2162792779 Fax: +86 2162792855
[email protected]
India
Tel: +91 124 4848200 Fax: +91 124 4517878
[email protected]
When contacting us with a support query, it would help us if you: Give us as much information as possible about the problem and the t he context in which it occurred State the version and build you are using Have all the details of your query to hand Are logged into the ENTERPRISE application Can send extracts of your data sets if we need them to reproduce your problem
Page 14
ArrayWizard User Reference Guide 7.0 Introduction
Obtaining Further Information and Services As well as comprehensive online Help and User Reference Guides and dedicated Product Support, AIRCOM provides: Online Knowledgebase of Articles
If you register for a customer web account, you can view our searchable technical database in the Product Support section of the AIRCOM A IRCOM website. This Knowledgebase contains articles created by our support professionals who have resolved issues for our customers, and is constantly updated, expanded, and refined to ensure that you have access to the very latest information and frequently asked questions. Power Tools
If you register for a customer web account, you can download from a selection of useful power tools, such as file conversion utilities. Latest Copies of the User Reference Guides
If you register for a customer web account, you can download the latest User Reference Guides (PDFs) from our website. If you do this, please check the back of the reference guides for any additions or corrections. Consultancy Services
AIRCOM also provide full radio consultancy services in Network Audits, Business Planning Support, Licence Applications, Radio Network Planning, Telecommunications Research and System Modelling and Propagation Analysis and Modelling. Training
There is a wide variety variet y of courses run by AIRCOM. These courses range from tool training to technology training. For details, contact Competence Development Solutions (training@aircominternationa (
[email protected]). l.com).
ArrayWizard User Reference Guide 7.0 Introduction
Page 15
Page 16
ArrayWizard User Reference Guide 7.0 Introduction
CHAPTER 2
The ARRAYWIZARD ARRAYWIZARD User Interface You control ARRAYWIZARD with the ARRAYWIZARD Administrator.
Opening the ARRAYWIZARD ARRAYWIZARD Administrator To open the ARRAYWIZARD A RRAYWIZARD Administrator: 1
Click Start.
2
Browse to the ARRAYWIZARD subfolder of ENTERPRISE, for example All Programs/AIRCOM Programs/AIRCOM International/ENTERPRISE International/ENTERPRISE 7.0/ARRAYWIZARD.
3
Click ARRAYWIZARD Admin tool.
About the th e ARRAYWIZARD ARRAYWIZARD Main Window The ARRAYWIZARD Main Window enables you to view information about: The status of agents and tasks 2g analysis arrays 3g analysis arrays Cell predictions All currently active tasks The location of your agents
ArrayWizard User Reference Guide 7.0 The ARRAYWIZARD User Interface
Page 17
This picture shows an example of the ARRAYWIZARD Main Window:
With the exception of agents, all items displayed in the right hand pane can be multiselected.
About the File Menu Use the File menu to: Login and logout of databases Open and close projects Exit ARRAYWIZARD
About the View Menu Use the View menu to: Open a new Map View window Refresh the display in the currently selected Map View window
About the Database Menu Use the Database menu to: Refresh your current database
Page 18
ArrayWizard User Reference Guide 7.0 The ARRAYWIZARD User Interface
About the Project Settings Menu Use the Project Settings menu to configure: 2g and 3g display settings UTM borders MapInfo settings if you have MapInfo software installed
About the ARRAYWIZARD Toolbar The ARRAYWIZARD toolbar enables you to open and close projects, view map information, filter the display of running tasks and refresh the data displayed. The following picture shows the ARRAYWIZARD toolbar:
The ARRAYWIZARD Toolbar
About the Map View Window The Map view window enables you to view your current network’s configuration, pathloss predictions and 2g and 3g arrays. In the ARRAYWIZARD Administrator the Map View window retains the core functionality of the Map View window in ENTERPRISE. For more information see the ENTERPRISE User Reference Guide.
Permitting and Preventing Multiple Users You can configure ARRAYWIZARD to allow more than one administrator to schedule jobs. This is achieved by allowing each administrator to create their own personal user schema in the same database. The default schema can be used by any user whereas a user schema can only be used by b y the user who created it. Any parameter sets that are stored in a user schema will only be visible to the user that created the schema. There can only ever be one default schema but there can be multiple user schemas. Each agent machine can only work with one schema. If you are using two user schemas then you will need at least two agent machines available.
ArrayWizard User Reference Guide 7.0 The ARRAYWIZARD User Interface
Page 19
To permit multiple users: 1
From the Tools menu, click Allow user schemas so there is a tick next to this option:
If this is the first fi rst time you have done this, a message informing you that you will need to log out and in again for the change to take effect appears. 2
Click OK.
3
Log out of ARRAYWIZARD. A RRAYWIZARD. ARRAYWIZARD is now configured to allow multiple users. Next time a user logs in to ARRAYWIZARD, the schema choice dialog box is displayed:
To log in to ARRAYWIZARD A RRAYWIZARD with a user schema which can only be used by the t he current user: 1
Select User Schema.
2
Click OK. The Confirm schema creation dialog box appears.
3
Click Yes. A message informing you that the schema has been created appears.
4
Click OK. You can now use ARRAYWIZARD with your user schema and you will see that the current user name (such as 'admin') rather than 'default' ' default' is displayed at the top of the left hand pane of the ARRAYWIZARD Main Window:
Page 20
ArrayWizard User Reference Guide 7.0 The ARRAYWIZARD User Interface
Subsequently when you log in to ARRAYWIZARD the schema choice dialog box will appear with User Schema selected by default. Since the user schema has already been created you need only click clic k OK to continue using ARRAYWIZARD with your user schema. If you choose to use the default schema instead, this choice will appear the in schema choice dialog box by default next time you log in to ARRAYWIZARD. To prevent multiple users: 1
From the Tools menu, deselect Allow user schemas so that there is i s no tick next to this option. A message informing you that you will need to log out and in again for the change to take effect appears.
2
Click OK.
3
Log out of ARRAYWIZARD. A RRAYWIZARD. ARRAYWIZARD is now configured not to allow multiple users. Subsequently when you log in to ARRAYWIZARD the schema choice dialog box will not appear and the default schema will be used. You will see that default schema rather than administrator schema is displayed at the top of the left l eft hand pane of the ARRAYWIZARD Main Window.
ArrayWizard User Reference Guide 7.0 The ARRAYWIZARD User Interface
Page 21
Page 22
ArrayWizard User Reference Guide 7.0 The ARRAYWIZARD User Interface
CHAPTER 3
Setting Up Agents ARRAYWIZARD can distribute the processing load across multiple PCs to achieve greater speeds and to accomplish large tasks. In the context of ARRAYWIZARD, "agents" are applications that generate predictions and arrays based on parameter sets. ARRAYWIZARD defines 3 types of agent, namely “Prediction” agents, “2g” agents and “3g” agents, with each one having a connection to the central ENTERPRISE database. A single PC can run multiple instances of such agents. You can choose to run agents on separate machines in your network, for distributed processing. These can predict and re-predict out-of-date sites at defined intervals. Intervals can be set in the scheduler or you can manually start and stop parameter sets. The following table details the associations between agents and parameter sets: This agent
Requires this parameter set
2g
2g Analysis
3g
3g Analysis
Prediction
Prediction
About the th e Agent Status The current status of your agents is indicated in the right hand pane of the ARRAYWIZARD main window under the heading of Status.
ArrayWizard User Reference Guide 7.0 Setting Up Agents
Page 23
The following table shows the status meanings: Status
Meaning
Stopped
The agent is stopped and will need to be started (manually or automatically) in order to run tasks. To start an agent manually, see Starting and Stopping Agents on on page 25. page 25.
Idle
The agent is available to run tasks but is not currently processing any.
Not Responding
There is no response from the agent. Check the agent.
Switching Project
The agent has completed a task belonging to one project and is about to process another belonging to a different project.
Working
The agent is in the process of running a task.
Unknown
ARRAYWIZARD Administrator Administrato r has just been started and has not yet received a polling response from the agent.
Responding
The agent is responding to polls but has not provided a status update since the ARRAYWIZARD Administrator was started.
Error
An error has occurred. The agent will not process any more tasks until it has been restarted. To start an agent manually, see Starting and Stopping Agents on on page 25. page 25.
Adding Agents By adding agents, you can choose a type of agent and decide where you want your agent to run from. You will need to have the ARRAYWIZARD Agent software installed on any machine you select. It may be that agents have already been added during the installation process. See Configuring Agents on page 26 page 26 for further details. To add an agent: 1
In the left hand pane of the main window right-click on Agents and from the menu that appears, click Add Agent:
2
You can select your local machine to add or if you have a network, you can distribute the processing of agents to other machines. Distributed processing allows you to share the resources of your network and is helpful if you are running frequent predictions or predictions for large networks. Agents read and write predictions to a common shared directory. In the Agent Name field of the New Agent dialog box that appears:
Page 24
If you wish to run the agent from your local machine, type in the name of your local machine. If you wish to run the agent from a machine present on your network, type in the name of the networked machine. ArrayWizard User Reference Guide 7.0 Setting Up Agents
3
In the Agent Type field, select the type of agent (2g, 3g or prediction) that you wish to create from the drop down list.
4
In the Startup Type field, select whether you want to start this agent manually or automatically. If you select Automatic from the drop down list the agent will be started by ARRAYWIZARD Administrator which checks regularly to see if any agents need to be started or stopped. If ARRAYWIZARD Administrator fails to start the agent it will not try again for a given period, the default being four hours. An agent designated as automatic will be shut down automatically if it i t is inactive for a given period (the default being twenty minutes) and there is no work for it to do.
5
Select the number of instances of the agent that will be run concurrently.
6
Click OK.
Your agent is now ready to run.
Starting Starting and Stopping Agents To start an agent manually: 1
In the left hand pane of the main window, select Agents.
2
In the right hand pane, right-click the agent to be started.
3
From the menu that appears, click Start. The status of the t he agent is updated when the resulting Starting Agent progress bar reaches the end.
To stop an agent manually: 1
In the left hand pane of the main window, select Agents.
2
In the right hand pane, right-click the agent to be stopped.
3
From the menu that appears, click Stop. The status of the agent is updated when the resulting Shutting Down Agent progress bar reaches the end. An error message is displayed if the agent is processing an array when you attempt to stop it.
ArrayWizard User Reference Guide 7.0 Setting Up Agents
Page 25
Monitoring Agents To help diagnose problems with an agent, you can remotely retrieve its message log: 1
In the left hand pane of the ARRAYWIZARD Administrator main window, click Agents. A list of agents is displayed in the right hand pane:
2
Right-click on the agent that you wish to monitor and from the menu that appears select the Retrieve Message Log option. The message log for the selected agent is displayed.
Deleting Agents By deleting agents you can remove agents from any machine present in your network. You cannot delete a running agent. To delete an agent: 1
In the left hand pane of the main window, select Agents.
2
In the right hand pane, right-click on an agent.
3
From the menu that appears, click Delete.
4
Click Yes.
Configuring Agents This process is normally carried out when ENTERPRISE is installed and is described in the ENTERPRISE Installation and Administration Guide. If it has not been done during ENTERPRISE installation it can be done subsequently using the Configure ARRAYWIZARD Agent tool as described below. Before you can use ARRAYWIZARD on a particular machine you must identify: The database to which all the ARRAYWIZARD agents running on the machine will connect The account under which they will run
Page 26
ArrayWizard User Reference Guide 7.0 Setting Up Agents
To configure an agent: 1
Click Start, All Programs, AIRCOM International, ENTERPRISE 7.0, ArrayWizard, Configure ARRAYWIZARD Agent. The following dialog box appears:
2
In the ARRAYWIZARD Agent Database pane: In this field
Enter
Database Source Name
The name of the database to be used
Database User Name
The user name you use to access your database
Database Password/Confirm Password/Confi rm Password
The password you use to access your database
Select Use Default Schema if you want this agent to connect to the default schema. - or Select Use User Schema if you want this agent to connect to the personal schema for the user specified in the Database User Name field. For more information, see Permitting and Preventing Multiple Users on page 19. page 19. 3
In the Run Agent As pane: In this field
Enter
Windows Domain Name
The name of your Windows network
Windows User Name
The user name you use to access your Windows network
Password/Confirm Password
The password you use to access your Windows network
ArrayWizard User Reference Guide 7.0 Setting Up Agents
Page 27
This account must have access to folders containing predictions, coverage details and map data. 4
Click OK.
You can use the Register Agents button to add all 2g, 3g and prediction agents automatically rather than adding them manually via the ARRAYWIZARD Administrator as described under Adding Agents on page 24. page 24. You You can view the agents that you have automatically automatically added by opening the ARRAYWIZARD Administrator, clicking on ARRAYWIZARD in the left hand pane of the Main Window and then clicking on Agents.
Page 28
ArrayWizard User Reference Guide 7.0 Setting Up Agents
CHAPTER 4
Creating Arrays Using ARRAYWIZARD Arrays are generated from network information stored in your database. You can configure parameter sets to extract this information from your database and create your arrays. You can schedule the interval for this extraction extracti on to ensure that your predictions and arrays are up to date. If they are found to be out of date, they are updated during the predictions process. Before you create coverage analysis arrays, ensure you have created filters and coverage schemas in ENTERPRISE and ASSET. For more information see the ENTERPRISE and ASSET User Reference Guides.
About Array Creation ARRAYWIZARD uses the same system to create its Pathloss Predictions and Coverage Arrays as ASSET. It can create: GSM Coverage arrays such as Best Server and Service Area (block or contour) 3g arrays such as Pilot Strength, Ec/Io, Pilot Polluters and Handover Type for UMTS and CDMA2000 networks ARRAYWIZARD uses tiling as a way of breaking down the region of interest into more manageable portions which require fewer resources and can also be distributed for processing. By decreasing the tile size, you can create more tiles which require less l ess memory and processing, but consequently decrease the speed of the calculations. The tile size defines the distance in km that each array file is created for. For example, a tile size of 30 will create array tiles of 30 x 30 square km for the entire area of the network you are using for your predictions.
ArrayWizard User Reference Guide 7.0 Creating Arrays Using ARRAYWIZARD
Page 29
Opening and Closing Projects In ARRAYWIZARD you can configure coverage and prediction settings for several projects stored in the same database. The multi-project support that ARRAYWIZARD provides enables you to perform the following functions on parameter sets without having to open the projects with which they are associated: Run Delete Rename Change schedules Change output file formats Show selected tasks Delete all tasks To carry out any of these functions: 1
In the left-hand pane of the ARRAYWIZARD Administrator main window, click 2g Analysis, 3g Analysis or Cell Predictions as required.
2
In the right-hand pane of the ARRAYWIZARD Administrator main window, right-click a parameter set.
3
From the menu that appears, select the function you require. If you select Edit from this menu you will be prompted to open a project.
To open a project at any other time ti me in order to create or edit parameter sets: 1
From the File menu, click Open Project.
2
In the dialog box that appears, select the project you wish to configure and click Start.
To close the current project and open another project in the same database:
Page 30
1
From the File menu, click Close Project.
2
Click Yes to confirm.
3
From the File menu, click Open Project.
4
In the dialog box that appears, select the project you wish to configure and click Start. ArrayWizard User Reference Guide 7.0 Creating Arrays Using ARRAYWIZARD
To close the current project and open another project in a different database: 1
From the File menu, click Logout.
2
Click Yes to confirm.
3
From the File menu, click Login.
4
In the dialog box that appears, enter your password and click the Login button.
5
From the File menu, click Open Project.
6
In the dialog box that appears, select the project you wish to configure and click Start. For more information, see the ENTERPRISE Installation and Administration User Reference Guide.
Selecting an Area of Your Your Network Netw ork By selecting an area of your network in the Map View window you can identify specific sites or a specially chosen geographical location from which you wish to produce your arrays. To select an area of your network: 1
From the View menu select New 2d View or click on the View window. You must have a project open to do this.
icon to open the Map
2
Display sites and filters in your network from which you wish to produce your arrays.
For more information on these steps see the ENTERPRISE User Reference Guide. When you create a parameter set for analysis arrays as described in the following sections, you can apply the current map view to it.
Creating Parameter Sets You can use parameter sets to retrieve specific parameters from your database relating to arrays you wish to generate. By using parameter sets you can choose exactly which data elements you wish to extract from your database in order to create the arrays you require. The three types of parameter set that you can create are: 2g Analysis Parameter Sets 3g Analysis Parameter Sets Prediction Parameter Sets The following sections describe how to create each of these three types of parameter set. For more information on the setting and use of specific parameters see the ENTERPRISE and ASSET User Reference Guides.
ArrayWizard User Reference Guide 7.0 Creating Arrays Using ARRAYWIZARD
Page 31
Creating 2g Analysis Parameter Sets 2g analysis parameter sets are used to retrieve information from your database which is needed to create 2g analysis arrays. For more information on the setting and use of specific parameters see the ENTERPRISE and ASSET User Reference Guides. Before creating 2g analysis parameter sets, ensure that you have added an agent. For information on how to do this, see Adding Agents on page 24. If you have not yet opened a project you must now do so as described under Opening and Closing Projects on page 30. To create 2g analysis parameter sets: 1
In the left hand pane of the Main Window select 2g Analysis.
2
Right-click and from the menu that appears, select Add 2g Analysis:
3
On the Select View page that appears, enter in the co-ordinates for the area of your network view containing the sites you wish to predict. - or – If you are displaying the sites in the Map View window, click Select View to use the view currently displayed.
4
Click Next.
5
Select the filters you wish to use and click Next.
6
Select the types of arrays you wish to create. If you wish to display a particular Nth best server, type a value for N next to the checkbox:
The default setting of 1 is equivalent to the best server, 2 represents the second best server and so on. 7
In the Resolution field, select a resolution for the array.
8
In the Tile Size field, select a tile size. This size defines the distance in km that each array file is created for. For example, a tile size of 30 will create array tiles of 30 x 30 square km for the entire area of the network you are using for your predictions.
Page 32
ArrayWizard User Reference Guide 7.0 Creating Arrays Using ARRAYWIZARD
The number of tiles that will be generated by your choice of tile size and region is shown below the Tile Size field after you have made an entry in it:
9
Click Next.
10 Choose whether cell layers will be considered during the creation of coverage arrays and select the layers whose contribution you want to include. You can do this for both the serving and interfering signal. 11 To override the best server selection selecti on algorithm and ignore the contribution of higher priority cell layers without any carrier assignments, select the Consider only sub-cells that have carrier layers with assigned carriers checkbox. This prevents holes in the interference array from appearing when a sub-cell theoretically provides coverage but has not yet been assigned any carriers. 12 In the Thresholds pane, type service level and timing advance threshold values. These thresholds restrict the overall radius of coverage provided by the sub-cell to either the minimum service level or the maximum timing advance, whichever is reached first. For a cell using extended range where two timeslots are used, the maximum timing advance is 133, otherwise the maximum is normally 63. (Within ENTERPRISE these thresholds are set on the Coverage/Interference tab of the Array Settings dialog box which you open by selecting Array A rray Settings from the Arrays menu). 13 In the Cell Parameters pane, select to use sub-cell specific or global values. To use values that you have entered in the Thresholds pane as described above, you must select sub-cell specific. If you select Global Values the values entered in the ENTERPRISE site database are used. (Within ENTERPRISE these thresholds are set on the General tab of the Site Database dialog box which appears when you select Sites from the Database menu and click on an individual cell). 14 Click Next. 15 In the Channel Selection pane, select what type of interference you want to be considered for the interference arrays:
Co-Channel Only
Adjacent Channel Only
Co-Channel and Adjacent Channel
If you select Adjacent Channel Only or Co-Channel and Adjacent Channel, the value in the Adjacent Channel Offset pane is used to produce the adjacent channel arrays. You can edit this value if you wish. It is also used to produce the adjacent channel curve used in calculating interference.
ArrayWizard User Reference Guide 7.0 Creating Arrays Using ARRAYWIZARD
Page 33
16 In the Interference Options pane you can: Select
To
Use Frequency Hopping
Use Frequency Hopping information when creating arrays. If you have selected Use Frequency Hopping, you can al so choose to use Frequency diversity information when generating arrays. This adds a gain to the serving cell signal to simulate the improvement in C/I that frequency diversity provides. The gain applied depends upon the number of hopping frequencies. For more information on the frequency hopping diversity gain value, see the ASSET User Reference Guide. The interference array calculations also use a BER to/from C/I conversion when frequency hopping is used. For more information on using frequency hopping, see the ASSET User Reference Guide.
Use DTX
Use DTX information when creating arrays. This means ASSET will scale down the power of the transmitter based on the activity factor of the terminal. Using DTX then helps to reduce interference between different cells and to increase the capacity of the system.
Use Traffic
Scale the interference arrays if the traffic load of a subcell is smaller than the potential capacity of the carriers allocated to that subcell. By comparing the channels allocated to a subcell with the number of channels required by the traffic load, the proportion of channels in use ca n be calculated and interference reduced accordingly.
Use Antenna Hopping
Use the antenna hopping gain in the array calculations. Antenna hopping is a transmit diversity scheme in which consecutive bursts of information are transmitted on different antennas. When antennas are exposed to different multipath fading, a diversity gain is achieved. For information on how this gain is calculated, see the ASSET User Reference Guide.
17 In the Erlang Table type pane, select a blocking percentage and select to use either the Erlang B or Erlang C blocking b locking formula. These blocking formulas are described in the ASSET User Reference Guide. 18 Click Next. 19 On the Prediction Parameters page, select Use network element settings or Use overridden settings. If you choose Use network element settings, the creation of arrays is based on the model, resolution and radius settings on the ENTERPRISE Site Database Antennas tab. If you choose Use overridden settings, the creation of arrays is based on your override settings. For more information on these options, see the ASSET User Reference Guide. 20 On the Select Schedule page, indicate whether you wish to run your parameter set manually or every:
specified number of minutes
specified number of days at a specified time ti me
specified weekday or number of weekdays at a specified time
specified day of a specified month or number of months at a specified time
The ARRAYWIZARD Administrator must be running for scheduled parameter sets to run. You can change the schedule later if you want to. For information on how to do this see Changing Parameter Set Schedules on page 42. Page 34
ArrayWizard User Reference Guide 7.0 Creating Arrays Using ARRAYWIZARD
21 Click Next. 22 Select the Smooth predictions when using checkbox if you want bilinear smoothing to be performed on prediction (pathloss) data when it is used. This helps to minimise edge effects between a primary and secondary prediction. 23 Click Next. 24 On the Select Outputs page, select the file fi le format(s) (BMP, 3GA, DAT, DIB, GIF, JPEG, MapInfo MIF, MIF, MapInfo TAB, TAB, PCX, Shape, TGA, TIF) that your arrays will be saved in. 25 In the Array specific pane you can specify the folder name and file name text for each array type. The name of the currently selected array type is displayed above the Folder Name. To specify details for another array type, pick one from the drop-down list. 26 In the Folder Name field, type your required folder name for output files from the selected array type. 27 In the File Name Text field, type the required text component of the file name for output files from the selected selected array type. The full file name is made up of the text component specified here and a data component specified subsequently. 28 If you have selected an output file format of DAT, you can choose to generate statistics reports by selecting the Generate array stats checkbox in the Array statistics reports pane. To determine which details are included in the report:
Click the Configure button
Indicate your choices in the Statistics dialog box.
Because ARRAYWIZARD uses distributed processing, you will need to add a valid network path in the Raster file(.tri) field of the Statistics dialog box. For further information on the parameters in the Statistics dialog box, see the Generating Reports and Statistics chapter of the ASSET User Reference Guide. 29 If you have chosen to generate statistics reports you must also select the statistics file type that you require: XLS, text or CSL. The statistics file type ty pe that you choose will apply to all array types. 30 If more than one tile results from your settings at step 8 and you have chosen to generate statistics reports, a merged file based on the tiles is created for the purpose of generating the statistics. You can keep this merged file for use in ENTERPRISE by selecting the Save resultant merged file checkbox. 31 The file names for your array output files will comprise a data related element and a text element. You can choose the order in which these elements appear. The data element can be created from the region and resolution, an incrementing number (that is, a number which increases with each file fil e created), or an incrementing number and the resolution. In the Naming convention for file name data pane, select the type of data element and the order of text and data that you require.
ArrayWizard User Reference Guide 7.0 Creating Arrays Using ARRAYWIZARD
Page 35
32 You may want to use a post processing application to handle your output files. To open such an application automatically once your output files have been produced, select the 'Run an executable when the parameter set has completed' checkbox. You can then click the browse button and locate the required executable, or drag the executable into the specification field. You can also select the 'Only run if no errors were encountered' checkbox if applicable, and type any parameters applicable to the executable into the "Optional command line argument" field. 33 To have all the files in your coverage folder deleted before your arrays are created, select the appropriate checkbox. 34 Click Finish. Your parameter set is listed in the right hand pane of the main window and is ready to be run manually or when specified by the scheduler:
To run a parameter set manually see Starting and Stopping Parameter Sets on page 40.
Creating 3g Analysis Parameter Sets 3g analysis parameter sets are used to retrieve information from your database which is needed to create 3g analysis arrays. You can create 3g analysis arrays for UMTS and for CDMA2000. For more information on the setting and use of specific parameters see the ENTERPRISE and ASSET User Reference Guides. Before creating 3g analysis parameter sets, ensure you have added an agent. For information on how to do this, see Adding A dding Agents on page 24. page 24. To create 3g analysis parameter sets: 1
In the left hand pane of the main window select 3g Analysis. Right-click and from the menu that appears, point to Add 3g Analysis and then click cl ick either UMTS or CDMA2000. If you have not yet opened a project you must now do so as described under Opening and Closing Projects on page 30. page 30.
2
On the Select View page that appears, type in the co-ordinates for the area of your network view containing the sites you wish to predict. - or – If you are displaying the sites in the Map View window, click Select View to use the view currently displayed.
Page 36
3
Click Next.
4
Enter the parameters that you wish to apply to your 3g analysis. These parameters are described in Simulating Network Performance chapter of the ASSET3g User Reference Guide.
5
Click Next.
6
Select the filters you wish to use. ArrayWizard User Reference Guide 7.0 Creating Arrays Using ARRAYWIZARD
7
Click Next.
8
Where applicable use any available checkboxes to indicate the terminal types that you wish to include in your 3g analysis.
9
Click Next.
10 On the Simulator Settings page, click Next. 11 For CDMA parameter sets, go to step 13. For UMTS parameter sets only, the Specify DVB-H parameters page appears. Type in the DVB-H parameters you require. These are described in the chapter on Planning a DVB-H Network in the ASSET3g User Reference Guide. 12 Click Next. 13 On the Prediction Parameters page, select Use network element settings or Use overridden settings. If you choose Use network element settings, the creation of arrays is based on the model, resolution and radius settings on the ENTERPRISE Site Database Antennas tab. If you choose Use overridden settings, the creation of arrays is based on your override settings. For more information on these options, see the ASSET User Reference Guide. If you select an array resolution which is not supported by the current project height data, a clutter not found error will be displayed. 14 Select the Smooth predictions when using checkbox if you want bilinear smoothing to be performed on prediction (pathloss) data when it is used. This helps to minimise edge effects between a primary and secondary prediction. 15 Click Next. 16 In the Tile Size field of the Raster Parameters pane, select a tile size. This size defines the distance in km that each array file is created for. For example, a tile size of 30 will create array tiles of 30 x 30 square kms for the entire area of the network you are using for your predictions. The number of tiles that will be generated by your choice of tile size and region is shown below the Tile Size field after you have made an entry in it. 17 Click Next. 18 On the Select Schedule page, indicate whether you wish to run your parameter set manually or every:
specified number of minutes
specified number of days at a specified time ti me
specified weekday or number of weekdays at a specified time
specified day of a specified month or number of months at a specified time
The ARRAYWIZARD Administrator must be running for scheduled parameter sets to run. You can change the schedule later if you want to. For information on how to do this see Changing Parameter Set Schedules on page 42. ArrayWizard User Reference Guide 7.0 Creating Arrays Using ARRAYWIZARD
Page 37
19 Click Next. 20 On the Select Outputs page, select the file format(s) (BMP, 3GA, DIB, GIF, JPEG, MapInfo MIF, MapInfo TAB, PCX, Shape, TGA, TIF) that your arrays will be saved in. 21 In the Array specific pane you can specify the folder name and file name text for each array type. The name of the currently selected array type is displayed above the Folder Name. To specify details for another array type, pick one from the drop-down list. 22 In the Folder Name field, type your required folder name for output files from the selected array type. 23 In the File Name Text field, type the required text component of the file name for output files from the selected array type. The full file name is made up of the text component specified here and a data component specified subsequently. 24 If you have selected an output file format of 3GA, you can choose to generate statistics reports by selecting the Generate array stats checkbox in the Array statistics reports pane. To determine which details are included in the report:
Click the Configure button
Indicate your choices in the resultant Statistics dialog d ialog box.
Because ARRAYWIZARD uses distributed processing, you will need to add a valid network path in the Raster file(.tri) field of the Statistics dialog box. For further information on the parameters in the Statistics dialog box, see the Generating Reports and Statistics chapter of the ASSET User Reference Guide. 25 If you have chosen to generate statistics reports you must also select the statistics file type that you require from XLS, text or CSL. The statistics file type that you choose will apply to all array types. 26 If more than one tile results from your settings at step 16 and you have chosen to generate statistics reports, a merged file based on the tiles is created for the purpose of generating the statistics. You can keep this merged file for use in ENTERPRISE by selecting the Save resultant merged file checkbox. 27 The file names for your array output files will comprise a data related element and a text element. You can choose the order in which these elements appear. The data element can be created from the region and resolution, an incrementing number (that is, a number which increases with each file fil e created), or an incrementing number and the resolution. In the Naming convention for file name data pane, select the type of data element and the order of text and data that you require. 28 You may want to use a post processing application to handle your output files. To open such an application automatically once your output files have been produced, select the 'Run an executable when the parameter set has completed' checkbox.
Page 38
ArrayWizard User Reference Guide 7.0 Creating Arrays Using ARRAYWIZARD
You can then click the browse b rowse button and locate the required executable, or drag the executable into the specification field. You can also select the 'Only ' Only run if no errors were encountered' checkbox if applicable, and type any parameters applicable to the executable into the "Optional command line argument" field. 29 To have all the files in your coverage folder deleted before your arrays are created, select the appropriate checkbox. 30 Click Next. 31 The Summary page shows the input parameters that you have set and the amount of memory needed to generate your arrays. If you wish to change any of these you can use the Back button to access the appropriate page. 32 Click on the Auto Setup Configuration button, and in the dialog box that appears, select the Array Parameters and Array Types that you want to exclude excl ude from your arrays. It is important that you do this, t his, because the default settings will produce a lot of arrays and may take a very long time. You can make selections from both the Array Parameters and Array Types lists and the filters will act in combination. 33 Having made your selections, click OK. 34 Click Finish. Your parameter set is listed in the right hand pane of the main window and is ready to be run manually or when specified by the scheduler:
To run a parameter set manually see Starting and Stopping Parameter Sets on page 40.
Creating Prediction Parameter Sets Prediction parameter sets are used to retrieve information from your database, which is needed to create prediction files. For more information on the setting and use of specific parameters see the ENTERPRISE and ASSET User Reference Guides. Before creating prediction parameter sets, ensure you have added an agent. For more information see Adding Agents on page 24. page 24. To create prediction parameters sets: 1
In the left hand pane of the main window right-click on Cell Predictions and from the menu that appears, select Add Predictions. If you have not yet opened a project you must now do so as described under Opening and Closing Projects on page 30. page 30.
2
On the Select Filters page, choose the filters you wish to use.
3
Click Next.
4
On the Prediction Parameters page, select Use network element settings or Use overridden settings.
ArrayWizard User Reference Guide 7.0 Creating Arrays Using ARRAYWIZARD
Page 39
If you choose Use network element settings, the creation of arrays is based on the model, resolution and radius settings on the ENTERPRISE Site Database Antennas tab. If you choose Use overridden settings, the creation of arrays is based on your override settings. For more information on these options, see the ASSET User Reference Guide. 5
Select the Smooth predictions when using checkbox if you want bilinear smoothing to be performed on prediction (pathloss) data when it is used. This helps to minimise edge effects between a primary and secondary prediction.
6
Use the checkbox provided to indicate whether or not you wish to generate vectors for each cell, If you choose to do so, a polygon will be placed around the different dBm range bands which can be seen using MapInfo software. software.
7
Click Next.
8
On the Select Schedule page, indicate whether you wish to run your parameter set manually or every:
so many minutes
so many days at a specified time
specified weekday or number of weekdays at a specified time
specified day of a specified month or number of months at a specified time
The ARRAYWIZARD Administrator must be running for scheduled parameter sets to run. You can change the schedule later if you want to. For information on how to do this see Changing Parameter Set Schedules on page 42. 9
Click Finish. Your parameter set is listed in the right hand pane of the main window and is ready to be run manually or when specified by the scheduler:
To run a parameter set manually see Starting and Stopping Parameter Sets on page 40.
Starting Starting and Stopping Parameter Sets Before starting parameter sets, ensure you have selected and configured a suitable agent. For information on how to do this, see Setting Up Agents on page 23. page 23. By starting and stopping parameter sets, you can manually control predictions. For example, you may want to start a prediction before it is due to be started by the scheduler or stop a prediction before it has completed. To start and stop parameter sets:
Page 40
1
In the left hand pane of the main window, select the appropriate array type.
2
In the right hand pane, right-click on a parameter set and from the menu that appears, click either: ArrayWizard User Reference Guide 7.0 Creating Arrays Using ARRAYWIZARD
Run to start the parameter set - or Stop/Delete All Tasks to stop the parameter set
Working with Parameter Sets Having created parameter sets you can view, rename, edit edi t and delete them. You cannot rename, edit or delete a parameter set while it is running. Viewing Parameter Sets
This enables you to monitor the progress of your pathloss predictions and best server arrays as they are generated. To view parameter sets: In the main window in the left hand pane, select the appropriate array type. Parameter sets appear in the right hand pane, where you can view their progress which is shown in the Status column.
Renaming a Parameter Set
To rename a parameter set: 1
In the left hand pane of the main window, select the appropriate array type.
2
In the right hand pane, right-click a parameter set and from the menu that appears, click Rename.
3
In the dialog box that appears, type in a new name and click OK.
Editing a Parameter Set
To edit a parameter set: 1
In the left hand pane of the main window, select the appropriate array type.
2
In the right hand pane, right-click a parameter set and from the menu that appears, click Edit. If you do not have a project open you will be prompted to open one. The wizard from which you created the parameter set then appears and you can make the appropriate changes.
Deleting a Parameter Set
To delete a parameter set: 1
In the left hand pane of the main window, select the appropriate array type.
2
In the right hand pane, right-click a parameter set and from the menu that appears, click Delete.
ArrayWizard User Reference Guide 7.0 Creating Arrays Using ARRAYWIZARD
Page 41
3
In the dialog box that appears, click Yes.
Changing Parameter Set Schedules Before scheduling parameter sets, ensure you have selected and configured a suitable agent. For more information, see Setting Up Agents on page 23. You normally set up schedules when you first create your parameter sets. By scheduling parameter sets, you can control the rate at which sites in your network are predicted and re-predicted if found to t o be out of date. This enables you to continually monitor the state of your network. You can change the schedules and output file formats of parameter sets without having to open the projects with which they are associated. To change a schedule setting: 1
In the left hand pane of the main window, select the appropriate array type.
2
In the right hand pane, right-click a parameter set and from the menu that appears, click Set Schedule (for prediction parameter sets) or Set Schedule/Outputs (for 2g and 3g analysis parameter sets).
3
On the Select Schedule page, indicate whether you wish to run your parameter set manually or every:
specified number of minutes
specified number of days at a specified time ti me
specified weekday or number of weekdays at a specified time
specified day of a specified month or number of months at a specified time
This picture shows an example:
4 Page 42
Click OK. ArrayWizard User Reference Guide 7.0 Creating Arrays Using ARRAYWIZARD
Changing Output File Formats To select output file format(s) for your 2g or 3g analysis arrays: 1
In the left hand pane of the main window, select the appropriate array type.
2
In the right hand pane, right-click a parameter set and from the menu that appears, click the Set Schedule/Outputs Schedule/Outputs option. In the dialog box that t hat appears, select the Outputs tab:
3
Select the file format(s) that your arrays will be saved in.
4
Click OK.
Changing Output Folder and File Names To change the name of the folder where arrays of a particular type will be stored and to specify the text component of the file name: 1
In the left hand pane of the main window, select the appropriate array type.
2
In the right hand pane, right-click the required parameter set and from the menu that appears, click the Set Schedule/Outputs option.
3
In the dialog box that appears, select the Outputs tab.
4
The name of the currently selected array type t ype is displayed above the Folder Name field in the Array specific pane:
If you wish to select a different array type, you can pick one from the drop-down list. 5
In the Folder Name field, type your required folder name.
6
In the File Name Text field, type the required text component of the file name. The full file name is made up of the text component specified here and a data component. For more information on the second component, see Changing the Output File Naming Convention on page 44. page 44.
7
Click OK.
ArrayWizard User Reference Guide 7.0 Creating Arrays Using ARRAYWIZARD
Page 43
Generating Statistics Reports To choose to generate array statistics for a parameter set: 1
In the left hand pane of the main window, select the appropriate array type.
2
In the right hand pane, right-click a parameter set and from the menu that appears, click the Set Schedule/Outputs Schedule/Outputs option.
3
In the dialog box that appears, select the Outputs tab.
4
In the Save these outputs pane, ensure that either the DAT or the 3GA checkbox (as applicable) is selected.
5
In the Array statistics reports pane, select the Generate array stats checkbox:
To determine which details are included in the report you can click the Configure button and indicate your choices in the Statistics dialog box that appears. If you do not have a project open, you will be prompted to open the appropriate project. Since ARRAYWIZARD uses distributed processing, you will need to add a valid network path in the Raster file(.tri) field of the Statistics dialog box. For further information on the parameters in the Statistics dialog box, see the Generating Reports and Statistics chapter of the ASSET User Reference Guide. 6
Select the statistics file output type that you require from XLS, text or CSL.
7
Click OK.
You can control the interval between b etween the completion of the processing of a parameter set and the commencement of a post processing task such as statistics generation. To do this, edit the Analyse every parameter in the Workload Analysis pane of the Advanced Admin Settings dialog box as described in Configuring Advanced Administrator Settings on page 55. Do not use Excel on an agent while statistics generation is in progress.
Changing the Output File Naming Convention The file names for your array output files are made up of a data related element and a text element. You can choose the order in which these elements appear. The data element can be created from the region and resolution, an incrementing number, or an incrementing number and the resolution. To specify a naming convention:
Page 44
1
In the left hand pane of the main window, select the appropriate array type.
2
In the right hand pane, right-click a parameter set and from the menu that appears, click the Set Schedule/Outputs Schedule/Outputs option.
3
In the dialog box that appears, select the Outputs tab.
ArrayWizard User Reference Guide 7.0 Creating Arrays Using ARRAYWIZARD
4
In the Naming convention for file name data pane, select the type of data element and the order of text and data that you require:
5
Click OK.
Running an Executable You may want to use a post processing application application to handle your output files. To open such an application automatically once your output files have been produced: 1
In the left hand pane of the main window, select the appropriate array type.
2
In the right hand pane, right-click a parameter set and from the menu that appears, click the Set Schedule/Outputs Schedule/Outputs option.
3
In the dialog box that appears, select the Outputs tab.
4
Select the 'Run an executable when the parameter set has completed' checkbox.
5
Click the Browse button and locate the required executable.
6
If applicable, select the 'Only run if no errors were encountered' checkbox.
7
Click OK.
Deleting Old Files Before Creating Arrays To ensure that your coverage folder is purged of old files before your arrays are created: 1
In the left hand pane of the main window, select the appropriate array type.
2
In the right hand pane, right-click a parameter set and from the menu that appears, click the Set Schedule/Outputs Schedule/Outputs option.
3
In the dialog box that appears, select the Outputs tab.
4
Select the 'Delete all files in coverage folder before creating arrays' checkbox.
5
Click OK. Old files in your coverage folder will be purged when the parameter set is processed.
About Tasks When you run a parameter set, ARRAYWIZARD processes it by assigning work units known as tasks to agents. A number of tasks are normally combined into a single "rolled up" task to be sent to an agent. On receiving a rolled up task the agent unrolls it and processes its component tasks. A task that is currently being processed is referred to as a running task. ArrayWizard User Reference Guide 7.0 Creating Arrays Using ARRAYWIZARD
Page 45
Viewing and Deleting Selected Tasks Once you have started a parameter set running you can monitor the progress of the tasks associated with it. To view the tasks associated with a parameter set: 1
In the left hand pane of the main window, select the appropriate array type.
2
In the right hand pane, right-click a parameter set and from the menu that appears, click Show Tasks.
3
From the menu that appears, select the tasks you want to view. You can choose:
All tasks
Outstanding tasks
Tasks with a reported error
Tasks that have been completed successfully
Your selected tasks are displayed in the right hand pane and your choice of filter is shown by the drop-down fields in the toolbar.
To view the history of a task: In the right hand pane, double-click a task. - or Right-click a task and from the menu that appears, click the Show History option. The Task History dialog box appears:
Page 46
ArrayWizard User Reference Guide 7.0 Creating Arrays Using ARRAYWIZARD
To delete a task: 1
In the right hand pane, right-click a task.
2
From the menu that appears, click Delete. The task is removed from the list.
Viewing and Deleting Running Tasks To monitor the progress of tasks that are currently being processed you can view running tasks. To view running tasks: t asks: In the left hand pane of the main window, select Running Tasks:
All currently running tasks are displayed in the right hand pane. To view running tasks for a specific project: 1
In the left hand pane of the main window, right-click Running Tasks.
2
From the menu that appears, select Show Tasks For Project:
3
In the Select Project dialog box that appears, select the project you require and click OK. The running tasks for the selected project are displayed in the right hand pane.
To delete running tasks: 1
In the left hand pane of the main window, right-click Running Tasks.
2
From the menu that appears, select Delete Succeeded Tasks, Delete Error Tasks, or Delete All Tasks as required.
3
In the Confirm Delete box that appears, click OK. The list of tasks displayed in the right hand pane is updated accordingly.
ArrayWizard User Reference Guide 7.0 Creating Arrays Using ARRAYWIZARD
Page 47
Deleting Tasks Tasks for a Parameter Set You can delete the tasks associated with a parameter set according to their type - for example, you can delete Warning tasks, Error tasks or all tasks. To do this:
Page 48
1
In the left hand pane of the main window, select the appropriate array type.
2
In the right hand pane, right-click a parameter set and from the menu that appears, click the required option, depending on the tasks you want to delete:
ArrayWizard User Reference Guide 7.0 Creating Arrays Using ARRAYWIZARD
CHAPTER 5
Configuring Settings In ARRAYWIZARD The Project Settings menu enables you to set a number of network parameters affecting your predictions and arrays.
Configuring 2g Display Settings By configuring 2g display settings you can determine how acceptable and unacceptable network performance areas are displayed on your 2g arrays. You must have a project open on page 30 page 30 to be able to configure 2g display settings. To configure 2g display settings: 1
From the Project Settings menu, click 2g Display Settings.
2
From the menu that appears, select the array type you require.
3
On the Categories tab:
4
For Best and Nth Best arrays, select the t he coverage schema that you want to use for the array. (For information on adding or editing coverage schemas, see the ASSET User Reference Guide). The remaining steps do not apply to these types of array. For Average Connection, Worst Interferer, Total Interference and Worst Connection arrays, select the Interference Units to be used. For Total Received Power arrays go straight to the next step.
In the Category pane you can add, modify or delete coverage bands:
ArrayWizard User Reference Guide 7.0 Configuring Settings In ARRAYWIZARD
Page 49
To add a coverage band click clic k Add. In the Coverage Properties dialog box that appears, select a colour:
Choose distinctive colours to represent desirable or undesirable coverage in your network. In the Attributes pane, type a name for f or the coverage band in the Label field and the number of decibels that this band represents in the Level(db) field. In the Options pane, choose a colour depth and select the Include Summary in Legend check box if you want to display information such as size, resolution and the date that the array was created in the Map View legend. Click OK.
To modify a coverage band, select an existing band and click Modify. In the Coverage Properties dialog that appears, edit the colour, label, decibel value and options as required then click OK. To delete a coverage band, select an existing band and click Delete.
Configuring 3g Display Settings By configuring 3g display settings you can determine how acceptable and unacceptable network performance areas are displayed on your 3g arrays. You must have a project open on page 30 page 30 to be able to configure 3g display settings. To configure 3g display settings:
Page 50
1
From the Project Settings menu, click 3g Display Settings.
2
From the menu that appears, select CDMA or UMTS as required.
3
In the 3g Display Settings dialog box, select an array type.
4
Click the Configure button.
5
Assign colours, visibility settings and MapInfo Export details as appropriate. For more information on these settings, see the ASSET User Reference Guide.
ArrayWizard User Reference Guide 7.0 Configuring Settings In ARRAYWIZARD
Choose distinctive colours to represent accept able or unacceptable coverage in your network. 6
Click OK.
7
Click Close.
Setting UTM Borders Best server files are generated for tiles even when the tiles overlap a UTM border. When the Best Server data is merged in a tool such as MapInfo, the merged data contains overlapping best server data sets from each UTM zone. Consequently some areas appear to have more than one Best Serving Cell. To prevent this you can specify the westmost and the eastmost longitude bounds of a project. This ensures that each tile generated in a UTM U TM zone that overlaps a UTM border is reduced so that only the portion of the tile within the UTM zone has a best server file calculated. All tiles will then contain best server data only for the UTM zone in which they were calculated. To set UTM Borders: 1
From the Project Settings menu, click UTM Borders.
2
Select the Use UTM border settings checkbox.
3
Enter West Meridian and East Meridian values in degrees to define your UTM border:
4
Click OK.
Configuring Your Your GIS Coordinate Coo rdinate System If you use MapInfo software you can configure your GIS coordinate system from ARRAYWIZARD. To do this: 1
Select GIS Coordinate System from the Project Settings Menu. The GIS Coordinate System dialog box is displayed.
2
Select the projection you require from the list available.
3
Click OK.
Your MapInfo.prj file is updated accordingly. ArrayWizard User Reference Guide 7.0 Configuring Settings In ARRAYWIZARD
Page 51
Configuring Measurement Based Prediction and Interpolation If you have generated measurement-based pathloss files from your own drive test data (or other area and cell-specific data), you can use these files to t o influence your normal pathloss predictions. The amount of influence they have depends d epends primarily on the percentage weightings that you specify in the Measurements dialog box.
Representative illustration of Combining Predicted Data with Measured Data
If you want to influence the normal pathloss predictions: 1
From the Project Settings menu, select Measurements Settings. The Measurements dialog box appears.
2
Select the Use Measurements in Pathloss Predictions checkbox
3
Enter appropriate percentage weightings, as in this example:
The resulting pathloss value for each pixel that contains measurement-based data would be a new combined value v alue derived from the Measured value and the Predicted Predic ted value, according to the weightings you specify. So, for each pixel, the resulting pathloss value is: w% of Measurement value + (100-w (100-w)% of Prediction value
Page 52
ArrayWizard User Reference Guide 7.0 Configuring Settings In ARRAYWIZARD
These weightings (and any changes to them) will be automatically invoked whenever you create a coverage/interference array, or when you run the Simulator, or when you use the Pathloss Prediction Generator. If weightings are selected without interpolation, the weightings will only be used at pixels for which measurement data exists. The pathloss value for any pixels where this is not the case will be calculated using 100% pathloss prediction. If you have selected to use measurements to influence pathloss predictions, you can also choose to use interpolation to influence surrounding pixels that do not contain not contain measurement-based data.
Representative illustration of Combining Predicted Data with Measured Data using Interpolation
To do this: 1
Select the Interpolate checkbox.
2
Enter your preferred Roll-off Factor.
The differen difference ce ( ) between between the Measure Measurement ment value value and Predict Prediction ion value value is used used to influence the surrounding pixels. The Roll-off factor, which must be greater than 1, determines the rate at which which the the value value of of reduces as it moves moves from directly adjacent pixels to more distant pixels. The pixels which already contain measurement data are not affected not affected by this interpolation. The resulting pathloss value for each surrounding pixel is: w% of Measurement value + (100-w (100-w)% of Prediction value where the the interpolated interpolated Measurement value is derived derived from an adjusted from the formula:
, derived
Where: = Number of adjacent pixels pixels that contain measurement measurement data (between 1 and 4) = Difference between the Measurement Measurement value* and Prediction Prediction value * (real or interpolated) = Count of each adjacent adjacent pixel (up to maximum maximum of 4) = Roll-Off Factor specified specified (must be greater than 1) ArrayWizard User Reference Guide 7.0 Configuring Settings In ARRAYWIZARD
Page 53
These weightings (and any changes to them) will be automatically invoked whenever you create a coverage/interference array, or when you run the Simulator, or when you use the Pathloss Prediction Generator. If weightings AND interpolation are selected, the weightings and roll-off factor will be invoked at all pixels within the predicted region, including those that do not contain a pathloss prediction value. However, the pixels which already contain measurement data are not affected not affected by interpolation.
Configuring Carrier Wave Measurements You can include drive test data from measurement-based pathloss (.plc) files when creating your pathloss predictions. To do this: 1
From the Project Settings menu, select Measurement Settings.
2
Select the Use measurements in pathloss predictions checkbox.
3
Type in the required percentage weightings.
You can also choose to use interpolation to influence the prediction for the area surrounding the measured data, and you can specify the extent of this influence. To do this: 1
Select the Interpolate checkbox.
2
Type in the required Rolloff factor.
For more information on using measurement-based pathloss files to influence pathloss predictions, see the ASSET User Reference Guide.
About the ARRAYWIZARD ARRAYWIZARD Settings Settin gs Dialog Box You can use the ARRAYWIZARD Settings dialog box to: Indicate that succeeded tasks will be deleted automatically. Indicate that a forced shut down will always occur when you shut down an agent. If you do not select this option, ARRAYWIZARD gives the server three minutes to close down cleanly, then then prompts for a forced shutdown. Indicate that rolled up tasks are to t o be given a low l ow priority. Indicate that log files are to be truncated at a specified size. Indicate that log files are to be truncated at a specified age. Access database configuration table settings by clicking the Server button. Access registry settings by clicking the Admin button. To access the Settings dialog box: Select Options from the Tools menu.
Page 54
ArrayWizard User Reference Guide 7.0 Configuring Settings In ARRAYWIZARD
Configuring Advanced Administrator Settings To access and if necessary alter the settings shown in the table below: 1
Selecting Options from the Tools menu.
2
Click the Admin button in the Settings dialog box.
This Parameter
Determines
Default
Maximum number of tasks to display
The maximum number of tasks that can be displayed in the ‘Running Tasks’ pane of the Administrator.
10000 tasks
Warn if not all tasks will be displayed
Whether, if there are more tasks than the maximum number to be displayed, a message warning of this appears.
Yes
Automatically Automatically find a transfer transfer folder
Whether Whether a folder for the storage storage of the message message log is allocated automatically.
No
Specify
The folder in which the message log is stored if it is not allocated automatically.
Yes
Block size
The size of data block used when transferring message log from agent to administrator.
1024 kilobytes
Poll every
How often the Administrator polls agents.
300 seconds
Maximum reply period
The amount of time that agents are given to respond to poll for presence.
60 seconds
Analyse every every
How often often workload workload analysis is run (this is used to determine if agents need to be started).
300 seconds
Agent startup startup poll poll interval
The polling polling interval interval when when Administrator Administrator is waiting waiting for an agent to shut down or start up.
2 seconds
Auto start start agents if there is outstanding outstanding work
Whether, Whether, if there are tasks in the Submitted Submitted state state and agents that are shut down or not responding, these agents are to be started.
Yes
Resubmit waiting tasks if there are idle agents
Whether, if there are tasks in the Waiting state and idle agents which are not already waiting for tasks, the Waiting tasks are to be resubmitted.
Yes
Resubmit abandoned tasks
Whether, if tasks are allocated to an agent which is stopped, has an error or does not exist, these tasks are to be resubmitted.
Yes
Max agent wakeup time
The amount of time an agent is given to report its status after it has been started via workload analysis.
20 seconds
Dead agent retry interval
The interval after which an agent will be considered again in workload analysis having been found to be not responding.
14400 seconds
Max agent idle time
The time for which an agent can be idle while there is work to be done, before it is stopped and restarted.
1200 seconds
Max agent not responding time
The time for which an agent can be not responding while there is work to be done, before it is stopped and restarted.
600 seconds
Schedule overlap retry interval
The interval after which an attempt will be made to rerun a parameter set after a scheduled re-run has failed because the parameter set is still running.
900 seconds
ArrayWizard User Reference Guide 7.0 Configuring Settings In ARRAYWIZARD
Page 55
This Parameter
Determines
Default
Run logon scripts when logging on AW user (not recommended)
Whether logon scripts are run when an
user logs on.
No
Configuring Advanced Agent Settings To access the following editable parameters held in the database configuration table:
Page 56
1
Select Options from the Tools menu.
2
Click the Agent button in the Settings dialog box.
This Parameter
Determines
Default
Command polling interval for the agent
The interval after which agents will check the database for commands. Commands are things such as shutdown and poll for presence.
5 seconds
Idle time before shutdown
The amount of time an agent can be idle before it is shut down (for Automatic startup type).
1200 seconds
Maximum task poll interval
The maximum amount of time an agent’s worker thread is allowed to be dormant. This thread is used for checking for more tasks.
60 seconds
Command polling interval for the agent monitor
The polling interval for the agent monitor’s worker thread. 10 seconds This is used for checking for startup, shutdown and message log transfer.
Agent startup/shu startup/shutdown tdown poll poll interval interval
The polling polling interval interval when when the agent agent monitor monitor is waiting waiting for an agent to start or stop.
5 seconds
Maximum time for agent shutdown
The maximum amount of time allowed for an agent to shutdown after the shutdown command is issued.
180 seconds
Maximum login backoff period
The maximum period that the interval between login attempts can be. See I_SM_LOGIN_INIT_SLEEPTIME.
7200 seconds
Maximum time for agent startup
The maximum time allowed for the agent to start before an error is given when the agent monitor starts an agent.
60 seconds
ArrayWizard User Reference Guide 7.0 Configuring Settings In ARRAYWIZARD
Enabling Large Array Support You can enable large array support for all ARRAYWIZARD agents and for all projects. To do this: 1
Click Start/All Programs/AIRCOM International/ENTERPRISE/Misc/Large International/ENTERPRISE/Misc/Large Array Settings.
2
In the dialog box that appears, select the Allow Large Array Support On This Machine checkbox.
3
Click OK.
4
Open ARRAYWIZARD
5
Select Enable Large Array Support from the Tools menu.
Optimising Performance If you create and run a large number of different parameter sets (rather than the same ones repeatedly), the index.txt file in the coverage array folder may become large and slow ARRAYWIZARD down. Consequently you may want to delete the file occasionally when ARRAYWIZARD is not running. To find the location of your coverage array folder: 1
If you have a project open, close it.
2
From the File menu, select Open Project.
3
In the Start Project dialog box, select the required project and click the Info button.
4
Click the User data directories tab and look in the Coverage Array directory field:
ArrayWizard User Reference Guide 7.0 Configuring Settings In ARRAYWIZARD
Page 57
Page 58
ArrayWizard User Reference Guide 7.0 Configuring Settings In ARRAYWIZARD
Index A Agents adding • 24 configuring • 23 selecting • 23 deleting • 26 ARRAY WIZARD about • 9 installing • 9 opening • 17, 30 settings • 49 toolbar • 17
E Executable, running • 45
F Filenames, conventions • 44
P Parameter sets changing • 41 choosing • 31 configuring • 31 coverage interference • 32 creating • 32, 39 prediction • 39 scheduling • 42 starting • 40 static analysis • 36 stopping • 40 viewing • 41 Parameters sets for ARRAYWIZARD • 31, 32, 39, 40, 41, 42 Projects closing • 30
S Statistics reports • 44
ArrayWizard User Reference Guide 7.0 Index
Page 59
Page 60
ArrayWizard User Reference Guide 7.0 Index