You are on page 1of 46

Getting Started Using RANOPT

Quick Reference Guide

Software Version 6.1


Reference Guide Edition 1

Copyright 2008 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 23 May 2008.
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

Contents
Chapter 1 First Time Installation 7
Software Requirements

Hardware Requirements

Install the ENTERPRISE and RANOPT Software

Create ENTERPRISE and RANOPT Databases

10

Create an ENTERPRISE Database


Configure ENTERPRISE ODBC connection
Populate the Support Schema
Create a Link User
About the Installation Wizard
Creating a Database for RANOPT for UNIX

Chapter 2 Post Installation Process

10
11
14
15
15
17

19

Upgrading the RANOPT Database

20

Choosing the Database for Loading Data

21

Creating and Modifying Equipment

22

How Data for Equipment is Converted into Files


Setting up the Global File Location
Creating an Equipment

Creating and Modifying Network Operators


Creating a Network Operator
Modifying and Deleting Network Operators

22
23
23

26
26
28

Registering Tablespaces

29

Upgrading Reports

29

Logging into the Database Explorer

30

Choosing the Database Explorer Options

Starting ENTERPRISE and RANOPT

Chapter 3 Troubleshooting

31

31

35

Troubleshooting the Database Explorer

35

Troubleshooting

41

Getting Started With RANOPT


Version 6.1

Page 5

Page 6

Getting Started With RANOPT


Version 6.1

CHAPTER 1

First Time Installation


If you are installing RANOPT for the first time you will need to follow these steps:
Install third-party software
Check your hardware requirements
Install the ENTERPRISE and RANOPT software
Post-installation process

In This Section
Software Requirements
Hardware Requirements
Install the ENTERPRISE and RANOPT Software
Create ENTERPRISE and RANOPT Databases

7
8
9
10

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

9i

Oracle SQL*Net

10g

Oracle Call Interface (OCI)


Oracle Objects For OLE
Oracle ODBC

Microsoft Office

2000

Excel

2003
XP

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.

Getting Started With RANOPT


Version 6.1

Page 7

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

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

Requirements
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.

CLIENT

Processors

Recommended: 1 CPU * 2.0GHz

OS

Supported: Windows 2000, Windows XP

Memory

Minimum: 512MB
Recommended: 1GB

HDD

Minimum: 300MB
Recommended: 500MB

Processors

Page 8

Recommended: 1 CPU * 2.0GHz

Getting Started With RANOPT


Version 6.1

Install the ENTERPRISE and RANOPT Software


To start the installation process:
1

Open the folder named ENTERPRISE and look for the file setup.exe. Doubleclick on it.

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

Select Custom as type of setup and click Next.

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.

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 setup wizard. When the installation finishes, restart your computer.

Getting Started With RANOPT


Version 6.1

Page 9

Install 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.

When the installation has finished, restart your computer.

Create 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.

Create an ENTERPRISE database.

Configure the ENTERPRISE ODBC connection.

Populate the support schema.

Create a link user.

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

Create an ENTERPRISE Database


Before creating an ENTERPRISE Database,
Place the template AIRCOM_Production_Autoextents.dbt in the following
folder:
drive:\oracle\ora92\assistants\dbca\templates
where drive is the drive where Oracle is installed (probably c:\)

To create an ENTERPRISE Database:

Page 10

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

In the window that appears, choose the AIRCOM Production Autoextents


template and click Next.

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

Getting Started With RANOPT


Version 6.1

For example, you can use:


Global System Name: ent5
SID: ent5

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

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

Click End.

Configure ENTERPRISE ODBC connection


To configure the ENTERPRISE ODBC connection.
1

Open the ENTERPRISE Administrator tool by clicking:


Start -> All Programs -> AIRCOM International -> ENTERPRISE V6.1 -> Misc ->
ENTERPRISE Administrator

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.

Click the System DSN tab.

Click Add.

Getting Started With RANOPT


Version 6.1

