getting started with ranopt

Getting Started With RANOPT

Version 6.0

© Copyright 2007 AIRCOM International All rights reserved

ADVANTAGE, ENTERPRISE, ARCHITECT, ASSET3g, CONNECT, DATASAFE, ENTERPRISE, NEPTUNE, HOMEZONE, OPTIMA, RANOPT, TARGET and WEBWIZARD are recognised trademarks of AIRCOM International. Other product names are trademarks of their respective companies.

Microsoft Word, Microsoft Office, Windows®, Windows 95™, Windows 98™, Windows NT® and MS-DOS™ 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 15 August 2007.

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

United Kingdom

Telephone: +44 (0) 1932 442 000 Support Hotline: +44 (0) 1932 442 345 Fax: +44 (0) 1932 442 005 Web: www.aircominternational.com

Getting Started with RANOPT Version 6.0

Contents

Getting Started with RANOPT 7

First Time Installation ......................................................................................... 7

Software Requirements ............................................................................................7 Hardware Requirements ...........................................................................................8 Install the ENTERPRISE and RANOPT Software......................................................9 Create ENTERPRISE and RANOPT Databases ..................................................... 10 Post Installation Process ........................................................................................ 18


Getting Started with RANOPT

In This Section

First Time Installation 7

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

Software Requirements

Prior to installing RANOPT, there is Third Party software that must be installed. This software is listed in the table below:

Software Supported Versions Software Modules

Oracle Client 9i

10g

Oracle SQL*Net

Oracle Call Interface (OCI)

Oracle Objects For OLE

Oracle ODBC

Microsoft Office 2000

2003

XP

Excel

C H A P T E R 1


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

Note : 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


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

Note : Depending on the licence provided you will be 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 the “RANOPT Client” option is selected and the “RANOPT Loaders” are not.

If this is the 'Server' i.e. RANOPT Database or RANOPT Loader, install - make sure the “RANOPT Client” section is not selected and the “RANOPT Loaders" is.

Note: If RANOPT is to be configured both as a server and as a client you need to tick all options available, as it is shown in the picture. 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. If you have the dongle at your disposal, connect it to the USB port of your PC.

Note : If you do not have the dongle you will be unable to create the ENTERPRISE and RANOPT database. However if you have a dongle server follow the points below to set up the dongle server:

Open the ENTERPRISE Administrator tool by clicking: ‘Start -> All Programs -> AIRCOM International -> ENTERPRISE V6.0 -

> Misc -> Configure NetHASP Settings’


Edit the NetHASP.ini file.

Ensure that the variable, NH_SERVER_ADDR is set to the name of the dongle server.

NH_SERVER_ADDR=DONGLE_SERVER

6 Install latest supported RANOPT Patch if available.

7 The RANOPT patches are available from the support website. The table below shows an example of the patches available for downloading.

Version Apply to Build Description Download Release Notes Date

4.1 4010032R0 Patch R33 Download Release Notes <Date>

4.2 4020239R1 IR2 Patch R31 Download Release Notes <Date>




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

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

10 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 Create an ENTERPRISE database.

2 Configure the ENTERPRISE ODBC connection.

3 Populate the Support Schema

4 Create a Link User

5 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:

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

2 In the following window, choose the template „AIRCOM Production Autoextents‟ 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 reaching the end. 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.

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.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 Orahome92‟) 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: ent5 TNS Service Name: ent5


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.


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.0 -> Misc -> ENTERPRISE Administrator‟

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


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

2 Select New Database and click OK.

The Installation wizard will start up.

Note : 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'.

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

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

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

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

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

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.

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

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

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

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

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

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

Post Installation Process

After creating the ENTERPRISE and RANOPT database, you can:

1 Upgrade RANOPT database.

Note : It is not necessary 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 Parser/Loader for Loading Data.

3 Configure Equipment used.

4 Configure Network Operators.

5 Register Available Tablespaces.

6 Upgrade/Configure the Reports.

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

7 Log into the Database Explorer.

Upgrade RANOPT database

To upgrade the RANOPT database:

1 Open RANOPT Administrator by clicking: Start -> All Programs -> AIRCOM International -> ENTERPRISE V6.0 -> Misc -> RANOPT Administrator

2 Login with the administrator user: User Id: ranopt Password: ranopt Database: RANOPT

3 If not prompted to upgrade automatically click on the “Upgrade Database” button

located in the toolbar.


4 The “Upgrade” window will open with the recommended options ticked. Tick also the option „Continue On Non-fatal Errors‟ and click OK to continue. Your RANOPT installation will be updated to the latest version.

Note: Make sure that the RANOPT File Parser and Loader service is stopped and no other software is logged on the RANOPT database before upgrading it.

Configure Parser/Loader 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, select Parser/Loader.

2 In the Parser/Loader User Details pane, delete any text that exists and type in your RANOPT database username and password.

3 Select a Database.

4 To verify the database connection, click Test.

5 To save the details, click Commit.

Note : If the message indicates that your connection is valid, then you are ready to receive and load files correctly. If not you will be prompted to enter your windows login name and password.

6 Use the table shown here to start or stop 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 Now set the location where any errors/warnings of the service will be stored.


This picture shows an example of the Parser Loader Settings window:

Configure Equipment Used

The Home and Shared directory is set up for each Equipment in one place.

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

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.

Important : The Home Directory and Shared Directory are the global locations for all the equipments.

Note : With every change you make, you will be asked to restart the parser/loader service. You can either do that every time you change something or make all the necessary changes and restart once at the end.

The Equipment used is set up in the same window.


To set up new equipment to use:

1 Click on the Create New Equipment button .

2 Type an appropriate name in the Name field.

