Getting Started With RANOPT

Getting Started with RANOPT Installation Guide

Software Version 7.0

Reference Guide 1

© Copyright 2010 AIRCOM International All rights reserved

ADVANTAGE, ASSET, CONNECT, DATASAFE, DIRECT ENTERPRISE, NEPTUNE, ARRAYWIZARD, OPTIMA, OSSEXPERT, and WEBWIZARD are recognised trademarks of AIRCOM International. Other product names are trademarks of their respective companies.

Microsoft Excel , .NET™, Microsoft Office, Outlook , Visual Basic Windows®,

Windows XP™, Windows Vista™ and Word are trademarks of the Microsoft 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 08 October 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: +44 (0) 1932 442000 Support Hotline: +44 (0) 1932 442345 Fax: +44 (0) 1932 442005 Web: www.aircominternational.com

About This Manual

Change History

This table shows the change history (if any) of this guide:

Edition Date Reason

1 08/10/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.

Getting Started With RANOPT 7.0 Page 7 Contents

Contents

Chapter 1 First Time Installation 9

Software Requirements 9

Hardware Requirements 10

Installing the ENTERPRISE and RANOPT Software 11

Creating ENTERPRISE and RANOPT Databases 12

Creating an ENTERPRISE Database 12 Configuring the ENTERPRISE ODBC connection 13 Populating the Support Schema 16 Creating a Link User 17 About the Installation Wizard 17 Creating a Database for RANOPT for UNIX 20

Installing the Vendor Interface Pack 21

Chapter 2 Post Installation Process 25

Upgrading the RANOPT Database 26

Choosing the Database for Loading Data 27

Creating and Modifying Equipment 28

How Data for Equipment is Converted into Files 29 Setting up the Global File Location 29 Creating New Equipment 30

Creating and Modifying Network Operators 33

Creating a Network Operator 33 Modifying and Deleting Network Operators 35

Registering Tablespaces 36

Upgrading Reports 36

Logging into the Database Explorer 37

Choosing the Database Explorer Options 38

Starting ENTERPRISE and RANOPT 38

Chapter 3 Troubleshooting 41

Troubleshooting the Database Explorer 41

Troubleshooting 47

Index 53

Page 8 Getting Started With RANOPT 7.0 Contents

Getting Started With RANOPT 7.0 Page 9 First Time Installation

First Time Installation

If you are installing RANOPT for the first time you will need to follow these steps:

1 Install third-party software

2 Check your hardware requirements

3 Install the ENTERPRISE and RANOPT software

4 Carry out the post-installation processes

Software Requirements

Prior to installing RANOPT, you need to install some third-party software. This software is listed in the table below:

Software Supported Versions Software Modules

Oracle Client 10g Oracle SQL*Net

Oracle Call Interface (OCI)

Oracle Objects For OLE

Oracle ODBC

Microsoft Office 2000

2003

XP

Excel

Notes :

For UNIX installations of RANOPT, the RANOPT database must have following components installed:

Oracle Spatial - this is required because it is possible to bin data based upon distance or time.

Oracle Partitioning - this is required so that partitions for each logfile and group of logfiles (filters) may be created to ensure optimum performance. A gather stats (analyse tables) script should be regularly run to ensure that the tables are correctly indexed. This script is included in the RANOPT installation package, AIRCOM Optimiser.sql

Oracle 9i is not supported for RANOPT version 6.2 onwards.

C H A P T E R 1

Page 10 Getting Started With RANOPT 7.0 First Time Installation

Hardware Requirements

We recommend that you set up your hardware according to the requirements listed in the table below:

Server Requirements

DATABASE Server OS Supported: UNIX, Windows 2000, Windows XP,Windows 2003 Server

Memory Minimum: 1GB

Recommended: 2GB

HDD Disk space required is calculated using the algorithm provided in the 'Database Growth' section lower down in this document.

Processors Minimum: 1 CPU * 1.8 GHz

Recommended: 2 CPUs * 2.0 GHz

LOADER/PARSER Machine

OS Supported: Windows 2000, Windows XP, Windows 2003 Server

Memory Minimum: 1GBMB

Recommended: 2GB

HDD Minimum: 20GB

Recommended: 80GB

The loader keeps a copy of the results file, after loaded into the database. Although this may be removed or archived, it is recommended that the loader machine has capacity for at least a month's worth of result files.

Processors Recommended: 1 CPU * 2.0GHz

CLIENT OS Supported: Windows 2000, Windows XP

Memory Minimum: 512MB

Recommended: 1GB

HDD Minimum: 300MB

Recommended: 500MB

Processors Recommended: 1 CPU * 2.0GHz


Installing the ENTERPRISE and RANOPT Software

To start the installation process:

1 Open the folder named „ENTERPRISE‟ and look for the file setup.exe. Double-click on it.

2 Type in the Name, Company name and the Serial number. Click Next.

3 Select „Custom‟ as type of setup and click Next.

4 Select the components you want to install, as shown in the picture below.

Depending on the licence that you are using, you are presented with the option to install either RANOPT Server, RANOPT Standard or RANOPT Lite.

5 RANOPT Server can be installed as a client or a server:

If this is the 'Client' install in a 'Client/Server' environment, make sure that only the RANOPT Client option is selected.

If this is the 'Server' (in other words, RANOPT Database or RANOPT Loader) install - make sure that only the RANOPT Server option is selected.

If RANOPT is to be configured both as a server and as a client you need to select both options, as shown here. You also need to tick all the options in the „Core Application‟.


Complete the rest of the set-up, by selecting “Next” and then “Finish” in the set-up wizard. When the installation finishes, restart your computer.

