UG - Imonitor User Guide IDX 2.0 - Rev C - 012110
UG - Imonitor User Guide IDX 2.0 - Rev C - 012110
UG - Imonitor User Guide IDX 2.0 - Rev C - 012110
List of Figures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x
List of Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
Purpose
The iMonitor User Guide provides detailed instructions for monitoring your iDirect networks
using the iMonitor client application of the iDirect Network Management System (NMS). For
details on configuring your iDirect networks, see the iBuilder User Guide.
Intended Audience
The iMonitor User Guide is intended for network operators, network architects, and other
personnel who operate or monitor iDirect networks. It is not intended for end users or field
installers.
Basic knowledge of TCP/IP concepts, satellite communications, and the Windows operating
systems is expected. Prior experience operating an iDirect network, although desirable, is not
required.
Getting Help
The iDirect Technical Assistance Center (TAC) is available to help you 24 hours a day, 365 days
a year. Software user guides, installation procedures, a FAQ page, and other documentation
that supports our products are available on the TAC webpage. Please access our TAC webpage
at: http://tac.idirect.net.
If you are unable to find the answers or information that you need, you can contact the TAC at
(703) 648-8151.
If you are interested in purchasing iDirect products, please contact iDirect Corporate Sales by
telephone or email.
Telephone: (703) 648-8000
Email: [email protected]
iDirect strives to produce documentation that is technically accurate, easy to use, and helpful
to our customers. Your feedback is welcomed! Send your comments to [email protected].
iMonitor is a component of the iDirect iVantage Network Management System (NMS). The
iVantage NMS is a complete suite of tools for configuring, monitoring, and controlling your
iDirect satellite network.
The iVantage NMS consists of the following components:
iBuilder enables rapid, intuitive configuration of any iDirect network. It allows you to
easily add components to your network, change your current configuration, and download
configuration and software to network elements. The iBuilder Revision Server provides
automated management of software and firmware upgrades for your remote modems.
The iBuilder Group QoS (GQoS) user interface allows advanced network operators a high
degree of flexibility in creating subnetworks and groups of remotes with various levels of
service tailored to their network requirements. The iBuilder User Guide provides detailed
instructions for using iBuilder to configure and manage your network.
iMonitor provides network operators with detailed information on real-time and
historical performance of the network. Among its many capabilities, iMonitor allows you
to analyze bandwidth usage; view remote status; view network statistics; monitor
performance of networks, sub-networks and individual network elements; and manage
alarms, warnings and network events. Alarms, warnings and statistics can be forwarded as
SNMP traps. All events and performance statistics are automatically archived. Data
displayed on the iMonitor GUI can be exported directly into Excel for further analysis. A
Network Probe allows detailed investigation of network issues. The iMonitor User Guide
provides instructions for using iMonitor.
iSite allows you to monitor and configure iDirect devices in the field. It includes several
features that aid in the remote commissioning process, including assistance for antenna
pointing, antenna look angle calculation, and cross polarization. You can also use iSite to
configure and manage point-to-point SCPC connections between dedicated remotes. An
iSite API is available for custom development. For further information on these topics, see
the Installation and Commissioning Guide for iNFINITI remotes and the iSCPC User Guide.
iDirects Network Management System (the iVantage NMS) is a powerful suite of applications
and servers that provide complete control and visibility to all components of your iDirect
networks. The NMS client/server system architecture consists of three series of components:
Three NMS applications with Graphical User Interfaces (GUIs) that allow you to configure
and monitor your network
A database that stores the data entered by and displayed to users
A middleware tier that manages access to the database on behalf of user operations
For a description of all iVantage NMS components see the The iVantage Network
Management System on pagexxi.
Note: iDirect Mesh and iSCPC are not supported in iDX Release 2.0.
1.1 Introduction
This chapter provides some of the most important information you will need to understand
how iMonitor works and how to use it as effectively as possible. This chapter discusses how to
prepare for installation, what you will see when you first launch iMonitor, how to use the
many powerful tools available in iMonitor, how to create, customize, and print reports, and
how to determine the configuration status of network elements.
iMonitor provides complete visibility to real-time status and operational characteristics of
network elements.
Status refers to the real-time state of network elements (such as OK, Warning, Alarm).
iMonitor notifies you asynchronously of warnings and alarms for all network elements,
which are collectively called conditions.
Operational characteristics are captured in a variety of network statistical data, such as
IP traffic statistics, satellite link quality, and hardware component operating values.
You can also obtain and view data stored in the historical archive, which allows you to analyze
anomaly conditions and perform trend analysis.
iBuilder
The iBuilder application provides all configuration and control functions to network
operators. Configuration options consist of creating network elements (e.g. networks, line
cards, remotes) and specifying their operational parameters, such as QoS profiles or IP
addresses. Control options consist of applying the specified configurations to the actual
network elements, retrieving active configurations, resetting elements, and upgrading
element software and firmware. Refer to Network Management System iBuilder User Guide
for more information.
iMonitor
The iMonitor application provides complete visibility to the real-time status and operational
data of network elements. Status refers to the real-time state of network elements, such as
OK, warning, or alarm. Operational data are captured in a variety of network statistical data
tables and displays, revealing, for example, IP traffic statistics, satellite link quality, and
hardware component operating values.
In addition to real-time visibility, iMonitor allows you to access state and statistics from the
historical archive in order to analyze anomaly conditions and perform trend analyses. This
guide has a complete list of real-time and historical data available through iMonitor.
iSite
The iSite application is used primarily for commissioning new sites and monitoring TDMA
remotes from the local LAN side. It contains functions to help installers calculate antenna
azimuth/elevation, perform antenna pointing, and put up a continuous wave (CW) carrier for
antenna peaking, cross-polarization and 1 db compression tests. It also provides configuration
and real-time state/statistical information for one or more remote units. Instead of
interacting with the NMS middleware, it connects directly to each remote to perform all of its
operations. iSite does not provide access to historical information. See the Remote
Installation and Commissioning Guide for more on commissioning iNFINITI remotes using iSite.
In addition to its commissioning functions, iSite can be used to configure and monitor remote-
to-remote SCPC connections. It also allows monitor-only capability to end-users, should you
decide to provide it to them.
Note: End-users do not need iSite in order to receive or transmit IP data over the iDS
system.
For more information about NMS applications, see The iVantage Network Management
System on pagexxi.
Configuration Server
The configuration server is the core component of the NMS server family. It manages access to
the configuration database, which contains all the element definitions for your networks and
their operational parameters. Additionally, the configuration server provides most network
control functions (configuration apply, firmware download, resetting, etc.). The other servers
also use this server to determine what the network components are.
Event Server
The event servers primary job is to generate warnings and alarms and send them to iMonitor
for display. Warnings and alarms are collectively known as conditions. The event server also
collects and archives all system events and provides them to iMonitor for display.
Latency Server
The latency server measures round-trip time, or latency, for every active remote in your
networks. These measurements are stored in the archive and provided to iMonitor for display.
PP Controller Servers
The PP Controller processes control the samnc process on each PP blade.
Consolidation Script
The consolidation process periodically consolidates records in the statistics archive to
preserve disk space on the server machine. Default consolidation parameters are already
entered into your configuration database; they can be tuned to your particular storage
requirements if necessary.
Note: The Geographic Map is a licensed feature. Please contact your iDirect sales
representative for pricing and ordering information.
To support this feature, your client PC or laptop should meet the following requirements:
1.6 gigahertz (GHz) Pentium processor or higher
Microsoft Windows XP, Service Pack 2
512 megabytes (MB) of RAM or more
At least 1 gigabyte (GB) of free disk space
Note: Do not change the name of the map license file. The license file name must be
nmssver_e.lic for the Geographic Map software to operate.
It is not necessary to restart any of the NMS servers; the new license will be enabled
immediately.
3. Click Server and select the IP address or host name of your primary NMS Server machine.
The Server box holds up to three IP addresses. If yours does not exist, enter the IP Address
in the Server box.
4. Click OK to complete the login process.
Note: The NMS server version must match the iMonitor version in order for you to log
in. For example, version 8.0.0 of iMonitor may connect only to version 8.0.0 of
the NMS servers.
The iMonitor application automatically connects to the NMS server processes that are
required to perform the NMS functions. If this connection is lost for any reason, iMonitor
automatically reconnects to the servers when they become available.
Off to log out of your current session and File J Log On to open the Login Information dialog
box again.
Before you accept the changes, you may view the other users changes by selecting View J
Configuration Changes (see Configuration Changes Pane on page26). To accept the
changes and update your view of iMonitor, click Accept Changes. Any modifications the other
user has made are now displayed in your copy of iMonitor.
All future requests will automatically use the time range you just saved, until you take
down the time range by clicking on the pushpin again.
Right-Clicking
In general, you must right-click on your mouse or use the task bar to display any list of options
in submenus that can be performed on the element you currently have selected.
To dock a window pane somewhere else on the NMS interface or on your monitor, follow the
procedure below:
1. Point to and right-click the double-ridge lines of the pane you want to move and select
Allow Docking.
2. Place the pointer (mouse arrow) on the double-ridge lines and drag the pane wherever
you want it. Depending on where you drag it, the pane may change shape (for example,
from a vertical display to a horizontal display).
3. If you want to move the pane back into its original place or to another location, start by
grabbing the double-ridge lines with your pointer. Then, you can click the Name toolbar
at the top of the pane to move it around, and you can place your pointer at the edges of
the pane to resize the pane.
4. To detach the pane completely, double-click the double-ridge lines. The pane becomes
separately parented and you may move it independently from the main iMonitor window.
Hiding Elements
You can click Hide to remove the iMonitor Network Tree from view.
Figure 8. Expand Tree Selection Figure 9. Expanded Tree with Child Elements
Sorting Columns
In any pane with columns or list controls, you can sort the entries in the pane by clicking on
the heading of the given column.
4. Click the Sort items by drop-down list and select one of the options. Depending on what
you select in this field, your choices in the Apply sort to field will change.
5. If you select Name, either click the Names are case sensitive check box or clear it.
6. Select the element to which you want to apply the Sort feature. The options are:
Remote
Hub
Inroute Group
7. Click OK. The next time you log in, iMonitor will remember and display the last sort
preference you chose.
A minus sign (-) next to an element indicates that the element has been expanded and
children are visible at the next level, or branch, in the Tree.
In the figure below, the UAT-RF Network has been expanded as far as possible. The UAT-RF
Network cannot include children in another network; therefore, its only children are the TxRx
and Rx line cards, and the IG_1_UAT-RF Inroute Group. The Inroute Group is a parent element
that can be expanded by clicking its plus sign (+) to reveal its children elements at the next
level of the Tree.
Title Bar
The Title bar identifies the name of the application (in this case, iMonitor), the iDS software
version, and the IP address of the server to which you are connected.
Menu Bar
The Menu bar at the top of the display provides access to log in, log out, quit, and other high-
level functions.
Toolbar
The main Toolbar (Figure 16) contains context-sensitive buttons, allowing you to perform a
variety of operations on a currently-selected element without using its context menu. Their
functions are described in Table 1.
Allows you to view Conditions. The Conditions pane has two tabs you can select to
view different aspects of the conditions: Conditions Log and Observation View. See
Conditions Pane on page33 for more information.
Allows you to turn audio on or off when a new alarm or condition is presented or
when a condition is cleared.
Allows you to accept any changes made to the system by another user. This does
not mean that you approve of or agree with the changes; it simply updates your
GUI with the latest database information.
Allows you to view the version number of the NMS and system information.
Audio Notification
You can choose to turn on audio notification to alert you whenever a new alarm or condition is
raised. When you select audio notification, you are only notified of newly-raised conditions by
default. When you acknowledge conditions, the audio notification will stop, even if the alarm
has not yet cleared.
To configure audio notification, select ResultsJAudio Notification from the main menu. You
can select any of the three conditions under which you would like to have an audio
notification raised.
You may select one, two, or all three. If you wish to have no audio notification, select None.
To set up how often you want the audio notification to be repeated, or to specify that the
notification should play only when a new condition occurs, select ResultsJAudio Notification
J Properties from the main menu. Then configure one of the two choices in the Audio
Notification Properties dialog box (Figure 19).
Acknowledging Conditions
You can also use iMonitor to acknowledge all conditions. If audio notification is in effect,
acknowledging conditions prevents continuous audio notification, even if the condition that
raised the audio notification has not cleared. Once youve acknowledged conditions, audio
notification will stop until a new condition is raised. When you acknowledge conditions in
iMonitor, all outstanding conditions are acknowledged. You cannot acknowledge individual
conditions.
To acknowledge conditions:
1. If not already visible, open the Conditions pane by clicking the Toggle Conditions icon on
the main toolbar.
2. On the Conditions pane, select the Condition Log tab.
3. Click the Acknowledgement icon on the main toolbar. On the Condition Log tab, a check
is displayed for all acknowledged conditions as shown in Figure 20.
View Menu
The View menu on the main menu toolbar allows you to display or hide the following toolbars
and panes. You can also right-click your context menu button (typically the right mouse
button) to see the same options as those in the View menu.
Find Toolbar
The Find toolbar provides users the option to search the NMS for a given element and display
the results in either the Network Tree View or the Results Window. This becomes
increasingly important as the network grows larger. You can search by selecting a specific
element name in the first drop-down list (note that only elements you have created will be in
the list); by type of element in the second drop-down list; or by Name, IP address or ID
number in the third drop-down list. The figure below shows all of the various options within
each category; however, you can actually only click one drop-down list at time. To display the
Find toolbar, select View J Find Toolbar from the main menu.
You can also click the Find button on the toolbar to open a dialog box that gives you the same
options.
That remote is highlighted in the Tree when the user clicks the binoculars icon on the
toolbar. (See Figure 22 on page 21.)
Workspace Toolbar
The Workspace capability solves one of the biggest problems with real-time monitoring
systems: window real estate. As you launch more and more displays, you may find that youre
quickly running out of space in the results pane and you wish you had a bigger display. The
Workspace Toolbar provides a convenient way for you to organize multiple displays into a
series of virtual workspaces. The four workspaces on this toolbar effectively give you four
times the window real estate without having to add another display.
To launch the Workspace toolbar, select View J Workspace from iMonitors main menu. You
will see four small windows appear on the right-side of iMonitors main tool bar. Each of these
windows represents a virtual workspace where you can launch different displays. When you
click one of the workspace windows, displays you launched on another workspace are hidden
and a new, blank workspace appears. For convenience, each workspace is highlighted in
yellow whenever a display is present on that workspace.
The figure below shows the Workspace toolbar in action. In this example, workspace one
contains one or more displays and the other workspaces are empty. The fifth workspace pane,
when clicked, shows all panes in all workspaces.
Note: Only real-time and Get Past requests are saved in workspace files.
To save the contents of a workspace, select File J Save Workspace As from the main menu.
This operation will save all the displays currently active in the workspace. You may also adjust
the contents of any workspace and re-save it by selecting File J Open Workspace from the
main menu.
To reload a previously-saved workspace, select File J Open Workspace from the main menu.
When you reload a workspace the saved requests will be automatically resubmitted to the
appropriate servers.
This feature works best when you have the iMonitor application maximized on your PC screen,
but will also function properly if the application is not maximized.
Operational Toolbar
The Operational Toolbar (Figure 25) contains context-sensitive buttons, allowing you to
perform a variety of operations on a currently-selected element without using its context
menu. Those functions are described in Table 2.
Request conditions.
Status Bar
The Status bar is located at the bottom of the iMonitor window and displays the user name of
the person who is currently logged in and what their server connection status is. On the
toolbar shown below, the connection status is Ready.
Conditions Pane
The Conditions switch on the View menu opens the Conditions pane. See Chapter 2,
Monitoring Conditions and Events for complete information on the tabs in this pane. Select
View J Conditions on the main menu to open the pane.
Legend Pane
The Legend view displays the Configuration State icons and their meanings. They are
organized by type of element as shown in Figure 28.
1. Right-click anywhere in the column headings to display the column selection context
menu.
2. You can use the menu to select or clear individual columns for display one at a time, or
you can select More to view the Select Columns dialog box.
3. In the Select Columns dialog box, click the check boxes to select or clear the
corresponding columns for display. (You can also select and clear a check box by first
selecting the column name in the list, and then clicking the Show or Hide button.) Only
selected columns will be displayed in the pane.
4. Click Show All or Hide All to select or clear all check boxes.
Note: In some cases, the Select Columns dialog box also contains a Show Default
button (Figure 32). Click that button to select only the default columns.
Figure 32. Select Columns Dialog Box with Show Default Button
2 Monitoring Conditions
and Events
You can view Conditions on every element in the Tree, and you can view Events on every
element except the Chassis. On the Protocol Processor and the Blades, you can further view
Blade Information. Table 4 identifies the types of information iMonitor provides for each
element.
Type of Incident
Elements
Information Provided
Teleport Conditions
Protocol Processor Events/Conditions/Blade Info
Blades Events/Conditions/Blade Info
Network Events/Conditions
Line Card Events/Conditions
Inroute Group Events/Conditions
Remotes Events/Conditions
Chassis Conditions
2.1 Conditions
Conditions in iMonitor are made up of Alarms and Warnings, which are collectively called
conditions. Alarms alert you to an interruption in service, whereas Warnings indicate a
condition that could result in an interruption of service if not handled in a timely fashion.
The Conditions pane has tabs that enable you to view conditions using different criteria, as
follows:
Active Conditions This tab shows all outstanding conditions that have not been
cleared. Any current alarms or warnings are displayed on this tab.
Observation View This tab shows all conditions for specific elements you have put
Under Observation. You put a Protocol Processor, Blade, Line Card or Remote under
observation by clicking the element and selecting Under Observation. You may cancel
the observation view by clicking the element in the tree and switching the Under
Observation control off, or by right-clicking on a specific condition in the Under
Observation tab and selecting Cancel Observation.
Disabled Conditions This tab shows any conditions that have been disabled. You can
disable an active condition by right-clicking the condition and selecting Disable
Condition.
Condition Log This tab shows the 500 most recent condition changes; older changes are
dropped from the display. All conditions shown on the Condition Log tab are sorted by the
time that the condition change occurred. iMonitor no longer groups condition changes.
You can clear the contents of the Condition Log tab as follows:
1. With the Condition Log tab selected, right-click anywhere in the Conditions Pane.
2. Select Clear List from the menu.
Note: SCPC conditions that apply to either network line cards or TDMA remotes also
apply to both iSCPC line cards and iSCPC remotes.
2. Select View J Conditions from the main menu or click the Toggle Conditions icon on the
main toolbar.
3. Click the Observation View tab to view only the conditions (alarms and warnings) for the
element you chose.
Note: If you have previously put another element under observation, without
canceling that observation view, the previous elements information will still
be visible in the pane. To omit the unwanted information, right-click on the
unwanted element and select Cancel Observation.
4. You can right-click the element to either view the elements control panel or cancel the
observation.
5. If you click Cancel Observation, the data in the Observation pane disappears.
6. If you click Control Panel, a pane appears providing more information for you to view
(Figure 36). See Control Panel on page87 for details.
Viewing Conditions
If you want to view conditions, you may want to put an element under observation first. For
information on this, see Putting an Element under Observation for Conditions on page37.
Viewing Events
If you are viewing events, you may want to filter the results. Often its useful to retrieve
certain events over an extended time period for one or more remotes. Although you can
retrieve all events and sort the results to find the ones youre looking for, iMonitor also allows
you to specify a text filter when retrieving historical events. When you specify a text filter,
iMonitor shows you only those events that match the filter.
The text filter is available at the bottom of the historical time range parameters dialog box
(Figure 39 on page42), either prior to retrieving events or from the Time Range button on an
existing events display. The filter values are applied only to the Event Description section of
the event message. The simplest filter string is simply a substring of the event description,
such as server. Any event message that contains your specified substring will be returned
from the server and displayed in the pane. The text field also supports full Linux regular
expression matching, allowing you to apply an arbitrarily complex expression to the event
description text. For more information on regular expressions, see any of the commercially-
available Linux reference books.
Follow these steps to retrieve and view conditions or events for an element:
1. Right-click the element in the tree and select Conditions or Events from the menu. The
Select Items dialog box appears.
2. Click either Historical or Get Past. If you are viewing Events, you can filter the results, or
simply click OK to begin retrieving events in real-time. If you enter a Text Filter in the
Get Past time range dialog box (Figure 39), the filter values are applied only to the Event
Description field of the event message.
a. If you click Historical, click Time Range. The Select Time Range dialog box appears
(see Figure 38 for Conditions and Figure 39 for Events). If desired, click the ellipses
next to the Start Time and End Time to set the time using the graphical clock display.
If you selected Get Past, see Step b.
Figure 39. Events Time Range Dialog Box with Text Filter
b. If you click Get Past, the Get Past drop-down list appears.
3. Select the elements for which you want to view conditions or events.
Depending on what level in the system you chose to obtain information, the options in the
Select Items dialog box will differ in what is available and unavailable for selection.
4. When you have made your selections, click OK.
Depending on whether you chose to view conditions or events, either the
Conditions/Time Line pane appears or the Events pane appears. Follow the directions in
Step 5 for Conditions or Step 9 for Events below.
5. Conditions. If you are retrieving data on conditions, the Conditions/Time Line pane
appears, displaying the conditions logged for the specified period. This data is displayed
in a multicolumn format. See Figure 41 for an example of data displayed on the
Conditions tab.
On the Conditions tab, notice that many remotes have an arrow next to them. If you click
on the arrow so that it is pointing down, the conditions for that remote are revealed.
6. To view conditions in a graphical format, click the Time Line tab. See Figure 42 for an
example of data displayed on the Time Line tab.
7. On the Time Line display, you can right-click to elect to view the results in Seconds,
Minutes, or Hours.
8. You can also elect to view Details from this menu, which displays a heading line at the top
of the display showing the following information:
Name of Network Element
Type and Serial Number of a Remote or Line Card
Current Date
Number of hours it has been up
Number of hours it has been down
Percentage of time it has been up (Up %)
Percentage of time it has been down (Down %)
9. Events. If you are retrieving data on events, the Events pane appears, displaying the
events logged for the specified period. This data is displayed in a multicolumn format
only. It cannot be viewed in graphical format.
Arrow
The example in Figure 44 shows a remote reset resulting in the following conditions:
1. The first entry shows the remotes state at the start of the specified time range: the
remote is OK, and the last condition that cleared was DOWNSTREAM_SNR.
2. The next entry shows that the PP lost contact with the remote (this happens soon after
the reset was sent from iBuilder).
3. The next entry shows two conditions: the LOST_CONTACT warning is still active, and has
been joined by the layer 3 alarm LAT_TIMEOUT.
4. Finally, the Protocol Processor declares the remote OUT_OF_NETWORK, and this condition
is added to the list, giving us a total of three simultaneous conditions.
5. The next line shows that two of the three conditions cleared: The remote is back in the
network and the Protocol Processor has re-gained contact with it. The layer 3 alarm at
this point is still active.
6. The next line shows that the last condition, LAT_TIMEOUT, cleared.
7. The last two lines show a separate condition that was raised and cleared in a 15-second
time span.
When multiple conditions are shown in this display, the icon in the left column does not
represent the current state of the remote. Rather, it shows the type of condition that
occurred at that time. For example, in number 5 above, the state of this remote is still
ALARM, since the layer 3 alarm is still active. However, this particular entry represents the
clearing of two conditions, and the green icon indicates that to the user.
2.4 Snapshots
There are two types of snapshots: Conditions Snapshots and Data Snapshots.
Snapshots can be selected from the various elements in the iMonitor tree as follows:
Teleport: Teleport Condition Snapshot
Network: Network Condition Snapshot, Network Data Snapshot, Line Card Data Snapshot
Inroute group: Network Condition Snapshot, Network Data Snapshot, Line Card Data
Snapshot
Remote: Device Condition Snapshot
Figure 45 shows an example of a Network Condition Snapshot at the network level. (Both
the List and Detail views are shown. You can toggle between these views by right-clicking
in the window and selecting List or Details from the menu.)
Depending on your selection, the Condition Snapshot includes the following elements:
If you select Teleport Condition Snapshot at the teleport level, all protocol
processors, protocol processor blades, chassis, inroute group, and remotes configured
under the teleport.
If you select Network Condition Snapshot at the network level, all inroute groups
and remotes in that network are displayed.
If you select Network Condition Snapshot on a particular inroute group, only the line
cards and remotes in that inroute group are displayed in the Network Condition
Snapshot box.
If you select Device Condition Snapshot from a remote, only the remote is displayed.
3. You can view different data depending on your selections when you right-click a network
element in the Condition Snapshot pane. Figure 46 shows an example of a remotes
submenu when right-clicked from this pane.
4. In the lower half of the submenu shown in Figure 46 are several options that allow you to
tailor the Condition Snapshot view:
Compact Icons
Arrange Icons
List
Details
Details in Group
Real-time Status Only
Activated
5. Figure 47 shows the results of selecting Details for the Teleport Condition Snapshot.
6. If you hover the pointer (mouse arrow) over an element in the snapshot, a box of
information about that element is displayed. Figure 48 shows an example of the pointer
hovering over a line card in a network.
If you are ever in doubt as to the kind of element you are viewing, you can look at the
Type: line. In this case, you can see that the element pointed to by the mouse is a Line
card. The box also provides the following information on this element:
Type of Unit and Serial Number
Type of element
Name of element
Current Condition of element
Other Details about the element
7. You can double-click a Remote in the snapshot view to see the remotes Control Panel.
See Control Panel on page87 for information about the control panel.
2. With your mouse pointer located within the region of the highlighted elements, right-click
and select a report from those available. For this example, the Remote Availability
report was selected.
Notice that the resulting Select Remotes (Figure 50) dialog box shows only the remotes
that are highlighted in Figure 49. If you had selected this same report (Remote
Availability) from the Tree, even with these remotes highlighted, the resulting dialog box
would have listed all of the remotesnot just the ones you highlighted. Therefore, it is
important that your mouse pointer is actually over the highlighted elements when you
right-click.
3. Make your selections in the dialog box.
4. Click OK to display the selected report.
The Select Items and Stats dialog box has two panes. The pane on the left lists the
Remotes or Line Cards that you can include in the data snapshot. (Figure 51 shows
remotes because Network Data Snapshot was selected for this example.) The pane on
the right lists all the data you can view for these remotes or line cards.
3. In the pane on the left, select the remotes or line cards you want to view.
By default all elements are displayed in the left-hand pane. To select only Activated
elements, click Active. To clear all selections, click Clear.
4. In the pane on the right, expand the tree. Then select all parameters you want to view for
the selected elements. These selections will appear as columns in the Data Snapshot.
5. Click OK to view the Data Snapshot. Only the selected elements and parameters are
displayed.
You can obtain many types of performance information on the elements in your network. This
chapter describes how to view and interpret this information.
2. Click any of the three tabs to view different types of information. Figure 54 shows
examples of all three Blade Info tabs.
3. You can also right-click the blade in any of these displays and select CPU Usage. This
option allows you to view historical information about CPU usage on blades. See CPU
Usage (Blades Only) on page61 for instructions on how to obtain and use this
information.
Terminal Sessions allows you to launch a terminal window to this remote or to the
remotes protocol processor blade. The remote must be in the network and your PC must
be able to ping the remote for the remote terminal function to work.
Reset Remote allows you to reset the remote using a MAC-level message from the
Protocol Processor. The remote does not have to be in the network to receive this
message, but it must be locked onto the downstream carrier.
Cross Polarization allows you to transmit an unmodulated or modulated carrier on a
specified frequency from a remote.
Protocol Processor allows you to view statistics, reset statistics, view parameters,
bounce the link layer, or perform an ACQ Bounce.
The Protocol Processor section of the Probe pane allows you to bounce the link layer,
which causes it to go through its initialization handshake sequence and perform the ACQ
Bounce function on this remote. ACQ Bounce is discussed in Performing ACQ Bounce on
page67. Inroute Distribution is discussed in Inroute Distribution on page66.
1. Right-click a remote and Select Probe from the menu to open the Probe dialog box.
2. To alter the Transmit Power Value, click Change in the Remote Power section to open
the Change Remote Tx Power dialog box.
Note: You cannot set the power outside of the Min/Max range defined for this remote
in iBuilder.
4. To connect directly to the remote or protocol processor blade, click Remote or Blade in
the Terminal Sessions area of the Probe dialog box (Figure 55).
5. To reset the modem, click the Reset button in the Reset Remote area of the Probe dialog
box (Figure 55).
6. To transmit an unmodulated (CW) or modulated (PN) carrier:
a. Specify an unused RF Uplink Frequency for transmission in the Cross Polarization
area of the dialog box (Figure 57). This is the center frequency of the satellite carrier
you want to transmit.
b. Specify the BUC LO Frequency translation for the remotes BUC.
c. Click Start CW to begin transmitting an unmodulated carrier, or click Start PN to
begin transmitting a modulated carrier.
Figure 57. Probe Dialog Box: Cross Polarization and Adjust Transmit Power
d. To dynamically change the transmit power once the carrier is active, select the up
and down arrows to adjust the Transmit Power (Figure 57). Each time you click an
arrow, the transmit power changes by .5 dBm.
e. To change to a different frequency, click the Stop button (Figure 57) to bring down
the existing carrier; specify a new RF Uplink Frequency; then click the appropriate
start button to retransmit the carrier.
f. When you have finished, reset the remote to return the remote to normal
functionality. You can use the Reset button on the probe, or you can reset the remote
from iBuilder.
Note: A carrier launched from this screen will automatically stop transmitting five
minutes after the carrier was started or the power was last adjusted. You can
configure a custom key on the remote to change this timeout. See Modifying
the Timeout Duration for a CW or PN Carrier on page60 for details.
7. To view statistics, reset statistics or perform bounce functions, select a layer in the
Protocol Layer drop-down list.
Note: Only Real-time is available in the Get Past menu when viewing CPU Usage.
2. Select the blade for which you want to view information. Notice that the Line Cards and
Remotes sections are unavailable for selection.
3. Click OK to view the Blade CPU Usage pane. The Chart View tab is selected by default
(Figure 62).
4. Click the List View tab to view the data in multicolumn format.
5. You can also view limited CPU Usage information in list format on the CPU Usage tab by
following the directions in Monitoring Blades in iMonitor on page55.
3.4 Timeplan
The Timeplan graph shows you the number of TDMA time slots allocated to each remote on an
inroute, averaged over a one-second time period. This display provides an excellent glance at
the relative busy-ness of the inroute and the remotes that are getting the most time slots.
This display shows real-time data only; the NMS back-end does not archive Timeplan slot
allocations.
The Timeplan display can be selected from:
Receive line cards
Inroute groups
To view Timeplan information, follow the directions below:
1. Right-click a receive line card or an inroute group.
2. Select Time Plan from the menu.
If you selected a receive line card from the tree, the Timeplan graph appears
immediately (Figure 65 on page 64). However, if you selected an inroute group from the
tree, the Select Line Cards dialog box opens (Figure 64).
3. In the Select Line Cards dialog box, select the check boxes for receive line cards or
inroute groups for which you wish to view data. You can also use the buttons as follows:
All selects all elements in the list
Clear clears all elements in the list
Active selects only the active elements in the list
Because the information in the timeplan graph is specific to an individual inroute (i.e. line
card), when you select multiple line cards from the inroute group level iMonitor launches a
separate graph for each line card.
The graph is organized into two sections. The top section of the graph shows the total number
of slots allocated across all remotes in the inroute. The Y-axis of this display is scaled to the
total number of time slots available on this inroute. For each entry written to the top graph,
the bottom graph shows the slot allocation to each remote, along with the total number of
unallocated (i.e. free) slots. Check the Show Serial Numbers box to toggle the display of
remote name vs. serial number in the bottom graph.
Note: The graph does not show slots handed out via free-slot allocation; it only shows
slots allocated based on remote demand.
5. Click the Slot Assignment tab to view each timeplan message as it is sent to the remotes.
Because the inroute distribution data is specific to an individual inroute group, when you
select multiple line cards from the network level, iMonitor launches a separate pane for each
inroute group in the network.
This Inroute Distribution display (Figure 69) is organized into the following columns:
Remote name and serial number
Total slots allocated to this remote across ALL inroutes
The totals at the bottom show the total slots allocated to all remotes across all
inroutes, the percentage of the total bandwidth this represents, and the total number
of slots in all timeplans
For each inroute, the total number of slots allocated to each remote in the inroute
The totals at the bottom show the total slots allocated to all remotes in this inroute,
the percentage of this inroutes bandwidth this represents, and the total number of
slots in this timeplan
3.6 Latency
The NMS measures the round-trip time from the hub to each remote and back every five
seconds. All values are available from iMonitor in real-time. Latency responses exceeding 800
msec are available from the historical archive and are saved for one week by default. The
Latency display can be selected from:
Networks
Inroute Groups
Remotes
To view latency measurements for one or more remotes:
1. Right-click a network, inroute group, or remote in the iMonitor Tree.
2. Click Latency to open the Select Items dialog box.
3. Select the remotes for which you want to view information. Notice in Figure 71 that all
but the Remotes section are unavailable for selection.
4. Select either the Historical or the Get Past check box, or click OK to begin viewing
latency in real-time.
a. If you select Historical, click Time Range to open the Select Time Range dialog box
(Figure 72). Then enter a Start Time and End Time, or use the slider to set the Start
Time.
Note: If desired, you can click the ellipses next to the Start and End times to set
the time via the graphical clock display.
Figure 72. Select Time Range Dialog Box and Clock Display
b. If you selected Get Past, the Get Past drop-down list appears. Select an interval of
time.
Note: Historical latency reports show only data for latency timeouts. They do not
show measurements that are below the threshold.
The NMS measures latency by sending an empty ICMP echo request and measuring the elapsed
time until it receives a corresponding ICMP echo response from the remote. The round-trip
time (RTT) is limit-checked by default; if the RTT is greater than two seconds, iMonitor raises
a Warning for this remote. Additionally, the receipt of the ICMP echo response is used to
generate the layer 3 LATENCY Alarm, which indicates a potential IP problem. The NMS back-
end generates this alarm if it misses three consecutive ICMP echo responses.
Note: Latency is measured from the NMS server; the latency results do not represent
latency values from the remotes to arbitrary IP addresses on the public
Internet.
As with all multicolumn lists, you may copy and paste multiple rows from the latency display
into another Windows application such as Excel for further analysis.
The number of bursts received from the peer remote that were dropped
To open the Probe Mesh pane:
1. Right-click a mesh remote and select Probe Mesh to open the Select Mesh Remotes Pair
dialog box.
2. Select the peer remote from the Remote Two list and click OK. The Probe Mesh pane is
displayed showing the information described above.
Note: Probe Mesh is primarily intended for debugging. When Probe Mesh is enabled,
the remotes send debug information to iMonitor. This increases the processing
on the remotes and uses upstream bandwidth that could otherwise be used to
send traffic.
Figure 76. Select Items Dialog Box for Line Card Stats
Note: If you selected Line Card Stats at the Network level, every line card in that
network is displayed in the Line Cards area of the Select Items dialog box.
If you selected Line Card Stats on a particular line card, only that line card
is displayed in the Line Cards area of the Select Items dialog box.
2. Select either the Historical or the Get Past check box, or click OK to begin viewing
latency in real-time.
a. If you select Historical, click Time Range to open the Select Time Range dialog box
(Figure 72 on page 69). Then enter a Start Time and End Time, or use the slider to
set the Start Time.
Note: If desired, you can click the ellipses next to the Start and End times to set
the time via the graphical clock display.
b. If you click Get Past, the Get Past drop-down list appears. Select an interval of time.
3. Select the line cards for which you want to view statistics, and click OK to view the Hub
Stats pane.
Note: You may adjust the default color settings on this display by selecting the
Properties option from the context menu. Right-click anywhere inside the
display to launch the menu.
Note: You can also view this information on the remote Control Panel. See Control
Panel on page87.
To view the SATCOM Graph, Remote Status, or UCP Info on remotes, follow the directions
below:
1. Right-click a remote and select SATCOM Graph or Remote Status/UCP Info to open the
Select Items dialog box. The remote is pre-selected in the Remotes area of the dialog
box.
Note: If desired, you can click the ellipses next to the Start and End times to set
the time via the graphical clock display.
b. If you click Get Past, the Get Past drop-down list appears. Select an interval of time.
The SATCOM pane contains four tabs (Figure 79). The Remote Status and UCP Info tabs
contain the raw data used to draw the SATCOM graph. The Mesh UCP tab can be used to graph
various Uplink Control parameters for a remote.
SATCOM Tab
Figure 79 is an example of the graphs on the SATCOM tab.
This example shows the most recent data using the Get Past option of the parameters dialog
box. The window is organized into three separate graphs. The displays show the following
information:
Note: The maximum time range you may display in this pane is one hour. This limit
includes both historical and real-time information.
There are three graphs in the Mesh UCP pane: View 1, View 2 and Tx Power.
To select the parameters to view in each graph:
1. Display the Parameters section of the screen by right-clicking anywhere in the Mesh UCP
pane and selecting Show Parameters from the menu.
2. In the Parameters section, select the parameters you want to display in the three graphs.
(Parameter selection and parameter definitions are discussed in detail in the next two
sections.)
Selecting or clearing the two SCPC check boxes controls the display of all SCPC
parameters in View 1 and View 2 as a group.
Selecting or clearing the two TDMA check boxes controls the display of all TDMA
parameters in View 1 and View 2 as a group.
The Tx Power area of the pane allows you to select which of the transmit power
parameters are displayed in the Tx Power graph.
Note: Some of the content of the remote status message is based on the remote mode
of operation. For example, remotes in a DVB-S2 network report different status
than remotes in a legacy SCPC network, and mesh remotes report different
status than non-mesh remotes. Therefore the columns displayed by iMonitor
vary depending on the remote mode.
Note: If the GQoS configuration has changed, then historical GQoS statistics that
were logged under the previous configuration are not displayed.
2. In the Group Tree pane of the Select Group dialog box, select an element in the tree
over which you want to aggregate the Group QoS statistics. Sub-elements are
automatically selected.
Note: Checking Select single node allows you to select an individual element in
the Group Tree pane. This is illustrated in Figure 85.
3. Select Real time, or enter a Start Time, End Time and Duration.
5. Select elements at different levels of the tree in the left-hand pane to control the
aggregation of the statistics displayed in the List and Plot tabs of the right-hand pane.
Figure 86 shows the total statistics aggregated over the selected Service Group.
The following statistics are displayed in the List tab in the right-hand pane of the Group Stats
display:
BW Req shows the total bandwidth requested by the selected subgroup
BW Alloc shows the total bandwidth allocated by the selected subgroup
Free BW Alloc shows the number of slots allocated to the remote in excess of the
requested bandwidth.
Note: The BW Req column only displays correct data when congestion is not present.
Note: When you right-click a remote and select Upstream QoS Stats from the menu,
you can view all the QoS statistics for a single remote. The Select Group dialog
box for a single remote is shown below.
6. Click the Plot tab to view a graphical representation of the data on the List tab. By
default, three graphs appear: BW Requested, BW Allocated and BW Free.
7. You can right-click anywhere in the plot area and highlight Select Graph to view or hide
any of the three graphs.
You can also use the right-click menu to change the display. For example, you can select
ChangeJScale to modify the scales of the X axis or Y axis; select Legend to display or hide
the legend; or Change the background (Back Color) or Text color. If you select Mouse
Tracking, you can click and drag along the plot line to view the value of each data point.
1. Right-click in the display area of the List tab and select Export to Excel or Export to CSV
from the menu.
2. In the Save As dialog box, browse to the folder in which you want to save the statistics.
3. Select the remotes you want to monitor in the Remotes area of the dialog box.
4. Select the Historical check box to select a fixed time range for viewing. Otherwise, select
a time interval from the Get Past drop-down menu, or merely click OK to begin viewing
data in real-time. (Real-time is selected by default from the Get Past drop-down menu.)
Note: For historical data, you can click the ellipses next to Start Time and End
Time to set the Time Range using the graphical clock display.
5. Click OK to launch the ACM Gain display. The ACM Gain tab is selected by default.
The ACM Gain tab graph (Figure 93) shows the ACM Gain over time for the selected
remote(s) or for the entire DVB-S2 outbound carrier (if you launched the display from the
Line Card level of the iMonitor tree).
6. If you launched the display from the Network or Inroute Group, you can click on any
available remote in the left pane to display the ACM Gain for that remote. You can switch
to a new remote at any time by selecting it.
Figure 94. Selecting Remotes in the Left Pane of the ACM Gain Display
7. If you want to change the list of remotes that you can view without relaunching the
display, click the Filter button to open the Select Remotes dialog box.
a. Use the arrow buttons to move remotes between the Available Remotes pane and the
Selected Remotes pane to modify the list.
b. Click OK to return to the main ACM Gain display.
8. You can right-click in the graph to change the display by selecting menu options.
For example, you can change the scales of the X axis or Y axis; display or hide the legend;
or change the background or text color. If you select Mouse Tracking, you can click and
drag along the plot line to view the value of each data point.
9. To see the ACM Gain data in tabular form, click the List Data tab.
The table on the List Data tab shows the following information for each time period:
Low MC shows the minimum MODCOD of the DVB-S2 carrier as configured in iBuilder.
CCM kSym shows the number of kilosymbols that would have been required to transmit
the data if it had all been transmitted using Low MC as the MODCOD.
Actual kSym shows the number of kilosymbols that were actually required to transmit the
data using ACM.
ACM Gain shows the percent gain in efficiency achieved by comparing the CCM bandwidth
that would have been required with the actual bandwidth used.
The remaining columns show the number of kilobytes transmitted at each MODCOD.
Perform these steps to view the MODCOD distribution for your DVB-S2 carrier, or for selected
remotes receiving the carrier:
1. Right-click a DVB-S2 network, Tx line card, or remote in the iMonitor tree and select DVB-
S2 StatsJMODCOD Distribution to open the Select Remotes dialog box.
2. Make your selections in the dialog box. (See page89 for details.)
3. Click OK to view the MODCOD Distribution display.
4. If you launched the display from the Network, click on any available remote in the left
pane to display the MODCOD Distribution for that remote. You can switch to a new remote
at any time by selecting it.
Note: You can also click the Filter button to change the list of available remotes in
the left pane.
5. To see the MODCOD Distribution data in tabular form, click the List Data tab.
The table on the List Data tab shows the Total kilobytes transmitted during the time period as
well as the number of kilobytes transmitted at each MODCOD. For specific remotes, this
includes all data sent to that remote. If you launched the display from the Tx line card, then
the table includes all data transmitted on the DVB-S2 downstream carrier.
Perform these steps to view the MODCOD Utilization for your remotes:
1. Right-click a DVB-S2 network or remote in the iMonitor tree. Then select DVB-S2
StatsJMODCOD Utilization from the menu to open the Select Remotes dialog box.
2. Make your selections in the dialog box. (See page89 for details.)
3. Click OK to view the Message Structure tab of the MODCOD Utilization display. The
display contains one row for each remote.
4. Select a remote in the Structure column. If you selected Historical in the Select Remotes
dialog box (Figure 101), the time range of the selected remotes data is displayed at the
top of the display.
The Message Structure tab contains the following columns:
The Structure column contains the remote names. When you select a remote in the
Structure column, the data for that specific remote is shown when you click the
MODCOD tab or the Detailed Data tab. (See page 96 and page 97 for descriptions of
those tabs.)
The Sparkline column provides a graphical indication of which MODCODs the remote
received during the reporting period. There is one vertical line per statistical record.
Each line represents the MODCOD index of the MODCOD reported in the corresponding
record. The MODCOD index range is 0 (QPSK 1/4) to 21 (16APSK 8/9). (See Table 8 on
page 98.) The height of each line is proportional to the index of the MODCOD reported
in the corresponding record.
You can configure a number of settings that affect how the Sparkline data is
displayed by right-clicking a Sparkline and selecting options from the context menu.
For details, see Customizing the Display with the Sparkline Context Menu on
page99.
The Nominal column shows the Nominal MODCOD configured for the remote at the
time of the latest statistics record of the statistics sample. (The fields of the statistics
record are described on page 97.)
The Current column shows the MODCOD received by the remote in the latest
statistics record of the statistics sample.
The Utilize column shows the overall Bandwidth Utilization factor as calculated from
all records in the statistics sample. (See page94 for an explanation of the Bandwidth
Utilization factor.)
5. Click the MODCOD tab for a graphical representation of the percentages of data received
at each MODCOD for the remote that you selected on the Message Structure tab.
Figure 103 shows a remote that has received two MODCODs during the time represented
by the statistics. The remote received its outbound data on MODCOD 8PSK-3/5 for 91.95%
of the time and on MODCOD 8PSK-2/3 for 8.05% of the time.
6. To change to a different type of graph (such as a pie chart), right-click anywhere in the
display and select Type. Select the format you want from the list of options.
7. To view a legend showing the color coding of the different MODCODs, right-click anywhere
in the display and select Legend. (See Figure 104.)
8. To see the MODCOD Utilization data in tabular form, click the Detailed Data tab.
This tab displays all the statistics records currently being analyzed for the specific remote
that you selected on the Message Structure tab. Each record includes:
The Date and time of the statistics record
The configured Nominal MODCOD of the remote at the time of the record
The Current MODCOD of the remote at the time of the record
The Bandwidth Utilization factor (BW Utilization) calculated for that specific record.
(See page94 for an explanation of the Bandwidth Utilization factor.)
Note: The MODCOD Index Numbers (which start at 0) are not identical to the MODCOD
numbers used in the DVB-S2 standard as documented in the iDirect Technical
Reference Guide (which start at 1).
1. If you enable Mouse Tracking, you can click and drag along the Sparkline to view the
MODCOD Index of each data point. In Figure 107, Mouse Tracking has been enabled and
the mouse is over a line representing a data point with MODCOD index of 12 (8PSK 2/3).
See Table 8 on page 98 for the MODCOD index associated with each MODCOD.
2. Select Out of Bound to open a dialog box (Figure 108) that allows you to differentiate
between MODCODs inside or outside a configured range.
In the dialog box, you can set a minimum MODCOD index (Min. Boundary) and a Maximum
MODCOD index (Max. Boundary). Then click OK.
Individual spark lines that represent MODCOD indexes that fall within these boundaries
are displayed in one color in the Sparkline column. Individual spark lines that are outside
the boundaries are displayed as a different color.
3. Select Size to open a dialog box (Figure 109) that allows you to configure the Width and
Height of your Sparklines.
Figure 109. MODCOD Utilization: Setting Size of Sparkline Column and Rows
Enter a Width to set the width of the Sparkline column in pixels. You cannot adjust the
column on the GUI to be smaller than this setting. Enter a Height to adjust the height of
the rows (in pixels) on the Message Column tab.
4. Select Apply Filter to open dialog box (Figure 110) that allows you to set the maximum
number of lines in a Sparkline.
Figure 110. MODCOD Utilization: Setting the Maximum Spark Lines for a Remote
In Max. Samples, enter the maximum number of lines that you want to display in the
Sparkline column for the selected remote. For example, if you enter 100 for Max.
Samples, only the latest 100 records are represented in the Sparkline column for that
remote.
Note also that critical data (such as timeplan messages) and all multicast data are sent to all
remotes at the lowest MODCOD configured for the downstream carrier, regardless of the
current maximum MODCOD of the individual remotes.
Perform these steps to monitor the SNR values being reported by your remotes to the protocol
processor:
1. Right-click a DVB-S2 network or remote in the iMonitor tree and select DVB-S2 StatsJSNR
Graph to open the Select Remotes dialog box.
2. Make your selections in the dialog box. (See page89 for details.)
3. Click OK to view the SNR Plot tab of the SNR Monitoring Display.
4. You can right-click anywhere in the graph to change the graph display. See page102 for
more details.
5. To see the SNR data in tabular form, click the List Data tab.
In the table:
The MODCOD column displays the best MODCOD at which the remote can currently
receive data
The Bitmap column is intended for use by iDirect engineers and support personnel. It
displays the bitmap sent from the protocol processor to the line card representing all
MODCODs at which the remote can currently receive data.
The SNR column displays the SNR values reported by the remote
The Structure column in Figure 114 shows the following types of statistical data that can
be viewed on this screen:
UDP Rx High/Low indicates the number high and low priority UDP packets received by
the line card from the protocol processor. These packets contain the data for
transmission on the outbound carrier. Each UDP packet is subdivided into ACM
packets. Each ACM packet contains data that can be sent on a specific maximum
MODCOD.
ACM Packets Rx High/Low indicates the number of high and low priority ACM packets
received by the line card from the protocol processor that can be transmitted at a
given MODCOD.
ACM Packets Tx High/Low indicates the number of high and low priority ACM packets
received by the line card from the protocol processor for a specific MODCOD that have
been transmitted.
Note: In some cases, the line card may not send the data to the remote at the
remotes maximum MODCOD. To achieve the most efficient frame packing and
to minimize latency, an outbound frame may contain data for multiple remotes
with different maximum MODCODs. ACM Packets Tx High/Low indicates the
number of packets received from the protocol processor per MODCOD that have
been transmitted. It does not indicate whether or not the packets were actually
transmitted at the requested MODCOD.
3. The Hub Debug Statistics display has two tabs. The row that you select in the Message
Structure tab determines which statistics are displayed in the other tab. In Figure 116,
the row containing ACM Packets Rx Low is selected. This causes the corresponding data
to be displayed on the second tab. Notice in Figure 116 that the name of the second tab
has changed to match the selected struture.
Figure 116. Hub Debug Statistics: Selecting Structure for Second Tab
4. Click the tab on the right to view the statistics in real time. All ACM statistics are
displayed by MODCOD.
5. You can reset the counters in the display to zeroes by clicking the Reset View button
(Figure 118) at the top right of the screen.
When you click the Reset View button, iMonitor clears all values and sparklines and
begins accumulating data starting with the next set of statistics received from the line
card.
An S+ indicates star routing (i.e., all transmissions pass through the hub).
An M+ indicates that mesh routing is in effect between this remote and other
mesh remotes in the inroute group.
rmtarp displays the MAC and IP addresses for all remotes in this remotes inroute
group. This does not include the remote you are connected to.
ll hdlc shows the HDLC address of this remote.
These commands are illustrated in Figure 119.
Figure 119. Viewing IP Routing and HDLC Information from the Remote Command Line
Note: SkyMonitor is a licensed feature. If you plan to add SkyMonitor units to your
networks, please contact the iDirect Technical Assistance Center (TAC).
You can launch SkyMonitor from the iMonitor network tree either by right-clicking the
SkyMonitor unit itself, or by selecting a line card carrier that you have associated with a
SkyMonitor port in iBuilder. If in iBuilder you configured a port for a specific iDirect carrier,
then when you right-click the line card for that carrier and launch SkyMonitor, SkyMonitor
automatically displays the bandwidth defined for that carrier. If you launch SkyMonitor by
right-clicking the SkyMonitor unit, the ports are automatically tuned to the center frequency
that you configured for each port. For details on configuring SkyMonitor units in iBuilder, see
the iBuilder User Guide.
Note: When the NMS server processes are started, the NMS Sky Server process
automatically creates an exclusive connection to each licensed SkyMonitor
unit. If you are already connected to a SkyMonitor unit using a web browser,
the Sky Server connection will fail and you will not be able to view your
carriers from your iMonitor clients. Similarly, if the NMS has established a
connection to a SkyMonitor unit, you cannot connect using a web browser.
Figure 120 shows the initial SkyMonitor view. The current settings (Center Freq., Span, etc.)
are displayed in the monitor pane on the left.
2. The keypad on the right allows you to temporarily change the RF port settings, capture
data, recall captures, and save screen images. These functions are discussed in detail
later in this section.
3. You can select a new SkyMonitor port by clicking a port number in the RF Port section of
the keypad. (If you launched SkyMonitor from a line card, the RF port configured for the
carrier is automatically selected.)
4. Click the Start button to begin monitoring your preconfigured carrier or RF port. Figure
121 shows an iDirect carrier being monitored by a SkyMonitor spectrum analyzer.
5. Click the Stop button if you want to stop monitoring the bandwidth and clear the display.
Note: You can determine the exact frequency and amplitude of any point on the
monitor by positioning your cursor over that point on the screen.
Operate the keypad buttons as you would the buttons on a typical spectrum analyzer. As an
example, if you want to temporarily change the Center Frequency to be different from the
iBuilder configuration, follow these steps:
1. Click the Frequency button to view the sub-function buttons. (See Figure 123.)
2. Click the Center Frequency button.
3. Using the Data section of the keypad, click the number buttons to enter the value of the
new center frequency.
As you enter the data, it is displayed in the monitor pane on the left side of the window as
shown in Figure 124. You can click the up and down arrow buttons to increment or
decrement the last digit you entered. You can also click the minus sign button (-) to clear
the previously-entered digit.
4. Click the appropriate button for the units you are entering (GHz, MHz, KHz or Hz). Once
you select the units, the value displayed at the bottom of the screen changes to the new
center frequency, converted to KHz.
5. If you want to restore the iBuilder configuration, click the Preset button in the
Instrument State section of the keypad.
2. If you want to save the current data, click the Save Data button. This writes the spectrum
analyzer data to a file on your NMS server.
3. To capture data at five minute intervals over a set time period:
a. Click the Capture Time button.
b. In the Data area of the keypad, enter the time period over which you want to collect
data and click the Min or Sec button.
c. Click the Save Continuous button. Data is saved to a single capture file on the NMS
server every five minutes for the specified time period.
3. Select a time range within which to search for data files by entering a Start Time and End
Time or by adjusting the slider.
4. Click OK to view the Select Sky Data to Recall dialog box. (The maximum time range you
can enter is one week.)
5. In the Select Sky Data to Recall dialog box, select the data you want to recall and click
OK. The dialog box shows the Center Frequency and Timestamp of each data file. For
iDirect carriers, the line card Name is also displayed.
6. If the file you selected contains a continuous capture, you can click the Prev and Next
buttons to sequentially display the captured data.
7. Click the Stop button when you want to stop viewing the data file.
2. Click the Copy Bitmap button. This copies the image on the monitor pane to the
computers clipboard.
3. Open the application into which you want to past the image.
4. Select the paste function of the application, or type Ctrl + V to paste the image into the
application.
This chapter discusses the IP, Satellite, and Mesh Traffic graphs. It also describes the statistics
on which the various graphs are based.
To Internet
Upstream Lan Segment
Upstream Router
To Protocol
To line cards, satellite, remotes
Internet Processor
Note: Due to the different collection points for IP and SAT statistics, the IP Statistics
display may show more upstream traffic than is actually possible; i.e., greater
than the channel rate or configured rate limit. This is normal and not a cause
for concern.
To Internet
Remote 1
Upstream Router
Upstream Lan Segment
Protocol
Processor
Remote 3
2. Click SAT Traffic Graph. The Select Items dialog box appears.
3. Select the remotes for which you want to view information. Notice that all but the
Remotes section are unavailable for selection.
4. Click either Historical or Get Past, or OK to view real-time.
You may specify a historical time range or Get Past value from the parameters dialog. The
maximum interval you can select is 12 hours. The farther you go back in time, less
granularity will be available from the database due to archive consolidation.
If you retrieve more than 30 minutes of data, the display will be easier to read if you
select the Minutes or Hours interval from the context menu.
a. If you select Historical, click Time Range. The Select Time Range dialog box appears
(see below). If desired, click the ellipses next to the Start and End times to set the
time via the graphical clock display. If you selected Get Past, see Step b.
Figure 135. Select Time Range Dialog Box and Clock Display
b. If you selected Get Past, the Get Past drop-down list appears. Select an interval of
time.
5. Click OK.
6. The SAT Traffic pane appears with three tabs. Below are examples of the SAT Traffic tab
(Figure 137) and the SAT Downstream tab (Figure 138). The SAT Upstream tab has the
same format as the downstream, but displays data regarding the upstream path.
Note: You can also view the total kbps traffic in both directions for a selected group
of remotes by launching the SAT Bandwidth Usage display. See Satellite
Bandwidth Usage on page132 for details.
7. You can change the graphical display on the Sat Traffic tab by toggling the buttons to the
left of the graphs (Figure 137). The buttons work as follows:
The U and D buttons (shown below) toggle on and off the Upstream and Downstream
graphs. Click these buttons to display one or both graphs.
The Hour, Min and Sec buttons change the scale of the X axis to hours, minutes or
seconds.
The Bits and Bytes buttons toggle the scale of the Y axis to Kbits per second or Kbytes
per second.
The All and None buttons select all traffic types for the graphs or clear the display.
The Scale button applies only to the Downstream graph for DVB-S2 ACM networks. If
the Scale button is not selected, the actual data rate is shown on the Y axis. If the
Scale button is selected, the Y axis changes to show the downstream data rate that
would have been achieved if all downstream data had been transmitted at the
networks best MODCOD.
The Totals button adds a line to the graphs showing the total traffic for all the
selected traffic types.
The last five (traffic type) buttons determine which traffic types are included on the
graphs. You can select any combination of: Reliable, Unreliable, Overhead, Multicast
and Broadcast.
8. To choose among various display options on the graph, right-click inside the window to
view the menu below.
2. Click IP Traffic Graph or IP Traffic Graph (Group). The Select Items dialog box appears.
3. Select all remotes for which you want to view information. Notice that only the Remotes
section is available for selection.
4. Click either Historical or Get Past, or OK to view real-time.
a. If you select Historical, click Time Range. The Select Time Range dialog box
appears. (See Figure 135 on p. 122).
If desired, click the ellipses next to the Start and End times to set the time via the
graphical clock display.
b. If you selected Get Past, the Get Past drop-down list appears. Select an interval of
time.
5. Click OK.
6. The IP Graph pane appears, as shown in Figure 141. Refer to the Accessing the NMS
Statistics Archive on page155 for information on these results.
7. You can click the Upstream Data or Downstream Data tabs to view the raw statistics used
to draw the graphs. (Refer to the Accessing the NMS Statistics Archive on page155 for
information on these statistics.)
8. You can change the graphical display on the IP Graph tab by toggling the buttons on the
left. (See Figure 141.) The functions of the various buttons are documented on page 124.
9. If you selected IP Traffic Graph (Group), the selected remotes are shown at the left of
the display. You can show or hide the traffic of individual remotes by selecting or clearing
the check boxes. This is illustrated in Figure 143. The top image shows the traffic graph
with two remotes selected. The bottom image shows the same graph for only one of the
remotes.
10. If you selected IP Traffic Graph (Group), you can click the Filter button (Figure 143) to
open the Select Remotes dialog box (Figure 144).
Use the Select Remotes dialog box to select which remotes are displayed in the pane on
the left side of the main display (Figure 143). Click the arrow buttons to move remotes
between the Selected Remotes area and the Available Remotes area. Only Selected
Remotes are shown on the main display.
11. To choose among various display options on the graph, right-click inside the window to
view the menu below.
The menu options are described below. Some of these options perform the same functions as
the buttons on the left side of the display. (See Figure 141.)
Select Graph allows you to select the Upstream and/or Downstream graph for display
Change allows you to change characteristics of the graph such as text color; the scale of
the X axis and Y axis; the data refresh rate; and the units for the Y axis.
Note: If you change the scale of the X axis, you must enter the new values in seconds
since January 1, 1970.
Legend displays a color-coded legend of the graph contents.
Traffic allows you to select some or all of the following traffic types for display on the
graph: TCP, UDP, ICMP, IGMP, HTTP, Other. It also allow you to graph the Total traffic.
Copy sends the current graph display to your PCs clipboard.
Max Points allows you to limit the number of statistics records used to plot the graph.
Refresh Rate allows you to change the data refresh rate for the graph.
Manual Refresh refreshes the display immediately.
5. Click OK.
6. The Mesh Traffic pane appears with three tabs. Below are examples of the Mesh Traffic
tab and the Mesh Receive tab. The Mesh Transmit tab has the same format as the Mesh
Receive tab but displays data regarding the transmitted traffic.
7. If you right-click inside the frame and click Show Parameters from the context menu, you
can select what you want to see in the graph from the options shown in Figure 147.
Note that the Rate Limits (Downstream Max and Upstream Max) are only selectable if
you have configured rate limits on the QoS tab of the selected remotes.
8. Click the Mesh Receive tab or Mesh Transmit tab to view the mesh statistics in tabular
form. Figure 148 shows an example of the Mesh Receive statistics display.
3. Make the appropriate selections, and click OK. The SAT Bandwidth Usage results pane
appears, as shown below.
5 Reporting on Networks
iMonitor allows you to generate reports from the statistics archive. Each is discussed in detail
in this chapter.
You can generate reports from the following elements in the iMonitor tree:
Networks
Inroute groups
Remotes
TDMA line cards
iSCPC line cards
The following reports are available from multiple levels of the iMonitor tree:
SAT Long Term Bandwidth Usage
IP Long Term Bandwidth Usage
Mesh Long Term Bandwidth Usage
Remote Availability
Line Card Availability
2. Select IP Long Term Bandwidth Usage, SAT Long Term Bandwidth Usage or Mesh Long
Term Bandwidth Usage. The Long Term Bandwidth Usage Parameters dialog box
appears.
3. In Remote Devices, select the check boxes of the remotes for which you want to
generate reports.
4. When the Total All Remotes box is selected, iMonitor will add all the values together for
all of the selected remotes. If clear, iMonitor reports on each remote individually.
5. In Direction, select Downstream, Upstream, or Both to tell iMonitor whether to report
on downstream usage, upstream usage, or usage in both directions.
6. In IP Type, SAT Type or Mesh Type, select one or more protocol types that you would like
in your report, or select None to report only on total traffic, not broken down by
protocol. Selecting the All check box selects all of the protocol type boxes and results in a
complete listing of the individual values for each protocol type.
7. Select Total Traffic to sum the columns of IP traffic in a Grand Total.
8. In Time Range select the time period for your report. By default, you can select up to six
months in the past; values older than this are not saved by the back-end server. If you
wish to save IP statistics for longer than six months, please contact iDirects Technical
Assistance Center (TAC).
In Time Range, enter the start date by selecting a day, month, and year from the
calendar drop-down box. You can enter time values using the text boxes, or by clicking
the Details button to display the clock tool.
To specify an hour value, click the hour hand, and then click the hour. To select a minute
value, use the same technique, but click the minute hand instead. You can also double-
click anywhere on the dial to move both hands to that location.
Note: This method for specifying time is available from all historical query
parameters panes.
9. The Interval box allows you to specify the time period represented by each message
returned from the server. This feature allows you to show more or less granularity in the
results depending on the type of report you want. In general, raw data is less informative
for long-term reporting than data consolidated to represent larger time periods.
The minimum interval available will vary depending on the Start Time you specify for
your report. As usage data ages, the NMS server automatically consolidates records to
save disk space, so the higher-granularity intervals may not be available if your Start
Time value is far in the past. iMonitor automatically chooses the highest-granularity
interval for you. For more information on how the NMS server consolidates usage records
see Accessing the NMS Statistics Archive on page155.
10. In the Sort By drop-down list, specify an initial sort order for the report. Once the report
is generated you can re-sort at any time by clicking on the appropriate column heading.
11. When you have finished specifying the parameters, click OK to run the report. After the
server has retrieved the data, consolidated it into your chosen interval, and delivered it
to your client, a separate pane appears showing the results of the report.
5.1.2 Results
The report is organized into Totals and Averages tabs. The Totals tab shows total kilobytes
for each message returned from the server in the interval that you selected. There is a total
value at the end of each row, and a grand total at the bottom of each column. The Averages
tab shows the calculated kilobits per second value for each message.
Totals Tab
Figure 151 shows an example of the Totals tab of the Sat Long-Term Bandwidth Report. In
this example, the user chose to total all remotes, and to not break out the report by IP
protocol type. If the user had chosen to report individual IP protocols, each supported
protocol would have appeared in its own column.
Averages Tab
Figure 152 shows the same report as Figure 151, but with the Averages tab selected. As with
the Totals tab, only the averages for the total IP traffic are calculated, since the user chose
to not break out the data by individual IP protocol type.
12. Click Averages to view the average values for each parameter for the period of time the
report covers.
information rate would be 2 * .975 = 1.95 Mbps.For the upstream, we use the following
calculation to determine the theoretical maximum in bits per second:
(bytes per slot)*(8 bits per byte)*(slots per frame)*(1000/frame_len)
In the first clause, the byte count per slot does NOT include our internal overhead.
Additionally, this calculation removes unique word and guard band overhead. In a typical
network configuration with small FEC blocks, a 658 kbps information rate, a 125 ms frame,
and 109 traffic slots, the theoretical maximum would be as follows:
(70 bytes per slot)*8*(109 slots)*(1000/125)= 488320 bps = 488.320 kbps
The upstream theoretical maximum is an estimate only; the actual maximum will vary
depending on a number of factors, such as the number of remotes in the network, the
minimum data rate for each remote, and IP packet sizes.
Keep in mind that the larger your interval, the lower the percentage will probably be. This is
due to the fact that kbps values are averaged over the entire period of the interval, so spikes
in activity will tend to be hidden in the average value.
An example report is shown below. For each remote you selected, the report displays the
percentage of the time period the device was up and down, and the total number of hours
during the time period the device was up and down. Up refers to the time the remote was
able to pass traffic, and Down refers to the time the remote was unable to pass traffic due
to either a Layer 2 or Layer 3 Alarm being active (or both). The last line of the report shows
the average up/down hours and percent of all the devices for which you generated the report.
6 Monitoring Remotes
Using the Geographic
Map
You can view your teleport and all remotes in your networks on iMonitors Geographic Map.
These elements are positioned on the map according to their current geographic locations. A
remote is represented by a green, yellow, or red icon, depending on its real-time state. You
can interact with the map to zoom, pan, select remotes for further operations, toggle labels
and elevation, and perform other useful functions.
Note: You must be logged on as a Super User to use the Geographic Map in iMonitor.
See the iBuilder User Guide for information on configuring user account
privileges.
2. In the Remotes area of the Select Remotes dialog box, select the remotes you want to
view on the map. You can use the buttons to select All remotes, to Clear all remotes, or
to select only Active remotes. If you select Historical and enter a Time Range, the map
will be displayed with remote tracking over the selected time. (See Tracking and
Locating Mobile Remotes on page147 for details.)
3. As an alternative to selecting Historical and a Time Range, you can select a duration
from the Get Past drop down menu to display tracking for that time period up to the
present.
4. When you have finished making your selections, click OK to view the Geographic Map in
the main pane of the iMonitor display.
The toolbar is shown below. It is highlighted whenever one or more Geographic Maps is active.
Table 9 describes the functionality of all buttons on the Map Toolbar. Icon names used in this
document are in bold typeface.
Allows you to Zoom In through successive map levels, centered on the current mid-
point of the map.
Allows you to Zoom Out through successive map levels, centered on the current
mid-point of the map.
Allows you to Pan to a new region of the map within the current zoom level by using
the hand cursor to drag the map in any direction. If the entire map is visible, this
function does nothing.
Jumps directly to the Highest Zoom Level from the current zoom level. (The
highest zoom level shows the entire map.)
Allows you to click your mouse on a remote icon to determine Details of that
remote. When you click a remote icon, the remotes name, exact location, and any
current conditions are displayed.
Enables and disables Mobile Remote Tracking. When enabled, mobile remotes
that move within the network leave a trail on the map indicating where they have
been.
The Clear Track button clears the trails of mobile remotes from the map that result
when Mobile Remote Tracking is enabled. This button does not disable Mobile
Tracking.
The Toggle Elevations button turns on or off elevation measurements and contours
on the map display. Elevations are available only on lower zoom levels.
The Map Labels button turns on or off the name display for map features such as
cities, towns, rivers, ports, and highway route numbers. The labels displayed vary
with zoom level.
When enabled, the Circle Remote Images button causes the map to display a
shadow or outline around each remote icon. This function is useful when remotes are
clustered, or when elevation or label data obscures the remote icons.
When enabled, the Flash Remote Images button causes all remote icons to flash
continuously. This feature allows you to quickly identify all remotes in a specific
network or inroute group. It is especially useful at higher zoom levels.
When the Filter on Alarms button is selected, remotes with alarm status are visible
on the map.
When the Filter on Warnings button is selected, remotes with warning status are
visible on the map.
When the Filter on Mesh Alarms button is selected, remotes with mesh alarm
status are visible on the map.
When the Filter on OK button is selected, remotes with OK status are visible on the
map.
When the Filter on Elsewhere button is selected, roaming remotes with elsewhere
status for the network being monitored are visible on the map.
When the Filter on Offline button is selected, remotes with offline status are
visible on the map.
161, the green icon just off the coast of Russia is the current location of the remote. The grey
trail traces its movement over time.
Note: It is not possible to track Secure Mobile Remotes. By design, these units do not
report their geographic locations to the hub.
2. Click any of the grey icons in the trail of a remote. An Information Message will display
the name of the remote along with its position and the time of day when its location
corresponded to the grey icon you selected.
3. Right-click to display the remote submenu. When you select an operation from the menu,
iMonitor will display the results with the remote pre-selected.
group pre-selected. The figure below shows the results of selecting three remotes on the
map, and then selecting Network Data Snapshot from the menu.
Note: If the status of a remote changes so that the remote status no longer matches a
selected filter, the remote will disappear from the map. Similarly, if a remote
that was not visible due to filtering changes to a visible status, the remote will
appear on the map.
The following criteria can be applied when filtering Remotes on the geographic map:
Show all remotes (no filtering)
Show or hide remotes with Alarm status
Show or hide remotes with Warning status
Show or hide remotes with Mesh Alarm status
Show or hide remotes with OK status
Show or hide remotes with Elsewhere status (See note below.)
Show or hide remotes with Offline status
Hide all remotes
Note: Remotes with Elsewhere status are roaming remotes that are configured in the
network being monitored, but that have moved to another network. An icon for
a remote with Elsewhere status reflects the last position in which that remote
was displayed on the geographic map prior to leaving the network.
Filters can be set either by selecting icons on the geographic map toolbar, or by right-clicking
in the map pane and using the filter menu. The following two sections describe these options.
2. Select or clear the check marks in the menu to choose the remotes you want to view on
the map. You can select any combination of status filters. With the settings shown in the
figure below, only remotes with Alarm or Warning status are visible on the map.
Note: Selecting All from the filter menu selects all menu items. Selecting None clears
all selections. These are quick methods for toggling all geographic map
filtering on or off.
Many iDirect customers have requested specific reports on various aspects of their network
behavior, ranging from IP traffic activity to system uptime to satellite link behavior. iMonitor
allows users to retrieve historical data and populate a number of raw and graphical displays
on both firmware versions and per-remote uptime via web-based tools. iMonitor also provides
an easier way of retrieving long-term bandwidth usage statistics for network usage profiling.
iDirect also provides limited support for read-only direct archive access. This section
discusses how this is done and provides information about specific tables in the archive
database.
Note: The intended audience for this appendix are technical personnel with
experience developing relational database applications, preferably using
ODBC.
Note: Note: if you access the stats archive using ODBC, you may have to modify your
reporting software to handle gaps in the data.
Latency measurements below a default threshold of 800 msec are not logged to the
archive; only measurement times above this value are logged.
Consecutive latency time-outs are written to a single entry in the database along with a
count. For example, 10 consecutive latency time-outs are written as a single database
record with a count of -10.
Consecutive Sweep messages are written to a single entry in the database along with a
count. For example, 10 consecutive Sweeps are written as a single database record with a
count of 10.
All of these settings can be overridden or modified if necessary. Please contact iDirects
Technical Assistance Center for help changing the default archive behavior.
iDirect supports read-only access to the archive database only. The configuration database
contains a number of intricate relationships between tables that require a detailed knowledge
of the structure to interpret. This structure usually changes from one release to another to
allow configuration of new data path features, which would further complicate customer
access.
Note: Retrieving information based on serial number is not recommended you will
lose access to historical data if the hardware is swapped in the field.
In the archive database, remote unique ids in all tables are stored in the column named
unique_id. In the config database, this same ID is stored in a table named NetModem in the
column NetModemId. The remote name is in the column named NetModemName.
A sample SQL query that retrieves the remotes name from a known remote ID is:
select NetModemName from nms.NetModem where NetModemId = 15;
The config database name is nms, and that name must be in your query to tell the MySQL
server which database to look in.
In the archive database, network ids in all tables are stored in the column named
network_id. In the config database, this same ID is stored in a table named Network in the
column named NetworkId. The network name is in the column named NetworkName.
A sample SQL query that grabs a remotes network name from a known network ID might be:
select NetworkName from nms.Network where NetworkId = 1;
A.3.4 Timestamps
All raw data received from network elements is time stamped at the NMS prior to being
written to the database. All timestamp fields in the archive database are Linux time_t values,
which represent the number of seconds since January 1, 1970.
Note: For efficiency, archive data is divided into multiple tables for each data type.
Names of tables that contain data are derived from the base table names
shown in Table 10. For details, see Consolidated Group QoS Statistics on
page180. When referring to tables in this section, the base table name is
used.
Table 10. Archive Database Tables
Data
Base Table Name Contains
Saved For
raw_ip_stats IP stats sent from the protocol processor 24 hours
ip_minute_stats raw IP stats consolidated to one record per minute 30 days
ip_hour_stats IP minute stats consolidated to one record per hour 6 months
lat_stats latency measurement 1 week
nms_hub_stats hub line card statistics 1 week
nms_remote_status remote information 1 week
nms_ucp_info uplink control adjustments 1 week
event_msg events sent from protocol processors, hub line cards, and 1 week
remotes
state_change_log hub line card and remote state changes (conditions raised and 30 days
lowered)
pp_state_change_log protocol processor state changes 30 days
chassis_state_change_log chassis state changes 30 days
raw_ota_stats Over-the-air stats sent from the protocol processor 24 hours
ota_minute_stats raw ota stats consolidated to one record per minute 30 days
ota_hour_stats ota minute stats consolidated to one record per hour 6 months
raw_otacast_stats Over-the-air multicast stats sent from the protocol processor 24 hours
otacast_minute_stats raw otacast stats consolidated to one record per minute 30 days
otacast_hour_stats otacast minute stats consolidated to one record per hour 6 months
raw_mesh_stats Mesh stats sent from the remote 24 hours
mesh_minute_stats raw mesh stats consolidated to one record per minute 30 days
mesh_hour_stats mesh minute stats consolidated to one record per hour 6 months
remote_dvbs2_stats DVB-S2 statistics per remote 30 days
hub_dvbs2_stats DVB-S2 statistics per line card 30 days
pp_dvbs2_stats DVB-S2 statistics per protocol processor blade 30 days
nms_group_qos_stats group-level GQoS statistics 30 days
Data
Base Table Name Contains
Saved For
nms_sl_qos_stats service level GQoS statistics 30 days
group_qos_hour_stats group-level qos stats consolidated to one record per hour 6 months
group_qos_minute_stats group-level qos stats consolidated to one record per minute 30 days
rev_activity revserver log per network upgrade Unlimited
rev_state revserver log per remote per network upgrade Unlimited
sl_qos_hour_stats service-level qos stats consolidated to one record per hour 6 months
sl_qos_minute_stats service-level qos stats consolidated to one record per minute 30 days
Note: For convenience, HTTP traffic is broken out separately from TCP traffic, but
the TCP counts include HTTP as well. If you want a total count of traffic, do not
include the HTTP values in your addition.
If remotes are not active in the network, i.e. they are deactivated or incomplete in iBuilder,
the latency server will not attempt to measure their latency and no data will be written to
this table in the database for them.
Transmit (tx) values are always zero for receive-only line cards, and receive (rx) values are
always 0 for transmit-only line cards. While traffic CRCs almost always indicate an anomaly
condition, acquisition CRC values well above zero are normal when remotes are coming into
the network. In fact, by default iMonitor doesnt raise a warning condition on acquisition CRCs
until they go above 200 in a 20 second period.
received. However, built-in QoS rules give it higher priority than other types of traffic, and
our experience has shown that these messages are rarely dropped. The message contains a
variety of information about the remote, including temperature, number of milliseconds since
last boot-up, perceived SNR, etc. In the absence of other traffic from the remote, the
nms_remote_status message fits into a single small-block TDMA burst. Its contents are shown
in Table 15 below.
Interpreting the entries in the state_change_log table requires some understanding of how
the NMS manages conditions and overall element state. First of all, it is possible for multiple
conditions to be active for a single hub or remote at any given time. Consider the following
scenario:
1. A remote is in steady state with no active conditions. The overall state of the unit is OK.
2. A rain storm blows into a remotes location, which causes the SNR of the downstream
signal to drop below the defined low limit. This is condition 1, a warning. The overall
state of the unit changes to WARNING.
3. The weather situation persists, and the protocol processor loses contact with the remote.
This is condition 2, a warning. The overall state of the unit remains at WARNING.
4. The protocol processor is unable to re-gain contact with the remote, so it declares the
unit out-of-network. This is condition 3, an alarm. The overall state of the unit changes to
ALARM.
5. The NMS latency server stops hearing ICMP echo responses from the remote. This is
condition 4, an alarm. The overall state of the unit remains at ALARM.
We now have four simultaneously active conditions, and the overall state of the remote is
ALARM. Each time a new condition is raised for a remote, it is written to the database with
the current time of the NMS server machine in the timestamp field. The occurred_at field is
also given the same timestamp. All pre-existing conditions for that same element are re-
written with the same timestamp in the timestamp field. However, their occurred_at fields
remain unchanged, thus indicating the time those conditions were first raised. Using the
timestamp field as a key, you can determine all active conditions for a remote at any given
time.
When conditions clear, they are written once again to the state_change_log table, but this
time with the severity field set to EVT_CLEARED. Not all conditions clear at the same time,
but when all conditions have cleared the overall state of the unit returns to OK.
The only conditions with alarm severity are those that cause a service interruption. Currently
there are three conditions that fall into this category: LLDOWN (layer 2),
UCP_OUT_OF_NETWORK (layer 2), and LAT_TIMEOUT (layer 3). You can generate a remote
up/down report for a given time period by correctly parsing the entries in this table and
ignoring all warning conditions.
Entries in this table can be processed in essentially the same way as hub line card and remote
state changes. See Hub and Remote State Changes on page167 for more details.
value, calculated using a common formula, tells you how clustered the consolidated
measurements were around the average of all consolidated data records.
group-level and sevice-level statistics are consolidated into minute and hour Group QoS
statistics. See Consolidated Group QoS Statistics on page180.
WARNING! If you are currently accessing the statistics archive directly using ODBC, your
software will not work on this new archive structure without modifications.
See the following sections for detailed information.
A.5.1 Background
In older iDS releases, each archive data type was represented by a single MySQL database
table. Using the raw_ip_stats table as an example, all IP statistics for all remotes were
written directly to this table as they arrived at the NMS. Historical queries for IP statistics
were performed on this table as well. In large networks, the table could grow to well over one
gigabyte. This large size, combined with a large amount of read and write operations, caused
a significant performance load on the NMS servers CPU and degraded response time in the
iMonitor and iBuilder GUIs.
To alleviate this situation, the NMS now uses a multiple-table storage scheme in which each
type of archived data is divided among multiple tables by time and groups of remotes.
Dividing tables in this manner is known as data striping. The following sections discuss this
implementation change in detail.
Time Table 1
Time Table 2
D
at
a
S
Time Table 3
tri
pe
d
in
Time Table 4
6-
ho
ur
Time Table 5
se
gm
en
ts
Database
Archive Operation Server Incoming Stats
Table
Database
Tables
Database
Tables
Archive
Database
Tables
Table
Database
Operation Selection Incoming Stats Server Incoming Stats
Tables
Algorithm
Database
Tables
Database
Tables
In iDS 6.1 as well as later releases, instead of writing all data to one table as it arrives at the
NMS, the server first passes the data through a table selection algorithm. This process
determines the correct database table for the data that has just arrived. A similar selection
process also occurs when historical data is queried from iMonitor.
The selection rules are based on the following criteria:
The type of data IP statistics, events, condition changes, etc. As before, each type of
data has its own table structure
The remotes unique database ID
The current timestamp
time_table_number
second_dimension_table_number
time_interval
base_table_name
second_dimension_name
The type of The number The number of The time The actual tables names, The second
statistics of time tables per segment derived from the base dimension
data periods kept time period interval in table name. (These data type ID
for this kept for the each table, match the table names in
statistics second in minutes prior releases)
type dimension
data type ID
0 6 1 360 chassis_state_change_log chassis_id
1 6 1 360 event_msg unique_id
2 6 1 360 lat_stats unique_id
3 6 1 360 nms_hub_stats unique_id
4 6 1 360 nms_remote_status unique_id
5 6 1 360 nms_ucp_info unique_id
6 6 1 360 pp_state_change_log blade_id
7 6 1 360 raw_ip_stats unique_id
8 6 1 360 raw_ota_stats unique_id
9 6 1 360 raw_otacast_stats network_id
10 6 1 360 state_change_log unique_id
11 6 1 360 ip_minute_stats unique_id
12 6 1 360 ip_hour_stats unique_id
13 6 1 360 ota_minute_stats unique_id
14 6 1 360 ota_hour_stats unique_id
15 6 1 360 otacast_minute_stats unique_id
16 6 1 360 otacast_hour_stats network_id
17 6 1 360 raw_mesh_stats unique_id
Database Values:
ttn = TABLE_INFO.time_table_number
tis = (TABLE_INFO.time_interval * 60) // convert to seconds
sdtn = TABLE_INFO.second_dimension_table_number
btn = TABLE_INFO.base_table_name
Variables:
t = <timestamp> (Linux time_t)
id = unique_id of element (e.g. remote)
Note: When running a distributed NMS system, you must read TABLE_INFO from the
master MySQL machine. This is typically the same machine as your
Configuration Server.
raw _ip_stats_0
raw _ip_stats_1
raw_ip_stats_2
Existing
Data { Existing
raw _ip_stats
data
Empty
{
raw _ip_stats_3
raw _ip_stats_4
raw_ip_stats_5
When you restart the NMS servers, new data arriving at the NMS will be archived to the new
tables. The old data will remain in the old tables until you delete it or convert it to the new
format.
If you want to convert your existing archive data to the new format, follow these steps:
1. Log on to the NMS server as root.
2. At the command prompt, type:
cd /home/nms/utils/db_maint
3. Convert your archive data by typing:
./DB-Conversion.pl
Converts your archive data to the new table format
The DB-Conversion.pl command has the following format and output:
./DB-Conversion.pl -h
Usage:
DB-Conversion.pl [-cd=NAME] [-ad=NAME]
-cd : Change config database from [nms]
-ad : Change archive database from [nrd_archive]
WARNING! If you choose to modify the default TABLE_INFO settings, and you are running
a Distributed NMS, you must change the database on the master MySQL
machine. This is typically the same machine as your Configuration Server.
WARNING! You must stop NMS Services before changing the table structure, or run this
process offline.
4. Use the ./DB-Migration.pl script to change the table structure. All forms of this
script are shown below.
# ./DB-Migration.pl -h
DB-Migration.pl [-cd=NAME] [-ad=NAME] [-DD]
-cd : Change config database from [nms]
-ad : Change archive database from [nrd_archive]
-DD : Do not touch any data outside of the ip_stats
-suffix : Change suffix for existing tables for database
[nrd_archive], default is "old"
If you run the script with no arguments as shown below, it will rename the existing tables by
adding the suffix old. For example, event_msg_1 becomes event_msg_1_old. Once you have
verified the data in the new format, you should remove these renamed tables by entering the
command:
./DB-Migration.pl
This converts existing data to new table structure.
Note: You must have access to the root account on the NMS server to retrieve the
calculator.
Follow these steps to copy the archive database partitioning calculator to your PC or laptop
using Cygwin:
1. Create a folder on your PC or laptop where you want to store the calculator.
2. Start Cygwin on your PC or laptop.
3. In the Cygwin window, use the cd command to change your directory to the new folder.
The command syntax is show here using the directory db_calculator at the top level of
the C: drive.
cd /c/db_calculator
4. In the Cygwin terminal window, type:
SCP root@<IP Address>:/home/nms/utils/db_maint/table_info-
calculator.htm ./
where <IP Address> is the IP address of your NMS server.
5. Enter the root password when prompted. The calculator will be transferred to your PC.
6. Enter the following command to reformat your copy of the file for the Windows
environment.
unix2dos table_info-calculator.htm
7. Close your Cygwin terminal window.
Figure 174 presents an example of these steps.
3. If you are running Windows XP with Service Pack 2, you must right-click the security
message at the top of the calculator window and select Allow Blocked Content. Then
click Yes in the warning dialog box.
4. Use the calculator to determine the optimal settings for your archive database partitions.
The parameters and their usage is described below.
Figure 176 shows the calculated results for the nms_remote_status table in a network with
750 remotes with a logging rate of four times per minute. The parameters are entered in the
top portion of the screen. The results appear in the lower (yellow) portion of the screen when
you click the Calculate Table_Info data button.
The following parameters can be entered in the calculator.
The Base Table Name (identical to the base_table_name in the TABLE_INFO table on
page186) represents the table definition for the table set that contains all statistics of
this type. Before calculating the results, you should select the Base Table Name of
interest from this list.
Time to Keep Data (hrs) represents the amount of time in hours to retain the data for
this Base Table Name before it is overwritten. You can modify this parameter based on
your requirement to keep records of this type on the NMS server and your available disk
space.
Maximum Table Size (MB) is used to calculate the optimal number of tables that should
be created for this Base Table Name. This parameter is not stored in the database. It is a
limit used by the calculator to help compute the best results. In general, you should use
the default setting.
Number of Records per Minute is the rate per minute at which records of this type are
being logged for each remote (or other device) in the table set. This is not a configurable
parameter and it varies dynamically with network load. If you have measured a value for
your network for which you want to optimize the table set, you can change this
parameter to reflect that value. Otherwise, you should use the default setting.
Number of Second Dimension Elements represents approximately the total number of
devices (second dimension elements) associated with the Base Table Name in your
network. Note that if the number of remotes in your network changes significantly, you
should consider re-executing the calculator and reconfiguring the TABLE_INFO for tables
that log remote statistics. You can vary the number of second dimension elements used by
the calculator in increments of 250.
Record Size (in bytes) is the size of the database record for this Base Table Name. In
general, you should use the default setting.
After entering all parameters, click the Calculate Table_Info data button to calculate the
following results:
Time Table Number represents the optimal number of time segments recommended for
this Base Table Name based on the parameters entered. This result corresponds to the
time_table_number in the TABLE_INFO table shown in Table 35 on page186.
Second Dimension Name represents the number of tables per time period recommended
for this Base Table Name based on the parameters entered. This result corresponds to
the second_dimension_name in the TABLE_INFO table.
Time Interval (hrs) represents the length of time for each time segment recommended
for this Base Table Name based on the parameters entered. This result corresponds to
the time_interval in the TABLE_INFO table.
After you have calculated the optimal time_table_number, second_dimension_name and
time_interval for all tables you want to optimize, you can log into the root directory of the
NMS server and use MySQL to change the TABLE_INFO configuration in the NMS database to
match the optimal values.
Figure 177 shows the table set that would be created for nms_remote_status if INFO_TABLE
were modified in accordance with the values calculated in figure Figure 176 on page192.
UNION
(SELECT * FROM state_change_log_4 WHERE timestamp BETWEEN
20061120100000 AND 20061120140000)
UNION
(SELECT * FROM state_change_log_5 WHERE timestamp BETWEEN
20061120100000 AND 20061120140000)
ORDER BY timestamp;
With this method, MySQL concatenates and sorts the records for you. No external post-
processing required.
The iDirect NMS provides real-time notification of system anomalies, classified by severity.
The iMonitor GUI provides complete visibility to the real-time status and operational
characteristics of network elements. Status refers to the real-time state of network
elements, i.e. OK, warning, and alarm.
Alarms indicate an interruption in service or remote sites that are out-of-network. Warnings
display potential anomalous conditions and system values that are out of range.
This appendix provides troubleshooting recommendations for a subset of alarms and warnings.
Not all warnings are listed in this appendix. See Table 7 on page 35 for comprehensive lists
of warnings for each element.
B.1 Alarms
Table 36 lists alarms, their descriptions and recommended actions.
B.2 Warnings
Warnings signal a condition that could possibly result in a future interruption in service if not
handled in a timely fashion. Table 37 lists a subset of warnings, their descriptions and
recommended actions. See Table 7 on page 35 for comprehensive lists of warnings for each
element.
Note: Warning limits can be configured using iBuilder. For details on setting warning
limits, see the iBuilder User Guide.
iDirects NMS includes an SNMP proxy agent that provides real-time status, statistical
information, and basic configuration information to any interested SNMP client.
The SNMP Proxy Agent Management Information Base (MIB) supports both SNMP Get requests
for polling and SNMP traps for asynchronous notification of status changes. The MIB is
automatically updated to reflect changes in element status and/or configuration, including
the addition and deletion of network elements. It also collects statistical information
regarding network elements.
The SNMP Proxy Agent is automatically installed on the NMS server as part of the iDirect
software release and is included in the normal NMS server startup and shutdown procedure.
Beginning with iDirect Release 7.0, the SNMP MIB supplies the statistical information in Table
39 for iDIRECT network elements.
Note: Add the above line only if snmpd.conf does not already contain it.
4. Restart the snmpd service:
Example: /etc/init.d/snmpd restart
5. Use the SNMP SET command to set the MIB Object resetAllStatTables to 1.
Usage: snmpset -v 2c -c private <NMS server Ipaddress>
resetAllStatTables.0 u 1
Data types and table entry names are available from the MIB itself, which is available in the
following file on the NMS server machine:
/usr/share/snmp/mibs/IDIRECT-REMOTE-MIB.txt
Note: In a few instances, the SNMP trap configuration has been moved into
/home/nms/snmpsvr/para_cfg.opt. If the instructions above are not accurate,
execute these commands instead:
# cd /home/nms/snmpsvr/
# vi para_cfg.opt
3. Add a line like the following for each machine to which you want to send SNMP Version 1
(v1) traps:
trapsink host [community [port]]
Replace host with the name of the desired recipient. The community and port strings are
optional.
4. Add a line like the following for each machine to which you want to send SNMP Version 2
(v2) traps:
trap2sink host [community [port]]
Replace host with the name of the desired recipient. The community and port strings are
optional.
For more information on any of the commands in this list, log in to the NMS server machine
and type the following command:
# man <command name>
This will display the Linux manual entry or man page for the specified command that
provides usage details, output descriptions, etc. Note that some of the commands above will
not display anything about your iDIRECT networks, but instead display Linux system
characteristics, such as disk space and network status.
Transmit problems on one or more remotes may cause CRC errors on the hub line card that is
receiving the upstream carrier. CRC errors could be caused by any of a number of problems: a
remote transmitting above the saturation point, a bad cable, interference, etc.
If the upstream carrier is being received by an iNFINITI or Evolution line card, you can use the
iDirect Rx CRC Correlation feature to identify which remote or remotes are causing the
receive packet errors (Rx CRC errors) on the card.
1. Using a terminal emulator (such as PuTTY), use SSH to log on to the line card receiving the
upstream carrier.
2. From the command line of the line card, enter the following command and log on to the
admin account:
telnet 0
3. Use the dumpb command to examine the bursts being received by the line card. The
dumpb command has several forms shown in the syntax below:
> dumpb -h
Usage: dumpb <n> <options> - dumps trailer and first 4 words of n
rxd bursts on hub
-t - traffic bursts only
-a - acquisition bursts only
-r - for the remote specified only
-c - crc errors only
-s <m> - size of dumped packet
For example:
dumpb 50 displays the next 50 bursts.
dumpb 50 -c displays the next 50 bursts that contain CRC errors.
The following figures highlight the difference between real CRC errors and CRC errors
reported for false burst detections. Bursts with CRC errors contain a 0 in the crc field.
Figure 179 shows an example of a real CRC error captured by a dumpb command. Notice that
the highlighted burst has a relatively high SNR value. Also notice that the pattern of the data
is similar to other bursts, indicating that this was not the detection of random noise.
Figure 180. dumpb Output with CRC Error Reported Due to False Burst Detection
Figure 180 shows three CRC errors reported because of false burst detections, two in traffic
slots (T) and one in an acquisition slot (A). Notice that the SNRs reported for the bursts are
zero or near zero. Notice also that the burst data is random compared to other bursts. These
are indications that the CRC errors were reported due to false burst detections. If your CRC
errors are due to false burst detections, they do not affect the performance of your network.
You do not need to perform the remaining steps in this procedure.
2. In the Configuration Comparison dialog box, clear the Show Differences Only check box.
3. Examine the Latest pane to determine the Inroute IDs for the Inroutes in your Network.
Inroute IDs are displayed in the format INROUTE_#, where # represents the ID of the
Inroute. (See Figure 181.) Note the ID of each Inroute.
If you have multiple Inroutes in the Network, you need to create a custom key for each.
For example:
[INROUTE_1]
disable_lock = 0
[INROUTE_2]
disable_lock = 0
etc.
Figure 182 shows an example of setting the disable_lock custom key for three inroutes.
3. Enter the net list command to determine the networks available on this blade. You
will see a list of valid networks, as in the following example:
> net list
Valid Networks are: 1 4 6
4. Enter the net command to select the Network you want to examine. For example:
> net 1
NETWORK 1
5. Enter the crc report command to see the number of CRC errors generated by each
remote over time. The crc report command has several forms shown in the syntax
below:
> crc report
Usage:
crc report {data|acq|all} [reset]
6. Enter the following command to see a count of data CRC errors for each remote:
> crc report all
3100.3235 : DATA CRC [ 1]
3100.3502 : DATA CRC [5818]
3100.4382 : DATA CRC [ 20]
3100.4463 : DATA CRC [ 3]
3100.4656 : DATA CRC [ 11]
3100.7249 : DATA CRC [1369]
3100.8963 : DATA CRC [ 1]
3100.9162 : DATA CRC [ 1]
You can clear the counts by entering:
> crc report all reset
7. Repeat Step 4 through Step 6 for each Network on current blade, or enter the following
command to see all CRC errors for all Networks on the blade:
> net * crc report all
8. Repeat Step 2 through Step 7 for each sarmt process identified in Step 1.
If you have more protocol processor blades to check, execute this procedure again, beginning
with the instructions in the section Connecting to the Protocol Processor Blade on page216.
When you have finished, iDirect recommends that you delete the custom keys you configured
for your Network(s) and re-apply the changes.
G
B
geographic map
blades
clearing remote tracks 148
cpu usage 61 components of 5
monitoring 55 determining a remotes past locations 149
button enabling remote tracking 148
accept changes 8 filtering 152
filtering criteria 152
filtering using the context menu 153
C filtering using the toolbar 153
installing on PC 6
conditions 31 installing server license 5
acknowledging 19 launching 143
alarms and warnings on elements 34 launching with historical tracking 144
audio notification 18 license for 5
condition log tab 33 monitoring remotes with 143
interpreting 45 PC requirements 5
observation view tab 33 selecting remotes to view 144
viewing 39 toolbar 145
conditions pane 25, 33 tracking mobile remotes 147
configuration changes 26 using the map to select from Network Tree menu
150
connecting to network elements 106
viewing the toolbar 145
CRC errors
globe
Identifying Rx errors on line cards caused by remote
hiding elements 12
transmissions 74
sorting elements 12
cw carrier tree 12
enabling from remote probe 58 graphs
modifying timeout duration 60
IP traffic 125
mesh traffic 130
D mesh UCP 77
SAT traffic 120
DVB-S2 SATCOM 75
monitoring ACM gain 89 timeplan 63
monitoring carrier MODCOD distribution 92 Group QoS
monitoring remote MODCOD utilization 94 explanation of statistics displayed 83
monitoring SNR of remotes 100 exporting statistics to excel or CSV 86
viewing hub line card statistics 102 limitation of BW Req statistic 83
viewing statistics 81
I N
iBuilder network condition snapshot 47
description 2 network data snapshot 53
installing 4 network tree 15
iMonitor see also: tree
description 2 NMS
launching 7 applications 2
using the interface 11 iVantage NMS components xxi
installation main components 1
NMS applications 4 multiple users accessing 8
IP long term bandwidth usage 135 servers used 3
IP routing table, viewing on remotes 106 NMS database
IP statistics 117 overview 156
IP traffic graph 125
iSite 2 O
iVantage NMS components xxi
observation
putting elements under 37
L
offline state 34
latency, monitoring round-trip 68
launching iMonitor 7 P
legend 25
line card data snapshot 53 panes
line cards conditions 25
configuration changes 26
identifying remotes causing Rx CRC errors on 74
legend 25
statistics on 72
probe 56
logging in probe mesh 71
passwords 7 See also dialog boxes
to other servers 7 selecting columns for viewing 26
sorting columns in 14
M passwords 7
pn carrier
main toolbar 20 enabling from remote probe 58
map, see geographic map modifying timeout duration 60
mesh probe 56
mesh long term bandwidth usage 135 adjusting remote transmit power 58
mesh statistics 119 functions of 56
mesh traffic graph 130 transmitting a modulated or unmodulated carrier
mesh UCP tab 77 58
probe mesh 70 probe mesh 70
selecting UCP parameters for viewing 78