3 Select the Equipment type decoder you want to use to Parse the file from the drop-down list in the Decoder Keyword field.

4 If the Equipment chosen is TEMS then you are required to enter the version number in the next field, Version.

5 In the Extension field type in the extension the files of this equipment have so that they can be detected by the Parser/loader service (for example, dt1, cmd, log, sd5, fmt and so on).

This picture shows an example of the Equipments window:

Configure Network Operators

To set up the Network Operators:

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

button or from the Configure Menu, select Network Operators.

2 Click the Create New Network button.

3 Insert a name in the Name field.

4 In the Code field give the Network a unique Network code, this can be any number.

5 Select the technologies you want to use your network on, in the Technologies field.

6 Press Commit to accept changes.

7 If you wish to use the Automatic Network detection feature then you should check the Enable Automatic Network Detection box and edit the appropriate frequency fields.


This picture shows an example of the Networks window:

Register Available Tablespaces

To register the Available Tablespaces:

1 On the RANOPT Administrator toolbar, click the Register Available Tablespaces

button or from the Configure Menu, select Registered Tablespaces.

2 In both Result and Filter Tablespace Sections you should:

3 Click on the Add Tablespace button.

4 In the popup box select the default tablespace (for example, RANOPTD) and click OK.


Upgrade/Configure the Reports

To the RANOPT Reports:

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

2 The „Upgrade Reports‟ window will open with the Parameters tab selected. Under the „Released Modules Location„ field, search for and locate the Available Reports Directory for the Parameters/Reports/Modules, if not already populated.

3 The „New Available Released Reports‟ will be listed in the left hand pane. Select the check boxes required or right-click on the left hand pane and „Select All‟.

4 Click OK to update the Excel Reports. When prompted to close the window, click on „No‟.

Note : For a new database, after pressing ok the user is prompted to input the path to the RANOPT reports folder, for example c:\RANOPT\reports

5 Click on the „Reports‟ tab and repeat the process.

6 Click on the „Modules‟ tab and repeat the process.

7 When prompted to close the window, click on „Yes‟

The installation process has finished.


Logging into the Database Explorer

To start using the RANOPT Database Explorer:

1 From the Start menu, point to Programs, AIRCOM International, ENTERPRISEV6.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.

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.

This picture shows an example of the RANOPT Database Explorer Settings dialog box (With the server being the local machine):

Starting ENTERPRISE and RANOPT

To open ENTERPRISE:

1 From the Start button, point to Programs, AIRCOM, ENTERPRISE 6.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.

Note : To complete this section please follow the instructions given in the following documents:

Installation and Administration Guide: see Chapter 4, „Setting up projects‟.

RANOPT User Reference Guide: see Section 2, „Setting up a new project‟.

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.


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



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.

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



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

Check that all required modules have been logged in where appropriate (for example ASSET3g, 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.



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 .

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



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.

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.

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.

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.

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

Viewing the Status Monitor in the RANOPT Database Explorer

The following steps should ensure that the status of logfile loading can be easily viewed for installations using Windows 2003 Server Service Pack 1 or older:

The process is split into two parts, the first to configure the firewall, the second to configure the dcom security settings. If there is currently no firewall then you can just configure the dcom security settings.

Turning the Windows Firewall Off

All configuration is for the machine that is running the file parser service, i.e. the file loader machine.

To turn off the Windows Firewall software do the following:

1 Log on as a user with administrative rights.

2 Click „Start‟ and select Control Panel.

You will have one of two control panels.

3 Click on the Security Center icon.

4 Click on the Windows Firewall icon beneath the status updates.

5 Click Off (not recommended) and then click OK.

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

This error will continue to pop up in the system tray until you tell Windows that you realise the Firewall is turned off. To do this, continue to Step 7.


7 Click on the balloon, or on the red shield in the system tray, and click on „Recommendations‟

8 Check the "I have a firewall solution that I'll monitor myself" box. This will stop Windows from alerting that there is a risk. Click OK

9 After you click OK, a screen warning that Windows will not monitor your firewall settings will appear, this dialog can be closed.

Configuring the DCOM security settings

The following configuration is for the machine that is running the file parser service, i.e. the file loader machine.

To change the DCOM Logon permissions do the following:

1 Log on as a user with administrative rights

2 From the Start menu, select 'Run' and then type 'dcomcnfg'. Click OK to launch the 'Component Services' dialog box.

3 In the 'Component Services' dialog box, expand the 'Component Services' node, then expand the 'Computers' and „DCOM Config‟ sub-nodes.

4 From here the „status monitor‟ node should be accessible. Right click on the 'status monitor' node and select properties.


5 Select the customise radio-button for the Launch and activation permissions and click „edit‟. If the ENTERPRISE installation is published via Citrix, then the network user group can be specified here. If users are logging on directly to the database via the network, then a network user group (or individual users) can be specified here. If a variety of users are allowed access to the database and it is unknown which users will logon to the machine, 'ANONYMOUS LOGON' should be added to the list of permitted users. If the users will remotely access the service, then Remote launch, and remote Activation should be selected.

6 Repeat the steps above for the Access Permissions applying the same permissions to the same groups as before.

7 Click OK to save all changes.

8 Return to the component services tree (step 3) and right click on „My Computer‟ under the „Component Services‟ – „Computers‟ nodes. Select „Properties‟.

9 From the „COM Security‟ tab select „Edit Limits‟ for „Access Permissions‟, and for „Launch and Launch and Activation Permissions‟ provide access to the users/groups specified in step 5.


10 Repeat step 8 also for any Citrix machine or client machine that is running Windows 2003 SP1.

getting started with ranopt

Documents

ranopt version

ranopt page

ranopt databases

party software

software products

unix installations of

time installation

electronic version