6 Install the latest supported RANOPT Patch if available:

The RANOPT patches are available from the support website.

Click on Download to download the correct patch according to the version and build and choose a directory to download the file.

On completion of the download, double-click on the file, located in the folder specified during the download process.

7 When the installation has finished, restart your computer.

Creating ENTERPRISE and RANOPT Databases

To create an ENTERPRISE database and RANOPT database, you need to:

1 Ensure that ENTERPRISE and RANOPT are licensed correctly. For more information, see the ENTERPRISE Installation and Administration Guide.

From version 6.1 onwards, the licensing of ENTERPRISE is now handled by a software licensing system rather than by a hardware dongle or by node locking.

2 Create an ENTERPRISE database.

3 Configure the ENTERPRISE ODBC connection.

4 Populate the support schema.

5 Create a link user.

6 Create a RANOPT database:

In a Windows environment, use the Installation Wizard to create or use an existing database

In a UNIX environment, use the UNIX template to create a RANOPT database

Creating an ENTERPRISE Database

Before creating an ENTERPRISE Database,

Place the template „AIRCOM_Production_Autoextents.dbt‟ in the following folder: drive:\ORACLE_HOME\assistants\dbca\templates where „drive‟ is the drive where Oracle is installed (probably c:\) and ORACLE_HOME is the path where the Oracle Home was created.

To Create an ENTERPRISE Database:

1 Open the Oracle „Database Configuration Assistant‟ and select the „Create a database‟ option. Click Next.

2 In the window that appears, choose the „AIRCOM Production Autoextents‟ template and click Next.


3 Specify a Global System Name for the database and an Oracle System Identifier (SID).

For example, you can use: Global System Name: ent5 SID: ent5

4 Click Next until you get to the final page of the database wizard. Then click Finish.

5 Once the database is created, Oracle prompts to specify a SYS user/password and a SYSTEM user/password: SYS username: sys SYS password: sys SYSTEM username: system SYSTEM password: system

6 Click End.

Configuring the ENTERPRISE ODBC connection

To configure the ENTERPRISE ODBC connection.

1 Open the ENTERPRISE Administrator tool by clicking: „Start -> All Programs -> AIRCOM International -> ENTERPRISE V7.0 -> Misc -> ENTERPRISE Administrator‟

2 Open the „Database Login‟ window (if it does not open automatically, just click on Login, in the „Database‟ menu). In the Login dialog box, do not type the username and password, but click the „Setup‟ button to configure the ODBC source.

3 Click the „System DSN‟ tab.

4 Click Add.


5 Scroll down and click the Oracle ODBC driver („Oracle in OracleHomeName‟) and click Finish.

6 In the Oracle ODBC Driver Configuration dialog box, type the Data Source Name in the Data Source Name field and the TNS Service Name in the TNS Service Name field. You do not need to type neither a Description nor a User Id. Data Source Name: ent7 TNS Service Name: ent7


7 On the „Oracle‟ tab of the „Oracle ODBC Driver Configuration‟ dialog box, set the „Fetch Buffer Size„ to 1.

8 On the „Workarounds‟ tab of the „Oracle ODBC Driver Configuration‟ dialog box, select the „Disable Microsoft Transaction Server‟.


9 Click OK to return to the database login screen and, in the drop down Data Source box, make sure the correct database is available.

Populating the Support Schema

After creating a blank database instance suitable for ENTERPRISE you need to connect to the database and populate the data dictionary entries that define the ENTERPRISE schema. This sets up the required tables, stored procedures and constraints.

To do this:

1 Open the ENTERPRISE Administrator by clicking: „Start - > All Programs -> AIRCOM International -> ENTERPRISE V7.0 -> Misc -> ENTERPRISE Administrator‟

The ENTERPRISE Administrator may be already open from the previous step.

2 In the „Database Login‟ dialog box, type the system username and password that you set when you manually created the ENTERPRISE database: Username: system Password: system

3 You will be prompted for the three tablespace names required by ENTERPRISE:

Select PERM or similar in the Permanent Tablespace field

Select INDX or similar in the Index Tablespace field

Select TEMP or similar in the Temporary Tablespace field

4 Click Next.


5 You are then prompted for an Administrator username and password. This will be the password for the Super User. For example, you can use: Username: Administrator Password: admin

6 In the schema pane, select the default schema password. Click OK.

7 The Administrator now configures the database. This can take a few minutes depending on the speed of your machine.

8 From now on you can use this username and password when logging into the ENTERPRISE database.

Creating a Link User

1 Log out the ENTERPRISE Administrator and log in again, now using the new username and password („Administrator‟ and „admin‟).

2 In the left hand pane, under the ent5 tree-like directory, click the folder „Users‟.

3 The User „Administrator‟ has already been created and it is populated in the right hand pane. Now you must create a new user which will be used to create the link between the RANOPT database and the ENTERPRISE database. To do so, double click on „Add User‟, in the right hand pane.

4 Type the UserId and Password for this new user. For example, use: UserId: link Password: link Profile: ENT_DEFAULT_PROFILE

5 Click Next until you reach the end of the Wizard.

6 Click Finish.

7 Check that the new user „link‟ has been created.

8 Close ENTERPRISE Administrator.

About the Installation Wizard

Use RANOPT Installation Wizard to create a new database or use an existing database, if you already have a previously created RANOPT database then you can login to it and you will be prompted to upgrade to the latest version. Make sure you select to upgrade both the database and the Network messages. The Installation Wizard will also dynamically create the public synonyms for all the tables, procedures, functions, triggers and sequences. It will create the necessary roles in the system and grant the required privileges for each role and if desired by the user it will also create the database link to the Planning/Cell Site database.

