OPTIMA User Reference Guide
OPTIMA User Reference Guide
Version 5.0.3
© Copyright 2005 AIRCOM International Ltd
All rights reserved
Microsoft Word, Microsoft Office, Windows®, Window 95™, Window 98™, Windows NT®, Windows XP®
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 express or
implied, about this documentation, its quality or fitness for a particular customer purpose. Users are solely
responsible for the proper use of ENTERPRISE software and the application of the results obtained.
♦ ♦ ♦
Contents
Chapter 1 Introduction
About This Manual .............................................................................................. 2
Obtaining User Assistance .................................................................................. 2
About the ENTERPRISE User Reference Guides ...................................................... 3
Using ENTERPRISE User Reference Guide PDFs .................................................... 4
Obtaining Further Information and Services................................................................ 4
Obtaining Support........................................................................................................ 5
Index
Introduction
OPTIMA is a network performance management and monitoring software that logs
and stores network parameters, enabling you to gain a complete understanding of the
current and past performance of your network.
You can use OPTIMA with ENTERPRISE or standalone, as OPTIMA Lite.
By accessing and analysing invaluable performance data, you can:
• Identify and respond quickly to change
• Accurately pinpoint extra capacity requirements
• Deploy network enhancements in a timely and cost effective manner
• Predict future trends in the network or at any part of the network
Some typical uses of OPTIMA for network operation and performance management
are:
• Daily reporting of cell, site, BSC, MSC and transmission network performance
• Daily reporting of any cluster of cell sites or network elements covering particular
cities, roads or other geographical regions
• Identification of performance anomalies across network regions
• Overall monitoring of alarms and equipment operational status
• Identification and strategic reporting of traffic hotspots and network locations
generating high traffic and revenues
In This Section
About This Manual
Obtaining User Assistance
Obtaining Support
Logging Support Requests Online
To log a support request online:
1 Go to the AIRCOM website, at http://www.aircom.co.uk.
2 Click the link to Support.
3 Log in, using your customer web account username and password.
4 In the Technical Support pane, click Online Helpdesk System.
5 Click Log New.
6 Enter the details of your request, and then click Log.
Installing OPTIMA
OPTIMA can be used in the following ways:
If using OPTIMA Then
As part of the ENTERPRISE suite To ensure top performance, one of our teams needs to install and integrate
OPTIMA to a network, configuring the collection of performance counters,
data storage and the database.
As a standalone product You should contact your system administrator to find out where on your
network OPTIMA is installed, and to get a username and password.
When you have this information, you can access OPTIMA without having to
install anything.
Over the internet You should contact your system administrator to find out how to use OPTIMA
over the Internet.
In This Section
About the Hardware and Software Requirements for OPTIMA
Installing OPTIMA
Starting OPTIMA
Changing your OPTIMA Password
Updating Data
When connected to the network switches and the database, OPTIMA updates itself
and automatically adds new sites and counter data when necessary. The data
collection process is one way and OPTIMA cannot modify the network.
Tip : Once you have logged in, you can change your password. For more
information, see Changing your OPTIMA Password on page 10.
In This Section
About the Main OPTIMA Toolbar
About the OPTIMA Menus
About the Counter Descriptions Window
Using Clocks in OPTIMA
About Performance Alarms
About the Data Explorer
About the Filter Explorer
Switching Between Open Windows
Defining User Preferences
This table describes the toolbar functions, some of which are only available if you are
running OPTIMA as part of ENTERPRISE:
Click: To:
Exit OPTIMA Close the current project and exit the tool.
Login/Logout Login to and logout of the database but keep ENTERPRISE running.
Open/Close Project Open and close projects but keep ENTERPRISE running.
New 2D View Open the 2D Map View. For more information, see Displaying Performance Data on the
Map on page 146.
Data Explorer Open the Data Explorer. For more information, see About the Data Explorer on page 20.
Filter Explorer Open the Filter Explorer. For more information, see Using the Filter Explorer on page 99.
Module Explorer Access the Module Explorer in which you can view and use modules. If you have
OPTIMA_Administrator or OPTIMA_Advanced_User permissions, you can also create,
modify and delete modules. For more information, see Creating OPTIMA Modules on
page 72.
Combination Explorer Access the Combination Explorer from which you can view and use module
combinations. If you have OPTIMA_Administrator OPTIMA_Advanced_User
permissions, you can also create, modify and delete combinations. For more information,
see About Combination Windows in OPTIMA on page 79.
New Combination Create a new OPTIMA window for viewing data. For more information, see Creating
Combination Windows on page 83.
New Work Area Access a New Work Area. For more information, see Creating a New Work Area on
page 140.
Report Explorer Access the Report Explorer. For more information, see About Using OPTIMA Reports on
page 152.
Schedule Explorer Access the Schedule Explorer. You can only schedule reports if you have
OPTIMA_Administrator OPTIMA_Advanced_User permissions. For more information,
see Scheduling When Reports Run on page 185.
Counter Legend Access the Counter Legend. For more information, see About the Counter Descriptions
Window on page 15.
OPTIMA Login Retry your login. This button is only enabled if you have had an unsuccessful login
attempt.
Main Clock Access the Main OPTIMA clock. For more information, see Using Clocks in OPTIMA on
page 16.
Favourites toolbar
If you have created a report, module combination or work area that you will reuse
frequently, you can save it as a favourite. When you save it as a favourite you also
select a button to be added to the Favourites toolbar. For information about saving
favourites, see Adding and Editing Favourites in OPTIMA on page 91.
6 Providing there is data for that date, you can display the data in different ways:
If you are using OPTIMA with ENTERPRISE, click Update Map to apply the
time you have chosen to any open Map View window. For more information,
see Viewing Data on the Map on page 145.
To review data collected over the same period, ensure that in each
combination window, in the Date Range pane, the Link to Main Calendar
check box is selected.
7 When you have finished reviewing data, you can reset the date and time to the
System Clock again by opening the Global Clock and selecting the Set to System
Clock check box.
From the Alarms Explorer toolbar you can create alarm definitions and folders and
view alarm definition logs.
This picture shows an example of the Alarms Explorer toolbar:
From the Alarms Handler Explorer toolbar you can view, create, edit and delete alarm
handlers.
This picture shows an example of the Alarms Handler Explorer toolbar:
For more information about the Filter Explorer, see Creating Filters in the Filter
Explorer on page 100.
OPTIMA Administrator
Tools
You should only read this section if you are an OPTIMA Administrator.
You can only use the OPTIMA Administrator menu if you log in to OPTIMA or
OPTIMA Lite, with OPTIMA_Administrator permissions.
OPTIMA_Administrators can:
• control who has access to the features in OPTIMA and at what level.
• configure settings such as the busy hour and Key Performance Indicators (KPIs).
• define and view performance alarms. For information about using alarms, see
Using Performance Alarms on page 191.
In This Section
About OPTIMA Security
Using Contacts in OPTIMA
About KPIs
Adding a Description to a Raw Counter
About Global Counters
About Table and Field Information Settings
About Categories
About Routes
Downgrading Cells
Excluding Particular Days from Reports
Setting the Busy Hour
Modifying Element IDs
You can then use these groups to limit access to the folders in the Schedule Explorer,
as shown below:
When you have finished adding users to the Destination List, click OK.
4 To remove a user: select the user and click the Remove User button.
5 Click Close to save the changes.
To delete a group:
1 From the Administrator menu, point to Security and click Groups.
The OPTIMA Groups dialog box displays.
2 Select the group and click the Delete Group button.
3 Click Yes to confirm.
4 If no objects are owned by the group, the group is deleted. However, if there are
objects still owned by the group, then the Change OPTIMA Group dialog box
appears.
5 To select a new owning group for the objects:
Select a group from the Group list and click the right arrow button.
-or -
Cascade permission changes to child folders The selected folder and its subfolders. This option
will not overwrite any existing groups that have
already been assigned to the folder or subfolders.
Cascade all permission to child folders The selected folder and its subfolders. This option
overwrites existing groups that have already been
assigned to the folder or subfolders.
Username Type a name for the user, this is the name they will use to log into OPTIMA.
Note: You can only use letters, numbers and the symbols $ _ and # in the
username. You cannot use spaces and you must use a letter or number for the first
and last characters.
Full Name Type the full name of the user.
Description Type a description of the user's account if necessary. This field is not mandatory.
Department Type the name of the user's department if necessary. This field is not mandatory.
Region Type the name of the user's region - this could be actual location or the part of the
country they work deals with, for example, a cell planner covering the North. This
field is not mandatory.
Password, Verify Password Type the password for the user, this is the password they will use to log into
OPTIMA.
User Access Select a role for the user. For more information about roles, see About OPTIMA
User Roles on page 32.
Creating KPIs
To create a KPI:
1 From the Administrator menu, point to Counters and then click KPI Manager. The
KPI Manager dialog box appears. This picture shows an example:
Column Order Type a number that corresponds to where you want the column to appear on the 2D
Map data types tree.
Show in 2D Map - Select the Show in 2D Map check box if you want the KPI to be available in the Map
Cell-based KPIs only View Window.
You must select an element and data column from your chosen table.
Equation Type an equation to define the KPI, using the available columns.
Note : The equation must be in syntax that Oracle will understand.
Tip : Double-click a KPI in the Counters for Equation list to have it added to the
equation.
You can build complex equations using the Expression Editor. Click Build Equation to
open the Expression Editor.
Description Type a description of the KPI.
4 Click Save.
Note : This may take a few seconds as the equation is automatically tested against
the database.
5 If the counter cannot be saved, correct the error and click Save again.
6 Click Close to return to the KPI Manager dialog box.
Deleting a KPI
To delete a KPI:
1 From the Administrator menu, point to Counters and then click KPI Manager. The
KPI Manager dialog box appears.
2 In the KPI Manager dialog box, click + to view the tables for the appropriate
schema and then select the required table.
3 In the right-hand pane, select the KPI(s) you want to delete.
Tip : Use the Shift and Ctrl keys to highlight more than one KPI at a time.
Click the down arrow next to the Synchronise Summary Tables button and
click either Selected KPI(s) or Selected Table.
5 In the Synchronise Tables dialog box, set the following options:
In This Pane: Do This:
Associated Tables Select the check boxes of the associated tables that you want to
synchronise.
Tip : Use the Check All button to select all the associated tables in
the list and the Uncheck All button to deselect all the tables.
Note : If the selected table has no associated tables listed, click the
Get Derived Tables button. This will attempt to retrieve all of the
tables that, in conjunction with the selected table, form an
associated list for the table. For example, if the table CELLSTATS
has an association with the daily, weekly and monthly summary
tables, then the daily and monthly summary tables can be derived
from the weekly summary table.
Synchronise Options Select how you want the synchronisation to be done.
If you want to match KPIs exactly during synchronisation, select the
Synchronise to Match KPIs Exactly radio button.
If you want to merge KPIs during synchronisation:
1. Select the Synchronise to Merge radio button.
2. If you want to overwrite KPIs that have duplicate names, select
the Replace KPIs With the Same Name check box.
6 Click OK. A new summary table appears in the Hierarchy Tree if not already
present.
7 Click Close to return the KPI Manager dialog box.
5 Click Process to recreate the view. In the Select Items to Process dialog box, the
Status and Message columns are updated to show the process output for each
selected table. This picture shows an example:
In the Global Counters dialog box, you can add, edit, and delete global counters. You
can also add global counters automatically. To do this:
1 From the Administrator menu, point to Counters and click Global Counters.
The Global Counters dialog box displays.
2 Click the Auto Add Counters button. The available global counters will be added
to the list.
To display the global counters for a particular table:
Click on the table name in the Table column.
For more information about categories, see About Categories on page 51.
About Categories
All the tables in OPTIMA's database are assigned a category. Categories are used to
group tables in the Data Explorer. If a table does not have a category assigned to it,
then it will not appear in the Data Explorer list of tables.
The categories can be manually assigned or automatically assigned when you
repopulate the Table and Field Info dialog box. For more information about
repopulating tables, see Repopulating Data on page 51.
OPTIMA has four default categories, which cannot be edited or deleted:
• Configuration
• Counters
• KPI
• Summary
However, if you are an OPTIMA_Administrator, you can create user-defined
categories and then associate them with database tables.
Creating a Category
To create a category:
1 From the Administrator menu, point to Counters and then click Categories.
The Table Categories dialog box appears.
2 Click Add.
3 In the Add Category dialog box, type a name and description for the category.
4 Click OK.
5 In the Table Categories dialog box, click Close.
Editing a Category
To edit a user-defined category:
1 In the Table Categories dialog box, highlight the category you want to edit.
Note: You cannot edit OPTIMA's default categories.
2 Click Edit, and edit the name and description as required.
3 Click OK.
4 In the Table Categories dialog box, click Close.
Deleting a Category
When you delete a category, you must reassign other categories to all the tables that
were in the category you have deleted. If you do not assign other categories, the tables
will not appear in the Data Explorer.
To delete a user-defined category:
1 In the Table Categories dialog box, highlight the category you want to delete.
Note: You cannot delete OPTIMA's default categories.
2 Click Remove.
3 Click OK to confirm the deletion.
4 In the Table Categories dialog box, click Close.
2 Click the button and type the required information on the new row
marked with an asterisk.
To edit a route in the Route Editor:
TCH Editor
You can correct OPTIMA, so the historic DTCH values are correct, by downgrading a
cell.
Warning : Downgrading a cell permanently changes historic performance data.
To downgrade a cell:
1 From the Administrator menu, point to Editors and then click TCH Editor.
2 In the TCH Editor, double-click on the relevant cell. This will update the cell.
3 Click OK to downgrade the cell.
The full Network Tree is displayed using data from the OPTIMA database.
Tip : If you select a filter, you can limit the number of nodes displayed in the tree.
If child objects exist then all the necessary parents are added to the tree.
5 If you want to set the rule for a particular cell, in the Rule column next to the
object, select the rule you wish to use.
- or -
If you want to set the default rule for any level other than cell, for example the
whole network, double-click on the chosen object and in the Specify Rule for Child
Nodes dialog box, set the rule and click OK.
6 When you setup the busy hour for all the cells, click Apply.
6 Click Apply to save the changes and then close the Capture Settings dialog box.
In This Section
Using the Data Explorer
About OPTIMA Modules
From the Data Explorer Misc menu, OPTIMA_Administrators can access KPIs,
categories and table information. For more information about using these features, see
OPTIMA Administrator Tools on page 25.
Defining a Query
You can define a query which returns data from OPTIMA's database tables. You can
use this query to view data in the Data Explorer or you can create a query as part of a
module.
Note : Only OPTIMA_Administrators or OPTIMA_Advanced_Users can create
modules.
Tip : If you are not familiar with SQL, you can use the Builder tab to create the query.
However, the Builder tab is disabled if:
Your database is not using Oracle 9i or above.
- or -
You have manually edited the SQL on the SQL tab.
Selecting a table name and then, while holding down the left mouse button,
dragging it onto Builder tab.
Tip: To remove a table from the Builder tab, select the table and click the button
in the top-right of the table box.
3 Select which columns you want to include in the query by clicking the boxes next
to the column headings.
Tip: Select and clear all the columns in a table by clicking the button next to the
table heading.
4 Add links between the tables by selecting a column heading in one table and then,
while holding down the left mouse button, dragging the heading to a column
heading in another table.
Note : If the two columns cannot be linked, the following icon appears .
Tip: To remove a link, select the link, click with the right mouse button and from
the menu that appears, click Delete Link.
5 Set the link type by double-clicking the link and selecting a type. By default, all
links are inner links. This means that only rows with matching values in the linked
columns will be displayed when the query is run.
7 When you have finished, you can add filters to the query. For more information,
see Adding Filters to a Query on page 66.
You can preview the results of the query at any time. For more information, see
Previewing the Results of a Query on page 67.
4 Select the date field you wish to use and click the button to select it.
5 Select the Add filter check box if you want to add a filter parameter. If you want
this filter to replace one already used in the SQL, select the Replace Values in SQL
Criteria check box.
A list of available filters appear in the Filter Names box.
6 Select the filter you wish to use and click the button to select it.
7 You can now preview the results of the query.
3 Click OK to close the Parameter Input dialog box and run the query.
4 You can now customise how the data is shown in the grid. For more information
about customising grids, see Customising Grids in OPTIMA on page 103.
Example Module
Deleting Folders
To delete a folder:
1 In the Module Explorer window, highlight the folder you want to delete.
2 Click with the right mouse button and, from the menu that appears, click Delete.
- or –
5 Click OK.
6 If the selected folder has child folders, you will be asked if you want to apply
changes to all child folders. This enables you to lock all of the child folders of an
Admin Folder. Click Yes to apply changes, otherwise click No.
To unlock a folder:
Follow the previous steps and clear the Admin Folder check box.
Note : If you have included a date filter in the SQL, you must also define a date and
time in the Date Time Entry dialog box. Select a date range and click OK to
continue.
7 On the Module Definition tab, click Edit Tree Level SQL to open the Data
Explorer. The Data Explorer enables you to define the tree level information which
customises the data displayed in a grid or graph when an item is selected from the
network element tree. For more information, see Using the Data Explorer on page
62.
8 When you have defined the tree level query, close the Data Explorer and in the
Module Maker Graph pane, from the Type and X-axis menus, select the type of
graph and X-axis you would like to use:
The graph is shown when you run a module in a combination window. For more
information, see Using Graphs on page 121.
9 Click OK to finish.
Select the module you want to delete and click the Delete button .
4 In the Confirm dialog box, click Yes to delete the module.
Tip : Use the Shift and Ctrl keys to select more than one module at a time.
3 Click the right mouse button, and from the menu that appears, click Copy.
4 Select the folder that you want to copy the module(s) to.
5 Click with the right mouse button, and from the menu that appears, click Paste.
The modules are copied to the specified folder.
Exporting Modules
To export a module:
1 In the Module Explorer, select the module(s) and/or folder(s) you want to export.
Tip : Use the Shift and Ctrl keys to select more than one module and/or folder at a
time.
In This Section
About Combination Windows in OPTIMA
Adding and Editing Favourites in OPTIMA
Filtering Data in the Combination Window
Finding Elements in the Modules Pane
Filtering Elements in the Modules Pane
Using the Filter Explorer
- or –
Deleting Folders
To delete a folder:
1 In the Combination Explorer window, highlight the folder you want to delete
2 Click with the right mouse button and, from the menu that appears, click Delete.
- or –
5 Click OK.
6 If the selected folder has child folders, you will be asked if you want to apply
changes to all child folders. This enables you to lock all of the child folders of an
Admin Folder. Click Yes to apply changes, otherwise click No.
To unlock a folder:
Follow the previous steps and clear the Admin Folder check box.
Click the Run All Modules button to view data for all the modules in the
combination
5 If you want to view a single module, select it in the Module pane and click the
Run Highlighted Module button .
3 To save the window, click the Save button , type a name and description in the
Save Module Combination dialog box and click Save.
Note : Removing a module from a combination window does not delete that module
from the Module Explorer.
Tip : Use the Shift and Ctrl keys to select more than one combination at a time.
3 Click the right mouse button, and from the menu that appears, click Copy.
4 Select the folder that you want to copy the combination window(s) to.
5 Click with the right mouse button, and from the menu that appears, click Paste.
The combinations are copied to the specified folder.
• If you do not know where the element appears in the module tree, you can search
for it within one module or across all modules. For more information, see Finding
Elements in the Modules Pane on page 94.
• You can apply a filter to select a defined group of elements within the modules.
For information, see Filtering Elements in the Modules Pane on page 95.
Tip: You can select or clear all the elements under each network element by clicking
with the right mouse button on the element name and, from the menu that appears,
clicking All or Clear All.
When you have selected the network element(s):
Click the Run All Modules button or the Run Highlighted Module button
to refresh the data based on this filtering.
3 Click the Run All Modules button or the Run Highlighted Module button
to refresh the data.
Data for the period that you specified is displayed. The dates you set are saved for
this window and you can save different dates for each window separately unless
you have linked to the global clock.
Filters are found in the Custom Filter pane. If the pane is hidden, click on the title bar
to display it.
You can create custom filters in the Filter Explorer. For more information see Creating
Filters in the Filter Explorer on page 100.
Note : You cannot create ENTERPRISE filters in OPTIMA Lite.
Tip : If you have already set a threshold for the field, you can use this instead of
setting a new threshold. To do this, select the Use Existing Threshold check box
and choose the required threshold from the list.
5 Click OK to save the threshold and return to the Create Filter Wizard.
6 Click Next.
The values that will be included in the filter are listed in the Filter Values pane.
7 In the Save Filter As pane, select the appropriate check boxes to define the filter
type, and then click Next.
8 Check that the filter details are correct. If not, click Back to go back and correct
them, otherwise click Finish.
The filter is now available from the list of filters that appear in the Custom Filter
pane.
Applying a Filter
To apply a filter that has already been created:
1 In the Custom Filter pane, select the filter from the Filter Name menu.
2 Select if you want to apply the filter to All Modules or just a Selected Module. To
apply the filter to a selected module, ensure the module is highlighted in the
Modules pane.
Customising Grids in
OPTIMA
You can show data in grid format when you run either:
• A performance alarm in the Alarm Explorer
• A module in the module combination window
• A query in the Data Explorer
For modules, a separate grid is displayed for each module in the combination
window. You can switch between grids by clicking the appropriate tab above the
grid:
Many of the tools used are found by clicking with the right mouse button on the grid.
When a grid contains a large number of records some of the tools, such as filtering
and grouping, may slow down the speed with which data is shown in the grid. This is
due to the background processing of these tools. You can prevent this slow down by
disabling these tools after a given number of records are returned from a query. For
more information, see Setting Grid Preferences on page 22.
Move a column to the beginning Select the column from the list and click the Move to First and Move to Last
or end buttons as appropriate
Change the width of the column Double-click on the column you want to modify and, in the Column dialog
box, type the width you want the column to be.
– or –
Select the column to which you want to make changes and click the Edit
button. In the Column dialog box, type the width you want the column to be.
– or –
Click in the Width column next to the column to which you want to make
changes and type in the width you want the column to be.
Hide or show a hidden column Select the check box in the Show column for each column to want to display.
You can Show All, or Hide All, by clicking the Show All or Hide All buttons.
Tip : You can also use shortcuts to quickly edit columns. For more information, see
Shortcuts for Changing Column Settings on page 109.
5 Click the button to set the conditional fonts. You can set the colour, size and
font type.
6 Click OK to close the Font dialog box and then click OK to close the Column
dialog box.
Note : You can set up to three threshold for each column.
Refreshing Data
The Refresh data option is used to update data in the grid to show the most recent
query run.
To refresh data:
Click with the right mouse button on the grid and, from the menu that appears,
select Refresh Data.
- or -
2 In the Search On box, from the menu select the item that you want to find.
3 In the For box, type a value or element name as required.
4 Select the check boxes if you want to find a Partial Match and/or you want your
search to be Case Insensitive.
Note : If you search for a partial match of CELL and 301, the search would return all
cells containing the number 301. That is 30100, 30101, 40301 and so on.
5 Click Find to start the search.
The grid scrolls and the line that contains the nearest match to your search is
indicated with an arrow:
To remove a filter:
Click the blue arrow on the heading of the column from which you want to
remove the filter and then click All.
You can limit number of values that are listed by editing your user preferences. For
more information, see Setting Grid Preferences on page 22.
3 To select an operator, click on the default operator and from the list that appears
select the appropriate operator.
4 To select a value, click Empty and type a value. If the value is a date, click the
arrow in the value box and a calendar appears from which you can select a date.
5 Repeat the above steps until you have defined your filter.
6 Click Apply to view the grid with the filter applied.
7 Click OK to apply the filter and close the Filter Builder.
Summarising Data
OPTIMA enables you to summarise the data contained in the grid.
You choose at least one column by which you wish to group the data for example
BSC, the data in this column cannot be summarised. You can then summarise each
column by one summary type, that is either count, average, minimum, maximum or
total. For example:
4 In the Grid Details window, you can manipulate your data in the following ways:
Manipulation To Do This
Move the position of data Click the data you wish to move and drag it to the required position.
Sort the details by Field name or Click on the Field name or Data header box to sort the details. Click again
Data to view the details in descending order.
Delete a piece of data Click with the right mouse button on the data and from the menu that
appears, click Delete.
Note : Deleting data in this way removes it from the Grid Dialog Box only;
it still remains in the Cell Statistics window.
Print the data In the Grid Details window, click with the right mouse button and, from the
menu that appears, select Print or Print Preview.
Note : This will only print data for this network element.
Using Graphs
When you run a module in the module combination window, the data is shown in
grid and graph format. This Chapter describes the tools you can use to customise the
graph.
Many of the tools used are found by clicking with the right mouse button on the
graph.
In This Section
About the Tools for Customising a Graph
Changing the Appearance of Graphs
About the Navigating Tools
About the Appearance Tools
Forecasting and Extending Trends on a Graph
Printing and Exporting Graphs
About the Series List
By selecting Toolbar, you can display all the options from the menu as a toolbar. This
picture shows the sections of the toolbar that appears:
Rotating a Graph
You can rotate graphs using the rotating tool. To do this:
1 On the graph, click with the right mouse button and then from the menu that
appears, select the Rotate button.
- or -
Select the Show Weekend button or Show Holiday button from the
toolbar.
To remove the points from the graph, click the Show Weekend or Show Holiday
buttons.
2 On the graph, click with the right mouse button and from the menu that appears,
select Extend trends.
- or -
Printing a Graph
To print a graph:
1 On the graph, click with the right mouse button and from the menu that appears,
select Print Preview
- or -
3 If you want to save the graph to the Clipboard, click Clipboard. The graph is
saved to the clipboard.
4 If you want to export the graph to a File, click File and in the Save as window that
appears, browse to the appropriate folder and save your graph.
5 If you want to export the graph via email, click Email and in the Choose profile
dialog box, ensure the profile is correct and click OK. The graph is added to a
blank email as an attachment.
6 When you have completed your export, in the Export dialog box, click Close.
Series List
You can show and hide the series list. To show or hide the list:
Click with the right mouse button on the graph, from the menu that appears click
Series List.
To view the series list tool menu:
1 Click with the right mouse button on the series list.
This menu appears and is split into two sections:
2 Use the Select all option to select all the data in the series list and the Unselect all
option to deselect the data.
From the series list you can:
• Order data in the series list
• Move series along the z axis when viewing a graph in 3D
• Change the colours used on the graph
• Change the axis where data appears
• Access extra functions if the graph is a line graph
In This Section
About the Work Area Toolbar
Creating a New Work Area
Adding and Removing Combinations
Adding and Removing Web Browsers
Refreshing Data and Switching Tabs
Loading a Work Area
You can use the options available from the toolbar to customise your work area. For
more options when you have a work area open, click with the right mouse button on
the work area and, from the menu that appears, select the appropriate action.
Removing a Combination
To remove a combination from the work area:
1 Click with the right mouse button on the combination tab you want to remove
and, from the menu that appears, select Remove Combination.
- or -
Click on the combination tab you want to remove and click the Remove
Combination button .
2 In the Confirm dialog box, that appears, click Yes.
The combination is removed from the work area.
3 Click the Save button on the work area toolbar to save your changes.
Refresh Option
To turn the Refreshing data option on or off:
Switching Option
To turn the Switching option on or off:
3 On the work area toolbar, click the Load work area button.
4 In the Open window select the relevant work area file and click Open.
The work area is loaded along with any switching and refreshing procedures
previously set up for that work area.
In This Section
Displaying Performance Data on the Map
Changing the Display of Performance Data
Using the Clock to Display Performance Data
4 Expand the appropriate schema and table and then select the counters that you
want to display on the map.
5 Click with the right mouse button on the map and click Refresh to redraw the map
and show the performance data that you selected.
This picture shows an example.
1 In the Map View window, click the Show Data Types button .
2 Expand the Performance Data category.
3 Double-click the counter whose display you wish to change. The Display
Properties dialog box appears.
Playing Data in 2D Map – Increment The size of the interval you want between each data display. For example, to see the
by: data at 0000, 0200 and 0400, you would select a step of 2 hours.
Playing Data in 2D Map – Every: How quickly you want the map to refresh with the data you have specified. For example,
if you refresh the map view every minute, it gives you a minute to analyse the data
before it changes.
2D Map Switching – Every: How often you want to switch between maps.
3 When you have selected the step and period value, click Play. The performance
data displayed on the map will alter accordingly.
You can save a report as a favourite and then have quick, easy access to that report
from the Favourites toolbar. For more information, see Adding and Editing
Favourites in OPTIMA on page 91.
The report system uses the following report applications:
• ReportBuilder, which is a third party report application that is fully integrated
with OPTIMA. For more information, see Creating Reports Using Report Builder
on page 155.
Note : Detailed information on ReportBuilder and how to use it can be found on
the Digital Metaphors website at www.digital-metaphors.com. Digital Metaphors
supply a document called Learning ReportBuilder, which is available for
download from their website.
• OPTIMA Excel Report Editor, which enables you to create and edit Microsoft®
Excel™ reports in OPTIMA. For more information, see Creating Excel Reports on
page 175.
In This Section
Download Learning ReportBuilder
About Using OPTIMA Reports
Scheduling When Reports Run
ENTERPRISE link .
2 On the page that is displayed next, select Learning ReportBuilder from the list of
options in the left hand pane.
You can now download the Learning ReportBuilder document, in PDF format.
Deleting Folders
To delete a folder:
1 In the Report Explorer window, highlight the folder you want to delete.
2 Click with the right mouse button and, from the menu that appears, click Delete.
- or –
5 Click OK.
6 If the selected folder has child folders, you will be asked if you want to apply
changes to all child folders. This enables you to lock all of the child folders of an
Admin Folder. Click Yes to apply changes, otherwise click No.
To unlock a folder:
Follow the previous steps and clear the Admin Folder check box.
Viewing Reports
To view a report:
1 From the Reporter menu, click Report Explorer.
- or –
Click with the right mouse button on the report, and from the menu that
appears, click Open.
The Report Designer window has three tabs, which are described in the following
table:
Use This Tab: To:
Data Select and manipulate the data required for a report. For more
information, see Defining Queries on page 156 and Editing
Queries on page 163.
Design Design the layout of a report. For more information, see Designing
Reports on page 164.
Preview See how a report will look when it is printed.
2 In the New Items dialog box that appears, select Query Wizard and then click OK.
3 On the first page of the Query Wizard, in the left-hand pane, select the table that
you want to query and click the > button.
4 Click Next.
6 Click Next.
7 On the third page of the Query Wizard, you can add calculations to the fields
selected in Step 5.
To add a calculation to a field:
1. Select the Add Calculations radio button.
2. In the left-hand pane, select the field you want to add a calculation to and click
the > button.
3. In the dialog box that appears, select a function from the Function drop-down
list and a field from the Numeric Field drop-down list.
4. Click OK. The calculation is added to the right-hand pane.
5. To add another calculation, repeat steps 2 to 4.
If you do not want to add any calculations, select the No Calculations radio
button.
8 Click Next.
9 On the fourth page of the Query Wizard, you can group rows together based on
common field values. The following table describes the two grouping options:
Select This Radio Button: If You Want To:
No Grouping Have no grouping.
Select Group Fields Select the fields to group by.
To select a field, select it in the left-hand pane and click the > button.
12 Click Next.
13 On the sixth page of the Query Wizard, you can set the row order based on the
field values. The following table describes the two row order options:
Select This Radio Button: If You Want To:
Natural Order Use the natural row order.
Set Order Set your own row order.
To set the row order:
1. In the left-hand pane, select the row that you want to be first in the
order and click the > button.
2. In the left-hand pane, select the row that you want to be next in the
order and click the > button.
3. Repeat step 2 until there are no more rows in the left-hand pane.
14 Click Next.
15 On the final page of the Query Wizard, type a name for your query and select one
of the options described in the following table:
Select This Radio Button: If You Want To:
Return to Data Workspace To be returned to the data workspace when you have finished.
Preview this Query Preview the data returned by your query when you have finished.
Modify the Query's Design Modify your query using the Query Designer when you have finished.
16 Click Finish to save your query and close the Query Wizard.
Example Query
2 In the New Items dialog box that appears, select Query Designer and then click
OK. The Query Designer window appears. This picture shows an example:
Tip : To remove a table, double-click the table in the Selected Tables list.
4 On the Fields tab, in the Available Fields list, double-click the fields you want to
query. The fields are added to the Selected Fields list. This picture shows an
example:
Tip : You can add all of the fields to the Selected Fields list by selecting the All
Fields check box.
5 On the Calcs tab, you can add calculations to the fields selected in Step 4.
To add a calculation to a field:
1. In the Available Fields list, double-click the field you want to add a calculation
to. The field is added to the Calculations list.
2. In the Calculations list, select the field.
3. Select a function from the Function drop-down list. If you want to use a user-
defined expression, select Expression from the Function drop-down list and
then type the expression in the Expression field.
This picture shows an example of the Sum function:
Tip : To use the order of the rows stored in the OPTIMA database, select the
Natural Order check box.
9 On the SQL tab, you can view and manually edit the SQL of your query.
Note : Once you have manually edited a query, you can no longer use the Query
Designer tabs to edit your query.
To manually edit a query:
1. Click with the right mouse button on the SQL and, from the menu that
appears, click Edit SQL.
2. Click Yes to confirm. The SQL becomes editable.
10 Click OK to save your query and close the Query Designer.
The Data Component toolbar contains data aware components. You use these
components to display actual data from the OPTIMA database. This picture shows an
example of the Data toolbar:
For more information about designing reports using ReportBuilder, see the Digital
Metaphors website at www.digital-metaphors.com.
Tip : To rename the series, click Title and, in the dialog box that appears, type a
new name and then click OK.
8 Click the Series tab and then click the Data Source sub-tab.
9 On the Data Source sub-tab, select Data Pipeline from the drop-down list. This
will enable you to link a query to the series.
10 From the Data Pipeline drop-down list, select the query that you want to link to
the series.
DateTime Select this check box if you want to display the date and time on the y axis.
12 Click Apply.
13 If you want to add another series to your graph, repeat steps 5 to 12.
14 Click the Chart tab and then click the Titles sub-tab.
6 Click OK.
7 Close the Report Designer and click Yes to save your changes.
Now when you run the report, you will be asked to specify filter value(s) based on
the criteria you have set. For more information about filter values, see Adding
Filter Values on page 173.
3 Click OK to close the Search dialog box and run the report with the specified filter
value.
4 To add an available element to the search values, click the right arrow button.
Tip : To add all of the available elements to the search parameters, click the double
right arrow button.
5 Click OK.
The selected filter elements appear in the list of search values. This picture shows
an example:
6 Click OK to close the Search dialog box and run the report with the OPTIMA
Filter.
3 On the Report Information tab, type a name and description and select the
Enabled check box.
Important : Ensure the Enabled check box is selected otherwise the report will not
run.
Click with the right mouse button on the report, and from the menu that
appears, click Open.
Editing Reports
To edit a report:
1 From the Reporter menu, click Report Explorer.
- or –
Renaming Reports
To rename a report:
1 In the Report Explorer, click with the right mouse button on a selected report, and
from the menu that appears, click Rename.
2 Type in the new name for the report and press Enter.
Deleting Reports
To delete a report:
1 In the Report Explorer, highlight the report you want to delete
2 Click with the right mouse button, and from the menu that appears, click Delete.
– or –
Tip : Use the Shift and Ctrl keys to select more than one report at a time.
3 Click the right mouse button, and from the menu that appears, click Copy.
4 Select the folder that you want to copy the report(s) to.
5 Click with the right mouse button, and from the menu that appears, click Paste.
The reports are copied to the specified folder.
Printing Reports
To print and print preview reports, you must have OPTIMA_Administrator or
OPTIMA_Advanced_User permissions.
To print a report:
1 From the Reporter menu, click Report Explorer.
- or –
Importing Reports
To import a report:
1 In the Report Explorer, select the folder into which you want to import the
report(s).
Note : If you are exporting an Excel report, the Excel File radio button is pre-
selected for you.
4 If you want to zip the report, select the Zip File Before Exporting check box.
5 If you want to export the report to file, click File and in the Save As dialog box that
appears, browse to the appropriate folder, type a name, and click Save.
6 If you want to export the report via email, click Email and in the blank email that
appears, type the email addresses and click Send.
7 When you have finished, click Close to return to the Report Explorer.
Deleting Folders
To delete a folder:
1 In the Schedule Explorer window, highlight the folder you want to delete.
2 Click with the right mouse button and, from the menu that appears, click Delete.
- or –
5 Click OK.
6 If the selected folder has child folders, you will be asked if you want to apply
changes to all child folders. This enables you to lock all of the child folders of an
Admin Folder. Click Yes to apply changes, otherwise click No.
To unlock a folder:
Follow the previous steps and clear the Admin Folder check box.
Editing Schedules
To edit a report schedule:
1 In the Schedule Explorer, double-click the report you want to edit. The Schedule
Editor is displayed.
2 Amend the details and click OK to save the changes.
Renaming Schedules
To rename a schedule:
1 In the Schedule Explorer, double-click the schedule you want to rename.
2 In the Schedule Editor, select the General tab and delete the current schedule
name and insert the new schedule name.
3 Click OK to save the changes.
Deleting Schedules
To delete a schedule:
1 In the Schedule Explorer, highlight the schedule you want to delete
2 Click with the right mouse button and from the menu that appears, click Delete.
– or –
Copying Schedules
If you have OPTIMA_Administrator or OPTIMA_Advanced_User permissions, you
can copy existing report schedules and then modify them.
To do this:
1 From the Reporter menu, click Schedule Explorer.
-or -
In This Section
About Alarm Settings
About Alarm Filters
About Ripple Counts
Defining an Alarm
Assigning Alarms to Contacts
Viewing, Clearing and Resetting Alarms
Viewing and Clearing Alarm Definitions
Viewing and Clearing Alarms History
Customising Alarm Information
Configuring Vendors
In the Vendor Settings dialog box you can add, edit or delete the vendors that you can
use when creating an alarm.
To add a vendor:
1 In the Alarms Explorer, from the Vendor menu click View.
2 In the dialog box that appears, click Add.
3 Type the name of the vendor and click OK.
To edit a vendor name:
1 In the Alarms Explorer, from the Vendor menu click View.
2 Select the vendor and click Rename
- or –
Double-click the vendor name.
3 Type in the new name for the vendor.
To delete a vendor:
1 In the Alarms Explorer, from the Vendor menu click View.
2 Select the vendor and click Delete.
3 Click Yes to confirm.
6 Click Save.
To edit a filter:
1 In the Filter_ID Settings dialog box, select a filter and click Edit
- or –
Double-click the required filter.
2 Edit the code for the filter and click Save.
To delete a filter:
1 In the Filter_ID Settings dialog box, select a filter and click Delete
2 Click Yes to confirm.
2 In the Alarms Explorer, click the Create New Alarm Definition button .
- or –
In the Alarm Definitions pane, click with the right mouse button and from the
menu that appears, click Add Definition.
The Alarm Definition dialog box appears.
3 On the Information tab, type the alarm name and add a description.
4 On the Settings tab:
In This Pane Do This
Alarm Polling Set the rate at which information from the network is tested against the alarm thresholds. To
do this:
1 From the Next Polling Date Time menus, select a date and a time from which to
run the alarm.
2 From the Alarm Polling Interval menu, select the polling interval frequency and time
duration.
Ripple Counts Select the ripple counts that will define the thresholds. For more information, see About Ripple
Counts on page 196.
Alarm Severity Select the severity levels for your alarm from the list available.
Vendor, Technology, Select a vendor, technology and element type. For more information, see About Alarm
Element type Settings on page 192.
Probable Cause Select a probable cause for your alarm from the list available.
SNMP Select the Forward SNMP Traps check box if you want SNMP traps to be forwarded to a third
party fault management system.
7 When you have defined both SET and CLEARED alarms, you can activate the
alarm. For more information, see Activating an Alarm on page 199.
2 In the Alarms Handler Explorer, click the Create New Alarm Handler button .
- or –
In the Alarm Handler pane, click with the right mouse button and from the menu
that appears, click Add Handler.
The Alarms Handler dialog box appears.
3 On the Information tab, type the handler name and add a description.
4 On the Settings tab:
In This Pane Do This
Alarm Handler Choose which alarm you want a contact to be notified about:
1 Click Select.
2 From the list that appears, select an alarm and click Select.
Note : You can only choose one alarm in an alarm handler.
Notification Type Select how you want the contact to be notified when the alarm is raised.
If you want the contact to receive an alert for each element within the alarm, select the Send
Multiple Notifications Per Email and/or SMS check box.
Note : You should only use this option if the alarm is monitoring a small number of elements.
Amend Alarm Type Select the Apply Handler on CLEAR Alarms check box if you want the contact to be notified
when an alarm is cleared. The contact will also be notified if the alarm is cleared by the
OPTIMA_ Administrator.
Template You do not need to change the report format type.
Alarms Tab
Viewing Alarms
The following information is shown in the Alarms tab:
• Description of the alarm.
• Element type, for example Cell.
• Element ID.
• SQL Date Time, this is the date and time of the data that generated the alarm.
• Alarm Date Time, this is when the data was queried by the alarms program.
• Vendor, Technology and Severity as selected when the alarm was defined.
• Problem Text.
• Forwarded value. The following table describes the two possible Forwarded
values:
Forwarded Value: Description:
0 Alarm has not been forwarded to the FMS by the SNMP program.
1 Alarm has been forwarded to the FMS by the SNMP program.
Tip : You can customise the way alarm information is displayed by using the tools
menu. For more information, see Customising Alarm Information on page 207.
You can show the toolbar above the grid by pointing to Toolbars and from the menu
that appears select Toolbar. The toolbar duplicates the options in the popup menu:
Index viewing • 82
Copying
combination windows • 88
modules • 76
reports • 181
schedules • 188
Counter types, adding
global • 44
A raw • 43
Viewing • 15
Adding viewing on the map • 145
alarms • 197, 200 Creating
combination windows to a work area • 141 alarms • 197
favourites • 91 combination windows • 83
holidays • 55 custom filters • 95
modules to a combination window • 83 folders • 70, 80, 153, 185
web pages to a work area • 142 KPIs • 37
Alarm definitions links between modules • 84
clearing • 204 new work area • 140
viewing • 204 queries • 63
Alarms report schedules • 186
about • 191 reports • 155, 175
activating • 199, 201 Users • 31
clearing • 202 Custom Filters • 95
defining • 197
deleting • 199
editing • 199 D
resetting • 202
Data
viewing • 202
gathering • 61
Alarms history
grids • 103
clearing • 205
monitoring with alarms • 191
viewing • 205
setting-up • 61
sorting • 105, 106
B summarising • 115
viewing on the map • 146
Busy Hour Data Explorer
about • 56 about • 20
capture settings • 57 adding filters • 66
setting • 56 defining queries • 63, 64, 66
searching • 63
C using • 62
Date Range • 93
Capture Settings • 57, 58 Defining
Categories • 48, 51 associations for a table • 49
Clearing Deleting
alarm definitions • 204 KPIs • 39
alarms • 202 report schedules • 188
alarms history • 205 reports • 180
Clock Drill Down Links • 84
offsetting • 17
play data • 149
setting global date • 16 E
viewing data on the map • 149 Editing
Combination Window KPIs • 39
adding to work area • 141 report schedules • 188
copying • 88 reports • 180
creating • 83 Element IDs • 59
data grids • 103 Excel Reports
deleting • 84 creating • 175
exporting • 89 viewing • 178
T
Table and Field Information
about • 45
adding comments to columns • 50
adding comments to tables • 50
assigning categories • 48
defining associations for a table • 49
setting granularity period • 48
setting table security • 47
using the Settings Wizard • 46
Table associations, defining • 49
Table Security, setting • 47
Tables
synchronising • 40
Thresholds
Thresholds • 109
Toolbar
favourites • 13
grids • 104
OPTIMA • 12
Tree Links • 84
U
User Permissions
about • 26
creating • 31
Using
custom filters • 95
Data Explorer • 62
OPTIMA • 9
OPTIMA Lite • 9
quick selection filters • 98
reports • 152
work areas • 139
using windows in the work area • 139