Académique Documents
Professionnel Documents
Culture Documents
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: Support Hotline: Fax: Web: +44 (0) 1932 442 000 +44 (0) 1932 442 345 +44 (0) 1932 442 005 www.aircominternational.com
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
Page 5
Page 6
CHAPTER 1
Software Requirements
Prior to installing RANOPT, there is Third Party software that must be installed. This software is listed in the table below:
Software Oracle Client Supported Versions 9i 10g Software Modules Oracle SQL*Net Oracle Call Interface (OCI) Oracle Objects For OLE Oracle ODBC Microsoft Office 2000 2003 XP Excel
Page 7
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 DATABASE Server OS Memory Requirements Supported: UNIX, Windows 2000, Windows XP,Windows 2003 Server Minimum: 1GB Recommended: 2GB HDD Processors Disk space required is calculated using the algorithm provided in the 'Database Growth' section lower down in this document. Minimum: 1 CPU * 1.8 GHz Recommended: 2 CPUs * 2.0 GHz LOADER/PARSER Machine OS Memory Supported: Windows 2000, Windows XP, Windows 2003 Server 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 CLIENT OS Memory Recommended: 1 CPU * 2.0GHz Supported: Windows 2000, Windows XP Minimum: 512MB Recommended: 1GB HDD Minimum: 300MB Recommended: 500MB Processors Recommended: 1 CPU * 2.0GHz
Page 8
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 setup 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:
Start -> All Programs -> AIRCOM International -> ENTERPRISE V6.0 > Misc -> Configure NetHASP Settings Getting Started with RANOPT Version 6.0 Page 9
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 7
Install latest supported RANOPT Patch if available. The RANOPT patches are available from the support website. The table below shows an example of the patches available for downloading.
Version 4.1 4.2 4.2 4.2 5.0 Apply to Build 4010032R0 4020239R1 4020367R3 4020474R0 5000216R4 Description Patch R33 IR2 Patch R31 IR3 Patch R10 IR4 Patch R21 IR2 Patch R22 Download Download Download Download Download Download Release Notes Release Notes Release Notes Release Notes Release Notes Release Notes Date <Date> <Date> <Date> <Date> <Date>
8 9
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.
Page 10
To Create an ENTERPRISE Database: 1 2 3 Open the Oracle Database Configuration Assistant and select the option Create a database. Click Next. In the following window, choose the template AIRCOM Production Autoextents and click Next. 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 5
Click Next until reaching the end. 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.
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.
Page 11
3 4 5
Click the System DSN tab. Click Add. 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
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.
Page 13
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
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 5
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
6 7 8
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.
Page 14
5 6 7 8
Click Next until you reach the end of the Wizard. Click Finish. Check that the new user link has been created. Close ENTERPRISE Administrator.
existing database in the RANOPT Administrator. To create a new database, on the RANOPT Administrator toolbar, from the Tools Menu, select Install Database.
Page 15
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.
Page 16
You should 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 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 Installation wizard (Installation Progress) Enter the sys password configured in the previous step and click OK. 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.
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. Note : This enterprise.sql file does require some editing to use the correct database ids as shown in the tnsnames of the database server.
further patches have been applied. This operation should be done every time a new patch is applied. 2 3 4 5 6 7 Configure Parser/Loader for Loading Data. Configure Equipment used. Configure Network Operators. Register Available Tablespaces. Upgrade/Configure the Reports.
Note : This operation must be done every time a new RANOPT patch is installed.
If not prompted to upgrade automatically click on the Upgrade Database button located in the toolbar.
Page 18
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
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 Start the Parser/Loader Service Stop the Parser/Loader Service Pause the Parser/Loader Service Restart the Parser/Loader Service Status
Now set the location where any errors/warnings of the service will be stored.
Page 19
In the Home Directory, type in a path where you want to store all loaded files
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 all the equipments.
Note : With every change you make, you will be asked to restart the parser/loader
Important : The Home Directory and Shared Directory are the global locations for
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.
Page 20
To set up new equipment to use: 1 2 3 4 5 Click on the Create New Equipment button . Type an appropriate name in the Name field. Select the Equipment type decoder you want to use to Parse the file from the dropdown list in the Decoder Keyword field. If the Equipment chosen is TEMS then you are required to enter the version number in the next field, Version. 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).
Page 22
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 4
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. 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 6 7
Click on the Reports tab and repeat the process. Click on the Modules tab and repeat the process. When prompted to close the window, click on Yes The installation process has finished.
Page 23
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. This picture shows an example of the RANOPT Database Explorer Settings dialog box (With the server being the local machine):
3 4
Page 24
following documents: 4 5 6 7 Installation and Administration Guide: see Chapter 4, Setting up projects. RANOPT User Reference Guide: see Section 2, Setting up a new project.
Configure the RANOPT ODBC connection. After logging into ENTERPRISE database (ent5) 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 . In the Database login dialog box, click the Setup button to configure the ODBC source.
8 9
Page 25
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.
Page 26
Troubleshooting
If you install RANOPT and experience a problem, this table describes the problem and the possible solutions: What to do if:
Problem Files do not load. Cause You have parser problems. Solutions 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. 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. 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.
Incorrect database.
Page 27
Problem The calls are not being correctly analysed or not shown properly.
Cause
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. 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.
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 28
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 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. 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.
Page 29
Problem
Cause
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 . 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.
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.
Page 30
Solutions 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.
Inproc is not included in the Microsoft Install the objects for OLE in the Oracle installation. office references. Please contact AIRCOM support. The current reports folder is set to the Change the location of the current reports folder to a different location. same location as the available released reports folder. Note : If you are not experienced at setting up RANOPT, it is recommended that you contact the administrator.
7 8 9
Click on the balloon, or on the red shield in the system tray, and click on Recommendations 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 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 2 3 4 Log on as a user with administrative rights From the Start menu, select 'Run' and then type 'dcomcnfg'. Click OK to launch the 'Component Services' dialog box. In the 'Component Services' dialog box, expand the 'Component Services' node, then expand the 'Computers' and DCOM Config sub-nodes. From here the status monitor node should be accessible. Right click on the 'status monitor' node and select properties.
Page 32
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. Repeat the steps above for the Access Permissions applying the same permissions to the same groups as before.
7 8 9
Click OK to save all changes. Return to the component services tree (step 3) and right click on My Computer under the Component Services Computers nodes. Select Properties. 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.
Page 33
10 Repeat step 8 also for any Citrix machine or client machine that is running Windows 2003 SP1.
Page 34