To create or upgrade an existing database:

1 Open RANOPT Administrator:

From the Start button, point to Programs, AIRCOM International, ENTERPRISE V7.0, Misc, then click RANOPT Administrator.

2 Select New Database and click OK.


The Installation wizard will start up.

It is possible to create a new database once you have already logged into an existing database in the RANOPT Administrator. To create a new database, on the RANOPT Administrator toolbar, from the Tools Menu, select Install Database.

3 Use the following table to help you with the installation:

On this page You should

Welcome Click Next.

This page contains information describing what the installation wizard can do.

Database Create a new database or use an existing database instance.

To use an existing database instance:

Type in a database name, for example, 'RANOPT'.

Type the ORACLE SYS password, for example, 'sys'.

Only the ORACLE SYS user will be allowed to perform this operation so the user will need to supply only the existing database name and the ORACLE SYS password.

Click the Next button and the SYS password will automatically be verified. If the password is valid, the SYS user will be logged in and the next screen will be displayed.

To create a new database:

Type in a database name, for example, 'RANOPT'.

Type in a default tablespace name, for example, 'RANOPTD'.

Type in an index tablespace name, for example, 'RANOPTI'.

Type in a temporary tablespace name, for example, 'RANOPTT'.

Select the memory for the database, 512MB or 1GB.

Click the Next button and the next screen will be displayed.

If you have purchased RANOPT Lite, it is recommended that you use an existing ASSET database instance.

Administrator User Details

Type in a user name for the administrator user,

Type in a password, for example, 'ranopt'.

Type in the password again, for example, 'ranopt'.

The Administrator User is also the schema owner. If a new Administrator User is created, the old Administrator User in the database will remain in the database but will be ignored. If an Administrator User already exists with the same name, the user will be prompted to overwrite the existing Administrator User.

The Default and Temporary tablespace lists will list the already available tablespaces in the database.

Click the Next button.

If the "Ignore Errors" option is selected, non-critical errors that occur during the installation process will not cause a message box to pop up requiring user interaction. These errors will still be logged in the message log.


On this page You should

Planning/Site Database Link

Select Create Link to Planning/Site Database.

Type in a Link Name, for example, 'RT_DB_LINK'.

Type in the User name of the previously created user, for example, 'link'.

Type in the Password, for example, 'link'.

Select the ENTERPRISE Database from the list, for example, 'ent5'.

Click Finish for the database creation to start.

The current database must be on the local machine to be able to create a database link to another database (the Planning/Site database).

If the current database is not on the local machine, the page will be disabled and the user will not be able to create the database link to the Planning/Site database.

If a database link cannot be created, please refer to the document, S-PS-003-WP-01 Setting up an ORACLE Database Link - Issue5.5.doc or contact AIRCOM Product Support Group.

Progress Click Stop to stop the Installation Progress.

This page indicates the progress and logs every operation being performed and any errors that occur during the installation process.

If prompted with an error similar to: “The specified operator doesn’t exist” then click ignore.

Database Configuration Assistant

Enter the sys and system username and password in the corresponding fields as you did previously for the ENTERPRISE database.

Click close to finish the database creation

Please Supply sys password

Enter the sys password configured in the previous step and click OK.

Installation wizard (Installation Progress)

This page indicates the progress and logs every operation needed to populate and upgrade the database with the latest settings required.

Click close to finish the Database Installation and Upgrade.

The Next and Back buttons enable you to navigate through the wizard.


Creating a Database for RANOPT for UNIX

1 On the UNIX machine, copy the template file, ranopt.dbt (which is included in the RANOPT installation package) and start the dbca using the template.

2 Create the RANOPT database using the dbca and the template.

The RANOPT database must use WE8MSWIN1252 character set, unfortunately files will not load correctly if this is not used.

3 Update the tns names for the client hosting the RANOPT administrator and loader.

4 Upgrade the database (install schema, triggers, procedures, functions, sources and so on) using the RANOPT Administrator hosted by the client.

Choose not to create a DB link.

5 Upgrade the RANOPT database again using the upgrade utility in the RANOPT Administrator.

6 If the database is set up on an external database server, from the one that is running the RANOPT Administrator application you must also run a script to create a link between the RANOPT and ASSET databases. Create the link using the script, enterprise.sql which is included in the RANOPT installation package.

This enterprise.sql file does require some editing to use the correct database id‟s as shown in the tnsnames of the database server.


Installing the Vendor Interface Pack

In previous versions of RANOPT, you had the option to install the Interface Pack during the server installation. From version 6.1onwards, the Interface Pack has been separated from the main installation, and must be installed separately. It is no longer necessary to install the RANOPT server.

To install the Interface Pack:

1 Download the latest Interface Pack from the support website at www.aircomassist.com.

2 Double-click the executable file to open the Installation wizard.

3 Click Next.


4 Review the licence agreement and click I Agree.

5 Choose the path for the folder in which the Interface Pack will be installed.

It is recommended that you use the default path specified by the Installation Wzard.


After installation is complete, the Interface configuration dialog box opens, shown in this picture:

6 In the Database Connection Details pane, type your username and password.

7 Select a database, which should match the data source name that was created when the ODBC connection for the database was configured. This defines the location where the data loader files will be saved.

8 To verify the database connection, click Test.

9 To save the details, click Save Connection Details.

If the message indicates that your connection is valid, then you are ready to receive and load files correctly.This table describes how to start, stop, pause and restart the Parser/Loader Service:

Click To Status

Start the Parser/Loader Service

Stop the Parser/Loader Service

Pause the Parser/Loader Service

Restart the Parser/Loader Service

You can now configure a message log.


10 Register the Interface Pack by following the steps displayed below the Save Connection Details button, shown in this picture:

The Interface Configuration dialog box appears automatically when you are installing the Interface Pack for the first time. However, if you wish to change any of the settings, click the Start button, point to Programs, AIRCOM International, ENTERPRISE VX.x, RANOPT Interface Pack, and click on Interface Configuration.

11 Complete the RANOPT Vendor Interface Request Template, specifying which of the interfaces you require.

12 Mail the completed template to [email protected], and the registration activation key, together with further instructions, will be sent to you.

If the Service and Maintenance Expiry Date is not filled in on the Vendor Interface Request Template, you will only be issued with a 3 month temporary key with which to log files. After 3 months, the interfaces stop working.

When installing the RANOPT Interface Pack for the first time, it should be done in the following order:

1 Install the latest ENTERPRISE patch. This de-registers and removes the old loader files as well as the old Parser service.

2 Open RANOPT Administrator and upgrade the database. This sets the database to work with the new Interfaces.

3 Install the latest RANOPT Interface Pack.

After you have done this, patches and new Interface updates can be installed in any order. It is VERY important that the first Interface Pack installation is done in this order, to resolve the initial split of the Interfaces from ENTERPRISE. If this is not done in the order specified above, errors may occur. See Troubleshooting the RANOPT Installation on page 47 for information on how to resolve these errors.

Getting Started With RANOPT 7.0 Page 25 Post Installation Process

Post Installation Process

After you have created the ENTERPRISE and RANOPT database, you can:

1 Upgrade the RANOPT database.

You do not need to upgrade the database if it has just been created and no further patches have been applied. This operation should be done every time a new patch is applied.

2 Configure the parser/loader for loading data.

3 Configure the equipment that is used.

4 Configure the network operators.

5 Register the available tablespaces.

6 Upgrade the reports.

This operation must be done every time a new RANOPT patch is installed.

7 Log into the Database Explorer.

C H A P T E R 2

Page 26 Getting Started With RANOPT 7.0 Post Installation Process

Upgrading the RANOPT Database

You can use the RANOPT Administrator to upgrade the RANOPT database. This is necessary when a new version of the RANOPT software or a patch has been installed, and there have been tables, fields, procedures added, deleted, updated and so on. By upgrading the RANOPT database, it becomes compatible with the RANOPT software, and can be used as normal again.

Do not make any changes unless you are experienced at upgrading the database.

To upgrade the RANOPT database:

1 On the RANOPT Administrator toolbar, click the Upgrade Database button .

- or -

From the Tools Menu, select Upgrade Database.

The Upgrade Database dialog box appears. The current version of the database appears in this window as well as the schema name. This picture shows an example:

2 Select the checkbox next to the Database to upgrade the database.

3 Select the checkbox next to the Network Messages to upgrade the network messages

4 If you want the upgrade to continue even if non-fatal errors are found during the process, select the Continue On Non-fatal Errors option.

5 Click OK to upgrade.

If the upgrade RANOPT script file is found, the latest database dump that has been imported will be updated to the latest version.


If the script file cannot be found automatically, you will be prompted to find the script file.

The progress of the upgrading is displayed.

If any errors occur during the upgrade, they are logged in the progress window. To view an error in a separate window, double-click the error message.

Choosing the Database for Loading Data

To choose the database that you will be using for loading data, and test the validity of your connection:

1 On the RANOPT Administrator toolbar, click the Configure Parser/Loader button

.

- or -

From the Configure Menu, click Parser/Loader.

This picture shows an example of the User Details pane, and the other Parser/Loader settings:

2 In the User Details pane, type your username and password.

3 Select a database, which should be the data source name that was created when the ODBC connection for the database was configured. This defines the location for your data loader files.


4 To verify the database connection, click Test.

5 To save the details, click Commit.

If the message indicates that your connection is valid, then you are ready to receive and load files correctly.

6 This table describes how to start, stop, pause and restart the Parser/Loader Service:

Click To Status

Start the Parser/Loader Service

Stop the Parser/Loader Service

Pause the Parser/Loader Service

Restart the Parser/Loader Service

7 You can now configure a message log.

Creating and Modifying Equipment

The RANOPT Administrator contains a powerful decode engine, that enables you to load a variety of different formats into the database.

As part of the setup for this loading process, you must create instances of vendor equipment, which are essentially smaller custom decode engines, and are used to import vendor-specific measurement files into the database.

Equipments are used to control the extraction of information from data files. They ensure that data files have a valid file extension, contain valid information, have a valid format and are collected from a valid source.

If you are not experienced at creating and modifying equipments, it is recommended that you do not make any changes. Incorrect editing could cause errors during the loading of data files.

Before creating the equipment, it is important to set the global location.


How Data for Equipment is Converted into Files

An equipment or device is defined as a physical phone. When RANOPT loads the data that is captured using a drive test tool, it is split into files in the database according to the equipment used in the drive test.

For example: If two phones are connected to a drive test tool, Tems, the results of the files will be stored in one file. The results for phone 1 and phone 2 will be stored in the same file. During the loading of these files into RANOPT, the results for phone 1 and phone 2 will be split into two separate files.

For Nemo equipment, the data for each equipment/device is automatically split into separate files. However, the data for more than one network may still be contained in that file.

Setting up the Global File Location