Page 11

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

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: ent5
TNS Service Name: ent5

Page 12

Getting Started With RANOPT


Version 6.1

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

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

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

Getting Started With RANOPT


Version 6.1

Page 13

Populate 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 V6.1 -> 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

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.

Click Next.

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

Page 14

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

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

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

Getting Started With RANOPT


Version 6.1

Create a Link User


1

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

In the left hand pane, under the tree-like directory for your project, click the folder
Users.

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.

Type the UserId and Password for this new user.


For example, use:
UserId: link
Password: link
Profile: ENT_DEFAULT_PROFILE

Click Next until you reach the end of the Wizard.

Click Finish.

Check that the new user link has been created.

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
V6.1, Misc, then click RANOPT Administrator.

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.

Getting Started With RANOPT


Version 6.1

Page 15

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.

Page 16

Getting Started With RANOPT


Version 6.1

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 doesnt 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 allow the user 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.

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.

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

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.

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

Getting Started With RANOPT


Version 6.1

Page 17

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
ids as shown in the tnsnames of the database server.

Page 18

Getting Started With RANOPT


Version 6.1

CHAPTER 2

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.

Configure the parser/loader for loading data.

Configure the equipment that is used.

Configure the network operators.

Register the available tablespaces.

Upgrade the reports.


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

Log into the Database Explorer.

In This Section
Upgrading the RANOPT Database
Choosing the Database for Loading Data
Creating and Modifying Equipment
Creating and Modifying Network Operators
Registering Tablespaces
Upgrading Reports
Logging into the Database Explorer
Choosing the Database Explorer Options
Starting ENTERPRISE and RANOPT

Getting Started With RANOPT


Version 6.1

20
21
22
26
29
29
30
31
31

Page 19

Upgrading the RANOPT Database


You can use the RANOPT Administrator to upgrade the RANOPT database.
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:

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

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

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.

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.

Page 20

Getting Started With RANOPT


Version 6.1

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:

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

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.

To verify the database connection, click Test.

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.

Getting Started With RANOPT


Version 6.1

Page 21

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.

Creating and Modifying Equipment


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.

Page 22

Getting Started With RANOPT


Version 6.1

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.
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.

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.

Creating an 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

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

From the Decoder Keyword drop-down list, select a suitable decoder keyword.
You can use the same decoder keyword for more than one equipment.

Getting Started With RANOPT


Version 6.1

Page 23

If you are creating TEMS equipment, select the version number.

In the File Extension box, type an 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.

Create a template string, which will be used to extract information from a data file.

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:

Page 24

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

Getting Started With RANOPT


Version 6.1

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

Make the required changes and click Commit.

To delete an equipment:
1

From the Available Equipment pane, select an equipment.

Click the Delete an Equipment button

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.

Getting Started With RANOPT


Version 6.1

Page 25

Creating and Modifying Network Operators


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

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.

Page 26

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.

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

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

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.

Getting Started With RANOPT


Version 6.1

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:

Setting up Automatic Network Detection


Automatic network detection is a method used to load the files regardless of the
equipment type or network.
Files are submitted into the configured 'home' or 'shared' directories under Import
Sources.
To enable automatic network detection,
This feature currently only works for Nemo User Equipment, Nemo Scanner, SD5
and Tems files.
Files containing multiple devices (equipments), such as Tems and/or Agilent SD5, are
split up into separate files, even if Automatic Network Detection is switched off.
Getting Started With RANOPT
Version 6.1

Page 27

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

Make the required changes, and click Commit.

To delete a network operator:

Page 28

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

Click the Delete Network button

Getting Started With RANOPT


Version 6.1

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.

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.

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

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.

Getting Started With RANOPT


Version 6.1

Page 29

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:

Page 30

From the Start menu, point to Programs, AIRCOM International, ENTERPRISE


6.1, Misc and click RANOPT Database Explorer.

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

Click OK.

Now you can choose your options.

Getting Started With RANOPT