When you create equipment, you must specify the global file location, which consists of a home directory (and possibly a shared directory) for all equipment.

The directories that you specify are used to create the folder structure that is required to load files. For more information, see Setting Up RANOPT for Manually Loading Measurement Data in Chapter 4 of the RANOPT User Reference Guide.

This picture shows an example:

Home and Shared directories

To set up the file locations:

1 On the RANOPT Administrator toolbar, click the Equipment button .

- or -

From the Configure Menu, select Equipment.

2 In the Home Directory box, type a path where you want to store all loaded files.

- or -

Use the Search button to browse to a suitable location then click OK.

3 If you need to share files with other users across a network, in the Shared Directory box, type in a path where you want to store all loaded files.

– or –

Use the Search button to browse to a suitable location then click OK.


For shared directories, you should use mapped drive names (for example, X:\ or I:\) rather than UNC paths (for example, \\machine\imports).

Creating New Equipment

The equipment that you define in the RANOPT Administrator is the equipment used during the drive test. It contains the required settings to:

Recognise the drive test file

Indicate how the RANOPT loaders should interpret the results file when loading it into the database

To create an equipment:

1 On the RANOPT Administrator toolbar, click the Equipment button .

- or -

From the Configure Menu, select Equipment.

2 Click the Create a New Equipment button .

3 In the Name box, type a name for your equipment.

4 From the Loader/Interface drop-down list, select the appropriate Loader/Interface for the file type.

For a list of the file types and their appropriate loaders/interfaces, see Compatible Loader/Interfaces for RANOPT.

5 In the File Extension box, type the appropriate file extension.

The file extension should be consistent with any template strings you wish to use. For information about template strings, see Creating and Modifying Template Strings in the RANOPT User Reference Guide.

6 If the loader/interface type supports template strings, you can create a template string, which will be used to extract information from a data file.

7 Click Commit.


The new equipment is now available in the left-hand pane of the Equipment dialog box. This picture shows an example:

The list of equipments can also be viewed in Windows Explorer in the location you specified in the Home Directory text box. This picture shows an example:

Each equipment displays all of the networks (created in the New Networks dialog box) beneath it. Additionally, under each network type, RANOPT creates three subfolders (Err, In and Out), which are used as follows:

When a file is chosen for loading, it will be moved to the In folder

If the file is loaded successfully, it is moved to the Out folder

If there are problems loading the file, it is moved to the Err folder

For more information on Equipment see the RANOPT User Reference Guide.


Appropriate File Extensions

When you are specifying file extensions for equipment and network operators, you can use wildcard characters. They are described in this table:

Wildcard Character Description Example

* String of characters d* = ds1, ds2, ds3 and all strings starting with "d".

? Single character ds? = ds1,ds2 and all strings starting with "ds" and ending in any ONE character.

Previously two separate equipments had to be created for files that had different extensions. This is no longer necessary with the introduction of the wildcard character. For example, ds? will include files ds1, ds2 and ds3.

Modifying and Deleting Equipment

If you have appropriate administrator permissions, you can modify and delete existing equipment.

To modify an equipment:

1 From the Available Equipment pane, select an equipment and click the Modify

Equipment button .

2 Make the required changes and click Commit.

To delete an equipment:

1 From the Available Equipment pane, select an equipment.

2 Click the Delete an Equipment button .

3 In the dialog box that appears:

To delete the equipment type only (and not the associated directories and files), select 'Don't delete the import directories'.

- or -

To delete the equipment type, directories and files associated with the equipment, select 'Delete all directories associated with the import source (including files)'.

- or -

To delete the equipment type and directories associated with the equipment, but not the files associated with the equipment, select 'Delete all directories associated with the import source (excluding files)' .

You must specify a directory where you can move the associated files to.


Creating and Modifying Network Operators

By defining networks, you can:

Perform benchmarking activities for several networks

Filter files based on their network

Network operators provide network details for imported data, and consist of:

Network name

Network code

Technology type

If you are not experienced at creating and modifying network operators, it is recommended that you do not make any changes. Incorrect editing could cause errors during the loading of data files.

Creating a Network Operator

To create a network operator:

1 On the RANOPT Administrator toolbar, click the Configure Network Operators

button .

- or -

From the Configure Menu, select Network Operators.

2 Click the Create a new Network button .

3 If you want to use automatic network detection, select the Enable Automatic Detection option:

When Enable Automatic Network Detection is not selected, RANOPT will not split the files per network. The whole file will be loaded and will be associated with the network chosen when submitted.

4 In the Network Name and Network Code boxes, type a name and a code for your network. The network code uniquely identifies the available network.

5 In the list of technology types, select the appropriate technology (or technologies) for your network.


6 If you have enabled automatic network detection, add the appropriate frequencies for the technologies by clicking the Add button.

7 If you are configuring a network operator for use with Nemo files, select the Use File Extension checkbox, then type in an appropriate file extension for the Network.

If you are using Nemo files, you can specify a different file extension for each network. When you load the files, the file extension is checked and the file will be automatically loaded into the network assigned for that extension. For example, for Network A, you might always record the files with extension, .dt1 and for Network B with extension .dt2. If you set the file extensions up for each network, then RANOPT will automatically load dt1 files as Network A files and dt2 files as Network B files whichever network directory you put them into.

8 Click Commit.

This network operator will be available when creating filters in RANOPT. This picture shows an example of an available network:


How Data for Networks is Converted into Files

Scanner equipment can scan the entire frequency range (for GSM) or several carriers (for W-CDMA), but it does not have the intelligence to determine the specific networks that are being scanned.

Scanner data is loaded into RANOPT and if Automatic Network Selection is enabled, the data will be divided into as many files as there are networks contained in the original scanner data.

For example: Country X has two GSM networks, NetworkA and NetworkB, utilising the 900Mhz band. This band is divided up into channels running from 1 to 124. The channels are allocated between the two networks as follows: NetworkA - Channels 1 to 60, with channel 61 as a guard channel to separate the networks NetworkB - Channels 62 to 123, with channel 124 as a guard channel to separate the networks The scanner will scan the entire range from 1 to 124 and take measurements, and store the values into a file, <file_name>.ds1.

If two scanners are used, one scanner will save its results in <file_name>.ds1 and the other will save the data into <file_name>.ds2. The file name for each file containing the scanner data will be identical but the file extension will be different. If you have created three network operators in RANOPT Administrator corresponding to Network A, Network B and the guard channels, and selected automatic network detection, RANOPT will process the measurement data in <file_name>.ds1 as follows:

1. The measurement data from channels 1 to 60 will be split into a separate file with the network name appended to it (in this example, NetworkA <file_name>.ds1).

2. The measurement data from channels 62 to 123 will be split into a separate file with the network name appended to it (in this example, NetworkB <file_name>.ds1).

3. The measurement data from channels 61 and 124 will be split into a separate file for the guard bands.

Modifying and Deleting Network Operators

If you have the appropriate administrator permissions, you can modify and delete existing network operators.

To edit a network operator:

1 From the Network Operators pane, select the required network and click the

Modify Network button .

2 Make the required changes, and click Commit.

To delete a network operator:

1 From the Available Networks pane, select the network operator that you want to remove.

2 Click the Delete Network button .


Registering Tablespaces

To register tablespaces in RANOPT:

1 On the RANOPT Administrator toolbar, click the Register Tablespaces button .

- or -

From the Configure Menu, select Registered Tablespaces.

2 Use the table shown here and:

Click To

Add a tablespace

Delete a tablespace

Move the tablespace up

Move the tablespace down

Upgrading Reports

You can use the RANOPT Administrator to upgrade the reports in the Report Registry:

1 On the RANOPT Administrator toolbar, click the Upgrade Reports button .

- or -

From the Tools Menu, select Upgrade Reports.

2 In the dialog box that appears, click the Browse button to locate the directory into which the upgraded reports will be placed, and then click Close.

3 In the left-hand pane, select the checkboxes for all of the reports that you want to upgrade.

4 Click OK to upgrade the selected reports.

Click each tab to move between each type of report.

To view the Legend which describes the colour coding of the reports, from the View Menu, select Legend.


This picture shows an example of the Upgrade Reports dialog box:

There are three tabs on the Upgrade Reports dialog box:

This tab Contains

Parameters A list of the parameters that are available for view/analysis.

Reports The library of MS Excel reports provided by AIRCOM International.

Modules The pre-configured analysis modules useful for analysis that are provided as a default.

Logging into the Database Explorer

To start using the RANOPT Database Explorer:

1 From the Start menu, point to Programs, AIRCOM International, ENTERPRISE 7.0, Misc and click RANOPT Database Explorer.

2 In the dialog box that appears, enter a username and password then select a database from those shown in the list.

3 Click OK.

4 Now you can choose your options.


Choosing the Database Explorer Options

To change the RANOPT Database Explorer settings:

1 Click the Change Settings button .

- or -

In the Database Explorer, from the Edit Menu, click Settings.

2 In the RANOPT Database Explorer Settings dialog box, select the appropriate checkbox if you want to check the database for new files and enter a value in seconds for the time frame you require.

3 Type in the name or IP address of the RANOPT Server (database).

4 Click OK to save the settings or Cancel to cancel the changes.

Starting ENTERPRISE and RANOPT

To open ENTERPRISE:

1 From the Start button, point to Programs, AIRCOM, ENTERPRISE 7.0, then click ENTERPRISE.

2 Log in to ENTERPRISE, type in the administrator user name and password: User Id: Administrator Password: admin

3 Create an ENTERPRISE project. For more information on how to do this, please see the ENTERPRISE Installation and Administration Guide.

4 Configure the RANOPT ODBC connection.

5 After logging into ENTERPRISE database (ent5) and after creating a project, select the newly created project and click Start.

6 Once the project data has been loaded, select the „RANOPT‟ tab and click on the

„RANOPT Login‟ button .


7 In the Database login dialog box, click the „Setup‟ button to configure the ODBC source.

8 Click the „System DSN‟ tab.

9 Click Add.


10 Scroll down and click the Oracle ODBC driver (Oracle in Orahome92) and click Finish.

11 In the Oracle ODBC Driver Configuration dialog box, type the Data Source Name in the Data Source Name field and the TNS Service Name in the TNS Service Name field. You do not need to type a Description or a User Id. Data Source Name: RANOPT TNS Service Name: RANOPT

12 Click OK to return to the database login screen and, in the Data Source list, make sure the correct database („RANOPT‟) is available.

13 Login to RANOPT by entering the Login Details.

Getting Started With RANOPT 7.0 Page 41 Troubleshooting

Troubleshooting

This chapter offers some troubleshooting suggestions.

Troubleshooting the Database Explorer

If you are using RANOPT with Windows 2003 Service Pack 1 or older, you should follow these steps to ensure that the status monitor in the Database Explorer can be viewed easily. There are two stages:

Turn off the firewall (this section can be ignored if you do not have a firewall)

Configuring the DCOM security settings

You should configure the the machine that is running the file parser service (in other words, the file loader machine).

Turning off the Firewall