Version 6.1

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.

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

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, International, ENTERPRISE


6.1, then click ENTERPRISE.

Log in to ENTERPRISE, type in the administrator user name and password:


User Id: Administrator
Password: admin

Create an ENTERPRISE project. For more information on how to do this, please


see the ENTERPRISE Installation and Administration Guide.

Configure the RANOPT ODBC connection.

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

Once the project data has been loaded, select the RANOPT tab and click on the
RANOPT Login button

Getting Started With RANOPT


Version 6.1

Page 31

Page 32

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

Click the System DSN tab.

Click Add.

Getting Started With RANOPT


Version 6.1

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


Version 6.1

Page 33

Page 34

Getting Started With RANOPT


Version 6.1

CHAPTER 3

Troubleshooting
This chapter offers some troubleshooting suggestions.

In This Section
Troubleshooting the Database Explorer
Troubleshooting

35
41

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.

Click Start and select Control Panel.

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

Click the Windows Firewall icon beneath the status updates.

Click Off (not recommended), and then click OK

After turning off the Windows Firewall, you will get the following warning
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, continue to with the steps
below.

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

Getting Started With RANOPT


Version 6.1

Page 35

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

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.

From the Start menu, click 'Run'.

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

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:

Page 36

Getting Started With RANOPT


Version 6.1

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

Click the Security tab, and in the Launch and Activation Permissions pane, select
the customise radio-button.

Getting Started With RANOPT


Version 6.1

Page 37

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

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

Page 38

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

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

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

Getting Started With RANOPT


Version 6.1

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.

Getting Started With RANOPT


Version 6.1

Page 39

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.

Page 40

Getting Started With RANOPT


Version 6.1

Troubleshooting
if you install RANOPT and experience a problem, this table describes the problem
and the possible solutions:
What to do if:
Problem

Cause

Solutions

Files do not load.

You have parser problems.

Look at the RANOPT status monitor, and see what


it is doing. If it is still parsing another file you need
to wait until the parsing is completed before the
next file may be loaded.
- or If all files that are in the in folder have an extension
.detected, rename one of them by taking off this
extension.
- or Open the RANOPT Administrator and look at the
service details. If the service appears to be running
successfully and the window is coloured green then
check the message log. If there is a problem, then
restart the service using the RANOPT
Administrator. Check that this is completed
successfully, then check the message log to ensure
that the action has been tracked and completed.
- or Look at the RANOPT file parser process in
windows task manager, if the process is at 99/99%,
stop the file parser from the services.msc window
on the loader machine, and stop the parser process
(this is the windows process). Move the file out of
the in folder and restart the parser.

You have login


problems.

Locked account.

When trying to log in to ENTERPRISE check that


you have not been locked out of the account. This
can potentially occur if the user session has
terminated whilst logged in.

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.

Getting Started With RANOPT


Version 6.1

Page 41

Problem

Cause

The calls are not being


correctly analysed or
not shown properly.

Solutions
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.

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.

Failure to see any


logfiles 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.

Page 42

Getting Started With RANOPT


Version 6.1

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

Cause

Solutions
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).

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.

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


Version 6.1

Page 43

Problem

Cause

There is a problem with This typically occurs because the


your connection, after
database address is the host name of
resuming from 'standby' the PC.
mode on a laptop.

Solutions
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.

Page 44

Getting Started With RANOPT


Version 6.1

Problem

Cause

Solutions

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.

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.

You cannot open


Reports.

Inproc is not included in the Microsoft Install the objects for OLE in the Oracle installation.
office references.
Please contact AIRCOM support.

A HRCHECK Error
window is displayed.

The current reports folder is set to the Change the location of the current reports folder to
same location as the available
a different location.
released reports folder.
If you are not experienced at setting up
RANOPT, it is recommended that you contact the
administrator.

Getting Started With RANOPT


Version 6.1

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.

Page 45

Page 46

Getting Started With RANOPT


Version 6.1

You might also like