To turn off the Windows Firewall:

1 Ensure that you are logged on as a user with administrative rights.

2 Click Start and select Control Panel.

3 You will have one of two control panels. Click the Security Center icon.

4 Click the Windows Firewall icon beneath the status updates.

5 Click the 'Off (not recommended)' option, and then click OK

6 After turning off the Windows Firewall, you will get the following warning message: "Your computer may be at risk; No firewall is turned on".

After turning off the Windows Firewall, you will get the following message: "Your computer may be at risk; No firewall is turned on". This error will continue to appear in the system tray until you tell Windows that you realise the Firewall is turned off. To do this:

1 Click the balloon, or the red shield in the system tray, and from the menu that appears, click Recommendations.

2 Select the "I have a firewall solution that I'll monitor myself" checkbox. This will stop Windows from alerting that there is a risk.

C H A P T E R 3

Page 42 Getting Started With RANOPT 7.0 Troubleshooting

3 Click OK.

A warning that Windows will not monitor your firewall settings appears. You can close this dialog box.

Configuring the DCOM Security Settings

To configure the DCOM Security Settings:

1 Ensure you are logged on as a user with administrative rights.

2 From the Start menu, click 'Run'.

3 In the dialog box that appears, type 'dcomcnfg', and then click OK.

4 In the Component Services dialog box that appears, expand the Component Services node, then expand the Computers and 'DCOM Config' sub-nodes.

The 'status monitor' node should now be accessible. This picture shows an example:


5 Right-click this node, and from the menu that appears, click Properties. The StatusMonitor Properties dialog box appears. This picture shows an example:

6 Click the Security tab, and in the Launch and Activation Permissions pane, select the Customize radio button.


7 Click the Edit button. The Launch Permission dialog box appears:

You can configure the launch permissions in different ways, depending on your setup:

If the ENTERPRISE installation is published via Citrix, then you can specify the network user group

If users are logging on directly to the database via the network, then you can specify a network user group or individual users

If a variety of users have access to the database and you do not know which users will logon to the machine, you should add 'ANONYMOUS LOGON' to the list of permitted users

If the users will remotely access the service, then you should select the Remote Launch and Remote Activation permissions

8 Click OK, and then OK again, to save all changes.

9 In the Component Services dialog box, expand the Component Services node, then expand the Computers sub-node.


10 Right-click 'My Computer', and from the menu that appears, click Properties. The MyComputer Properties dialog box appears. This picture shows an example:

11 Click the COM Security tab, and in the Access Permissions pane, click the Edit Limits button.


12 In the dialog box that appears, set the same permissions as you did in Step 5:

13 Click OK.

14 In the Launch and Activation Permissions pane, click the Edit Limits button.

15 In the dialog box that appears, set the same permissions as you did in Step 5, and then click OK.

16 Repeat steps 11-15 for any Citrix machines or client machines that are running Windows 2003 Service Pack 1.


Troubleshooting

If you install RANOPT and experience a problem, this table describes the problem and the possible solutions:

Category Problem Cause Solutions

Calls The calls are not being correctly analysed or not shown properly.

Ensure that voice summary report is run before showing call data in graphs, grids or map.

- or -

There are missing messages from the loader.

- or -

Poorly / incorrectly defined call classifications.

- or -

Many calls showing as unknown – again check call classifications.

Refer back to the report description or help document for more information.

Connection There is a problem with your connection, after resuming from 'standby' mode on a laptop.

This typically occurs because the database address is the host name of the PC.

The solution is to point everything to LOCALHOST by modifying

TNSNAMES.ORA and LISTENER.ORA which are located usually here C:\oracle\ora92\network\admin .

Make backup copies of the files, TNSNAMES.ORA and LISTENER.ORA.before following the steps below.

Firstly edit the LISTENER.ORA file.

Change the LISTENER section from:

LISTENER =

(DESCRIPTION_LIST =

(DESCRIPTION = (ADDRESS = (PROTOCOL = TCP)(HOST = RHCS300DT)(PORT = 1521))

)

(DESCRIPTION =

(ADDRESS_LIST =

(ADDRESS = (PROTOCOL = TCP)(HOST = localhost)(PORT = 1521)))))

To:

LISTENER =

(DESCRIPTION_LIST =

(DESCRIPTION =

(ADDRESS_LIST =

(ADDRESS = (PROTOCOL = TCP)(HOST = LOCALHOST)(PORT = 1521)))))

Then edit the TNSNAMES.ORA.

Change the HOST for each database to point to LOCALHOST.



For example, change from:

RANGSM =

(DESCRIPTION =

(ADDRESS_LIST =

(ADDRESS = (PROTOCOL = TCP)(HOST = RHCS300DT)(PORT = 1521)))

(CONNECT_DATA =

(SERVER = DEDICATED)

(SERVICE_NAME = RANGSM)))

To:

RANGSM =

(DESCRIPTION =

(ADDRESS_LIST =

(ADDRESS = (PROTOCOL = TCP)(HOST = LOCALHOST)(PORT = 1521)))

(CONNECT_DATA =

(SERVER = DEDICATED)

(SERVICE_NAME = RANGSM)))

Save both files and reboot the machine.

Now you can use RANOPT and ASSET without worrying about resuming from standby or disconnecting from the LAN.



Display You cannot view appropriate buttons on the toolbar or toolbar menus.

Check that all required modules have been logged in where appropriate (for example ASSET, RANOPT or ADVANTAGE)

- or -

Check that the correct tab is highlighted. Some generic options or buttons appear on all tabs, some are specific to each module. Check all relevant tabs.

- or -

Make sure that the module is still logged in and all other buttons (depending upon licence) are highlighted.

- or -

Ensure that there is still a connection to Oracle. Under certain circumstances the connection to the database may be lost. This can occur if the network connection has been unplugged (even if the database is hosted local to the machine).

Display RANOPT windows and dialog boxes are not fully displayed - for example, buttons are only partially visible.

The display properties of your PC are not set correctly for RANOPT.

Firstly, adjust the DPI to Normal size (96DPI). To do this:

From the Control Panel, open the Display Properties dialog box

On the Settings tab, click the Advanced Button

Click the General tab, and in the Display pane, select Normal size (96DPI)

Restart your PC

Then, change the screen font size to 'Normal': To do this

From the Control Panel, open the Display Properties dialog box

On the Appearance tab, in the Font size pane, select Normal

Click OK

Filter Manager Failure to see any log files in the RANOPT filter manager.

Date range not set to include all log files.

By default, a date range is set in the RANOPT filter manager for each user logging onto each machine. Once this has been changed the settings are then saved in the registry for each user or machine. Ensure that the date range is set to cover any loaded files. The date range is specified using the advanced section of the RANOPT filter manager.

- or -

If the filter has been modified or created based upon a previously created filter then any filters applied to the selection will be saved. Therefore any file comments, technology types, vendor types or date ranges will be kept and therefore the file that is required may not be present within the selected range of filtering.

Filter Manager You cannot open the filter manager or other replay associated windows.

On server-client installations (for example Citrix) it is likely that various monitors will be used with a variety of resolutions and display settings. The RANOPT workspace can be saved by the user to match so that windows are shown as originally selected. It is possible therefore that some windows may appear to open on a region that is outside the



currently visible screen area. Either change the resolution or configuration of the screen to match what was previously selected, or return to a default, or an alternative workspace.

Interface Pack Error when Installing new patches or Interface Pack.

First installation was not done in the specified order.

Stop any Parser services which are running

Manually remove the Parser service

Run "C:\Program Files\AIRCOM International\RANOPT Interface Pack>parser /uninstall"

as well as

"C:\Program Files\AIRCOM International\ENTERPRISE 6.1\RT Loader>parser /uninstall"

Uninstall the RANOPT Interface Pack

Repair the Enterprise Installation

Install the patch and Interface pack in the order specified in Installing the Interface Pack.This should resolve any installation issues, and further patches and Interface Packs can be installed in any order.

You have login problems.

Not enough disk space for the database.

Check the error that is provided to the user. It is possible that the database server has moved address, name or IP address. Check the display message at the message prompt, or in the message log. The database may have run out of disk or tablespace space and therefore will not provide any room for redo logs and output traces.

You are unable to login into database.

Incorrect database. Check that it is the correct database that you are trying to log in to. For example, it is easy to select the ASSET database, username or password when logging into the RANOPT database, and visa versa. When using RANOPT ENTERPRISE edition, two distinct databases are used, one for the site data, and one for measurement data. They must be logged in to separately and with the correct credentials.

Misc Certain parts of RANOPT are not functioning.

You have two Oracle homes. Two installations of Oracle will cause certain parts of RANOPT not to function.Unfortunately, setting the oracle home to the correct oracle installation for RANOPT from the Oracle Home selector does not fix the problem. The registry needs to be updated.

Start the registry editor and go to HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\ALL_HOMES. Change the DEFAULT_HOME key value to point to the correct Oracle installation for RANOPT.

Misc A HRCHECK Error window is displayed.

The current reports folder is set to the same location as the available released reports folder.

Change the location of the current reports folder to a different location.

If you are not experienced at setting up RANOPT, it is recommended that you contact the administrator.

Polygons Polygon filtering

Overlapping polygons.

- or -

Slight offsets between polygons and measurement data - overlapping can occur.



-or-

Excludes and includes using different polygons that do not overlap.

- or -

Restrictions on choice of polygons – only the external edge of a complete mapinfo polygon relation can be used.

Reports You cannot open Reports.

Inproc is not included in the Microsoft office references.

Install the objects for OLE in the Oracle installation. Please contact AIRCOM support.

Services RANOPT Services not installed, for example the RANOPT File Parser and Loader.

A user has installed previous versions of RANOPT. These other versions have been removed but the keys in the registry have not been deleted or updated.

This can be solved without repairing the software. You can install the service manually from a command window but you will have to ensure that all the loader dlls are also registered. Please contact AIRCOM Support.

Snapshot You cannot create a snapshot.

Check that all necessary fields are filled out (and that they refer to the correct network and so on). For example, ensure that the network and project have been set.

- or -

Check that all site data has been committed. Only data from the AIRCOM schema (and not from user diff tables) will be used for creating snapshots. - or -

Check that there is enough free table/disk space available.


Getting Started With RANOPT 7.0 Page 53 Index

Index

C

Creating ENTERPRISE Databases • 12 RANOPT Databases • 12

D

Database Explorer opening • 37

E

Equipment deleting • 32 editing • 32 splitting • 29

I

Installing installing RANOPT • 9, 17

N

Network operators about • 33 creating • 33 deleting • 35 editing • 35

Networks splitting • 35

T

Tablespaces registering • 36

Troubleshooting troubleshooting the RANOPT installation • 41, 47

U

Updating, databases • 26

V

Vendor Interfaces installing • 21

Page 54 Getting Started With RANOPT 7.0 Index

Date post:	17-Jul-2016
Category:	Documents
Upload:	kamal
View:	10 times
Download:	3 times

Getting Started With RANOPT

Documents