Ibuilder User Guide PDF
Ibuilder User Guide PDF
Release 7.0.1
October 15, 2007
.Copyright 2007, iDirect, Inc. All rights reserved. This manual may not be reproduced, in part or
in whole, without the permission of iDirect, Inc.
The specifications and information regarding the products in this manual are subject to change
without notice. All statements, information, and recommendations in this manual are believed to
be accurate, but are presented without warranty of any kind, express, or implied. Users must take
full responsibility for their application of any products.
Trademarks, brand names and products mentioned in this manual are the property of their
respective owners. All such references are used strictly in an editorial fashion with no intent to
convey any affiliation with the name or the products rightful owner.
iDirect, Inc.
International Headquarters
13865 Sunrise Valley Drive
Herndon, VA 20171
www.iDirect.net
HQ: 1.703.648.8000
Toll free from within the US 1.888.362.5475
ii
Network Management System iBuilder User Guide, Release 7.0.1
Contents
Figures xi
Tables xii
iii
Network Management System iBuilder User Guide, Release 7.0.1
3.7.2.1 Folders Containing Critical Information 20
QoS 20
Components: Remote Antenna Components 21
Components: Hub RFT Components 22
3.7.2.2 Folders Containing Reference Information 22
3.7.2.3 Adding Entries to Folders 22
3.7.2.4 Canceling an Entry 23
3.8 Using iBuilders Interface 23
3.8.1 Clicking on Elements and Folders: What Happens? 24
Right-Clicking 24
Double-Clicking vs. Single-Clicking 25
3.8.2 Globe 25
Using the Docking Feature 25
Expanding Tree 26
Collapsing Tree 26
Sorting Columns 27
Sorting the Tree 27
3.8.3 Network Tree 29
3.8.4 Using the Interface Toolbars and Menu Options 30
Title Bar 30
Menu Bar 31
Toolbar 31
Find Toolbar 32
View Menu 34
Status Bar 34
Connection Details on Status Bar Icon 35
Active Users Pane 35
Legend Pane 36
Configuration Changes Pane 37
Configuration Status View 37
Properties View 38
Details 38
Collapse Details Hierarchy + Details 39
Choose Details 40
3.9 Customizing and Creating New Detail Views 40
3.9.1 Customizing Detail Views for Configuration Reporting 40
3.9.2 Creating Additional Filters for Customized Reporting 44
3.10 Working with Multiple Elements Simultaneously 47
3.10.1 Working with Multiple Configurations and Image Files 47
3.10.2 Modifying Parameters on Multiple Elements 47
Rules for Multiple Edit 47
iv
Network Management System iBuilder User Guide, Release 7.0.1
Procedure for Group Editing 47
3.11 Configuration Status of Elements 49
3.11.1 What is a Configuration State? 49
3.11.2 Possible Configuration States 50
3.11.3 Configuration State Transition 51
3.11.4 Viewing Configuration States 52
3.11.5 Why Did My Configuration States Change? 52
3.11.6 Configuration States and iMonitor 52
3.11.7 Accepting Configuration Changes and Locking the Database 53
3.12 Understanding the Databases Numbering Convention 53
3.13 In Color versus Shaded Icons 54
3.14 Configuring Warning Properties 55
3.14.1 Setting Global Warning Properties 56
3.14.2 Customizing Warning Properties for Individual Network Elements 58
3.14.3 Clearing Customized Warning Properties 59
v
Network Management System iBuilder User Guide, Release 7.0.1
6.3 Adding a Tx Line Card, a Tx/Rx Line Card, or a 10000 Series Hub 94
6.4 Setting Warning Properties for Line Cards 97
6.5 Adding Receive (Rx) Line Cards 97
6.6 Adding an iSCPC Line Card 99
6.7 Defining a Standby Line Card 101
6.7.1 Selecting Automatic Failover 101
6.7.2 Failover Prerequisites 102
6.7.3 Basic Failover Concepts 102
6.7.4 Tx(Rx) versus Rx-Only Line Card Failover 103
6.7.5 Failover Sequence of Events 104
6.7.6 Failover Operation: Users Perspective 105
6.7.7 Recovering from a Line Card Failover 106
6.7.8 Recovering from a Reparable Line Card Failure On-site 106
6.8 Adding Inroute Groups 107
Carrier Grooming 107
Frequency Hopping 108
Mesh-Enabled Inroute Groups 108
Adding an Inroute Group 109
vi
Network Management System iBuilder User Guide, Release 7.0.1
7.7.2 Upstream and Downstream SAR 139
7.7.3 Upstream and Downstream Rate Shaping 140
7.7.4 PAD 141
7.8 Geo Location Tab 142
Mobile State 142
7.9 VSAT Tab 143
7.10 Setting Warning Properties for Remotes 145
7.11 Adding a Remote by Cloning an Existing Remote 145
7.12 Roaming Remotes 145
7.12.1 Adding a Roaming Remote 147
7.12.2 Managing Roaming Remote Configuration 149
Managing Must be the Same Parameters 149
Managing Dont Care Parameters 150
7.12.3 Beam Switching for Roaming Remotes 152
Automatic Beam Selection 152
Manual Beam Selection 153
Round Robin Beam Selection 153
7.13 Enabling IP Packet Compression Types 153
7.13.1 TCP Payload Compression 155
7.13.2 UDP Header Compression 155
UDP Header Compression Performance Characteristics 155
7.13.3 CRTP 156
RTP Header Compression Performance Characteristics 156
7.13.4 UDP Payload Compression 156
vii
Network Management System iBuilder User Guide, Release 7.0.1
10 Controlling Remotes 177
10.1 Activating and Deactivating Remotes 177
10.2 Moving Remotes 179
viii
Network Management System iBuilder User Guide, Release 7.0.1
12.5.1 How the Revision Server Works 208
12.5.2 When to Use the Revision Server 209
12.5.3 Starting the Revision Server 210
12.5.4 Monitoring Upgrades Using the Revision Server Status Pane 212
12.5.5 Cancelling an Upgrade 214
ix
Network Management System iBuilder User Guide, Release 7.0.1
14.10 Set the Clear Sky C/N Parameter for a Mesh Outroute 247
14.11 Set the UPC Margin for a Mesh Outroute 248
14.12 Set the Clear Sky C/N Parameters for a Mesh Inroute Group 248
14.13 Set the TDMA C/N Nominal Parameter for an Inroute Group 251
Index 281
x
Network Management System iBuilder User Guide, Release 7.0.1
Figures
Figure 2-1: Example iDirect Network 4
Figure 2-2: iDirect IP Architecture 5
Figure 2-3: iDirect IP Architecture Multiple VLANs per Remote 6
Figure 2-4: iDirect IP Architecture VLAN Spanning Remotes 7
Figure 2-5: iDirect IP Architecture Classic IP Configuration 8
Figure 2-6: iDirect IP Architecture TDMA and iSCPC Topologies 9
Figure 3-1: Desktop Shortcuts for NMS GUI Clients 15
Figure 3-2: Windows Start Menu Entries for NMS GUI Clients 16
Figure 3-3: Bench Test Components in Initial NMS Tree 20
Figure 3-4: Filter Profile Examples 21
Figure 3-5: Traffic Profile Examples 21
Figure 3-6: BUC Examples 21
Figure 3-7: LNB Examples 21
Figure 3-8: iBuilders Main Screen 24
Figure 3-9: Expand Tree Selection 26
Figure 3-10: Expanded Tree with Child Elements 26
Figure 3-11: Collapse Tree Selection 27
Figure 3-12: Collapsed Tree 27
Figure 3-13: View Menu Options 34
Figure 3-14: Right-Click Options 34
Figure 3-15: Example of Configuration States 38
Figure 3-16: Clicking Details 38
Figure 3-17: Network Highlighted in Tree 39
Figure 3-18: Result in Details View 39
Figure 3-19: Network Highlighted in Tree 39
Figure 3-20: Result in Details View 39
Figure 3-21: Configuration States of an iDirect Remote 51
Figure 5-1: Uplink VLAN Segment in a PP Blade Environment 88
Figure 6-1: Failover Sequence of Events, NMS Server Perspective 104
Figure 6-2: Failover Sequence of Events, NMS User Perspective 105
Figure 6-3: Inroute Group Relationships 107
Figure 7-1: Sample VLAN Network Layout 123
Figure 7-2: Figure: Using the Console's beamselector Command 153
Figure 8-1: Remotes Associated with Profiles 158
Figure 8-2: Downstream QoS (Left side of QoS pane) 166
Figure 8-3: Upstream QoS (Right side of QoS pane) 166
Figure 11-1: Global NMS Options Files 198
Figure 12-1: Revision Server Duty Cycle 209
Figure A-1: Sample Distributed NMS Configuration 260
Figure A-2: dbBackup and dbRestore with a Distributed NMS 271
xi
Network Management System iBuilder User Guide, Release 7.0.1
Tables
Table 3-1: Toolbar Icons and Functions 31
Table 13-1: User Types and Access Privileges 231
Table 13-2: Custom Privileges 231
xii
Network Management System iBuilder User Guide, Release 7.0.1
1 Using this Guide
This chapter discusses how to use this manual. It contains the following sections:
Intended Audience
Document Conventions
Informational Conventions
Some basic knowledge of TCP/IP concepts, satellite communications, and Windows operating
systems is expected. Prior experience operating an iDS network, although desirable, is not a
requirement.
Information you type directly into data fields or at command prompts is in courier
font.
Windows menu selections are represented as Menu Command, or in the case of
cascading menus, Menu SubMenu Command.
Menu selections made from items in the Network Tree are represented as <level in
tree> Command. For example, the tree menu item to modify a line card is shown as
Line Card Modify.
Names of commands, menus, folders, tabs, dialog boxes, list boxes, and options are
in bold font.
Procedures begin with a feature description, followed by step-by-step, numbered
instructions.
When you see the NOTE symbol, the corresponding text contains
NOTE helpful suggestions or references to material not contained in this
manual.
1
Network Management System iBuilder User Guide, Release 7.0.1
When you see this alert symbol with a WARNING or CAUTION heading,
WARNING strictly follow the warning instructions to avoid personal injury,
equipment damage or loss of data.
2
Network Management System iBuilder User Guide, Release 7.0.1
2 iDirect System Overview
As depicted in Figure 2-1 Example iDirect Network, p. 4, an iDirect network is a satellite based
TCP/IP network with a star topology in which a Time Division Multiplexed (TDM) broadcast
downstream channel from a central hub location is shared by a number of remote nodes. The
iDirect Hub equipment consists of an iDirect Hub Chassis with Universal Line Cards, a Protocol
Processor (PP), a Network Management System (NMS) and the appropriate RF equipment. Each
remote node consists of an iDirect broadband router and the appropriate external VSAT
equipment. The remotes transmit to the hub on one or more shared upstream carriers using
Deterministic-TDMA (D-TDMA), based on dynamic timeplan slot assignment generated at the
Protocol Processor.
Beginning with iDirect release 7.0, a mesh overlay can be added to the basic star network
topology, allowing traffic to pass directly between remote sites without traversing the hub. This
allows real-time traffic to reach its destination in a single satellite hop, significantly reducing delay.
It also saves the bandwidth required to retransmit mesh traffic from the hub to the destination
remote. For a description of iDirects mesh overlay architecture, see chapter 3, Mesh Technical
Description of the iDirect Technical Reference Guide.
The choice of upstream carriers is determined either at network acquisition time or dynamically at
run-time, based on a network configuration setting. iDS software has features and controls that
allow the system to be configured to provide QoS and other traffic engineered solutions to remote
users. All network configuration, control, and monitoring functions are provided via the integrated
NMS. The iDS software provides packet-based and network-based QoS, TCP acceleration, 3-
DES or AES link encryption, local DNS cache on the remote, end-to-end VLAN tagging, dynamic
routing protocol support via RIPv2 over the satellite link, multicast support via IGMPv2, and VoIP
support via voice optimized features such as CRTP.
An iDirect network interfaces to the external world through IP over Ethernet via 10/100 Base-T
ports on the remote unit and the Protocol Processor at the hub. The following figures, beginning
with Figure 2-2 iDirect IP Architecture, p. 5 describe the IP level configurations available to a
network operator.
The iDS system allows you to mix traditional IP routing based networks with VLAN based
configurations. This capability provides support for customers that have conflicting IP address
ranges in a direct fashion, and to support multiple independent customers at a single remote site
by configuring multiple VLANs directly on the remote.
3
Network Management System iBuilder User Guide, Release 7.0.1
Figure 2-1: Example iDirect Network
In addition to end-to-end VLAN, the system supports RIPv2 in an end-to-end manner including
over the satellite link; RIPv2 can be configured on per-network interface.
4
Network Management System iBuilder User Guide, Release 7.0.1
Figure 2-2: iDirect IP Architecture
5
Network Management System iBuilder User Guide, Release 7.0.1
Figure 2-3: iDirect IP Architecture Multiple VLANs per Remote
6
Network Management System iBuilder User Guide, Release 7.0.1
Figure 2-4: iDirect IP Architecture VLAN Spanning Remotes
7
Network Management System iBuilder User Guide, Release 7.0.1
Figure 2-5: iDirect IP Architecture Classic IP Configuration
In addition to the network architectures discussed so far, iDirects iSCPC solution allows you to
configure, control and monitor point-to-point Single Carrier per Channel (SCPC) links. These links,
sometimes referred to trunks or bent pipes, may terminate at your teleport, or they may be
located elsewhere. Each end-point in an iSCPC link sends and receives data across a dedicated
SCPC carrier. As with all SCPC channels, the bandwidth is constant and available to both sides
at all times, regardless of the amount of data presented for transmission. SCPC links are less
efficient in their use of space segment than are iDS TDMA networks. However, they are very
useful for certain applications. Figure 2-6 shows an iDirect system containing an iSCPC link as
well as a TDMA network, all under the control of the NMS.
8
Network Management System iBuilder User Guide, Release 7.0.1
Figure 2-6: iDirect IP Architecture TDMA and iSCPC Topologies
9
Network Management System iBuilder User Guide, Release 7.0.1
10
Network Management System iBuilder User Guide, Release 7.0.1
3 Overview of the Network Management System for iBuilder
This chapter presents an overview of the iBuilder network management tool for configuring your
iDirect network. It contains the following sections:
Introduction on page 11
Gathering the Information You Need on page 11
Preparing Equipment in Advance on page 12
Components of the Network Management System on page 12
Installing iBuilder, iMonitor, and iSite on page 15
Launching iBuilder on page 16
Pre-defined Components and Components Folders in iBuilder on page 19
Using iBuilders Interface on page 23
Customizing and Creating New Detail Views on page 40
Working with Multiple Elements Simultaneously on page 47
Configuration Status of Elements on page 49
Understanding the Databases Numbering Convention on page 53
In Color versus Shaded Icons on page 54
Configuring Warning Properties on page 55
3.1 Introduction
iDirects Network Management System (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
This chapter provides some of the most important information you will need to understand how
iBuilder 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 iBuilder, how to use the many powerful
tools available in iBuilder, how to create, customize, and print reports, and how to determine the
configuration status of network elements.
11
Network Management System iBuilder User Guide, Release 7.0.1
Longitude (Geo location)
Transponder translation frequency
Hub Up/Down local oscillator
LNB stability
Carrier uplink and downlink frequencies
FEC block sizes
FEC blocks per outroute frame (See the Network Planning Tool and its User
Guide.)
Data rates
Overall IP architecture plan for hub components
Geographic location of the hub
Line Card serial numbers and slot numbers
Number of inroutes
Tx/Rx or Tx-only line cards, depending on downstream/upstream data rates (Refer to
chapter 4, iDirect Modulation Modes and FEC Rates of the iDirect Technical
Reference Guide.)
Frequency hopping (requires that a Reference Clock Module be installed on your hub
chassis) or carrier grooming mode
Remote serial numbers and geographic locations
The NMS Server must already be installed and its interface defined.
The Protocol Processor blades must already be installed and configured.
The Chassis must already be installed and configured.
Line Cards must have already been installed in the Chassis with their IP addresses
defined using iSite.
12
Network Management System iBuilder User Guide, Release 7.0.1
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.
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. Refer to
Network Management System iMonitor User Guide for 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 1dB 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.
iSite also allows monitor-only capability to end-users, should you decide to provide it to them. For
more information About iSite, see Using iSite to Commission Equipment.
13
Network Management System iBuilder User Guide, Release 7.0.1
3.4.2 Server Components
The NMS server processes run on your NMS Linux Server machines. There are a number of NMS
servers processes, each of which performs a specific set of back-end functions.
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.
14
Network Management System iBuilder User Guide, Release 7.0.1
Database Backup Script
This script runs nightly to back up the data in your primary databases and copy it to your backup
NMS server. The database backup daemon must be custom-configured for each customer site.
By default, the clients are installed on your desktop in the following folder:
iDIRECT NMS Clients <version>, where version is the iDirect release number.
The installer automatically adds the appropriate entries in the Windows Start menu. Click Start
All Programs iDirect NMS Clients 7.0. The iBuilder, iMonitor, and iSite clients are displayed,
along with an Uninstall selection.
15
Network Management System iBuilder User Guide, Release 7.0.1
Figure 3-2: Windows Start Menu Entries for NMS GUI Clients
iDirect strongly recommends that you modify the admin user password as soon as possible after
the installation. This is especially important if your NMS Server is accessible via the public
Internet.
Step 1 To launch iBuilder, double-click the desktop shortcut or select it from the
Windows Start menu.
Step 2 Enter your user name and password in the Login Information dialog box.
Step 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.
The the iBuilder version must match the NMS server version in
NOTE order for you to log in. (For example, version 6.0.0 of iBuilder may
connect only to version 6.0.0 of the NMS servers.)
16
Network Management System iBuilder User Guide, Release 7.0.1
The iBuilder application automatically connects to the NMS server processes that are required to
perform the NMSs functions. If this connection is lost for any reason, iBuilder automatically
reconnects to the servers when they become available.
1. You may run multiple simultaneous sessions of iBuilder and/or iMonitor on a single PC.
These versions may be connected to different servers or the same server.
2. Multiple PCs may run the same session of iBuilder and/or iMonitor at any given time
and connect to the same server at the same time.
17
Network Management System iBuilder User Guide, Release 7.0.1
3. Only one iBuilder user may have a Modify Configuration dialog box open at any given
time. If another user tries to modify a record when someone else already has a Modify,
or configuration, dialog box open, an error message is displayed on the PC of the other
user, and they are not allowed to change anything in the database.
Accepting Changes
When two iBuilder users are connected to the same server, and one of them modifies the network
configuration, the other user cannot modify the configuration suite until he accepts the changes,
which will automatically refresh his configuration view to reflect the latest changes.
When the other user changes the configuration, the Accept Changes button on your toolbar
changes color from gray to red (For more information, see Table 3-1, Toolbar Icons and
Functions, on page 31.
If you attempt to modify the network configuration without accepting changes, the following
warning message appears:
Before you accept the changes, you may view the other users changes by selecting View
Configuration Changes (see Configuration Changes Pane on page 37). To accept the changes
and update your view of iBuilder, click Accept Changes. Any modifications the other user has
made are now displayed in your copy of iBuilder.
18
Network Management System iBuilder User Guide, Release 7.0.1
3.7 Pre-defined Components and Components Folders in iBuilder
iDirect has designed the Network Management System to be as easy to use as possible, and
therefore has added several components and components folder entries to iBuilder to get you
started. These pre-defined components and folders exist in iBuilder when you launch it for the first
time. The elements and folder entries can be re-used as you create new networks.
iBuilder is shipped with the following pre-defined and re-usable components and components
folders:
Bench Test Components for I/F Networks, that were set up for testing purposes prior
to shipping. They include the following elements which can be modified to have their
names and other properties changed to match the needs of your network:
a spacecraft
a transponder
a BUC
an LNB
bandwidth
an upstream and downstream carrier
19
Network Management System iBuilder User Guide, Release 7.0.1
Figure 3-3: Bench Test Components in Initial NMS Tree
QoS
Components
Remote Antenna Components
Hub RFT Components
QoS
This folder contains a number of subfolders, such as the Up/Downstream Filter Profiles and Up/
Downstream Traffic Profiles folders shown below. The entries listed in the figures below are
examples of default profiles developed by iDirect for use on iDirect products.
20
Network Management System iBuilder User Guide, Release 7.0.1
Figure 3-4: Filter Profile Examples Figure 3-5: Traffic Profile Examples
21
Network Management System iBuilder User Guide, Release 7.0.1
Components: Hub RFT Components
For detailed instructions on defining components within the Hub RFT Components folder, see
Preparing the Hub RFT Components Folders on page 61.
These folders include Manufacturers, Distributors, Operators, Customers and User Groups, as
shown below.
You can add additional entries to any folder by right-clicking on the folder and selecting Add [type
of component]. For example, you can right-click Manufacturers and select Add Manufacturer. A
22
Network Management System iBuilder User Guide, Release 7.0.1
dialog box appears allowing you to define a new manufacturer. When you have input the
information, click OK in the lower right corner of the dialog box (not shown).
23
Network Management System iBuilder User Guide, Release 7.0.1
Figure 3-8: iBuilders Main Screen
You can single-click a plus (+) or minus (-) sign next to an element in the Tree to expand or
contract the branches to the next level down in the tree for that element or folder. Once an element
has no plus sign or minus sign next to it, you can double-click any element to view the Properties
for that element in read-only mode.
For example, if the Hub RFT Components folder has a plus sign (+) next to it, you can double-click
it to expand it to see the four folders at the next level: Antenna, Up Converter, Down Converter,
and HPA. You can double-click any folder with a plus sign next to it to expand it to the next level.
However, once the folder is fully expanded and the elements within it are displayed, if you double-
click the actual element, the Properties for that element are displayed in read-only mode.
3.8.2 Globe
Using the Docking Feature
Docking refer to the ability to move a window pane of the NMS interface to another location on the
screen or to detach it from the screen entirely and place it somewhere else on your monitor. In
iDirects NMS, the dockable panes have double-ridge lines at the top of the pane.
To dock a window pane somewhere else on the NMS interface or on your monitor, follow the
procedure below:
Step 1 Point to and right-click the double-ridge lines of the pane you want to move
and select Allow Docking.
Step 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).
Step 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,
25
Network Management System iBuilder User Guide, Release 7.0.1
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.
Step 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 iBuilder window. This feature is useful if you have two
displays on a single PC and want to move this pane to the second display.
Expanding Tree
To expand the Tree to view all of the children elements, select Expand Tree. The Tree will expand
to show all of the child elements.
Figure 3-9: Expand Tree Selection Figure 3-10: Expanded Tree with Child Elements
Collapsing Tree
To collapse the Tree to view only the top level elements, select Collapse Tree. The Tree will
contract to show only the top level elements.
26
Network Management System iBuilder User Guide, Release 7.0.1
Figure 3-11: Collapse Tree Selection Figure 3-12: Collapsed Tree
Sorting Columns
In any pane with columns, or list controls, you can sort the entries in the pane by the values in any
column by clicking on the column heading. In the example below, the Active Users Pane has been
sorted on Group by clicking the column heading.
Step 1 Right-click the double-ridge lines above the Tree pane and select Sort Tree.
You can also select Edit Sort Tree...l
27
Network Management System iBuilder User Guide, Release 7.0.1
Step 3 Click the Sort items in drop-down list and select either Ascending or
Descending.
Step 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.
Step 5 If you select Name, either click the Names are case sensitive check box or
clear it.
Step 6 Select the element to which you want to apply the Sort feature. The options
are:
Remote
28
Network Management System iBuilder User Guide, Release 7.0.1
Hub
Inroute Group
Spacecraft
QoS Profile
Component
Manufacturer
Operator
Distributor
Step 7 Click OK. The next time you log in, iBuilder will remember and display the
last sort preference you chose.
Most elements and entries in the Tree are necessary to operate the network. However, some
folders are provided simply to enable you to add informational entries for reference and record-
keeping. These reference folders include the Manufacturers folder, Operators folder, Distributors
folder, and Customers folder.
29
Network Management System iBuilder User Guide, Release 7.0.1
A plus sign (+) next to an element or folder in the Tree indicates that additional elements, folders,
or informational entries exist below that level, or branch, of the Tree. Click the plus sign (+) to
expand, or collapse, the element or folder to view the next level of the Tree.
A minus sign (-) next to an element or folder indicates that the element or folder has been
completely expanded and has no other child entries below this level, or branch, in the Tree, other
than the children that are currently visible.
In the figure below, the NMS Network has been expanded as far as it can be. The NMS Network
cannot include children in another network; therefore, its only children are the Tx, Rx, and Standby
(Stdby) line cards, and the IG0 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.
In the example below, the QoS folder has been expanded as far as it can be. The QoS folder
cannot include children in another folder on the same branch of the tree; therefore, its only children
are the Filter Profiles and Traffic Profiles folders. The Filter Profiles and Traffic Profiles folders are
parents to the Downstream and Upstream folders that can be expanded by clicking their plus signs
(+) to reveal their children folders or elements below them in the Tree.
30
Network Management System iBuilder User Guide, Release 7.0.1
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 Toolbar, shown below, 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 3-1, Toolbar Icons and Functions, on page 31.
Opens the Modify Configuration dialog box of a highlighted parent element in the
Tree, allowing you to create a new child element for that parent. If the highlighted
element you select before clicking this button has no children elements, this icon
will become unselectable and is displayed in gray.
Allows you to add an element to the Tree. If the element in the Tree that is
highlighted before you click this icon does not have the capability to allow you to
add anything, the icon will become unselectable and be displayed in gray.
Allows you to view the properties of the highlighted element in the Tree in Read-
Only mode
Allows you to view and edit the highlighted element in the Tree.
Allows you to delete a highlighted element in the Tree. You CANNOT delete
parent node elements if they have children (sub) elements.
31
Network Management System iBuilder User Guide, Release 7.0.1
Table 3-1: Toolbar Icons and Functions (Continued)
Allows you to download firmware images to remote modems and line cards
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 means
that you are accepting the fact that changes have been made since the time of
your last login.
Allows you to view the version number of the NMS as well as system information
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 illustrates the various options within each category.
Binoculars
32
Network Management System iBuilder User Guide, Release 7.0.1
You can also click the Find button on the toolbar to open a dialog box that gives you the same
options.
Step 1 Select View Find Toolbar, or click the Find button on the toolbar. Either
the Find toolbar appears to the right of the main toolbar, or the Find dialog
box appears in the Results pane.
Step 2 Click the arrow on each drop-down list and click the criteria you want to use
in your search.
press Enter on the keyboard if you are searching from the Find toolbar
click the Binoculars icon to the left of the toolbar if you are searching
from the Find toolbar
click Find Next if you are searching from the Find dialog box
Step 4 In the example below, the user chose to look for a Remote by the Name of
3100-410 and display it in the Network Tree View.
That remote is highlighted in the Tree when the user clicks on the
binoculars icon.
33
Network Management System iBuilder User Guide, Release 7.0.1
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. If you have clicked an element in the Tree, the
Properties option is available also.
As you can see, the options on the View menu and those available by right clicking at the top of
the window are the same.
Status Bar
The Status bar is located at the bottom of the iBuilder 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.
34
Network Management System iBuilder User Guide, Release 7.0.1
Connection Details on Status Bar Icon
When your mouse hovers over the PC icon next to the user name on the Status bar, the IP address
of the NMS server that you are currently connected to is displayed.
35
Network Management System iBuilder User Guide, Release 7.0.1
Legend Pane
The Legend view displays the Configuration Status icons and their meanings. They are organized
by type of element as shown below:
36
Network Management System iBuilder User Guide, Release 7.0.1
Configuration Changes Pane
If another user changes the database, the Accept Configuration Changes icon on your toolbar will
become active.
If you want to view the changes in iBuilder before you click the icon to accept them, select
Configuration Changes from the View menu to display the Configuration Changes pane. You can
click the arrow to the left of each item to see more detail. The figure below shows the changes that
will appear if another user creates a new remote.
Note that creating a single remote results in a number of separate objects being created: antenna,
remote, default VLAN, etc. When you click the Accept Configuration Changes Icon, all entries will
be cleared from the Configuration Changes Pane.
37
Network Management System iBuilder User Guide, Release 7.0.1
Figure 3-15: Example of Configuration States
Properties View
The Properties view shows the properties of a highlighted element in the Tree, in Read-Only
mode. To view properties via the View menu, click an element in the Tree and select View
Properties, or simply double-click on the element.
Details
The NMS is shipped with predefined sets of details that may be viewed for any given element in
the Tree. Different elements have different predefined details. To view the details of a given
elements children who reside at the next level down in the tree, select View Details.
The Details view allows you to sort, view and print a number of details, including the real-time
states, of all or some of the elements under the parent node you have highlighted in the Tree. For
example, if you click a Network in the Tree, as shown in Figure 3-17, you can view the details about
that networks children (such as line cards and Inroute Groups) who reside on the same level of
the Tree, as shown in Figure 3-18. Notice that the remote in the Tree is not displayed in the Details
38
Network Management System iBuilder User Guide, Release 7.0.1
view. You do not see, however, the details of the Network, itself. If you want to view the Network
details, you must select its parent in the Tree.
Figure 3-17: Network Highlighted in Tree Figure 3-18: Result in Details View
To print a report of all the elements in the Details view, click anywhere in the Details view and
select File Print. You can print a portion of the view by using the Windows Explorer style
functionality to select any elements in the Details view (using the CTRL key and clicking on
individual elements, or using the Shift key to select a group of consecutive elements). Once the
desired elements are highlighted in the Details view, you can print a report of those elements
details by selecting File Print. (To customize the details you want in the report, see Customizing
Detail Views for Configuration Reporting on page 40.)
Figure 3-19: Network Highlighted in Tree Figure 3-20: Result in Details View
The Details + Collapse Details Hierarchy view collapses, or flattens, the hierarchy beneath a
highlighted element in the Tree so that you can view the details of all children elements at every
level of the Tree below the parent you selected. For example, if you click a Network in the Tree,
you can view the details about that networks children (such as line cards) who reside on the same
39
Network Management System iBuilder User Guide, Release 7.0.1
level of the Tree, and you CAN VIEW the details about the childrens sub-elements (such as
remotes) which reside at the second level down from the network you highlighted.
To view the details of all children elements at every level of the Tree below the parent you
selected, select View Details and View Collapse Details Hierarchy.
Choose Details
This option in the View menu allows you to modify the systems predetermined set of details for
any given element so that you can view only the details you need. For a detailed description on
using this feature, see Customizing Detail Views for Configuration Reporting on page 40.
Step 1 Click an element in the Tree for which you want to view details.
Step 2 Select View Choose Details from the Main Menu. The Choose Details
dialog box is displayed.
40
Network Management System iBuilder User Guide, Release 7.0.1
Step 3 Click the Select filter for Details list... drop-down list in the Choose Details
dialog box.
41
Network Management System iBuilder User Guide, Release 7.0.1
Step 4 Select one of the filters. Each filter offers a different set of details. For
example, the Carrier filter offers a list of all the predefined details that are
viewable when you highlight a carrier in the Tree and select Details from the
View menu.
When you select a filter, the detail choices appear in the Choose Details
dialog box, as shown below. The example below shows the details for
Carrier.
Step 5 From the list of available choices, click the details you want to view for the
element you have highlighted in the Tree.
42
Network Management System iBuilder User Guide, Release 7.0.1
a Use the Show All button on this dialog box to select all of the details with
one click.
b Use the Move Up and Move Down buttons to arrange the details in the
sequence in which you want them to appear from left to right on the Details
pane.
c Use the Hide All button to clear checkmarks from detail options you have
already checked.
Step 6 In the example below, only five details were chosen to remain in the Carrier
view: Name, ID, Type, Status and Carrier Type.
43
Network Management System iBuilder User Guide, Release 7.0.1
Step 7 When you are finished customizing the view, click OK to save the list of
details for this filter. The next time you open iBuilder, the last saved list of
details for any given filter are retained.
Step 8 Now that the details in the Carrier view have been altered to include only
these five details, you can select any element in the Tree (the element may
be a carrier or any other element), and select View Details, and only the
details you chose for the new Carrier view will be displayed for that element.
Step 9 In the following example, a carrier was selected in the tree. The user
selected View Choose Details Carrier OK. The user also selected
View Details for this element. If these options are selected, the following
details on the selected carrier are displayed in the Details view:
Step 10 If desired, you can now view Details or Details + Show All and print a report.
Step 1 Select View Choose Details from the Main Menu. The Choose Details
dialog box is displayed.
Step 2 Select a list of details that you want to display in your Details view by
clicking the arrow in the Select filter for details list drop-down box at the
bottom of the dialog box and choosing a set of details from which to start.
In the example below, the user selected All Available Fields to be displayed,
and then cleared some of the check boxes so that those details would not
appear in the Details view they were creating.
44
Network Management System iBuilder User Guide, Release 7.0.1
Step 3 Click the Plus (+) button to assign this custom filter a name. The Custom
Filter dialog box is displayed.
45
Network Management System iBuilder User Guide, Release 7.0.1
Step 4 Type a name into the field and click OK. When you add a filter, the buttons
at the bottom of the Choose Details pane change from:
to:
Step 5 To modify the field selection for a new filter, make the desired changes to
the detail selections for the filter and click the Modify button shown below:
Step 7 Change the name and click OK. A new filter is created.
Step 8 To delete a filter, click the X button at the bottom of the Choose Details
dialog box. A message appears to confirm that you want to delete the filter.
Step 10 If desired, you can now view Details or Details + Collapse Details Hierarchy
and print a report.
46
Network Management System iBuilder User Guide, Release 7.0.1
3.10 Working with Multiple Elements Simultaneously
The sections below describe how to modify parameters on multiple elements at the same time and
direct you to sections that describe how to work with multiple configurations and Image files.
1. You may select multiple elements only from the Details view. You cannot select
multiple elements from the Tree. Select View Details from the main menu to display
the Details pane.
2. All the elements you select must be of the same type. For example, elements to be
edited in a group must all be remotes or all be line cards, etc. You cannot edit, for
example, a remote and a line card in the same group.
3. You may only modify items in a group that have the same value, or have no value yet
assigned to them. For example, when editing a group of remotes, you may give them
all the same custom key or modify the custom key if they all have the same custom key
value. However, you will probably not be able to change the GEO location, because
this value is generally different on every remote in the group.
Step 1 Highlight an element in the Tree that is a parent to the elements to which
you want to make changes.
47
Network Management System iBuilder User Guide, Release 7.0.1
For example, Network is a parent element for line cards. However, any
element above Network can also serve as a parent element for line cards,
such as the Teleport or Protocol Processor.
Step 2 With a parent element highlighted in the Tree, select View Details from
the Main Menu. The Details pane is displayed to the right of the Tree, and
the elements to which you want to make changes appear in the list of
elements.
In this example, changes will be made to the remotes in the IG0 inroute
group. Therefore, IG0 has been selected as the parent element. The
elements on the next branch down from the inroute group parent level are
displayed in the Details pane. In other words, the child elements are the
only elements displayed. In this example, a line card and several remotes
are displayed.
Step 3 Use the Control (CTRL) key or the Shift key on your keyboard to highlight
the elements to which you want to make changes. In this example, changes
will be made to three remotes.
48
Network Management System iBuilder User Guide, Release 7.0.1
Step 4 Right-click the highlighted elements in the Details pane (in this case, the
remotes) to open the Configuration or Configuration and Control dialog box.
Step 5 To modify all of them, click Modify. The Modify Configuration dialog box for
those elements appears.
Step 6 Make the changes you want to apply to ALL of the selected elements, and
click OK. The changes are saved in the database.
Step 3 Once youre satisfied with the changes, make them active in the network by
applying them to the components that you changed via the Apply
Configuration or a multicast download feature
This three-step change process gives the network operator ultimate control over operational
network components, because no change takes place without the operator initiating it. However,
it creates a situation where the NMS database is temporarily out-of-sync with the actual network.
This occurs after the operator has made database modifications, but before they have been
applied to the network.
49
Network Management System iBuilder User Guide, Release 7.0.1
To help operators easily manage this situation and others like it, iDirect implements the concept
of configuration state. Configuration states show the current configuration status of key
components of the network: Hub Chassis, individual networks, line cards, and remote modems.
Using a specific modification as an example, we can see how configuration state changes over
time:
1. Remote r_123 is configured, commissioned, and all previous changes have been
applied. Its configuration state is Nominal.
4. User reviews the changes, determines they are correct, and then applies them to the
remote.
50
Network Management System iBuilder User Guide, Release 7.0.1
Table 3-2: Configuration States
Configuration Network
Definition Applies to
State Element
Network Remote
Chassis Hub
The element is completely configured, is alive in the
Nominal Line Card network, and there are no unapplied changes. Network
Remote Chassis
Network Remote
Chassis The element is completely configured and is alive in the Hub
Changes network. There are changes in the database that have
Pending Line Card Network
not been applied.
Remote Chassis
Network Remote
The element is only partially configured; one or more
Chassis Hub
key components of the configuration are unspecified
Incomplete Line Card (e.g. carriers, IP address, serial number) Network
Remote Chassis
Network Remote
Chassis Hub
The element is completely configured but the
Never Applied Line Card configuration has never been applied to the element. Network
Remote Chassis
The remote modem was at one time active in the
Deactivated Remote network, but it has been deactivated. Remote
51
Network Management System iBuilder User Guide, Release 7.0.1
An explanation of all configuration states for all elements, their meaning, and their respective icons
is available in iBuilder by selecting View Legend from the main menu.
See also Configuration Changes Pane on page 37 and Configuration Status View on page 37.
You changed configuration. Whenever you change the configuration, the Changes
Pending icon appears beside all affected network elements.
Someone else changed configuration. iBuilder supports multiple simultaneous logins.
If another user changes configuration, your network tree icons will change to reflect the
current configuration state.
Someone changed a modems configuration directly. When a modem comes into the
network, the configuration server uploads the active configuration from the remote and
re-calculates configuration state. If this configuration is different from the latest iBuilder
configuration, you will see the Changes Pending icon for that modem. This can
happen if someone changes a modems configuration from the console or the iSite
utility. This potentially dangerous situation is flagged by the configuration state.
You installed a new version of the Configuration Server. When the configuration server
starts up, it re-generates the configuration files for all networks, hubs, and remotes.
The new server may generate additions, deletions, or changes to the configuration
files. If so, all affected elements will display the Changes Pending icon after the new
server starts up.
52
Network Management System iBuilder User Guide, Release 7.0.1
An explanation of the configuration states, their meaning, and their respective icons is available
in iMonitor by selecting View Legend from the main menu.
When you exit iBuilder and log back in, the teleport will move from the bottom of the Tree to the
bottom of the list of teleports. In the example below, we named the new teleport Dulles. Notice
that the teleport names are not sorted alphabetically.
The NMS database assigned a system-generated number to each element when it is created. The
first teleport is assigned the number 1. The second teleport is assigned the number 2, and so
on. The same number assignment takes place with every element created in the tree. Therefore,
the first spacecraft would be named New Spacecraft #1, and so on. This number is always
associated with its original element. This is how the database keeps track of the elements and the
configurations and management control associated with it as long as it exists in the Tree. If an
element is deleted, the numbers of the elements created after it do not change numbers. For
example, if you have five teleports and teleport number 3 is deleted, teleport number 4 does not
become teleport number 3. Teleport number 4 remains teleport 4 forever. If a sixth teleport is
created, it becomes teleport number 6, not number 3.
53
Network Management System iBuilder User Guide, Release 7.0.1
3.13 In Color versus Shaded Icons
If an icon next to a component (such as a user, QoS profile, BUC, LNB, Converters, etc.) in the
Tree is in color, it indicates that component is being used somewhere in the network. Therefore,
if you perform any configuration or control functions on that element, it will affect other elements
in the network. If you modify the element, a message is displayed warning you that if you make
changes to this element, any other element in the database that is using it will be changed also.
As long as the icon is in color, you cannot delete the element.
If the icon next to an element in the Tree is unavailable and displayed in gray, you can make
modifications without it affecting other elements in the network.
54
Network Management System iBuilder User Guide, Release 7.0.1
3.14 Configuring Warning Properties
Warnings that indicate anomalous conditions on your iDirect equipment are generated by the
iDirect network and displayed in iMonitor. You can configure the properties that determine how
individual warnings are generated for the following network elements:
Line cards
Remotes
Protocol processors
There are two categories of warnings:
Limit-based warnings are generated when either the high or low limit defined for the
warning is violated. A warnings range can specify a low limit, a high limit or both.
Boolean warnings have two states: the warning is either off or on. A boolean warning
is generated when the value being monitored by the warning changes from the nominal
state to the anomalous state. For example, if a line card loses the chassis backplane
10 MHz timing signal, then the BackplaneLost10MHz warning is generated for the line
card.
You can perform the following operation when configuring warning properties:
You can use iBuilder to modify both global properties of warnings and warning properties for
individual network elements. When you customize a warning for an individual element, the new
setting overrides the global setting. Changes to global warning settings apply only to those
elements that do not have their settings customized on an individual basis.
55
Network Management System iBuilder User Guide, Release 7.0.1
The behavior of the system with regard to global properties and individual overrides is as follows:
A warning whose properties have not been modified for an individual element uses the
global properties for that warning. In the event that the global properties of the warning
are modified, the new global properties will be used by the element.
A warning whose properties have been modified for an individual element uses the
customized properties for that warning for that element. Changes to the global
properties of the warning have no effect on the warning properties configured for that
element; the element will continue to use the modified properties.
When a warning that has been modified for an individual element is reset for that
element, any properties that were previously modified for the warning take on the
current, global values.
To set global warning properties for your line cards, remotes or blades, follow these steps:
Step 1 Click the Edit menu and select Global Warnings for the element type. In this
example, Global Warning for Linecards is selected from the menu.
56
Network Management System iBuilder User Guide, Release 7.0.1
The Modify Global Warning dialog box appears with all warnings
appropriate to the selected network element type.
Step 2 Select the Warning Type for the warning you want to modify and click the
Edit button.
Step 3 Enter the new settings in the Modify Warning dialog box and click OK to
save the changes.
The Limit Value setting determines the high or low limit of the normal
range of values for the network parameter being monitored. When this
limit is crossed, a warning is generated. You can only set the Limit Type
for limit-based warnings. This field does not apply to boolean warnings.
57
Network Management System iBuilder User Guide, Release 7.0.1
The Send Value Change setting determines whether or not the warning
will be generated each time a value changes while that value is outside
normal operating limits. If the check box is selected, a new warning will
be generated each time the abnormal value changes. If the check box
is cleared, a warning will be generated the first time an abnormal value
is detected, but not if the abnormal value changes. You can only set the
Send Value Change property for limit-based warnings. This field does
not apply to boolean warnings.
The Enabled setting enables or disables the warning. If you clear this
check box, the warning will not be generated.
Step 1 Right-click the network element in the network tree and select the
appropriate Modify option from the context menu.
Step 2 When the dialog box for the network element appears, click the Warning
Properties tab.
Step 3 Select the Warning Type for the warning you want to reconfigure and click
the Edit button.
58
Network Management System iBuilder User Guide, Release 7.0.1
Step 4 Follow the procedure beginning with Step 2 in Setting Global Warning
Properties on page 56 to reconfigure the warning properties.
Warnings that have been customized are highlighted in bold text on the Warning Properties tab.
In the example, the BackplaneLost10MHz warning has been disabled for this specific line card.
Step 1 Right-click the network element in the network tree and select the
appropriate Modify option from the context menu.
Step 2 When the dialog box for the element appears, click the Warning Properties
tab.
Step 3 Select the warning for which you want to clear the customized settings.
(Warnings with customized settings are highlighted in bold text.) Then click
the Reset button at the bottom of the screen. The following dialog box will
appear:
Click OK in the dialog box. Then click OK on the Warning Properties tab. The warning that you
reset will be reconfigured with the global settings.
59
Network Management System iBuilder User Guide, Release 7.0.1
60
Network Management System iBuilder User Guide, Release 7.0.1
4 Defining Hub RFT Components and the Satellite
A spacecraft must exist in the Tree before the Hub RFT (Radio Frequency Terminal) can be
defined. However, before you define the spacecraft, you must define the Hub RFT Sub-
Components. This includes:
Antenna
Up Converter
Down Converter
High Power Amplifier (HPA)
You should add entries to these folders in advance and define the parameters of the components
you add so that the appropriate information is already in the drop-down lists on the Hub RFT
configuration dialog box. The steps below carry you through the configuration of these sub-
components.
Step 2 In Manufacturer Part Number, enter a part number or name for the antenna.
You may enter any information you like in this field, or leave it blank.
Step 3 You may also select a manufacturer in the Manufacturer drop down box
by selecting the appropriate manufacturer from the available list. The items
61
Network Management System iBuilder User Guide, Release 7.0.1
in this list were either pre-existing or were added when you populated the
folder earlier. See Adding Entries to Folders on page 22.
Step 4 You may also enter an iDirect Part Number for the antenna (optional). You
may enter any information you like in this field, or leave it blank.
Step 5 Click OK. The new antenna appears in the Tree under the antenna folder.
Step 6 If you have more than one antenna, repeat this procedure and assign the
new antenna a different name.
Be sure to enter the correct frequency translation values for all of your
NOTE Up and Down Converters. The NMS will use these values later to
generate network configurations.
Step 1 Under the Hub RFT Components folder in the Tree, right-click the Up
Converter folder, and select Add Up Converter or Add Down Converter.
The new converter appears in the Tree with a system-generated generic
name, and a dialog box appears allowing you to define its parameters. The
examples below show an Up Converter being added; however, the
procedure is the same for adding a Down Converter.
62
Network Management System iBuilder User Guide, Release 7.0.1
Step 2 In Manufacturer Part Number, enter a part number or name for the Up
Converter. You may enter any information you like in this field, or leave it
blank.
Step 4 You may also select a Manufacturer for the Up Converter (optional).
Step 5 Enter an iDirect Part Number for the Up Converter (optional). You may enter
any information you like in this field.
Step 6 Select ODU Tx DC Power and ODU Tx 10 MHz if you require the iDirect
modem to supply DC power and the 10 MHz clock. These settings are
applicable only if you are operating a small teleport whose BUC and LNB
are not built into the antenna. (The iDirect chassis and line cards do not
provide these capabilities; private hubs, mini hubs and remote modems
have these capabilities built into them.)
Step 7 In Spectral Inversion, leave it at Normal UNLESS you are using C-band. If
the local oscillator is higher in frequency than the one being transmitted or
received, then the spectrum must be inverted.
63
Network Management System iBuilder User Guide, Release 7.0.1
Step 8 Click OK. The new Up Converter appears in the Tree under the Up
Converter folder.
Step 9 If you have more than one Up Converter, repeat this procedure and assign
it a different name.
Step 10 Repeat these steps for all of the Down Converters at your teleport.
64
Network Management System iBuilder User Guide, Release 7.0.1
Step 2 In Manufacturer Part Number, enter a part number or name for the HPA,
or use the system-generated generic name.
Step 3 You may also select a Manufacturer for the HPA (optional).
Step 4 You may also enter an iDirect Part Number for the HPA (optional). You may
enter any information you like in this field, or leave it blank.
Step 5 Click OK. The new HPA appears in the Tree under the HPA folder.
Step 6 If you have more than one HPA, complete this procedure again and assign
it a different name.
65
Network Management System iBuilder User Guide, Release 7.0.1
Step 3 Enter the exact Longitude (between 0 and 180 degrees) of the satellite.
This information can be obtained from your satellite service provider.
Step 4 To the right of the Longitude box, enter the Hemisphere: E (East) or W
(West).
Step 5 You rarely have to enter the Orbital Inclination. This is necessary only if
the satellite is experiencing difficulty or is coming to the end of its life cycle,
in which case the satellite provider will provide you with the orbital
inclination.
Step 6 Select the name of the Operator (normally the service provider, assuming
that your company is not the provider). (Optional.) You can click the
Operator drop-down box to view a list of operators you have entered into
the NMS, and select one of them.
Step 8 Click OK. The spacecraft appears in Tree under the Spacecraft folder.
To define a transponder, you must first have a spacecraft defined in the Tree. To add and define
a transponder, follow the procedure below:
Step 1 Right-click to select a Spacecraft and select Add Transponder. The new
transponder appears in the Tree with a system-generated generic name,
and a dialog box appears allowing you to define its basic parameters.
66
Network Management System iBuilder User Guide, Release 7.0.1
Step 2 In Operator Reference Name, enter a name for the transponder to identify
it in the Tree.
Step 3 Enter the Translation Frequency. This information can be obtained from
your satellite provider. The frequency, in MHz, is transponder specific. It is
that frequency used to down convert the radio frequency (RF) uplink to the
RF downlink for retransmission from the satellite. This information must be
correct for your networks to function correctly.
Step 4 Enter the information for the remaining fields, which can also be obtained
from your service provider. This information is for reference purposes only.
67
Network Management System iBuilder User Guide, Release 7.0.1
4.4 Adding Bandwidth
A bandwidth region defines a specific portion of the satellites transponder within which you can
define transmit and receive bandwidth carriers. You must define at least one bandwidth region in
order to create carriers. To add and define a bandwidth region, follow the procedure below:
Step 1 Right-click the transponder and select Add Bandwidth. The new bandwidth
entry appears in the Tree with a system-generated generic name, and a
dialog box appears allowing you to define its basic parameters.
Step 2 On the Information tab, in the Operator Reference Name box, enter a name
to identify the bandwidth in the Tree.
Step 3 Enter the Center Frequency, Bandwidth, and Power values, which can be
obtained from your service provider. This information is for reference
purposes only.
68
Network Management System iBuilder User Guide, Release 7.0.1
Step 4 Click OK. A bandwidth entry appears in the Tree.
In addition to providing the outbound carrier for a network of TDMA remotes, a dedicated
downstream carrier can be used to send data on a point-to-point connection from an iSCPC line
card at the hub to a single iSCPC remote. In that case, the iSCPC remote transmits back to the
hub on an iSCPC upstream carrier. (For details, see Adding Upstream SCPC Carriers on
page 74.)
Step 1 Right-click on the bandwidth for your transponder and select Add
Downstream Carrier. The new carrier appears in the Tree with a system-
69
Network Management System iBuilder User Guide, Release 7.0.1
generated generic name, and a dialog box appears allowing you to define
its basic parameters.
70
Network Management System iBuilder User Guide, Release 7.0.1
Step 2 Enter a name for the downstream SCPC carrier.
Step 3 Enter the Uplink Center Frequency. The Downlink Center Frequency will
automatically be calculated when you press Tab or click in the Downlink
Center Freq box. This information can be obtained from your satellite
provider, as it is part of the satellite link budget process.
Step 4 In the Error Correction drop-down list, select the type of forward error
correction (FEC). See also chapter 4, iDirect Modulation Modes and FEC
Rates of the iDirect Technical Reference Guide.
Step 5 In Power, enter a value for the transmit power. The default is -25dBm.
Step 6 Enter either a Transmission Rate, Information Rate, or Symbol Rate. See
also chapter 4, iDirect Modulation Modes and FEC Rates of the iDirect
Technical Reference Guide. Entering any of the rate values will cause the
remaining rates to be automatically calculated. Typically, you would enter a
desired transmission rate and the service provider would determine if that
could be accomplished.
Step 8 In Timeplan Parameters, enter the number of FEC Blocks in each frame. The
frame length is automatically calculated, based on FEC Blocks, FEC rates
and transmission data rate. iDirect recommends that the number of FEC
blocks is set such that the frame length is ~125 ms.
71
Network Management System iBuilder User Guide, Release 7.0.1
To add an Upstream carrier (Inbound Carrier), follow the procedure below:
Step 1 Right-click Bandwidth, and select Add Upstream Carrier. The new carrier
appears in the Tree with a system-generated generic name, and a dialog
box appears allowing you to define its basic parameters.
72
Network Management System iBuilder User Guide, Release 7.0.1
Step 2 Enter a name for the upstream TDMA carrier.
Step 3 Enter the Uplink Center Frequency. This frequency assignment is provided
as part of the satellite link budget process and comes from the satellite
provider.
Step 4 The Downlink Center Frequency will automatically be calculated when you
click in the Downlink Center Freq box, based on the previous transponder
translation frequency.
Step 5 In the Error Correction drop-down list, select the type of forward error
correction (FEC). See also chapter 4, iDirect Modulation Modes and FEC
Rates of the iDirect Technical Reference Guide.
Step 6 Select the Modulation for your carrier: BPSK, QPSK or 8PSK.
Step 7 When building a new carrier, the Assigned to Line Card box is not available.
The field is populated automatically after the Hub RFT is assigned to this
satellite and this carrier is assigned under the hub line card configuration.
a The Acquisition Aperture Length is the size of the acquisition window in the
Time Plan. It is automatically calculated for you.
b Guard Band is the time between bursts on the TDMA upstream carrier. This
parameter is typically set to eight symbols.
c Frame Length and Traffic Slots for an upstream carrier are determined
when the carrier is assigned to a line card in a network with a downstream
73
Network Management System iBuilder User Guide, Release 7.0.1
carrier already assigned. Frame Length is the size of the Time Plan frame
in msec. Each frame is composed of or divided into many timeslots, based
on data rate, FEC, etc. Each time slot is a slice of time allotted to a remote
to send its data traffic.
Step 10 Click OK to save your settings. The Upstream Carrier appears in the Tree.
Step 1 Right-click on the bandwidth for your transponder and select Add Upstream
SCPC Carrier. The new carrier appears in the Tree with a system-generated
generic name, and a dialog box appears allowing you to define its basic
parameters.
74
Network Management System iBuilder User Guide, Release 7.0.1
Step 2 Enter a name for the upstream SCPC carrier.
75
Network Management System iBuilder User Guide, Release 7.0.1
76
Network Management System iBuilder User Guide, Release 7.0.1
5 Defining Network Components
The Teleport is the highest component in the Tree hierarchy and represents the facility where the
antenna and, typically, the rest of the Hub equipment is housed. After adding a Teleport, you can
add a Protocol Processor (PP), Blades, Hub RFT, and Chassis to the Tree. This chapter discusses
how to configure all of these components, with the exception of the chassis. Because the chassis
requires a different type of configuration process, it is discussed in another chapter. See chapter
9, Configuring the Initial Hub Chassis.
77
Network Management System iBuilder User Guide, Release 7.0.1
Step 2 On the Information tab, enter a name and a phone number for your
Teleport facility.
Step 3 Click the Geo Location tab. The Geo Location identifies precisely where
the Uplink facility (the Hub RFT) is geographically located on the Earth. The
teleport transmits the uplink signal to the satellite and receives the downlink
signal from the satellite.
Step 4 Enter the exact Latitude and Longitude of your teleport facility. This
information can be obtained from your service provider or can be
determined with a GPS device. Be sure to select the correct hemisphere for
each. Latitude represents North and South; longitude represents East and
West.
Step 5 Click OK to save your settings. The Teleport appears in the Tree.
The procedure for configuring your backup teleport assumes that your primary teleport is already
operational and that your backup teleport has been installed. Generally, the iBuilder configuration
78
Network Management System iBuilder User Guide, Release 7.0.1
of the backup components should be identical to the configuration of the primary teleport. During
operation, any configuration changes that you make at the primary teleport should also be made
at the backup teleport. This can be accomplished using the NMS database backup and restore
utility described in the iDirect Technical Note NMS Redundancy and Failvover.
If you are using the same outbound carrier for your primary and
backup teleports, the teleport operator must disable the backup
NOTE transmitter while the primary teleport is operational. In the event
of failure of the primary site, the teleport operator must enable the
backup transmitter for the backup teleport to become operational.
Using iBuilder at the primary teleport, follow these steps to configure your backup teleport hub
equipment and to add your existing remotes to the backup teleports networks. The procedure
assumes that your primary teleport and the networks it controls are already configured in iBuilder
and operational.
Step 1 Add the backup teleport to your network by following the steps in the
section Adding a Teleport on page 77. Then configure all the components
of the backup teleport, including:
79
Network Management System iBuilder User Guide, Release 7.0.1
Step 3 In the Backup NMS area of the Teleport dialog box, select Enabled. Then
enter the IP address (or addresses) of the NMS server(s) at your backup
teleport.)
Step 4 After you have enabled the Backup NMS, all remotes will have changes
pending. Apply the changes for each network as follows:
80
Network Management System iBuilder User Guide, Release 7.0.1
b In the Automated Configuration Downloader dialog box, select all remotes
and line cards.
Step 5 Right-click the protocol processor and select Apply Configuration from the
menu. Then click Yes in the confirmation dialog box to update the protocol
processor and blades.
a Right-click the remote in the network tree and select Add to Networks from
the menu to display the Roaming dialog box.
81
Network Management System iBuilder User Guide, Release 7.0.1
b In the Roaming dialog box, select the remotes Network under the backup
teleport.
Step 1 To create a Hub RFT, right-click Teleport, select Add Hub RFT. The new
Hub RFT appears in the Tree with a system-generated generic name, and
a dialog box appears allowing you to define its basic parameters.
Step 2 Enter a name for the Hub RFT, and then select the subcomponents for the
Hub RFT from each of the drop-down list boxes.
Step 4 Click OK. The Hub RFT appears in the Tree with its new name.
82
Network Management System iBuilder User Guide, Release 7.0.1
5.4 Adding a Protocol Processor
After adding the Hub RFT, create the Protocol processor. Networks can be expanded by adding
additional processing elements, referred to as Blades, to the Protocol Processor. The Protocol
Processor architecture provides both scalability and automatic failover. If a blade fails, its load is
automatically distributed across the remaining blades; the previous manual switchover process is
obsolete.
Step 1 To create a Protocol Processor (PP), right-click the Teleport, and select
Add Protocol Processor. The new Protocol Processor appears in the Tree
with a system-generated generic name, and a dialog box appears allowing
you to define its basic parameters.
83
Network Management System iBuilder User Guide, Release 7.0.1
Step 2 On the Information tab, enter a name for your Protocol Processor (PP).
Step 3 Enter your User Password and the Admin Password. The default passwords
are shown in the dialog box above. These passwords are used for the
Console and telnet logins. Make sure you record any changed password in
case you forget it. You will not be able to log in with the default passwords
once they are changed.
Step 4 In Download Monitor Credentials, enter any value greater than one and less
than four billion. (This number is used for multicast firmware image
download and can be duplicated across multiple PPs.)
Step 5 In Upstream Gateway, enter the IP address of your upstream router. This
should be the address of the router interface connected to the upstream
LAN segment.
Step 6 Click Enabled RIPv2 if you want the Protocol Processor to advertise remote
routes to your upstream router using the protocol RIPv2. This setting affects
your default VLAN only.
84
Network Management System iBuilder User Guide, Release 7.0.1
Step 7 Select the Upstream and Tunnel Interfaces. The tunnel is the LAN segment
between the Protocol Processor and the line cards.
Step 8 A persistent multicast group is a multicast group that includes all remotes
communicating with this protocol processor. A remote will be a member of
this group even if it has not been acquired into the network.
For details on configuring warning properties for line cards, remotes and protocol processors,
please see Configuring Warning Properties on page 55.
85
Network Management System iBuilder User Guide, Release 7.0.1
Step 1 You can use either the Blades tab of the Protocol Processor or the Tree
context menu to add a Blade. Both methods are shown here.
a Right-click the Protocol Processor in the Tree and select Modify Item.
Then select the Blades tab and click the Add button.
a Alternatively, right-click the Protocol Processor in the Tree and select Add
Blade.
86
Network Management System iBuilder User Guide, Release 7.0.1
In either case, the Protocol Process Blade dialog box appears allowing you
to define its parameters.
Step 3 Enter the Upstream Interface information for the default VLAN. (iBuilder will
automatically assign the Upstream Interface information for other existing
VLANs.)
Step 4 Enter the Tunnel Interface information for the default VLAN.
87
Network Management System iBuilder User Guide, Release 7.0.1
5.7 Adding a VLAN
Due to the distributed architecture of the Protocol Processor, all blades in a blade set combine to
form a single, logical, upstream interface. However, each blade must have a distinct IP address
for each VLAN. This is illustrated below for a single VLAN.
End-to-End VLAN
Network
PP Blade 1
Upstream PP Blade 2
Remote
VLAN SAT
Remote VLAN
Link
Segment PP Blade 3
Segment
VLAN-Aware
Switch or
Router
PP Blade 4
For more information on VLANs, see VLAN and LAN Information on page 123.
To add a VLAN:
Step 1 Right-click the Protocol Processor in the Tree and select Modify Item.
88
Network Management System iBuilder User Guide, Release 7.0.1
Step 2 Select the VLANs tab in the Protocol Processor dialog box.
Step 4 Enter a VLAN ID and VLAN Name. VLAN IDs can range from 2 to 4094.
Step 5 Select Enable RIPv2 to advertise remote routes to your upstream router
using the protocol RIPv2.
Step 6 In the Address Start field, specify the Upstream Interface IP Address to be
used by the first blade. iBuilder automatically enters the remaining IP
addresses
89
Network Management System iBuilder User Guide, Release 7.0.1
Step 1 On the VLAN tab, select the row containing the ID and Name of the interface
you want to modify and click Edit.
If a new blade is subsequently added for scalability, all VLAN end addresses will be automatically
updated to give the new blade the appropriate upstream interfaces, and the VLANs will be added
to the new blade.
90
Network Management System iBuilder User Guide, Release 7.0.1
Do not change the default MTU (1500) on the tunnel interface
WARNING (eth1).
91
Network Management System iBuilder User Guide, Release 7.0.1
92
Network Management System iBuilder User Guide, Release 7.0.1
6 Defining Networks, Line Cards, and Inroute Groups
The network child elements include the line cards or 10000 series satellite hub, the inroute groups,
and the remotes. Before you add a Network, you must have already added a Protocol Processor.
Step 1 Right-click the Protocol Processor (PP), and select Add Network. The new
network appears in the Tree with a system-generated generic name, and a
dialog box appears allowing you to define its basic parameters.
93
Network Management System iBuilder User Guide, Release 7.0.1
Step 2 Enter a name for the Network.
Step 3 Click the IF Network check box only if you are creating an L-Band/Bench
Test network. This will disable the Geo Location entry for all remotes on this
network.
6.3 Adding a Tx Line Card, a Tx/Rx Line Card, or a 10000 Series Hub
After creating the Network, you must add either a transmit (Tx) line card, a transmit/receive (Tx/
Rx) line card, or a 10000 series hub. A 10000 series Satellite Hub is configured by selecting the
correct hub model (Private Hub or Mini-Hub) in the drop-down menu. Only one line card in each
network may have transmit capabilities. You should have already created a carrier. If you have
not, the line card will have an Incomplete status until a carrier is created and assigned to it.
If you are adding mesh capabilities to your network, you must use an M1D1 line card or a Private
Hub for your mesh downstream carrier. Mini hubs and Private Hub-S models are not supported.
Selecting mesh-enabled will configure your line card or hub to monitor the downstream carrier. For
more details on adding mesh communications to your iDirect network see chapter 3, Mesh
Technical Description of the iDirect Technical Reference Guide.
94
Network Management System iBuilder User Guide, Release 7.0.1
Step 1 Right-click Network and select Add Transmit Line Card. The new line card
appears in the Tree with a system-generated generic name, and a dialog
box appears allowing you to define their basic parameters.
Step 3 Select a Model Type. The model type you select must match the installed
line card or 10000 series hub. If you are configuring a Mesh Enabled line
card, you must select either PrivateHub or M1D1 as the Model Type.
95
Network Management System iBuilder User Guide, Release 7.0.1
concept of a Derived ID, or DID. The DID is a 32-bit integer formed by
joining a model type code with a units serial number. Each remote and line
card will have a unique DID value.
Step 5 Select the Line Card Type from the drop-down box. You may select a
transmit or transmit/receive line card. See chapter 4, iDirect Modulation
Modes and FEC Rates of the iDirect Technical Reference Guide.
Step 6 Select the Hub RFT that is associated with this network. This selection gives
you a list of carriers.
b When you commission the line card, you must specify the following Uplink
Control Parameters for a transmit line card if it is going to be used in a mesh
network:
SCPC LB Clear Sky C/N is the C/N of the loopback SCPC carrier as
measured by the line card modem under clear sky conditions. This
value is typically set during hub commissioning.
Hub UPC Margin is the maximum amount of uplink power control
available at the hub through an external device.
For more information on setting these parameters, see Set the Clear Sky
C/N Parameter for a Mesh Outroute on page 247 and Set the UPC Margin
for a Mesh Outroute on page 248.
Step 9 By default, the User Password is set to iDirect and the admin password is
set to P@55w0rd!. You may specify alternate passwords.
Step 10 Select the Transmit Carrier associated with this line card. If this is a
transmit/receive line card, also select the Receive Carrier.
Step 11 The line card appears in the Tree under the Network.
You must correctly specify both the serial number and the model
type for a line card or 10000 series hub to function properly. If you
WARNING configure an M1D1 card as an M0D1 card, for example, the line
card will not operate in a network.
96
Network Management System iBuilder User Guide, Release 7.0.1
6.4 Setting Warning Properties for Line Cards
You can use iBuilder to modify both global properties of line card warnings and warning properties
for individual line cards. To change global warning properties for line cards, select Global
Warnings for Linecards from the Edit menu. To change warning properties for individual line cards,
click the Warning Properties tab for the line card you want to modify.
For details on configuring warning properties for line cards, remotes and protocol processor
blades, please see Configuring Warning Properties on page 55.
Step 1 Right-click Network and select Add Receive Line Card. The new line card
appears in the Tree with a system-generated generic name, and a dialog
box appears allowing you to define its basic parameters.
97
Network Management System iBuilder User Guide, Release 7.0.1
Step 2 You may use the system-generated generic name or enter a new name for
the card.
Step 4 Enter a Serial Number. A system-generated DID is displayed in the DID box.
Step 6 By default, the User Password is set to iDirect and the admin password is
set to P@55w0rd!. You may specify alternate passwords.
Step 7 In Receive Properties, select the Carrier associated with this line card.
Step 8 The receive line card appears in the Tree under the Network.
98
Network Management System iBuilder User Guide, Release 7.0.1
6.6 Adding an iSCPC Line Card
An iSCPC line card is the hub equipment that transmits and receives the SCPC carriers used in
a point-to-point connection with an iSCPC remote. You can configure the following iDirect Model
Type as an iSCPC line card:
As with TDMA networks, you must configure a Hub RFT record for the hub end point of an iSCPC
link, and a set of VSAT components for the remote end point. You may use traditional VSAT
components in your Hub RFT, such as iDirect-supported BUCs and LNBs, by defining these
components in the HubRFT Components folder in iBuilders network tree. You may also use an
existing Hub RFT definition in iBuilder.
Step 1 Right-click your Teleport and select Add iSCPC Line Card. The new line
card appears in the Tree with a system-generated generic name, and a
dialog box appears allowing you to define its basic parameters.
99
Network Management System iBuilder User Guide, Release 7.0.1
Step 2 Enter a Name for the line card.
Step 3 Select the Model Type of the line card or remote you are using to terminate
your SCPC connection at the hub.
Step 4 Enter a Serial Number. A system-generated DID is displayed in the DID box.
Step 5 Select the Hub RFT that is associated with your iSCPC line card.
Step 6 At this point, the procedure for configuring the iSCPC line card is similar to
the procedure for configuring a remote. To complete the configuration of the
line card, follow the instructions in chapter 7, Configuring Remotes
beginning with the section titled Information Tab on page 116. Special
considerations related to iSCPC line cards are noted in those instructions.
100
Network Management System iBuilder User Guide, Release 7.0.1
6.7 Defining a Standby Line Card
Only one standby line card may be defined for any one network. Standby line cards are configured
similarly to transmit and receive line cards, by right-clicking Network and selecting Add Standby
Line Card, or by selecting Standby in the Line Card Type drop-down box in the Modify
Configuration dialog box.
When a standby line card is defined, the NMS can automatically detect the failure of an operational
line card in a network and will swap that card with the standby line card. It is not required that a
standby line card be configured for a network. If there is no standby configured, the NMS servers
will not attempt to initiate the failover operation.
The option to command a standby line card to back up only the transmit line card allows you to
favor the card that is the most critical to the network. In a multi-inroute, frequency-hopping
network, the failure of a receive-only line card results in diminished upstream bandwidth only;
remotes will automatically load-balance across the remaining receive line card(s) without dropping
out of the network. If the transmit line card fails, however, the entire network will be out of service.
You can guard against a double failure by setting the standby line card to back up the transmit line
card only. This ensures that the standby line card will be available to take over for a failed transmit
line card even in the case of a prior receive line card failover.
You can control the line cards behavior during failover by selecting the desired option in the
Perform Automatic Failover drop-down list on the standby line cards Modify dialog. Four
selections are available in the menu:
101
Network Management System iBuilder User Guide, Release 7.0.1
Select None to disable automatic failover. In the case of a line card failure, you must
initiate the failover operation from iBuilder by selecting the Swap Line Card option from
any non-standby line card in the network.
Select All to configure the standby line card to backup all transmit and receive line
cards. (This is the default selection.)
Select Tx Only to configure the standby line card to backup only your transmit line card.
Select Rx Only to configure the standby line card to backup only your receive line
cards.
Automatic failover will occur only when the NMS fails to receive the expected heartbeat message
from the line card. This message will be lost if the line card fails, or if any component in the
communication path between the NMS and the line card fails.
2. The standby line card must be in the OK state (and accessible from the NMS) as
determined by the NMS event server.
3. The chassis must be currently accessible through the EDAS TCP interface.
If conditions two or three cannot be met during normal operation, the standby line card will enter
the WARNING state in iMonitor and the event server. The text of this warning is:
For Tx(Rx) line cards, the standby assumes the failed cards role immediately. For Rx line cards,
the standby needs to flash a new options file and reset. The estimated time to complete a Tx(Rx)
line card failover is less than 10 seconds; the estimated time to complete a Rx-only line card is
less than 1 minute.
If your Tx line card fails, or you only have a single Rx line card
NOTE and it fails, all remotes must re-acquire into the network after
failover is complete.
102
Network Management System iBuilder User Guide, Release 7.0.1
6.7.4 Tx(Rx) versus Rx-Only Line Card Failover
The most important line card in a network is the Tx(Rx) line card; if this card fails, all remotes drop
out of the network. When an Rx-only card in a frequency-hopping inroute group fails, all remotes
automatically begin sharing the other inroutes. While this may result in diminished bandwidth,
remotes do not drop out of the network.
iDirects failover method guarantees the fastest failover possible for the Tx(Rx) line cards. The
standby line card in each network is pre-configured with the parameters of the Tx card for that
network, and has those parameters loaded into memory. The only difference between the active
Tx(Rx) card and the standby is that the standby mutes its transmitter (and receiver). When the
NMS detects a Tx(Rx) line card failure, it sends a command to the standby to un-mute its
transmitter (and receiver), and the standby immediately assumes the role of the Tx(Rx) card.
Rx-only line cards take longer to failover than Tx(Rx) cards because they need to receive a new
options file, flash it, and reset.
103
Network Management System iBuilder User Guide, Release 7.0.1
6.7.5 Failover Sequence of Events
The flow chart below shows the sequence of events performed on the NMS server to execute a
complete failover.
Event Server
determines line
card has failed
Configuration
Server is notified
YES
YES
Send command to
spare to switch
Send ACTIVE
role from Standby
options file of Rx-only line
YES NO to Primary; send
failed card to card?
ACTIVE options
spare and reset
file of failed card
but DO NOT reset
Apply necessary
changes to puma
(serial number)
104
Network Management System iBuilder User Guide, Release 7.0.1
6.7.6 Failover Operation: Users Perspective
Portions of the failover sequence of events are revealed in real-time. You may perform a historical
condition query at any time to see the alarms and warnings that are generated and archived during
the failover operation. The flow chart in Figure 6-2, p. 105 shows the sequence of events you will
see on the screen in real-time during a failover operation.
iMonitor is notified
the line card has
failed. This is a
standard ALARM
with the
appropriate alarm
type
The ALARM is
displayed in all
appropriate
displays
YES
YES
iMonitor is notified
iMonitor is notified
the Spare has
Rx-only line the spare has
assumed the role NO YES
card? gone down and
of the primary and
displays ALARM
clears WARNING
iMonitor is notified
Accept Changes
the spare has
button highlights
come up and
on iMonitor (and
clears the ALARM
iBuilder )
and WARNING
User accepts
changes and sees
that failed card is
in Failed role,
spare now has
failed cards old
role.
105
Network Management System iBuilder User Guide, Release 7.0.1
6.7.7 Recovering from a Line Card Failover
After line card failover, the system will be operational, but will be in an interim state requiring
recovery. This recovery involves the following procedure:
Step 1 IMPORTANT: First, unplug the I/F Tx (and Rx) cables from the front of the
failed unit.
Step 2 IMPORTANT: Next, remove the Ethernet cable from the front of the failed
unit.
Step 3 It is now safe to power on the chassis slot of the failed unit for further
examination.
Step 4 Analyze the failure by connecting a console cable and examining the unit.
If the card experienced a hard failure or internal component failure, the user
must remove the failed card from the chassis and return it to iDirect for
repair. Some failures, such as those listed below, may be repaired on-site.
Step 4 Using the console, change the units role from Tx(Rx) to Standby using the
following console command: options set OPTIONS_FILE is_standby 1.
You may now connect to the line card using iSite or the telnet console and proceed with further
debugging, if necessary.
106
Network Management System iBuilder User Guide, Release 7.0.1
6.8 Adding Inroute Groups
Inroute Groups are groups of receive line cards, or Inroutes. If you have used a transmit/receive
line card, you may add this card to the Inroute Group also. However, transmit-only line cards may
not be included. The purpose for bundling several receive line cards together into Inroute Groups
is to allow for load balancing among the individual line cards. You must have created Inroute
Groups in order to add remotes to the network.
The relationship between carriers, line cards, and inroute groups is shown in Figure 6-3, p. 107.
There are specific rules regarding the assignment of line cards to inroute groups.
1. You cannot assign a line card to an inroute group unless its assigned carrier is identical
in data rate and FEC block size to the other line card(s) in that inroute group.
2. You cannot assign a line card to an inroute group if it is already assigned to another
inroute group. In this case, if rule 1 is true, you can un-assign the line card from its
current inroute group and re-assign it to the desired inroute group.
3. You may not change a line cards carrier assignment if the line card is assigned to an
inroute group. However, you may modify the characteristics of the current carrier (see
rule 4 below).
4. If you modify either the FEC block size or data rate of a carrier that belongs to a line
card in an inroute group, iBuilder will automatically change all other carriers that belong
to the other line cards in that inroute group. It will prompt you first and allow you to
cancel the modify operation.
To assign a line card to an inroute group, modify the Inroute Group and click Add. iBuilder will only
show you line cards that are valid to be assigned to that inroute group. If you dont see line cards
you expect to see, review the rules above.
Network
Tx/Rx -- or -- Rx Remotes
Remotes
Hub Line Card Remotes
Remotes
Inroute Carrier
(in Spacecraft folder in tree)
Carrier Grooming
Carrier Grooming mode is an option in which remotes dynamically acquire into the inroute with the
fewest number of remotes (assuming multiple inroutes in the group). Once acquired into an
107
Network Management System iBuilder User Guide, Release 7.0.1
inroute, the remote will remain in that inroute until it passes through acquisition again. iMonitors
Inroute Distribution screen provides an ACQ Bounce function that forces a remote to re-acquire
without resetting. An RCM is required for Carrier Grooming.
Frequency Hopping
Users may also select Frequency Hopping mode when defining inroute groups. Frequency
Hopping requires that you upgrade your Hub Chassis with redundant Reference Clock Modules
(RCMs). Frequency Hopping mode provides true run-time load balancing across all the inroutes
within an inroute group. In Frequency Hopping mode, remotes will dynamically load-balance
across all inroutes in the group based on inroute demand. The Protocol Processor analyzes
upstream demand from all remotes and automatically allocates timeplan slot assignments to
achieve an equal balance of remote demand across all the inroutes. Remotes will hop from one
inroute to another either on a frame boundary or within the same frame depending on the nature
of the demand.
Both Carrier Grooming and Frequency Hopping provide an added level of inroute redundancy as
well as improved performance. When line cards are added to or removed from a network, remotes
respond dynamically, either by reacquiring into another inroute when a line card is removed or
fails, or by moving to a newly added inroute. The use of inroute groups is mandatory with release
4.0 and above. However, you may continue to operate your networks exactly as before by
configuring a single inroute in each of your inroute groups. (This will be the default configuration
immediately after you upgrade to release 5.0 from any release prior to 4.0.)
108
Network Management System iBuilder User Guide, Release 7.0.1
Only iNFINITI 5300 and 7300 series remotes can be added to a mesh
NOTE inroute group.
Step 1 Right-click Network and select Add Inroute Group. The new inroute group
appears in the Tree with a system-generated generic name, and a dialog
box appears allowing you to define the basic parameters.
109
Network Management System iBuilder User Guide, Release 7.0.1
Step 2 Enter a name for the Inroute Group. We suggest selecting a name that
allows you to associate it with its corresponding Hub.
Step 3 Free Slot Allocation Enabled and Carrier Grooming are selected by default.
See Carrier Grooming on page 107 and Frequency Hopping on
page 108 above. For more information about Free Slot Allocation Enabled,
see chapter 5, QoS Implementation Principles of the iDirect Technical
Reference Guide.
110
Network Management System iBuilder User Guide, Release 7.0.1
c Select CRTP Compression if you want to enable CRTP for RTP packets for
all remotes in your mesh inroute group.
e Select Single Hop (No TCP Acceleration) if you want TCP traffic to be sent
as single-hop, mesh traffic. If this check box is cleared, only UDP packets
will be sent as single-hop, mesh traffic.
If you select Single Hop (No TCP Acceleration) for your mesh
WARNING inroute group, TCP traffic to or from remotes in the inroute group
will not be accelerated. This is true for both star and mesh traffic.
Step 5 Click Add to add line cards (with the same Information Rate, FEC Rate, and
Modulation) to this Inroute Group. All line cards in an Inroute Group must
have the same parameters.
Step 6 In the Assign Hub To Inroute Group dialog box, select the line cards that you
wish to add. Click OK. You are returned to the Inroute Group dialog box.
111
Network Management System iBuilder User Guide, Release 7.0.1
Step 7 The Shared Carrier Parameters area displays the shared values of all
selected line cards.
112
Network Management System iBuilder User Guide, Release 7.0.1
Step 9 You can specify the following Uplink Control Parameters for your inroute
group:
113
Network Management System iBuilder User Guide, Release 7.0.1
114
Network Management System iBuilder User Guide, Release 7.0.1
7 Configuring Remotes
The most important components of your network are the remotes. This chapter discusses the
various aspects of their functionality; provides instructions on how to create and configure them;
and provides details about their parameters. It contains the following sections:
115
Network Management System iBuilder User Guide, Release 7.0.1
currently being serviced by the inroute group. You will probably have a multitude of remotes
associated with a given Inroute Group.
An iSCPC remote is used to establish point-to-point communications with an iSCPC line card.
Only one line card and one remote participate in any iSCPC connection. Therefore, an iSCPC
remote is not a member of an inroute group. Instead, an iSCPC remote is associated with its peer
line card. Before you can add an iSCPC remote, you must first add the iSCPC line card as
described in Adding an iSCPC Line Card on page 99.
Step 1 If you are adding a remote to an inroute group, right-click the Inroute Group
and select Add Remote.
If you are adding an iSCPC remote, right-click the peer iSCPC line card and
select Add iSCPC Remote from the menu.
116
Network Management System iBuilder User Guide, Release 7.0.1
a number of user-selectable tabs across the top. The Information tab is visible when the dialog
box opens.
Step 2 On the Remote Information tab, enter a name for this remote.
117
Network Management System iBuilder User Guide, Release 7.0.1
Step 3 Select the Model Type of the remote from the drop-down list. The model
type you select must match the actual hardware model.
Step 6 The name of the Inroute Group with which this remote is associated
automatically appears in the Inroute Group box.
Step 7 By default, the User Password is set to iDirect and the Admin Password is
set to P@55w0rd!. You may specify alternate passwords. The User
Password provides users with access to basic commands and the Admin
password provides administrator-level access to all commands. For
security reasons, network operators should change the telnet console and
iSite User and Admin passwords from the defaults.
Step 8 Select Active to enable the Protocol Processor to become aware of the
remote site in the network, which it will do once you apply changes at the
network level. If the remote is Active, the remote is available for access to
the network.
118
Network Management System iBuilder User Guide, Release 7.0.1
Step 9 Select MUSIC Box, Disable Tx PWM, or Link Encryption.
a Select MUSiC Box if this site will use a Multi User Summing Chassis at the
remote site. The iDirect MUSiC Box allows a common antenna/electronics
platform to be shared across multiple remotes that are at the same physical
location. Selecting MUSiC Box overwrites VSAT ODU settings that turn on
the DC/10 MHz timing; instead, the MUSiC Box provides the DC/10 MHz
timing.
b Select the Disable Tx PWM to disable the Transmit Pulse Width Modulation
on the remote and enable console pointing mode. (With this box selected,
installers dont have to remove the transmit cable during pointing.)
c If you are commissioning a NetModem II Plus and have purchased the Link
Encryption option, installation of special hardware and software on the
Protocol Processor is required. Link Encryption must be enabled via the
NMS before the check box is visible.
Step 10 In the Compression area of the dialog box, select any IP compression types
you want to enable for this remote. For details on the different types of
compression available, see Enabling IP Packet Compression Types on
page 153.
Step 11 If this remote will be commissioned to send and receive mesh traffic on the
inbound carriers, enter the following parameters in the Mesh section of the
dialog box:
a Select Enabled.
b Enter a value for SCPC Clear Sky C/N. SCPC Clear Sky C/N is the C/N of the
downstream SCPC carrier as measured by the remote modem under clear
sky conditions. This value is typically set during remote commissioning.
c Enter a value for TDMA Loopback Clear Sky C/N. This represents the C/N of
the loopback TDMA carrier as measured by the remote modem under clear
sky conditions. This value is typically set during remote commissioning.
119
Network Management System iBuilder User Guide, Release 7.0.1
See Section 13.3 Set the Clear Sky C/N Parameters for a Mesh Remote
of the Installation and Commissioning Guide for iDirect iNFINITI Series
Satellite Routers for details on setting these parameters.
Step 1 In the Information tabs Transmit Properties and Receive Properties panes,
the Details buttons allow you to view the details about the carriers.
Step 3 Enter the Initial Power level in dBm, based on the commissioning results.
The default is -25.
Step 4 In Max Power, enter the maximum Tx power level in dBm based on
commissioning results. The default is zero. The range for both Initial and
Max power is -35 to + 7 for a NetModem II Plus or iNFINITI remote. (The
range for a NetModem II is -25 to +7.)
Step 5 In the Receive Properties pane, you cannot select the Carrier Name,
although you can view the details regarding it.This is the downstream
SCPC carrier for the network.
120
Network Management System iBuilder User Guide, Release 7.0.1
Step 6 The L-Band Frequency is calculated for you once the LNB is assigned on
the VSAT tab. See VSAT Tab on page 143.
Step 1 To add a Customer or a Distributor associated with the remote, click the
List button to the right of the Name box. The Customers or Distributors
dialog box appears.
121
Network Management System iBuilder User Guide, Release 7.0.1
Step 2 To the right of the dialog box, you can click Add to add another customer or
distributor.
Step 3 The Information tabs Customers (or Distributors) dialog box appears.
Step 5 Click OK. You are returned to the Customers (or Distributors) dialog box
Step 6 To add more customers or distributors, follow this procedure again. Click
OK. You are returned to the Remote dialog boxs Information tab.
Step 7 The new customer or distributor appears in the boxes, as shown below.
122
Network Management System iBuilder User Guide, Release 7.0.1
Step 8 For customers, you can enter a Commission Date, Contract Number, and
additional information in the Site Notes box, such as keeping a log of
commissioning or operational events.
Step 9 If you click OK, the dialog box will close, but your changes will be saved.
Instead, click the IP tab to continue configuring the remote. See IP Config
Tab on page 123.
iDirect Software supports end-to-end VLAN tagging. To implement this feature, the router or
switch that is upstream from the Protocol Processor must support IEEE 802.1Q (VLAN) tagging.
When multiple VLANs are present on the remote, a similar switch that is downstream from the
remote is also required.
A detailed, two-VLAN, multiple-remote example is shown in the figure below. Management traffic
between the NMS and remote must be untagged and each remote must have a unique
Management IP address. Networks may contain a mixture of remote VLAN and traditional IP-
based remotes. Each remote must be configured to work in either traditional IP or VLAN mode.
123
Network Management System iBuilder User Guide, Release 7.0.1
The iDirect VLAN capability allows customers to use their existing IP addressing schemes. Since
all routing options (RIPv2 and static routing) are configurable per VLAN interface, the end-to-end
VLAN feature allows each end customer to have their own routing architecture independent of
other customers sharing the same physical network components.
All traffic on a mesh inroute must have VLAN tagging enabled. This applies to packets sent on
user-defined VLANs as well as to packets sent on the default VLAN. Remotes on the same VLAN
can communicate on the mesh inroute over that VLAN. All mesh remotes on a mesh inroute can
communicate over the default VLAN.
There are two check boxes for configuration of the Routing Information Protocol (RIPv2) on the
remote: one for the LAN interface (eth0) and one for the for satellite interface (sat0). (The sat0
interface is called the management interface when referring to the default VLAN.) You can enable
or disable RIPv2 independently on the two interfaces. Depending on the RIPv2 options selected,
the remote behaves as follows:
When RIPv2 is not enabled on either interface, RIP is completely disabled on the
remote. It does not send or receive any RIP updates.
When RIPv2 is enabled on the LAN interface, the remote sends and receives RIP
updates over the LAN, updating its own IP routing table when new routing information
is received.
When RIPv2 is enabled on the satellite (or management) interface, the remote sends
and receives RIP updates over the satellite, updating its IP own routing table when new
routing information is received.
The remote does not relay RIP messages to other routers. Instead, it generates RIP messages
based on its own IP routing table.
124
Network Management System iBuilder User Guide, Release 7.0.1
The IP information for a remote is configurable per VLAN. Once you have selected a VLAN in the
left pane of the dialog box, you can configure its IP addressing information in the right pane.
Step 1 The LAN Interface IP address represents the remotes IP address on the
selected VLAN.
b Select Tag Packets if you want to tag packets with the VLAN ID according
to the IEEE 802.1Q VLAN Tagging specification.
c Selecting Enable RIPv2 enables RIPv2 over the LAN link for the selected
VLAN. RIPv2 is configurable per interface.
b Selecting Enable RIPv2 enables RIPv2 over the satellite link for the selected
VLAN. RIPv2 is configurable per interface.
When you select a VLAN other than the default VLAN, the
NOTE interface names change. LAN Interface changes to ETH0
Interface. Management Interface changes to SAT0 Interface.
Additional VLANs can be added and removed from a remote using the appropriate buttons located
in the VLAN area of the IP Config tab. The default VLAN is VLAN 1 (native VLAN) and is based on
the LAN Interface address.
125
Network Management System iBuilder User Guide, Release 7.0.1
Step 1 Click the Add button at the bottom of the VLAN area of the IP Config tab.
Step 2 In the Add New VLAN dialog box, select a VLAN Id and Name, and click OK.
Once a VLAN is added to the remote, it appears in the VLAN list, and the
LAN and Management Interfaces change to ETH0 and SAT0 Interface for
the VLAN.
Step 3 If you click the Remove button, a warning message is displayed, asking you
to confirm the deletion. VLAN 1 is the default VLAN; you cannot remove it.
The VLAN ID is also considered in QoS Traffic Profiles. See chapter 8, Creating and Managing
QoS Profiles section Adding a Service Level on page 160.
126
Network Management System iBuilder User Guide, Release 7.0.1
7.5.2 Domain Name Service (DNS)
This section discusses only the DNS portion of the IP tab.
The local DNS cache capability, which is checked by default, is available only for the default VLAN
1 interface set.
Step 1 If you want to configure DNS, you must specify both primary and secondary
IP addresses. Assigning DNS names is optional.
Step 2 The Cache size, Forward Queue size and Forward Timeout size shown are
default values. Modifications may be made in this pane if desired.
DHCP, including DHCP relay, is configurable on a per VLAN basis. In iBuilder, DHCP is disabled
by default.
127
Network Management System iBuilder User Guide, Release 7.0.1
Select Relay if you want to utilize an existing or separate DHCP server at your hub location. The
remote will pass through the DHCP request and return the provided address from the server.
To enable the remote to act as the DHCP server, follow the procedure below:
Step 2 Enter the Lease Duration or the amount of time before the address must be
renewed.
Step 3 Enter the Primary and Secondary DNS server addresses, and the Default
Gateway.
Step 4 Click the Add button to enter Client Address Ranges, which are the ranges
of assignable addresses. Multiple unique ranges may be assigned as
desired.
Step 1 Click the range in the table to highlight the range you want to change.
Step 4 If you select a range in the table and click the Remove button, a warning
message is displayed, asking you to confirm the deletion.
128
Network Management System iBuilder User Guide, Release 7.0.1
7.5.4 Static Routes, NAT, Multicast Groups, and Port Forwarding
This section discusses only the portion of the IP tab shown below.
The default route across the sat 0 interface is added by default when you create a new remote. Do
not delete this route unless your remote routing scheme requires it.
Static Routes
You can define Static Routes by selecting the Add button.
129
Network Management System iBuilder User Guide, Release 7.0.1
The Add Static Route dialog box appears. You must specify the IP address, subnet mask,
gateway, interface and cost value for each static route, and click OK.
Step 1 Click the entry in the table to highlight the range you want to change.
Step 2 Select Edit, edit the entry, and click OK to save your changes.
Step 3 If you select an entry in the table and click the Remove button, a warning
message is displayed, asking you to confirm the deletion.
130
Network Management System iBuilder User Guide, Release 7.0.1
3. Add the following entry to the Hub-Side section:
[BLADE]
blade_id = <ID>
4. Click OK to close the dialog.
To determine a blades ID, select ViewDetails from iBuilders main menu bar, and click on the
PP record in the network tree view.
Use the following procedure to turn RIPv2 off for a Protocol Processor:
Multicast Groups
To configure the remote to be a member of a persistent Multicast Group, follow these steps:
Step 1 Click the Add button in the Multicast Group section of the screen.
131
Network Management System iBuilder User Guide, Release 7.0.1
Step 4 Click OK.
To enable port forwarding, select the Enable NAT (Network Address Translation) check box.
Port forwarding allows you to specify that IP packets with certain port numbers are forwarded to
private IP addresses behind the remote. For example, if you wanted to run a web server on a PC
with a private IP address, you could specify http as the port start and port end, with TCP as the
protocol, and then add the PCs IP address in the IP address field.
Step 1 Click Add to access the Add Port Forwarding dialog box.
Step 2 Select a start and end port range for port forwarding. Select a protocol and
specify an IP address.
132
Network Management System iBuilder User Guide, Release 7.0.1
Step 3 Click OK to save your changes.
Beginning with release 6.0.5, you may send GRE-tunneled data with TCP acceleration across an
iDS network.
Step 2 Specify the hub and remote endpoints for the tunnel.
133
Network Management System iBuilder User Guide, Release 7.0.1
Step 3 Click OK to save your changes.
This procedure only sets up the GRE tunnel within the iDS
system. You must still establish the actual GRE endpoints on both
NOTE sides of the link for a GRE tunnel to work. GRE endpoints must be
configured upstream from the Protocol Processor and
downstream from the remote.
As an alternative to allowing a port to act as a trunk, you can define a port to be dedicated to a
single, specific VLAN. You can dedicate a port to any user-defined VLAN or to the default VLAN.
When a port is dedicated to a VLAN, only traffic for that VLAN passes through the port. There is
no VLAN tagging on a port dedicated to a single VLAN, regardless of whether the port is dedicated
to the default VLAN or to a user-defined VLAN.
134
Network Management System iBuilder User Guide, Release 7.0.1
Specify the port speed and mode (full duplex or half duplex)
Copy the table of switch settings to an external application such as a spreadsheet
To configure the eight port switch follow these steps:
Step 1 Click the Switch tab to view the current assignment of VLANs to ports. The
Switch tab contains two panes: the Port View (on the left), and the VLAN
View (on the right). Only VLANs that have already been added to this
remote appear in the display.
By default, all ports are defined as trunks. Trunk ports display the word Yes
in the All VLANs row of the VLAN View. Trunk ports also display All VLANs
to the right of the port in the Port View. This default configuration is
illustrated below.
Step 2 You can use either the Port View or the VLAN View to dedicate a port to a
single VLAN. Both methods are described here:
a In the Port View, right-click the port that you want to configure and select
Assign VLAN from the menu to display the dialog box. (Note: you can also
select the port and click the Assign VLAN button at the bottom of the
screen.)
b In the dialog box, select the VLAN ID of the VLAN you want to assign to the
port. (The VLAN Name will be displayed automatically when you select the
VLAN ID.
c Click OK.
a In the VLAN View, right-click in the table cell representing the port of the
VLAN you want to configure.
135
Network Management System iBuilder User Guide, Release 7.0.1
In the VLAN View, the word Yes will be displayed for the VLAN in the column
for the selected port, and the Port View will display the new selection.
You can double-click in any empty cell in the VLAN view to select
that cell. Double-clicking in an empty cell will select that cell,
NOTE causing the word Yes to be displayed. The cell that was
previously selected will be cleared.
In the Port View, right-click the port and select All VLANs from the menu.
Or, in the VLAN View, right-click in the column of the port in the All
VLANs row and select All VLANs from the menu.
136
Network Management System iBuilder User Guide, Release 7.0.1
Step 4 You can select the same setting for all ports by clicking your choice in the
VLAN column of the VLAN View and clicking Select All in the menu. The
word Yes will appear in all columns of the selected row. In this example,
Select All was used to dedicate all ports to the default VLAN.
Step 5 By default, the port speed and port mode are automatically negotiated.
Follow these steps if you want to disable auto-negotiation and select a port
speed and port mode:
a In the Port View, right-click the port you want to configure and select
Properties from the menu to display the Properties dialog box.
137
Network Management System iBuilder User Guide, Release 7.0.1
Step 6 To copy a row (or all rows) from the VLAN View so that you can paste the
information into a separate application such as a spreadsheet, follow these
steps:
a In the VLAN column, click the VLAN name (or click All VLANs) in the first
column of the row you want to select. This will highlight the name in the
VLAN column. (Or press Ctrl + A to select all rows in the table.)
b Right-click on any of the selected entries in the first column; then select
Copy or Copy without headers from the menu.
c You can now paste the row or rows you copied into your target application.
138
Network Management System iBuilder User Guide, Release 7.0.1
7.7.2 Upstream and Downstream SAR
This section discusses only the parameters of the QoS tab shown below. For information about
SAR, including recommended segment sizes for Upstream SAR and Downstream SAR, see
chapter 5, QoS Implementation Principles of the iDirect Technical Reference Guide.
139
Network Management System iBuilder User Guide, Release 7.0.1
Step 1 Either Downstream and Upstream Segmentation and Reassembly (SAR).
Downstream defaults to off (unchecked), whereas upstream defaults to
on (checked).
For information about rate shaping for QoS, see chapter 5, QoS
Implementation Principles of the iDirect Technical Reference Guide.
Step 1 Either select or clear Enable on Downstream and Upstream Rate Shaping
check boxes.
Step 2 If you enable Downstream Rate Shaping, you may enter a value for
Maximum or Committed Information Rate.
Step 3 If you enable Upstream Rate Shaping, you may enter a value for Maximum,
Committed, or Minimum Information Rate.
140
Network Management System iBuilder User Guide, Release 7.0.1
7.7.4 PAD
This section discusses only the parameters of the QoS tab shown below. For information about
PAD, see chapter 5, QoS Implementation Principles of the iDirect Technical Reference Guide.
141
Network Management System iBuilder User Guide, Release 7.0.1
7.8 Geo Location Tab
If you are commissioning a stationary remote, use the Geo Location tab to specify the geographic
location of the installation site. Geo location can be determined by using a GPS.
If you are commissioning a mobile remote, use the Geo Location tab to specify the remotes
mobile settings.
Step 2 Selecting Handshake Signaling provides an input and output signal to the
stabilizing antenna through the serial console port. (See the following
section on Mobile State.)
Step 3 Selecting Mobile Security prevents the remotes latitude and longitude
location from being sent over the air to the NMS. If this is selected, it will not
be possible to determine the remotes location from the hub. (See the
following section on Mobile State.)
Step 4 Select the correct type of GPS input for your mobile remote.
Mobile State
When the remote is configured as Mobile, it looks for a GPS string on the serial console port to
provide its latitude and longitude information in the form of an NMEA string. It uses this information
to compute the FSD and acquire into the network.
142
Network Management System iBuilder User Guide, Release 7.0.1
Once a remote has been acquired into the network, the remote automatically sends its latitude
and longitude to the hub every 30 seconds. However, when Mobile Security is selected, the
remote will not send its current geographic location to the hub. Since the hub requires this
information to communicate with the remote, mobile remote users must determine it and
communicate it to the remote, enabling the remote to compute the FSD.
In the absence of a GPS receiver interface to the modem, the latitude and longitude information
can be supplied through the serial console interface. The console interface for a mobile remote
runs at 4800 baud. This baud rate is a requirement of the NMEA protocol used by GPS to
communicate with the remote. (Note that the console interface for NetModems not in Mobile Mode
is 9600 baud). Customers can also provide the geographic location information for the hub
through the iSite GUI. (The hub geographic location is always sent as a broadcast message from
the hub.)
Handshake signaling requires a stabilizing antenna and requires customers to build their own
electrical interface (converter) to communicate with the antenna. When modem handshaking is
enabled at the NMS, the mobile remote provides an input and output signal to the stabilizing
antenna through the serial console port. The output signal, or lock signal, indicates the frame lock
status of the receiver on the remote. The input signal TxMute is used to mute the transmitter until
the antenna pointing is completed.
The remote sends an RS-232 active signal on the console port DTR output (pin 2) while the
modem is trying to acquire the downstream carrier. Once the remote achieves TDM frame lock,
the DTR signal becomes inactive. This signal is intended to indicate to the auto-point antenna
equipment when to switch from coarse-tune to fine-tune mode.
The DSR input on the console port (pin 7) can be used as a mute function and will allow the auto-
point antenna equipment to delay acquisition transmit until the antenna has finished pointing.
Without this function, the modem may transmit as soon as it detects TDM frame lock, before the
antenna is properly pointed and polarized. Sending an RS-232 active level to the DSR input
enables the mute function.
143
Network Management System iBuilder User Guide, Release 7.0.1
one screen. To add these subcomponents entries to the NMS database, see chapter 3, Overview
of the Network Management System for iBuilder section Adding Entries to Folders on page 22.
Step 1 In the Remote Antenna area, select a BUC from the BUC drop-down box.
Step 2 Select the LNB you are using for this remote from the LNB drop-down box.
Step 4 Approximate cable length should be set during the commissioning process.
Step 5 The tabs on the lower half of the dialog box display the details of the
components that you have selected. Click OK to save your settings. The
new remote appears in the Tree under the Inroute Group to which you
assigned it.
144
Network Management System iBuilder User Guide, Release 7.0.1
7.10 Setting Warning Properties for Remotes
You can use iBuilder to modify both global properties of remote warnings and warning properties
for individual remotes. To change global warning properties for remotes, select Global Warnings
for Remotes from the Edit menu. To change warning properties for individual remotes, click the
Warning Properties tab for the remote you want to modify.
For details on configuring warning properties for line cards, remotes and protocol processor
blades, please see Configuring Warning Properties on page 55.
Step 1 Right-click a Remote and select Clone. In the example below, the remote
named IOM Remote 4408 is being cloned. A new remote named Copy of
IOM Remote 4048 appears in the Tree and the remote configuration dialog
box is displayed.
Step 3 Modify any fields you want to change for the new remote.
145
Network Management System iBuilder User Guide, Release 7.0.1
The Global NMS feature allows remotes to move among networks on various transponders and
satellites, controlled from various hubs. To accomplish this, you must define the remote in all of
the networks in which it will be visible. For more information of the Global NMS feature, see
chapter 7, Global NMS Architecture of the iDirect Technical Reference Guide.
The set of parameters that defines a roaming remote falls into three categories:
Parameters that must be the same in all networks: DID, telnet passwords, and remote
name. iBuilder will not allow you to define these parameters inconsistently across
networks for the same remote.
Parameters that must be different in each network. These consist mostly of internal
database IDs and references that are automatically established by iBuilder when the
remote is defined in multiple networks.
Parameters that may be the same or different from network to network. These dont
care parameters include everything not in the lists above. Examples are IP
configuration, QoS settings, initial transmit power values.
Once you define a roaming remote and add it to multiple networks, the dont care parameters
will be identical in all networks. At that time, you can modify these parameters in the different
networks as desired. (See Managing Dont Care Parameters on page 150).
146
Network Management System iBuilder User Guide, Release 7.0.1
7.12.1 Adding a Roaming Remote
To define a roaming remote, first create the remote in one of the target networks using the
procedure in Adding Remotes on page 115. Define this remote in the normal way for that
network, including setting IP parameters and features, VSAT components, rate limits, and other
settings.
Once you have added the remote to one network, follow the steps below to add it to the remaining
networks:
Step 1 Right-click the Remote in the Tree and select Add to Networks in the
Roaming section of the remote menu.
147
Network Management System iBuilder User Guide, Release 7.0.1
Step 2 Select the appropriate check boxes to add the remote to one or more
additional networks.
Step 3 Click OK to save your changes and close the dialog box. iBuilder
automatically adds the remote to the selected networks, copying the dont
care configuration items to the new networks. You are free to modify the
remotes configuration in the other networks as desired.
148
Network Management System iBuilder User Guide, Release 7.0.1
7.12.2 Managing Roaming Remote Configuration
There are two primary ways to manage a roaming remotes configuration across all of its network
instances. Each is described in the sections that follow.
The Revision Server is completely compatible with roaming remotes. You may upgrade a network
even if a roaming remote is in another network. As long as IP connectivity is available from the
NMS to the remote, the remote will receive the download package (image and options file), write
it to flash memory, and reset. For details, see Downloading Remotes Using Revision Server on
page 207.
Use the following procedure to change roaming remote parameters that must be the same in all
networks:
Step 1 Right-click the Remote in the Tree and select Update Properties in the
Roaming section of the remote menu.
149
Network Management System iBuilder User Guide, Release 7.0.1
Step 2 Update the values in the Roaming Properties Update dialog box as desired.
Step 3 Click OK to save your changes and close the dialog box. iBuilder updates
the remote in all of its networks.
However, it is likely that many of a roaming remotes dont care parameters will be the same from
network to network. In those instances, iDirect recommends that you use iBuilders Group Edit
feature to modify the remote. Since this method allows you to modify shared parameters on all
instances of the remote at the same time, it is both easier and less error-prone than making the
changes one by one. For a general discussion of this feature, see Working with Multiple Elements
Simultaneously on page 47.
Step 1 Select View Details from the iBuilder main menu to display the Details
pane. The Details pane is displayed to the right of the Tree.
150
Network Management System iBuilder User Guide, Release 7.0.1
Step 3 Select View Collapse Details Hierarchy from the iBuilder main menu.
This option removes the hierarchical structure of the network elements and
components so they can all be shown in a single window.
Step 4 In the Details View, select the Type column header to sort by element type.
This will group together all remotes, regardless of their networks.
Step 5 If desired, select the Name column header to further sort by element name.
This will group together all instances of a roaming remote, since the remote
has the same name in all networks.
151
Network Management System iBuilder User Guide, Release 7.0.1
Step 6 Select all desired instances of the Roaming Remote in the Details pane.
Then right-click the selected group and choose Modify from the menu. You
may now modify any of the remotes parameters that are shared across all
network instances.
The map server contains footprint information for all beams on all satellites in the global network.
It parcels out pieces of the map to remotes based on their current geographic location. Depending
on signal quality and location, the remote will either remain in the current network or automatically
switch to a higher-quality network.
For more information on this feature, see the iDirect Technical Note
NOTE titled Automatic Beam Selection..
152
Network Management System iBuilder User Guide, Release 7.0.1
Manual Beam Selection
Users at a remote terminal can command the remote to join a particular network using the
beamselector command, available from the remotes console. The following figure shows the
command format and the output of the list option.
[RMT:2036] admin@telnet:10.0.150.7;1084
> beamselector
control Beam selector control command
list list known beams
mapsize print or change the map size request params
params stats | params | debug
switch switch to new beam
[RMT:2036] admin@telnet:10.0.150.7;1084
> beamselector list
3 is currently selected
3 = Beam_603_340000_GA
2 = Beam_906_64000_GB
1 = Beam_605_174000_GA
153
Network Management System iBuilder User Guide, Release 7.0.1
You can enable each compression type per remote on the remotes Information tab by following
these steps:
Step 2 In the Compression area of the Information Tab, select each compression
type that you want to enable for the remote.
154
Network Management System iBuilder User Guide, Release 7.0.1
7.13.1 TCP Payload Compression
You can enable TCP payload compression on your iNFINITI 5000 and 7000 series remotes to
increase the available bandwidth for TCP streams during periods of channel congestion. When
enabled, the TCP streams are compressed on both the downstream and upstream channels
simultaneously. By default, TCP payload compression is turned off.
Even during channel congestion, compression is not enabled under all circumstances. If a
remotes CPU utilization is above 50 percent, TCP payload compression is automatically disabled
for all sessions. If CPU utilization is below 50 percent, a maximum of five TCP sessions are
compressed. If the number of sessions exceeds five, the additional sessions are not compressed.
iDirect UDP header compression follows the specification in RFC 2508, Compressing IP/UDP/
RTP Headers for Low-Speed Serial Links. This RFC defines both CRTP (header compression for
RTP packets) and UDP header compression (for other UDP packets). When you enable UDP
header compression in iBuilder, only non-RTP headers are compressed for UDP packets. If you
want header compression to be applied to RTP packets, you must enable CRTP. (See CRTP on
page 156.)
155
Network Management System iBuilder User Guide, Release 7.0.1
7.13.3 CRTP
Compression of RTP packet headers (CRTP) is performed on per-packet basis using zlib. Unlike
TCP Payload compression, it is not stream-based. CRTP is available for all iDirect remote model
types.
iDirects implementation of the CRTP algorithm follows the specification in RFC 2508,
Compressing IP/UDP/RTP Headers for Low-Speed Serial Links. This RFC defines both CRTP
(header compression for RTP packets) and UDP header compression (for other UDP packets).
When you enable CRTP in iBuilder, only RTP packet headers are compressed. If you want header
compression to be applied to other UDP packets, you must enable UDP header compression.
(See UDP Header Compression on page 155.)
The iDirect CRTP implementation is a simplex-based compression scheme with the periodic
retransmission of full headers to restore the compression state in the event of error. Correct
functionality of the CRTP implementation has been field-proven in multiple iDS releases.
156
Network Management System iBuilder User Guide, Release 7.0.1
8 Creating and Managing QoS Profiles
This section discusses the concept of QoS profiles in detail, and what it means for your networks.
It contains the following sections:
157
Network Management System iBuilder User Guide, Release 7.0.1
NetModem NetModem NetModem NetModem NetModem
Rule
Rule
Rule 1..n
Clause 1..n
Source/Destination IP Address
Source/Destination Port Number
Protocol
Type of Service (TOS/DSCP)
158
Network Management System iBuilder User Guide, Release 7.0.1
8.3 Adding and Modifying Upstream and Downstream Profiles
To add a new profile, point to an upstream or downstream folder under Filter or Traffic Profiles;
right-click to open it; and select the Add option. The title of the Add option will be different
depending on what type of profile you are adding. The example below shows a Downstream Filter
being added.
A Modify Configuration dialog box opens to allow you to configure the profile you are adding. You
can assign it a name, and click Add to display either the Add Filter dialog box or the Add Service
Level dialog box. These are discussed further in:
159
Network Management System iBuilder User Guide, Release 7.0.1
8.4 Cloning a Profile
You can then right-click to select a profile and then select Clone or Clone As to create another
profile with a new name, but that has the same definition. The cloning feature is a quick and easy
way to create several profiles with minor differences, without having to configure each one from a
blank configuration screen.
If you select Clone, a copy of the selected profile is created in the same folder. You can
then edit the new profile to make a few minor changes.
If you select Clone As, the selected profile will automatically be copied to the folder that
houses profiles of the opposite direction. For example, if you select Clone As on an
Upstream Traffic Profile, it will create a duplicate Traffic Profile and place it in the
Downstream folder.
For traffic profiles, you create multiple service levels, each with its own set of rules. For filter
profiles, you create a list of rules.
160
Network Management System iBuilder User Guide, Release 7.0.1
161
Network Management System iBuilder User Guide, Release 7.0.1
Step 2 Click the Add button. The Add Service Level dialog box opens.
Step 4 Choose Reliable or Unreliable. If the service level is intended to match TCP
traffic, you should choose Reliable. All other traffic must have an Unreliable
designation.
Step 5 Select the method of Scheduling to be used for this service level: Priority
Queue, Cost-Based, or Best Effort. If you select Priority Queue, then select
the priority level from the menu. If you select Cost-Based, then enter a cost
level.
Step 8 Select the Trigger CIR (Committed Information Rate) check box to enable
Dynamic CIR for this service level only.
162
Network Management System iBuilder User Guide, Release 7.0.1
Step 9 To create a service level traffic profile with Static CIR, ensure that this
check box is cleared and that you have configured the Upstream Rate
Shaping parameters. See chapter 7, Configuring Remotes section
Upstream and Downstream Rate Shaping on page 140.
Step 11 Select the Real-Time Weight. For information about this parameter, see the
discussion of network QoS (real-time demand) in chapter 5, QoS
Implementation Principles of the iDirect Technical Reference Guide.
Step 13 If you need to edit anything later, simply click the Edit button on the Traffic
Profile dialog box shown above. An Edit Service Level dialog box opens,
which is exactly the same as the Add dialog box. Make any necessary
changes and click OK.
163
Network Management System iBuilder User Guide, Release 7.0.1
Step 2 Click the Add button. The Add Filter dialog box opens, allowing you to enter
a filtering rule. Note that all comparisons specified (as indicated by the
check boxes on the left-hand side) must match for the rule to be considered
matched.
Each filter profile has one or more rules. For a packet to be further classified
at a given traffic profile, it must match at least one of that filter profiles
rules. A rule is made up of one or more comparisons between IP header
fields and a known constant value specified by the user. The system
compares each rule of each traffic profile in the order specified, and
classifies the packet according to the first service level that matches.
164
Network Management System iBuilder User Guide, Release 7.0.1
.
Step 1 Enter a Source and Destination IP address and their corresponding Subnet
Masks and select the = or <> designations. Source and Destination IP
addresses may be supplied as a constant along with a Subnet Mask. The
IP header may be equal to (=) or not-equal to (<>) the known constant.
The subnet mask is first applied to the IP address in the packet, and then
compared against the user-supplied address. This way, Source and
Destination Ranges of subnet masks may be made to match the rule.
Step 2 Enter the Source and Destination Port Ranges and select the desired
protocols, which may be equal to (=) or not-equal to (<>) the constant.
165
Network Management System iBuilder User Guide, Release 7.0.1
Step 3 Enter the VLAN Ranges, which may be equal to (=) or not-equal to (<>) the
constant.
Step 4 Enter the Protocol, which may be equal to (=) or not-equal to (<>) the
constant.
Step 5 Select either DiffServ DSCP, in which case you cannot select TOS or
Precedence, or select TOS or Precedence, in which case you cannot select
DSCP.
Step 7 If you need to edit anything later, simply click the Edit button on the Filter
Profile dialog box shown above. An Edit Filter Profile dialog box opens,
which is exactly the same as the Add dialog box. Make any necessary
changes and click OK.
166
Network Management System iBuilder User Guide, Release 7.0.1
For each type of profile (upstream, downstream, filter profile, traffic profile), simply select the
desired profile from the drop-down list. iBuilder automatically displays a read-only summary of the
profile for quick reference. You can also manage assignment for multiple modems at once using
the Profile Assignment Editor. See Assigning QoS Profiles to Individual and Multiple Elements
on page 167 for more information.
Step 1 Right-click the element in the Tree and select Assign Profiles. The Assign
QoS Profile dialog box opens. In this example, a network is having profiles
assigned to its remotes.
The Assign QoS Profile dialog box lists all of the upstream and downstream
Traffic (Service Level) Profiles and Filter Profiles (which filter based on IP
addressing, VLANs and protocols). The title row specifies the filters and
traffic profiles, and the far left column lists the remotes in the network to
which we are assigning profiles.
167
Network Management System iBuilder User Guide, Release 7.0.1
Step 2 To assign a different profile to a remote, select the row that the remote is
in, and right-click in the column of the profile you want to change. In the
example below, we clicked in the Downstream Filter column for New
Remote #3951.
Step 3 Select Assign Profile. A drop-down list of all available profiles of that type
appears. For example, in this case, a list of all available Downstream Filters
would appear, as shown below.
Step 4 You can also change multiple assignments at the same time. Select all of
the remotes that you want to change, using the standard Windows multiple-
select keys (Ctrl or Shift), then right-click in the column for the type of profile
you want to change (upstream, downstream, filter or traffic). The
assignment you make is applied to all modems that are currently selected.
The example below shows the first three remotes selected.
168
Network Management System iBuilder User Guide, Release 7.0.1
Step 5 Click a filter and select Assign Profile as you do with a single entry.
Step 6 Select a profile from the drop-down list. It will be assigned to all of the
selected remotes.
When you initially upgrade your system, the default profiles for each type is displayed in gray
because no modems are currently using the default profiles.
169
Network Management System iBuilder User Guide, Release 7.0.1
170
Network Management System iBuilder User Guide, Release 7.0.1
9 Configuring the Initial Hub Chassis
The connection between the Hub Chassis and the NMS is encapsulated in a third-party IP-
addressable controller card called the EDAS board, designed and manufactured by Intelligent
Instruments, Inc. Using the EDAS board, the NMS servers are able to control slot power and
jumper settings, and monitor the status of the power supplies and fans.
The only way to configure the IP address of the EDAS board is via the 9-pin serial port on the back
of the Hub Chassis, labeled Config Port, using a null-modem serial cable and the iDirect-
supplied Windows GUI, EDAS SYSCHECK. (See the Technical Note titled Upgrading to
Release 3.1.x for instructions on installing this utility.)
Step 1 Ensure that you have a standard null modem serial cable.
Step 2 Connect your PC to the Hub Chassis Config Port using the serial cable.
Step 6 Click the Attach to EDAS button. After connection, the current IP settings
of the EDAS board will be displayed.
Step 8 Set the appropriate IP address, subnet mask and default gateway values.
The default gateway should be your upstream router.
Step 10 Write each IP address value to the board by pressing the appropriate
buttons.
Step 11 Reset the EDAS board by powering the Hub Chassis down and back up, or
by resetting just the EDAS board. (For the latter option, you will have to
remove the EDAS board cover and reset the power connector to the board
itself.)
171
Network Management System iBuilder User Guide, Release 7.0.1
9.2 Configuring and Controlling the Hub Chassis from iBuilder
The Hub Chassis includes the line cards, power supplies, and fans.
172
Network Management System iBuilder User Guide, Release 7.0.1
Step 2 Enter a name for the chassis.
Step 4 To turn power on for a particular slot, or to set a jumper, click the check
boxes beside the slots in which you have installed line cards. After each
group four slot rows, you will see a jumper row. Do not select the jumper
boxes unless your network spans virtual backplanes.
Step 5 To associate configured line cards with specific slots, click the slot row you
want to assign, and right-click. A box opens enabling you to select either
Assign Hub or Free.
173
Network Management System iBuilder User Guide, Release 7.0.1
You can also select Free to indicate that no modems are installed in that
slot. The associations you make must reflect the actual physical layout of
your chassis; iBuilder cannot map logical associations to physical line card
locations.
Step 7 When you select Assign Hub, a drop-down list appears in the row, listing of
all the hub modems that can be assigned to that line card.
Step 8 Click the drop-down list to select the modem you want to link to that line
card.
Step 9 Click OK. When you save your changes, iBuilder displays the Changes
Pending icon for the Chassis in the network Tree.
Step 10 To make your changes active, you must right-click the Chassis and select
Apply Configuration.
iBuilder uses the following rules when making line card assignments:
If no line cards have been associated with slots, the drop-down choice list will contain
all the hubs you currently have defined.
After you make the first association, the following rules apply:
That line card no longer appears in any drop-down list.
Only line cards from the same network appear in drop-down lists for other slots in
the same virtual backplane. If you have unassigned Solo line cards, they also
appear.
Drop down lists for other virtual backplanes will not contain any line cards from the
network already assigned.
If you have two networks in adjacent virtual backplanes, iBuilder will not let you set the
jumper between those two backplanes.
To assign line cards from a single network across a jumper, you must first set that
jumper.
If you have a large network that spans a jumper, iBuilder will not let you clear the
jumper.
174
Network Management System iBuilder User Guide, Release 7.0.1
Although the EDAS controller allows you to set jumpers and control slot power, it doesnt allow
real-time queries for its current state. Additionally, all slots are powered on by default when the
chassis is powered on. For this reason, the configuration database is the sole keeper of slot power
and jumper settings. When the configuration server starts up, or after a reconnection to the EDAS,
it automatically applies the settings stored in the database to the EDAS, thus restoring the desired
Chassis state.
175
Network Management System iBuilder User Guide, Release 7.0.1
176
Network Management System iBuilder User Guide, Release 7.0.1
10 Controlling Remotes
Step 1 Select a deactivated remote, right-click, and then select Activate Remote.
The term Activation Pending appears in red text to the right of the remote
you are activating. The term Changes Pending appears in red text to the
right of its corresponding network. For other states, see Step 4, p. 178.
177
Network Management System iBuilder User Guide, Release 7.0.1
Step 2 Select the network in which the remote resides, right-click the network, and
then select Apply Configuration.
If the remote has been acquired into the network, the term Nominal
appears in blue text to the right of both the remote and the network. If it has
not been commissioned and acquired into the network for the first time, the
term Never Applied appears to the right of the remote.
178
Network Management System iBuilder User Guide, Release 7.0.1
Step 5 To deactivate an active remote, select an activated remote, right-click it,
and select Activate Remote. The check mark will be removed and the
remote will become inactive.
Step 2 In the Move dialog box, highlight the destination Inroute Group and click
OK.
The remote now appears under the selected Inroute Group in the Tree.
179
Network Management System iBuilder User Guide, Release 7.0.1
180
Network Management System iBuilder User Guide, Release 7.0.1
11 Retrieving and Applying Saved and Active Configurations
Once you have configured your network elements, you might add more elements which will need
to be configured, or you might simply modify the configuration of one or more elements in your
network. This chapter includes:
Network elements such as remotes and Protocol Processors have both Active and Saved
configurations. The Saved configuration is the configuration that is stored in the NMS database.
The Active configuration is resident on the network element itself. When you modify the
configuration of an element, the Saved configuration is updated. When you Apply the changes,
the Saved configuration is sent to the element and loaded as the Active configuration.
The iDirect NMS system knows which elements are dependent upon one another, so that if you
download an Options file to one element that affects the configuration of other elements in the
network, the system will automatically update those elements as well.
181
Network Management System iBuilder User Guide, Release 7.0.1
the PP. When you modify a remote using iBuilder, the changes may affect the remote-side Options
file, the hub-side Options file, or both.
You can perform the following control operations on both types of remote Options files from the
remote level of the Network Tree:
The following sections describe how to modify, retrieve, compare, and apply configurations on
remotes as well as on other network elements.
You must deactivate a remote before you can delete it. When a
remote is activated, a check mark is shown next to the Activate
NOTE Remote selection in the network tree for the remote. To deactivate
a remote, right click the remote in the Network Tree and select
Activate Remote to remove the check mark.
182
Network Management System iBuilder User Guide, Release 7.0.1
The Network Tree menu selections for viewing and deleting a remote are shown below. Notice
that you cannot select Delete until a remote is deactivated.
An Active Configuration is the configuration that is currently running on the element. By retrieving
it, you are creating an Options file with that current configuration and saving it on your PC as an
.opt file. You can then downloaded, or apply, this Options file to one or more elements of the
same type. For example, if you retrieve and save the current configuration of a particular remote,
you can then apply that configuration to one or more other remotes.
Step 1 Right-click the element whose configuration you want to retrieve, select
Retrieve, and then select Active Configuration or Saved Configuration.
In the case of remotes, the menu allows you to select either the hub-side or
the remote-side configuration for retrieval. The example below shows
Saved Configurations being selected. However, the procedure for both are
the same.
183
Network Management System iBuilder User Guide, Release 7.0.1
Step 2 Navigate to the saved configuration file on your PC and click OK. Placing it
in your My Documents folder will make it easier to find later.
184
Network Management System iBuilder User Guide, Release 7.0.1
Step 3 The options file opens in Notepad allowing you to review your configuration
parameters before you apply them.
185
Network Management System iBuilder User Guide, Release 7.0.1
11.4.2 Retrieving Multiple Saved or Active Configurations
You can simultaneously retrieve multiple saved or active configurations for remotes or hubs as
follows:
Step 1 Right-click the Network element and select Retrieve Multiple. Then select
either Active Configurations or Saved Configurations. (The example below
shows Saved Configurations being selected. The procedure for retrieving
multiple Active Configurations is identical.)
186
Network Management System iBuilder User Guide, Release 7.0.1
Step 2 In the Multiple Configuration Retrieve dialog box, select the remotes and/or
the hubs for which you want to retrieve the configurations.
Step 3 In the Save As dialog box, navigate to the location on your PC where you
want to save the configuration files.
Step 5 iBuilder retrieves the selected configurations and copies them to the
designated location. Both the remote-side and hub-side options files will be
retrieved and saved for any selected remotes.
187
Network Management System iBuilder User Guide, Release 7.0.1
You will be able to access the files in the location to which you saved them.
You can compare configurations for Protocol Processors, Chassis, Networks, Line Cards, and
Remotes using the following method. This example compares the active configuration that was
last applied to a remote with the remotes latest configuration as stored in the NMS database.
Notice that the operator has configured a MUSiC Box for this remote, but has not yet applied the
changes.
To compare the active configuration of an element with its latest configuration, follow this
procedure:
188
Network Management System iBuilder User Guide, Release 7.0.1
Step 1 Right-click the element in the Tree and select Compare Configurations. In
the case of a remote, select Remote-Side or Hub-Side.
Step 2 To view all configuration parameters in the dialog box, clear the Show
differences only check box. Note that differences are shown in red.
189
Network Management System iBuilder User Guide, Release 7.0.1
Step 3 To view only the parameters that are different, select the Show differences
only check box.
Sequence of Download
When applying configurations to multiple elements, iBuilder treats each group of elements as a
batch, processing the batches in upstream order. Therefore, remotes are downloaded first,
followed by hub lines cards, and finally the network itself.
All elements of a batch must complete its download successfully before iBuilder will proceed to
the next batch. For example, if any remote in a given batch fails during the download process,
iBuilder will stop at the end of the remote batch and wait for your next command. It will not
download to any line cards or to the network. However, all elements within a single batch are
processed simultaneously, so a single remote failure will not stop the other remotes from being
downloaded. Also, if the reset button is selected on the dialog box, iBuilder immediately sends a
reset command to any remote that downloads successfully. If this behavior is not desired, make
sure you check the Dont reset button (you can always select Reset only at a later time).
190
Network Management System iBuilder User Guide, Release 7.0.1
11.6.1 Applying Multiple Configurations to Network Elements
To download configurations to one or several of these elements, follow the procedure below:
191
Network Management System iBuilder User Guide, Release 7.0.1
The Automated Configuration Downloader is divided into three main sections:
Remotes
Line Cards
Network
Beside each entry is a check box that you can select to include that item in the download. When
you first launch the Automated Configuration Downloader, all Remotes that currently have
changes pending are automatically preselected. If a box is not checked, the configuration will not
be downloaded to the corresponding element.
Reset Options
The Reset option allows you to choose a reset action after the download completes. The three
choices are: Reset on success, Reset only, or Dont reset.
Reset on success will automatically reset the modems after a successful download.
Choosing Reset only, simply resets the modems without a download being
performed. This option is useful if you previously selected Dont reset, but now you
want to reset the downloaded modems.
Dont Reset simply does not reset the modem.
Stopping the Download
The stop command attempts to halt processing at the next appropriate step after its current
operation. iBuilder will not stop download operations that are currently in progress, but when the
current operation is finished, iBuilder will not continue to the next chosen step.
For example, assume you have selected a given remote and clicked the Reset on Success
button. If you click Stop in the middle of the download, the reset command will not be sent.
However, the current download will finish; iBuilder makes no attempt to halt a download in the
middle or to back out a downloaded configuration.
Click Start. The Status column shows that the configuration is downloading.
192
Network Management System iBuilder User Guide, Release 7.0.1
11.6.2 Applying Configurations to Individual Elements
You can apply configurations to individual Protocol Processors, Chassis, Networks, Remotes, and
Line Cards.
Step 2 A message appears asking you to confirm the download. Click Yes.
193
Network Management System iBuilder User Guide, Release 7.0.1
Applying a Configuration to the Network
To apply the configuration at the Network level, follow the procedures below:
Step 2 A message appears asking you to confirm the download. Click Yes.
After the configuration is applied to the Network, the status of the network
changes from Changes Pending to Nominal.
Step 1 Right-click the any type of Line Card (Tx, Rx, Tx/Rx, Standby) and select
Apply Configuration.
194
Network Management System iBuilder User Guide, Release 7.0.1
Step 2 A message appears, prompting you to confirm the download. Click Yes.
Step 4 Click Reset Now or Reset Later, depending upon your needs. If you reset
the remote now, a message appears, confirming that the unit was reset
successfully.
195
Network Management System iBuilder User Guide, Release 7.0.1
Step 5 Click OK.
Step 2 Select Apply Configuration, and then select Reliable Hub-Side (TCP),
Reliable Remote-Side (TCP), Reliable (Both), or Push Remote-Side with
Reset (UDP). It is recommended that you use TCP if possible.
196
Network Management System iBuilder User Guide, Release 7.0.1
Step 5 When the download is complete and successful, a dialog box appears,
giving you the option of resetting the remote now or waiting and resetting it
later.
Step 6 Click Reset Now or Reset Later, depending upon your needs. If you reset
the remote now, a message appears, confirming that the remote was reset
successfully.
197
Network Management System iBuilder User Guide, Release 7.0.1
11.7 Configuration Changes on Roaming Remotes
The NMS maintains two options files for each non-roaming remote. One file resides on the
Protocol Processor and the other resides on the remote itself. Together, these two files represent
the configuration for a remote terminal in a single network. Roaming remotes require a different
set of option files. This section describes the options files associated with roaming remotes and
the implications of applying configuration changes to remotes that are configured in multiple
networks.
One Remote, One Network One Remote (global instance ), Multiple Networks
Remote
Options File
PP Options Network 1
File Network 2 Network 2
Network 3
PP Options
File Network 3
As with non-roaming remotes, the NMS sends a single options file to each roaming remote.
However, the NMS puts all the necessary parameters for each of the member networks into a
single remote options file.
The structure of the options file sent to the protocol processor has not changed. However, the
NMS generates a separate PP options file for each network a roaming remote belongs to.
198
Network Management System iBuilder User Guide, Release 7.0.1
11.7.2 Pending Changes across Networks
With a single remote options file now containing elements from multiple networks, a roaming
remotes configuration can now change for one, many, or all networks the remote is a member of.
This leads to some differences when the NMS compares its own configuration files to those
resident on the Protocol Processor or the remote.
For changes to a single network affecting only the Protocol Processor options files for a roaming
remote:
Only that specific network instance will show the Changes Pending icon
Only comparisons performed on that network instance will show the differences
For changes that affect multiple networks, or changes to any remote consolidated options file:
As long as the NMS can route packets to the remote terminal, it will update the remote when you
apply the changes. However, the remote must be acquired into some network.
For example, if a remote is a member of Networks 1, 2 and 3, and is currently in Network 1, you
can make changes that affect Network 2 and apply them immediately.
199
Network Management System iBuilder User Guide, Release 7.0.1
200
Network Management System iBuilder User Guide, Release 7.0.1
12 Upgrading Software and Firmware
An image package is a single file that contains all the firmware images for a particular release and
hardware platform. The packages contain FPGA (Field Programmable Gated Array) Images. You
can download images to remotes or line cards via the Multicast Download feature, Download
Image feature, or TCP Multicast feature. The TCP Multicast feature allows you to download both
Option and Image files to remotes and line cards.
To upgrade from one version to another, you should schedule a maintenance window with your
customers. The time required for an upgrade varies based on how many remotes you have
deployed, but averages around 1 hour. The upgrade process is covered completely in the
technical note, Installing NetModem Software. That document is specific to each release.
The following packages are installed on the NMS server during the upgrade to release 6.0:
CpApp-remote_NM2-5_0_3
201
Network Management System iBuilder User Guide, Release 7.0.1
Your upstream router must have multicast enabled before you
NOTE can multicast images to your line cards.
A multicast download operation consists of two phases: the data transmission phase and the flash
phase. During the data transmission phase, the package is broken into multicast IP packets, each
of which is given a sequence number. All recipients reassemble the individual packets, in order,
into the original image package. If a recipient misses a packet, it will send a NACK back to the
sender, at which point the sender re-winds to the missed packet and begins re-sending. A remote
will only NACK once; if it doesnt receive the missing packet it gives up and sends a final NACK
when it receives the last packet.
When reassembly is complete, the flash phase begins. Each individual component of the package
is extracted and written to the modems flash memory. After flashing is complete, the modem
resets automatically if the reset option was checked in iBuilder.
We refer to the protocol used for transmission as semi-reliable. It is reliable in that recipients will
NACK missing packets, but only semi-reliable in that packets are not re-sent forever. Also, the
recipients only NACK missing packets; a single ACK is sent when all packets have been received,
but no ACKs are sent during packet transmission.
Package Section
The upper-left section of the dialog box contains a drop-down list of all available image packages
(see Image Package Versions on page 201). When you select a particular package, the contents
of the package are displayed in the Contents box below the drop-down list. Confirm that the
control application version is correct; it is in the last row of the list.
202
Network Management System iBuilder User Guide, Release 7.0.1
203
Network Management System iBuilder User Guide, Release 7.0.1
Modems and Hubs Sections
iBuilder does not allow you to download an image package to an element that is not compatible.
When you select an image package for a given element (for example, a 5100 remote, a 5150
remote, or a line card), only the elements that are compatible with that package are displayed in
the list of remotes or hubs in their respective boxes on the right side of the dialog box. For
example, if you select the package for 5100 remotes, only 5100 remotes are displayed in the
Remotes box. Likewise, if you select the package for Receive line cards, only Receive line cards
are displayed in the Hubs box. This is a safety feature that prevents you from sending a
mismatched image package to the remotes and hubs. If you do not want to download the image
package to a given remote or line card, clear the checkbox next to it.
The Credentials and Group Address fields are primarily for reference purposes, and should be
left unchanged. The Reset check box, if selected, tells each remote to reset after the package has
been processed.
When you have made your selections, click Start to begin the download. The Progress bar at the
bottom of the dialog box will indicate the status of your download. The results of the download to
each remote (or line card) recipient are displayed next to that recipients name in the appropriate
pane. Depending on the status of the download, you will see either Download Complete or
Download Incomplete. If you receive the latter message, this doesnt necessarily mean the
download failed; it simply means the sending application didnt receive an ACK
(acknowledgement) from that recipient. This behavior is explained in the next sections.
Since the remotes are out-of-network and unable to send the final acknowledgement, the iBuilder
dialog box will display the Download Incomplete message after sending all packets.
If the remote is encrypted and out-of-network, you cannot perform a multicast download to it. This
is because the required key exchange cant take place. The workaround in this situation is to
temporarily turn encryption off, send the package, and turn it back on after the image has been
downloaded. For more information, see the iDirect Technical Note entitled Managing Encrypted
Remotes.
204
Network Management System iBuilder User Guide, Release 7.0.1
12.2.4 Interactions with Other iBuilder Operations
The sequence of events during a multicast download is as follows:
3. When all packets have been received, each recipient sends an acknowledgement to
the sender
4. The contents of the package are extracted and written to flash memory (a defragment
operation is performed automatically if necessary).
After step 3, iBuilder and the NMS are out of the loop. iBuilder declares the download complete,
and the user is free to move on to other tasks; however, the recipients are not finished they will
take up to a minute to flash the package contents. For this reason, it is wise to view recipient
multicast activity in iMonitor, and wait until step 5 is complete before continuing with other tasks
in iBuilder. Recipients send events into the NMS indicating the progress of the multicast operation,
and these events can be viewed in an iMonitor events pane if the recipients are in-network.
2. When iBuilder declares the operation complete, you immediately send an options file
to a particular remote.
Because options files are also stored in flash memory, and the remote may still be flashing
package contents, the options file apply will block until the package flash is complete. iBuilder,
meanwhile, is waiting for a response to the options apply, and will probably time out waiting for
that response. The apply will work, but not until after iBuilder gives up waiting for a response.
iDirect recommends you wait until all multicast activity is complete before performing additional
tasks in iBuilder.
205
Network Management System iBuilder User Guide, Release 7.0.1
12.3 Resetting Remotes
Modifications must be applied to all of the affected remotes in the network by resetting them.
Step 1 Right-click the remote, select Reset Remote, and then Reliable (TCP).
A message appears confirming that the reset command has been issued.
The success of the reset is confirmed with a dialog box.
206
Network Management System iBuilder User Guide, Release 7.0.1
12.4 Downloading an Image or Configuration File via TCP
You can download an Image or Options file via the TCP protocol by using the TCP Download
feature. However, images and options files can only be downloaded to a single network at a time.
Right-click Network and select Package Download TCP. The TCP Package Download dialog box
is displayed. You work with the TCP Package Download dialog box the same way you do with the
Multicast Download dialog box. Follow the directions in Package Section on page 202 and
Modems and Hubs Sections on page 204. Select the appropriate options in the lower left portion
of the TCP Download dialog box and click Start.
Using iDirects Revision Server, you can configure the NMS to automatically upgrade remote sites
that have not yet received the latest download. Once you select a set of remotes to upgrade, the
Revision Server packages the current images and options files together. It then periodically
transmits the latest package to the selected remotes, stopping only after all remotes in the list have
successfully received their upgrades.
You can also use the revision sever to send only options files, without reloading the images. This
allows you to change the configuration of one or more remotes and ensure that the changes will
be applied without further operator intervention.
207
Network Management System iBuilder User Guide, Release 7.0.1
By default, the Revision Server uses up to 10 percent of the downstream bandwidth
when it is active. (However, you can modify the download rate when you launch an
upgrade.)
Once you start the Revision Server, it immediately begins to upgrade all the selected
remotes. If one or more remotes fail to receive the package during an upgrade cycle,
the revision server will automatically begin a new cycle to retransmit the package to
those remotes. (The time remaining before the next cycle is displayed on the Revision
Server dialog box.) Once all remotes in the list are upgraded, the revision server stops.
You can command the Revision Server to stop upgrading one or more networks while
the upgrade is in progress.
Under normal operation, the Revision Server sits in an idle state waiting for commands from
iBuilder. When commanded to perform an upgrade and/or options file application, it operates in a
specific duty cycle until its assigned tasks are complete or until it is commanded to stop by an
iBuilder user.
The Revision Servers duty cycle is shown in Figure 12-1, p. 209. As the figure shows, the
Revision Server performs the following tasks for each cycle:
2. Creates a single package file containing the appropriate images (if upgrading) and
options files for all down-rev remotes.
3. Multicasts the package to the remotes using 10% of the downstream channel capacity.
4. Waits a calculated amount of time for the multicast to complete and for remotes to
receive the package and process it. (When a remote gets a complete package, it picks
out the images (if upgrading) and its own options file, writes the file(s) to flash, and
resets.)
5. Returns to step 1. When the list of down-rev remotes reaches zero, the revision server
returns to the inactive state.
208
Network Management System iBuilder User Guide, Release 7.0.1
Figure 12-1: Revision Server Duty Cycle
There are two ways you can use the Revision Server to automate remote upgrades:
209
Network Management System iBuilder User Guide, Release 7.0.1
1. Follow the manual upgrade procedure for all of your iDirect equipment, including
remotes. Then launch the Revision Server to upgrade any sites that were unreachable
at the time of the initial upgrade.
2. Upgrade your hub equipment, including line cards and protocol processors, manually.
Then launch the Revision Server to upgrade all remote sites.
When you make changes to your remotes configuration parameters, you can use the Revision
Server to automatically apply those changes by sending the updated options files to the remotes
as they become available in the network.
You can use the Revision Server to upgrade to iDS release 7.0
NOTE provided you are upgrading from iDS release 5.05 or later.
Step 1 Right-click your network in the Tree and select Package Download
Revision Server from the menu.
210
Network Management System iBuilder User Guide, Release 7.0.1
The Revision Server dialog box will appear, including a list of all the
remotes in the network. Remotes with a status of DownRev have a different
package version from that of the NMS server. UpRev remotes are current.
Step 2 In the Remotes section of the dialog box, select all remotes you want to
upgrade by clicking the check boxes. You can also click any of the following
buttons to select remotes for download:
211
Network Management System iBuilder User Guide, Release 7.0.1
Step 3 You can change the Download Rate specified in the Download Parameters
section if desired. By default, the download rate is calculated to be 10
percent of the downstream information rate.
Step 4 Select Options Files Only if you only want to send options files to the
remotes. No image files will be sent.
Step 6 Once you have started the upgrade, you can observe the following real-
time status in the Revision Server dialog box:
The Next Cycle counter will begin to count down, indicating the time
remaining before the Revision Server will restart the upgrade process
for any remotes that are not updated during this cycle.
In the Remotes section of the dialog box, the status will change from
DownRev to UpRev when a remote has successfully received its
upgrade.
Status messages will be displayed in the Messages section of the dialog
box, logging the progress of the upgrade.
212
Network Management System iBuilder User Guide, Release 7.0.1
The Revision Server Status pane will appear in place of the Network Tree,
showing the status of all upgrades that are in progress. Note that two tabs
appear at the bottom of the pane allowing you toggle between the Network
Tree (iBuilder Tree View tab) and the Revision Sever Status pane (Revision
Server tab).
213
Network Management System iBuilder User Guide, Release 7.0.1
Step 2 If you want to see the status of completed upgrades as well as current
upgrades, select Show historical information.
Step 3 Click Details for any upgrade to see more information about that upgrade.
This includes the upgrade Status of each remote in the upgrade list.
Step 1 Right-click your network in the Tree and select Package Download
Revision Server to launch the Revision Server dialog box.
214
Network Management System iBuilder User Guide, Release 7.0.1
13 Creating and Managing User Accounts and User Groups
Prior to iDirect Release 7.0, all user accounts were independent of one another. Beginning with
Release 7.0, all users belong to one of a variable number of User Groups. Visibility of network
elements and access rights to those elements are now defined at the user group level rather than
for each user account. This chapter explains how to create and manage user groups and user
accounts, and how to define the permissions and access rights associated with each. It discusses
the following topics:
All non-VNO accounts are put into the System group automatically.
For each VNO account, the upgrade creates a new user group and adds the user
account to it.
Account permissions are maintained, but all VNO visibility settings are turned off. You
must use iBuilder to re-establish appropriate visibility for each user group.
As soon as possible after you upgrade for iDS 7.0, you must re-
WARNING define the visibility settings for each VNO user group. VNO users
will be unable to use the system until you have done this.
All database items are visible to users in the system group, including all network elements created
by VNO users. Individual permissions of system users may vary from account to account.
215
Network Management System iBuilder User Guide, Release 7.0.1
VNO users may create and manage their own QoS profiles, filter profiles, antenna components,
or any other network components, subject to permissions established at the group level by the
Host Network Operator (HNO).
VNO User Groups restrict visibility and access rights of group members based on the permissions
granted to the group. Creating and managing VNO User Groups is discussed in detail later in this
chapter.
CNO User Groups can be created to allow customers to monitor groups of network elements
without the ability to add new elements or modify the network in any way. CNO users are restricted
to iMonitor read-only access to the network elements that are visible to their CNO User Group.
They cannot log into iBuilder.
VNO and CNO User Groups are licensed features. If you plan to
NOTE define VNO or CNO User Groups in your network, please contact
your iDirect Account Manager.
Visibility propagates up the tree, but not down the tree. For example if you make a
remote Visible to a User Group, members of the group will see that remotes
parentage all the way to the up to the teleport element. However, if you set visibility
at the teleport level, group members will see only the teleport when they log in; they
will not see any elements underneath it.
Visibility has three different levels of access rights. When you give visibility of an
element to a User Group, for example an inroute group, you have the following
additional access rights you can grant or revoke:
Create access allows users to create new elements underneath this node. For
example, you can allow a user to create new remotes in an inroute group.
Write access allows users to modify the contents of the element itself. For example,
a user with Write access to an inroute group could modify the inroute group to turn
off frequency hopping.
Control access gives users the right to perform control operations on child
elements of the specified node. For example, users with Control access for an
inroute group can perform all control operations on remotes in that inroute group.
Ownership is different from Visibility. When you set a node as Owned by a VNO group,
you are dedicating that node and all of its children to this VNO group exclusively
216
Network Management System iBuilder User Guide, Release 7.0.1
(except for system users, of course). No other VNO groups are able to see or interact
with this group in any way. Visibility to network elements, however, can be shared
across multiple VNOs.
VNOs cannot see each other; System users see all. When a VNO creates a network
element, only the members of that group and the System User Group are able to see
the element. When the system group creates or owns a network element, no VNOs can
see this element unless they are granted visibility to it.
User Groups are highly configurable. The implementation of VNO User Groups is quite
flexible; you can configure groups in a number of ways. However, unless you are
careful when configuring your user groups, this flexibility can result in unwanted
results. It is possible to give VNO User Groups various combinations of write and
visibility access that may create confusion in practice.
For example, giving a VNO Write access to an inroute group, without granting Control
access at the Network level, could result in a condition from which the VNO user is
unable to recover. In this example, a VNO user could modify the inroute group so that
it sets the Network to the Changes Pending state, yet be unable to apply the changes.
Visibility and Access for Components Folders
Visibility and access rights are handled differently for components folders than they are for
elements of the Network Tree. The following options exist when setting up VNO group visibility
and access to components folders in the Tree:
Users see the contents of folders. By default, users in a VNO group can see the
contents of all component folders. However, they cannot change them or add new
components.
QoS Profile and Customer folders are special. By default, VNO users cannot add or
modify QoS filters, QoS profiles, or Customers. However, selecting the Create property
on a QoS or Customer folder allows the customer to create new entries in that folder.
The rules for QoS visibility and control are:
All VNO users see profiles created in the System User Group.
Profiles created by VNO members are visible only to members of that VNO User Group
and the System User Group.
CNO users can log in to iMonitor only. They cannot log in to iBuilder.
Within iMonitor, CNO users can view all network elements that have been made Visible
to their CNO User Group. The rules of visibility propagation in the network tree that
apply to VNOs also apply to CNOs. (See Visibility and Access for Network Elements
on page 216).
CNO users have no access rights other than the ability to view visible elements.
Specifically, Create, Write and Control access cannot be granted to CNO users.
217
Network Management System iBuilder User Guide, Release 7.0.1
CNO users cannot execute iMonitor Probe functions that modify or control remote
modems. However, they can use all Probe read-only functions.
CNO users cannot select the Telnet command from the iMonitor GUI.
Step 1 To add a User Group, right-click the User Group folder in the Tree and
select either Add VNO User Group or Add CNO User Group. To modify an
218
Network Management System iBuilder User Guide, Release 7.0.1
existing User Group, right-click the User Groups name in the Tree and
select Modify. Both alternatives are shown below.
Step 2 In the Group dialog box, enter a Group Name for the User Group. If desired,
you can also change the Group Type and add a Description of the group.
Step 3 On the Information tab of the dialog box, right-click on elements in the Full
View to set their visibility and permissions for the User Group. The menu
displays a check mark next to all access rights selected for this element.
The User Group View shows you which elements this groups users will
219
Network Management System iBuilder User Guide, Release 7.0.1
have access to, and what their access rights will be. Several examples of
VNO User groups are shown here.
220
Network Management System iBuilder User Guide, Release 7.0.1
If you are configuring a CNO User Group, you will only be able to
NOTE select Visible from the context menu. Other permissions in the list
apply to VNO User Groups only.
Step 1 In the User Group dialog box, select the Properties tab.
221
Network Management System iBuilder User Guide, Release 7.0.1
Step 3 To limit the upstream information rate, select the MaxUpstreamKbps check
box and enter the rate limit in kbps. In this example, remotes created or
controlled by members of the User Group are restricted to a maximum of
256 kbps on the downstream and a maximum of 32 kbps on the upstream.
Step 2 To make the element visible to a VNO, select the check box next to the
VNO name. (You can also do this by selecting from the context menu as
described in the next step.) In this particular example, the inroute group is
visible to three different VNO groups. VNO1 and VNO3 can only view the
222
Network Management System iBuilder User Guide, Release 7.0.1
Inroute Group. VNO2 can perform control operations such as applying
configuration changes.
Step 3 To modify a VNOs permissions for the selected element, right-click on the
VNO name and select the desired permissions from the menu.
223
Network Management System iBuilder User Guide, Release 7.0.1
Clone an existing user and change the name and some of the properties
Delete a user
Modify a users account
View a users current properties
The next few sections explain these operations in detail.
Step 1 Right-click the User Group in the Network Tree and select Add User.
Step 2 When you select Add User, the Modify dialog box appears.
224
Network Management System iBuilder User Guide, Release 7.0.1
Step 3 Enter a user name and click Change Password.
Step 5 If you click either the Super User or Guest check box, the permissions
allowed for the user level you selected appear with check marks next to
them on the Modify dialog box, but they are not selectable. These
permissions may vary in accordance with the type of User Group.
Step 6 If you clear both of the main User Level boxes (Super User and Guest), the
individual permissions detailed in Table 13-2, Custom Privileges, on
page 231 become selectable. Click the boxes next to the customized
functions that you want to assign to the user.
Step 7 Click OK to save the settings for the user account. The new user will appear
in the Network Tree under the User Group you selected.
Step 1 Right-click the User Name in the Network Tree and select Modify Item.
Step 2 When the Modify dialog box appears, change the settings as desired. (For
details, see Adding a User and Defining User Privileges on page 224.)
225
Network Management System iBuilder User Guide, Release 7.0.1
Step 1 Right-click the User Name in the Network Tree and select Clone.
Step 2 A new user appears in the Tree and the Modify dialog box is displayed with
settings identical to the cloned user.
For a detailed description of user permissions, see User Privileges on page 230.
226
Network Management System iBuilder User Guide, Release 7.0.1
Step 2 Select View Properties Item.
Step 4 Click the Close button at the top of the dialog box to exit the pane.
Step 1 Right-click the User Name in the Network Tree and select Delete.
The Active Users pane is a standard Microsoft Windows dockable display that you can attach to
any part of iBuilders main window; detach into its own window; or hide altogether. When you first
open the pane, it will appear on the right side of the NMS window. The last setting you select is
saved between iBuilder sessions.
The Active Users pane has four columns. The columns display the Name, Permissions, Group
(User Group) and Logged On status for all users defined in the system. The Logged On column
227
Network Management System iBuilder User Guide, Release 7.0.1
indicates the logon session count for that user under both iBuilder and iMonitor. This pane is
updated in real time as values change.
To open the Active Users pane, Select View View Active Users from the main menu.
Depending on your permission level within the NMS, you can perform the following actions:
Delete a user
Modify a users account
View a users current properties
228
Network Management System iBuilder User Guide, Release 7.0.1
To perform any of these actions:
Step 1 Right-click on any user in the Active Users pane. A list of the user
management options available from this pane is displayed.
Step 3 For details, see the section indicated below for your menu selection:
To change the password, select File Change Password from the Main Menu bar. A user must
enter his current password before the change is processed. For security reasons, it is important
to change the passwords for the default user names as soon as possible.
229
Network Management System iBuilder User Guide, Release 7.0.1
Changes to user accounts take place immediately, i.e. you do not
have to apply changes for users. However, new settings for a
NOTE specific user will not take effect until the next login under that
account. If the user is logged in while you make changes, the old
settings remain in effect for the remainder of that session.
Initially, the Super User in the System group is the only user who can set up accounts. User
Groups and users can be added or deleted, and user privileges can be added or removed at any
time. For System and VNO users, a users privilege level is the same for both iMonitor and
iBuilder. For example, a user cannot be a Guest in iBuilder and a Super User in iMonitor. CNO
users have access to iMonitor only.
The NMS is shipped with a Super User and a Guest account already set up in the System User
Group. The Super User can then set up additional user groups and users and assign them to have
any of the following user levels:
Super User
Guest
Individually-defined User
If the Super User sets up a user as one of the standard user levels, the NMS system automatically
generates a predetermined set of privileges for that user level. (See Table 13-1: User Types and
Access Privileges.)
If the Super User sets up a user as a custom-defined user, the Super User can assign that user
any number of privileges from a list provided in the system. (See Table 13-2: Custom
Privileges.)
230
Network Management System iBuilder User Guide, Release 7.0.1
.
Table 13-1: User Types and Access Privileges
User Name
Account Type Access Level Access Privileges
Password
Access to the NMS database and all of its
components within this user group, including the
Pre- ability to configure, modify, and delete anything in
admin the database owned by the group, including users
Programmed Super User
admin and their privileges. For System Super Users, ability
by iDirect
to perform these operations on other User Groups
as well.
The following table lists the various privileges that can be granted or revoked for a custom-defined
user.
Table 13-2: Custom Privileges
Applicable NMS
Privilege Name Description
Application
The most basic privilege; allows retrieval of stored
configuration information. This is the only privilege
Database Read iBuilder, iMonitor
Guest users are granted. You cannot grant or
revoke this privilege from iBuilder.
Change Database Allows modification of configuration information. iBuilder
Allows download of firmware to line cards and
Download Firmware iBuilder
remote modems.
Allows application of configuration changes to
Apply Configuration iBuilder
networks, hub lines cards, and remote modems.
Reset Modem Allows remote and line card resets. iBuilder, iMonitor
Manage Users Allows modification of user names and passwords. iBuilder
Edit Permissions Allows modification of user permission settings. iBuilder
Allows retrieval of a remote modems or line cards
Upload Configuration iBuilder
active configuration.
Basic Probe Allows retrieval of real-time stats in the Probe tab. iMonitor
Allows all Probe functions (reset, telnet, change tx
Advanced Probe iMonitor
power, etc.).
231
Network Management System iBuilder User Guide, Release 7.0.1
Table 13-2: Custom Privileges
Applicable NMS
Privilege Name Description
Application
Allows access to the Custom tab in the Remote
Customize Configuration iBuilder
Modify Dialog Box.
Controls whether or not an NMS user can see
Password in Clear Text remote and protocol processor passwords in clear iBuilder
text.
Allows monitoring of long term statistics in
Monitor Longterm Statistics iMonitor
iMonitor.
The Super User access level gives the user complete access to all features of the
NMS, in both iBuilder and iMonitor, that are available to the User Group in which the
Super User is defined.
Guest access level provides read-only access to all parts of the network in iBuilder with
no ability to change data or download images. Guest access provides most functions
in iMonitor, with the following exceptions:
Guest-level users cannot telnet to remote modems.
Guest-level users cannot exercise functions on the Probe tab of iMonitors remote
control panel.
1. They cannot create or modify any network components in the network tree (Spacecraft/
Carriers, remote/hub antenna components, QoS Profiles).
3. They cannot perform any operations on the Teleport or Protocol Processor entries in
the network tree.
4. From the network level in the tree, they cannot perform multicast downloads, delete
networks, or create new line cards.
5. They can modify the network record, but only to activate/deactivate remotes.
232
Network Management System iBuilder User Guide, Release 7.0.1
6. They cannot see or modify acquisition or uplink control parameters.
7. From the hub level in the tree, they cannot perform image downloads, nor can they
create or delete line cards.
Beginning with release 7.0, there is one lock for each User Group. Members of different User
Groups can modify the database at the same time. Within a User Group, there is still a single lock.
The System User Group, however, is granted a global lock; if a user from the System group is
modifying a record, no other users, regardless of group membership, can modify the database.
If a user launches a Modify pane and forgets to close it, thereby preventing other users in the same
User Group from modifying records, you can use the following procedure to free the lock for other
users:
Step 3 Log onto the console with user name admin and password iDirect.
Step 5 Locate the line of the user who has the lock. The line will look something
like this:
Step 6 The section that begins IP contains the information you need to break
the lock (it is underlined above).
Step 7 Type: kill <ip address>:<port number, where <ip address> is the host
address, and <port number> is the actual port number. In the example
above, you would enter kill 10.0.19.108:1513.
233
Network Management System iBuilder User Guide, Release 7.0.1
Step 8 This command will break the users lock and other users will now be able
to modify network objects.
234
Network Management System iBuilder User Guide, Release 7.0.1
14 Commissioning a Line Card, Private Hub or Mini Hub
This section provides instructions for commissioning iDirect line cards, private hubs, and mini
hubs to transmit SCPC outroutes. It discusses the following topics:
If you are adding a new line card, the Tx Out, Rx In and Lan A
NOTE ports should not be connected at this time. Do not connect these
cables until instructed to do so by this procedure.
235
Network Management System iBuilder User Guide, Release 7.0.1
14.2 Add the Line Card in iBuilder and Retrieve the Configuration
Use iBuilder to add the line card to the Network Tree and configure the line card parameters in the
options file.
Step 1 In iBuilder, right-click your network in the Tree and follow the procedure in
Adding a Tx Line Card, a Tx/Rx Line Card, or a 10000 Series Hub on
page 94 to configure the line card.
Step 2 Right-click your network in the Network Tree and select Apply Network
Configuration from the menu.
Step 3 Right-click the line card in the Tree and select Retrieve Saved
Configuration.
Step 4 In the Save As dialog box, navigate to the folder on your PC in which you
want to save the options file. Then click the Save button to save the file to
your PC.
Step 5 After you save the options file, it will be displayed in Notepad as a text file.
If desired, review the configuration in Notepad; then close the Notepad
window.
Step 1 If you are commissioning a private or mini hub, plug in the AC power cord.
236
Network Management System iBuilder User Guide, Release 7.0.1
a Insert the line card into the slot in the chassis you plan to use.
b In iBuilder, right-click the chassis in the Network Tree and select Modify
Item. The Modify Chassis dialog box will appear.
c Select the check box for the slot that contains the new line card. This will
toggle the setting from Off to On.
Step 1 Connect a console cable from the COM1 port on your client PC to the
console port on the line card.
9600 bps
8 bits
No parity
1 stop bit
237
Network Management System iBuilder User Guide, Release 7.0.1
This is illustrated below using Tera Terminal.
Username: root
Password: <password>
For iNFINITI line cards, iDirect is the default password for the root account.
telnet 0
Username: admin
Password: <password>
For iNFINITI line cards, iDirect is the default password for the admin
account.
Step 6 At the Telnet prompt, type the following command to determine the IP
Address and subnet mask of the line card:
laninfo
238
Network Management System iBuilder User Guide, Release 7.0.1
The output of the laninfo command is shown here.
Step 7 Note the IP address and subnet mask. You will need this information when
downloading the image package and options file.
These steps assume that you are still connected to the console port of the line card and that you
have not yet connected your line card to the LAN.
Step 2 Connect a cross-over Ethernet cable between the LAN port of the line card
and your PC or laptop.
239
Network Management System iBuilder User Guide, Release 7.0.1
Step 3 Launch iSite. The main iSite screen will appear.
Step 4 Right-click the globe in the Network Tree and select New. An Unknown
element appears in the Tree.
240
Network Management System iBuilder User Guide, Release 7.0.1
Step 5 Right-click the new element and select Login to display the Login dialog
box.
Step 6 Enter the IP Address of the line card and a password. (For iNFINITI line
cards, iDirect is the default password.)
Step 7 Select Admin in the Login as section and click OK. The line card will appear
in the Network Tree, replacing the unknown element.
Step 8 In the Network Tree, right-click the line card and select Download Package
to display the Download Package dialog box.
241
Network Management System iBuilder User Guide, Release 7.0.1
Step 9 In the Download Package dialog box:
a Click the Open button to display the Open dialog box. Then navigate to the
folder on the client PC that contains your iDirect image packages.
(Typically, this is the same folder that contains your client software.)
242
Network Management System iBuilder User Guide, Release 7.0.1
b Select the image package (.pkg file) for your line card in the Open dialog
box and click the Open button. (iNFINITI line cards and hubs use the same
image package. The file name for this package should begin with hub as
shown in the example above.)
Step 10 Right-click line card in the Network Tree and select Download Option From
Disk to display the Open dialog box.
Step 11 Navigate to the folder containing the options file that you saved from
iBuilder when executing step 4 of section 14.2 on page 236. Then select the
options file.
Step 13 Click Yes to download the options file to the line card.
Step 14 Right-click line card in the Network Tree and select Reset from the menu.
At this point the new configuration (including the new IP address of line card) will be applied and
you will lose connectivity to the line card. Do not disconnect the console cable.
Connecting the transmit port of your line card will result in the
WARNING transmission of a carrier on the satellite. This step should only be
performed while on line with the satellite provider.
243
Network Management System iBuilder User Guide, Release 7.0.1
If you are adding a Tx-only line card:
Step 1 Connect the Tx coax patch cable to the line cards Tx Out port.
Step 2 Connect the Tx coax patch cable to the corresponding Tx patch panel port
above the line card slot.
If you are adding a Tx/Rx line card or a Tx line card that is configured for mesh:
Step 1 Connect the Tx coax patch cable to the line cards Tx Out port.
Step 2 Connect the Tx coax patch cable to the corresponding Tx patch panel port
above the line card slot.
Step 3 Connect the Rx coax patch cable to the line cards Rx In port.
Step 4 Connect the Rx coax patch cable to the corresponding Rx patch panel port
below the line card slot.
Step 1 Connect the Rx coax patch cable to the line cards Rx In port.
Step 2 Connect the Rx coax patch cable to the corresponding Rx patch panel port
below the line card slot.
Step 2 Connect the Tx cable to the Tx Out port on the back panel.
The 1 dB Compression Point test is performed at the direction of the satellite operator using a CW
carrier. The satellite operator should inform you of the transmit frequency for the test.
Step 1 If you do not have a console connection to the line card, establish one now
by following the steps in section 14.4 on page 237. (Note that the IP
address that you configured for your line card should now be loaded on the
line card. You may need to reconfigure the IP address of your PC to match
the new subnet.)
244
Network Management System iBuilder User Guide, Release 7.0.1
tx freq <fx>
Step 3 Set the initial transmit power of the line card by typing:
tx power <pwr>
where pwr represents the power setting in dBm. Typically you should
begin with a low value such as -25 dBm to minimize the chance of
interfering with other carriers.
tx cw on
Step 5 While the satellite operator is observing your CW carrier, increase the
transmit power in 1 dBm increments until a 1 dBm change in power no
longer results in a corresponding 1 dBm change in signal strength as
measured by the satellite operator. The last point at which the CW changes
by 1 dB is the 1 dB compression point.
tx cw off
Step 1 If you do not have a console connection to the line card, establish one now
by following the steps in section 14.4 on page 237.
245
Network Management System iBuilder User Guide, Release 7.0.1
Step 2 Configure the line card to transmit at the frequency indicated by the satellite
operator by typing:
tx freq <fx>
Step 3 Configure the line card to transmit a signal with pseudo-random data by
typing:
tx pn on
Step 4 Working with the satellite operator, adjust the transmit power to achieve the
contracted power at the satellite. To change the tx power to a new value,
type:
tx power <pwr>
tx pn off
Step 6 Open iBuilder and select the line card in the Network Tree. Then select
Modify Assigned Downstream Carrier from the context menu.
Step 7 In the Downstream Carrier dialog box, enter the value for Power determined
in step 4.
246
Network Management System iBuilder User Guide, Release 7.0.1
Step 8 Exit the console window by typing:
exit
14.9 Connect to the LAN and Apply the Line Card Configuration
Connect your line card to the LAN and apply the updated configuration.
Step 1 Connect the Ethernet to the LAN A port on the line card or private / mini hub.
Step 2 In iBuilder, right-click the line card in the network tree and select Apply
Configuration from the menu. Select the option to Reset your line card.
14.10 Set the Clear Sky C/N Parameter for a Mesh Outroute
If you are configuring a mesh outroute, you must use iMonitor to determine the value of the SCPC
loopback clear sky C/N. You will then use iBuilder to configure that value for the outroute.
You must determine the clear sky C/N value under clear sky
NOTE conditions at the hub.
Follow these steps to determine and set the outroute SCPC LB Clear Sky C/N parameter in iBuilder:
Step 1 In iMonitor, right-click the line card in the network tree and select Line Card
Stats. Then click OK in the Select Items dialog box. (The line card should
already be selected in the Line Cards area of the dialog box.)
Step 2 In the Hub Stats Results pane, determine the value for SCPC LB C/N [dB].
247
Network Management System iBuilder User Guide, Release 7.0.1
Step 3 In iBuilder, right-click the line card in the network tree and select Modify
Configuration.
Step 4 In the Line Card Modify dialog box, enter the value for SCPC LB Clear Sky
C/N determined in step 2.
Step 1 In iBuilder, right-click the line card in the network tree and select Modify
Configuration.
Step 2 In the Line Card Modify dialog box, enter the Hub UPC Margin.
14.12 Set the Clear Sky C/N Parameters for a Mesh Inroute Group
When commissioning the first remote on a mesh inroute, you must set the clear sky C/N parameter
for the inroute group before setting the initial transmit power for the remote. To accurately
determine the value for clear sky C/N, you must first configure a custom key to disable uplink
power control. Once clear sky C/N is entered, you must delete the key to re-enable uplink power
control.
For complete instructions on remote commissioning, including mesh remotes, see the Installation
and Commissioning Guide for iDirect iNFINITI Series Satellite Routers.
Follow the steps in this section to correctly set the clear sky C/N for the mesh inroute group.
248
Network Management System iBuilder User Guide, Release 7.0.1
Step 1 In iBuilder, right-click the remote in the network tree and select Modify
Item.
Step 2 Select the Custom tab in the Modify Remote dialog box.
[REMOTE_DEFINITION]
ucp_power_disable = 1
Step 4 Right-click the remote in the network tree and apply the hub-side
configuration.
Step 5 In iMonitor, right-click the remote in the network tree and select Probe from
the menu.
Step 6 In the Remote Power area of the screen, click the Change button.
Step 7 Working with the satellite operator, adjust the transmit power of the remote
until the contracted Tx Power on the satellite is reached for the TDMA
249
Network Management System iBuilder User Guide, Release 7.0.1
carrier. Adjust the power by entering a power setting in New Tx Power and
clicking the Set button.
Step 8 In iMonitor, right-click the mesh remote in the network tree and select
Control Panel from the menu.
Step 10 Record the average value displayed in the column Up C/N [db].
Step 11 In iBuilder, right-click the inroute group in the network tree and select
Modify Item from the menu.
250
Network Management System iBuilder User Guide, Release 7.0.1
Step 13 In TDMA Clear Sky C/N, enter the value recorded for Up C/N [dB] from
iMonitor.
Step 14 In iBuilder, right-click the remote in the network tree and select Modify
Item.
Step 15 Select the Custom tab in the Modify Remote dialog box.
[REMOTE_DEFINITION]
ucp_power_disable = 1
Step 17 Right-click the remote in the network tree and apply the hub-side
configuration by selecting Apply Configuration Reliable Hub-Side (TCP)
from the menu.
14.13 Set the TDMA C/N Nominal Parameter for an Inroute Group
Whenever you add an inroute group, you should set the TDMA C/N Nominal parameter on the
Acquisition/Uplink Control tab for that inroute group according to the TDMA carrier modulation
type. The value for TDMA C/N Nominal is determined based on the link budget analysis for your
network, which takes into consideration the modulation and FEC rate of the carrier.
For details on setting this parameter in iBuilder, see Adding an Inroute Group on page 109.
251
Network Management System iBuilder User Guide, Release 7.0.1
252
Network Management System iBuilder User Guide, Release 7.0.1
15 Adding Mesh Capabilities to a Star Network
Converting a star network to support mesh traffic will require changes to your existing inroute
groups, inroutes and remotes. This chapter documents the prerequisites and procedures for a
successful conversion from a network that supports star traffic only to one that can also carry
mesh traffic. It discusses the following topics:
Perform a new Link Budget Analysis (LBA) to ensure that the equipment is correctly
sized to support mesh. This is discussed in detail in chapter 3, Mesh Technical
Description of the iDirect Technical Reference Guide.
Verify that the satellite transponder configuration for the hub and each remote is able
to support the mesh architecture. All hubs and remotes must lie in the same
geographic footprint so that they are able to receive their own loopback transmissions
to the satellite. This requirement precludes the use of the majority of spot beam and
hemi-beam transponders for mesh networks.
Verify that all of the following mesh hardware requirements are met:
A Private Hub supporting mesh must use an externally referenced PLL LNB
An M1D1 line card must be used to transmit the mesh outroute.
An M1D1 line card or M0D1 line card must be used to receive the mesh inroute.
(This line card can be the same M1D1 line card used for the mesh outroute.)
All mesh remotes must be equipped with PLL LNBs.
Each remote BUC and antenna must be properly sized to close link budget for a
given data rate.
A mesh remote must be an iNFINITI 5300 or 7300 series modem.
For a detailed discussion of these prerequisites, see chapter 3, Mesh Technical Description of
the iDirect Technical Reference Guide.
253
Network Management System iBuilder User Guide, Release 7.0.1
Step 1 Right-click the M1D1 line card in the iBuilders tree and select
Modify Configuration from the menu.
Step 2 When the Line Card dialog box appears, select the Mesh Enabled check box
in the Mesh area of the screen.
Step 3 Click the M1D1 line card in the iBuilders tree and select
Modify Configuration from the menu.
Step 4 Configure the Uplink Power Control (UPC) parameters for the mesh
outroute:
a Follow the steps in section 14.10 on page 247 to determine and set the
SCPC LB Clear Sky C/N parameter for the mesh outroute.
b Follow the steps in section 14.11 on page 248 to determine and set the Hub
UPC margin for the mesh outroute.
Whether you are converting an existing inroute to mesh or adding a new mesh inroute, you must
calibrate the inbound carrier and set the Clear Sky C/N parameters for the mesh inroute group.
This must be performed during commissioning of the first mesh remote in the inroute group.
254
Network Management System iBuilder User Guide, Release 7.0.1
For details on how to calibrate the inbound channel to support mesh, see section 14.12 on
page 248.
NOTE There can only be a single inroute in any mesh inroute group.
The remote C/N at the hub will typically be higher in a mesh network than in a star network. The
UPC algorithm adjusts the transmit power of all remotes to operate within a common C/N range
at the hub. A remote with a C/N significantly higher or lower than this range will not acquire into
the network.
255
Network Management System iBuilder User Guide, Release 7.0.1
Follow these steps to configure an existing remote to carry mesh traffic:
Step 1 Right-click the remote in the network tree and select Modify Item to display
the Remote Modify dialog box.
Step 3 To determine and set the new initial power for the remote follow the steps
in Section 13.2 Set the Initial Tx Power for a Remote of the Installation
and Commissioning Guide for iDirect iNFINITI Series Satellite Routers.
Step 4 To set the Clear Sky C/N parameters for the remote, follow the steps in
Section 13.3 Set the Clear Sky C/N Parameters for a Mesh Remote of the
Installation and Commissioning Guide for iDirect iNFINITI Series Satellite
Routers.
256
Network Management System iBuilder User Guide, Release 7.0.1
Once recommissioned for mesh, a remote will typically have a
NOTE higher initial transmit power setting than it had in the star network.
257
Network Management System iBuilder User Guide, Release 7.0.1
258
Network Management System iBuilder User Guide, Release 7.0.1
Appendix A Configuring a Distributed NMS Server
You can distribute your NMS server processes across multiple IBM e-server machines. The
primary benefits of machine distribution are improved server performance and better utilization of
disk space.
iDirect recommends a distributed NMS server configuration once the number of remotes being
controlled by a single NMS exceeds approximately 800. iDirect has certified the new distributed
platform for up to 3000 remotes with iDS 7.0. This number should increase with future releases.
A.1 Prerequisites
Before you begin the configuration process, ensure that you have the following in place:
Four NMS e-servers, each installed with the same version of NMS software; three of
these servers are used for running various services and the fourth is used as a backup
server. If you already have a single Primary NMS server and a single Backup NMS
server in place, you will need to add two more NMS servers with the same version of
software the current Primary NMS is running.
IP addresses for all additional NMS servers must be on the same subnet as the
Primary and Backup servers. These servers are on the upstream side.
If the NMS servers have private IP addresses and you need to access these servers
(for running iBuilder and iMonitor) externally, then you have the following options:
configure a VPN system to allow access to the servers, or NAT the private addresses
to the public addresses and run the iDirect provided script on every client PC that will
run iBuilder and iMonitor clients. See Running the NAT Script on page 268 for the
script.
Server configuration is performed one time using a special script distributed with the nms_servers
installation package. Once configured, the distribution of server processes across machines will
remain unchanged unless you reconfigure it. This is true even if you upgrade your system.
259
Network Management System iBuilder User Guide, Release 7.0.1
The only supported distribution scheme is shown in the figure below.
NMS Server 1 (Primary) runs the configuration server (cfgsvr), and the Protocol
Processor controller process.
NMS Server 2 (Auxiliary) runs only the Statistics server (nrdsvr).
NMS Server 3 (Auxiliary) runs the Event server (evtsvr) and the Latency Server
(latsvr). The latsvr is not shown in this diagram.
260
Network Management System iBuilder User Guide, Release 7.0.1
A.4 Setting up a Distributed NMS Environment
You may set up or modify a Distributed NMS environment at any time while your network remains
operational. However, you will be required to stop your NMS server processes briefly and restart
them on the new machine(s) for the new configuration to take effect.
To configure a distributed NMS, you will run the script NMS-configuration-client.pl. This script
resides on the primary NMS server. When executed, it queries the local subnet, determining the
IP addresses of all NMS server machines and the current assignment of NMS processes to server
machines. The script then asks you to specify the new distribution and updates the assignments
before exiting. You then restart the NMS processes.
To configure a distributed NMS and retain historical data, begin with Step 1. To configure a
distributed NMS and not retain historical data, begin with Step 9.
Step 1 Verify that all four servers are configured with correct IP addresses, there
is IP connectivity between all the of the servers, and that iDirect NMS
software is installed on each server such that NMS server 1, 2, and 3 are
installed as primary and NMS server 4 is installed as backup.
Step 3 Stop the NMS processes on the server by entering the following command:
cd /var/lib/mysql/nrd_archive
Step 7 To copy the database from NMS 1 to NMS 2, enter the following command:
scp * root@x.x.x.x:/var/lib/mysql/nrd_archive/
Where,
Step 8 Repeat Step 7 and replace x.x.x.x with the IP address of NMS 3.
Step 9 Establish an SSH connection to the NMS 2 as root and convert it to the new
configuration by entering the following command:
261
Network Management System iBuilder User Guide, Release 7.0.1
/home/nms/utils/db_maint/DB-Conversion.pl
Step 10 When the DB-Conversion.pl script completes, restart the NMS
configuration by entering the following command:
The following steps must be done during a maintenance window as network downtime will
occur.
/home/nms/utils/db_maint/NMS-configuration-client.pl
The conversion script prompts you to select which services are to run on
which servers. At a minimum, the nrdsvr runs on NMS 2; the evtsvr and
the latsvr run on NMS 3. Then nmssvr, nms_config, nms_monitor,
cntrl, revsvr, and snmpsvr run on NMS 1.
Enter the number of the respective NMS when prompted. Sample output is
shown below.
root@x3550 ~
# /home/nms/utils/db_maint/NMS-configuration-client.pl
NMS Config Client >>> Looking for NMS installations with bcast
255.255.255.255, please wait...
===========================================================
List of existing NMS configurations
===========================================================
From NMS.ServerConfiguration on computer with 192.168.76.82 :
127.0.0.1 nms_cfg_server_ip
127.0.0.1 nms_evt_server_ip
127.0.0.1 nms_lat_server_ip
127.0.0.1 nms_nrd_server_ip
262
Network Management System iBuilder User Guide, Release 7.0.1
127.0.0.1 nms_lat_server_ip
127.0.0.1 nms_nrd_server_ip
===========================================================
List of IPs, where NMS installation was presented:
===========================================================
192.168.76.82 (1)
192.168.76.80 (2)
192.168.76.65 (3)
192.168.76.67 (4)
NMS Config Client >>> Please enter index for MySql server
(use number in parentheses above)
1
NMS Config Client >>> Server MySql assigned to IP address
192.168.76.82
NMS Config Client >>> Please enter index for CFG server
(use number in parentheses above)
1
NMS Config Client >>> Server CFG assigned to IP address 192.168.76.82
NMS Config Client >>> Please enter index for EVT server
(use number in parentheses above)
3
NMS Config Client >>> Server EVT assigned to IP address 192.168.76.65
NMS Config Client >>> Please enter index for NRD server
(use number in parentheses above)
2
NMS Config Client >>> Server NRD assigned to IP address 192.168.76.80
NMS Config Client >>> Please enter index for LAT server
(use number in parentheses above)
3
NMS Config Client >>> Server LAT assigned to IP address 192.168.76.65
263
Network Management System iBuilder User Guide, Release 7.0.1
Step 16 Log on to NMS 2 and repeat Step 15.
A.5 Removing the SNMP Proxy Server from Auxiliary NMS Servers
Before you continue, you must remove the SNMP proxy service from NMS 2 and NMS 3. To
remove the snmpproxy from NMS 2 and NMS 3, perform the following:
Step 3 Verify that the snmpproxy service is no longer running by entering the
following command:
telnet 0 14123
Step 3 Enter the Username and Password when prompted as follows:
Username: admin
Password: iDirect
Step 4 Enter the following commands:
264
Network Management System iBuilder User Guide, Release 7.0.1
Once these commands have been entered successfully, all the
devices (remote, HLC, network, PP) will display Changes
NOTE Pending in iBuilder. Downtime will be incurred while devices
reboot.
Step 5 Launch iBuilder and apply the changes in the following order: all remotes,
all Hub Line Cards, network, and Protocol Processor.
Step 4 Restart the Event and NRD servers to force a reconnection to the config
server using the new permissions.
To verify that the new permissions have been correctly configured, perform the following step on
both NMS 2 and NMS 3:
Step 1 Enter the following command from the command line prompt:
mysql --host=x.x.x.x
Where,
If this command immediately connects you to the mysql prompt on NMS 1, then the new
permissions have been correctly configured on the server from which you are connecting.
265
Network Management System iBuilder User Guide, Release 7.0.1
A.8 Assigning QoS Profiles
Once you have set up your distributed NMS, you must redirect your IP packets for remote NMS
traffic to the correct NMS servers by modifying the NMS Service Levels in your Upstream and
Downstream Traffic Profiles.
For the Upstream Traffic Profile, modify the Service Levels as follows:
Step 1 In the iBuilder tree, right-click the Default Traffic Profile folder and select
Modify Item.
Step 2 In the Service Levels area of the dialog box, select the appropriate Service
Level for the IP packet type you want to modify. (NMS_UDP, NMS_TCP or
NMS_ICMP).
Step 3 In the Rules area of the dialog box, select the Rule for that traffic and click
the Edit button.
266
Network Management System iBuilder User Guide, Release 7.0.1
Step 4 Change the Destination IP address to match the NMS servers IP address
for this type of traffic. (TCP traffic must be routed to config server, UDP
traffic to nrd server, and ICMP traffic to both evt server and lat server.)
Step 5 There will be Changes Pending on all remotes. Apply the changes.
If a service is running on a server that it should not be, use the following command to kill the
service:
killall service
Where,
killall evtsvr
Verify that your servers are configured to run dbBackup and dbRestore. For configuration
procedures, refer to the iDirect NMS Redundancy technical note, which is available for download
on the TAC web page located at http://tac.idirect.net.
267
Network Management System iBuilder User Guide, Release 7.0.1
A.10 Running the NAT Script
The iDirect NAT script translates private IP addresses to public IP address so that you can run
iBuilder and iMonitor from an external source. This section describes how to run the script for
iBuilder and iMonitor.
The steps for running the script for iBuilder are as follows:
@ECHO OFF
SET ENV_NRD_NMSAPI_IPADDR= x.x.x.x
Where,
Step 4 Save the file to the same directory where iBuilder is located.
The steps for running the script for iMonitor are as follows:
@ECHO OFF
SET ENV_NRD_NMSAPI_IPADDR= x.x.x.x
Where,
268
Network Management System iBuilder User Guide, Release 7.0.1
x.x.x.x represents the IP address of NMS 3
SET ENV_LAT_NMSAPI_IPADDR= x.x.x.x
Where,
Step 4 Save the file to the same directory where iMonitor is located.
# ./NMS-configuration-client.pl h
The NMS-domain-commands.pl command stops, starts or restarts the NMS server processes on
all NMS machines. You can run the command on any of the server machines.
# ./NMS-domain-commands.pl -h
Usage:
269
Network Management System iBuilder User Guide, Release 7.0.1
./NMS-domain-commands.pl -exec="status"
./NMS-domain-commands.pl -exec="status nms_monitor"
The following three commands start, restart and stop server processes, respectively. The first
example starts the evtsvr process. The second example restarts the latsvr process. The final
example stops all processes.
# ./NMS-domain-commands.pl -exec="status"
+++++++++++++++++++++++++++++++++++++++++++++++++
Using configuration from MySQL NMS.ServerConfiguration table on computer
127.0.0.1:
>>>>> 10.11.64.71:
nms_config (pid 22540) is running...
nmssvr is stopped
cntrlsvr is stopped
latsvr (pid 22596) is running...
snmpsvr is stopped
nms_monitor is stopped
>>>>> 10.11.64.72:
nms_config (pid 1628) is running...
evtsvr (pid 1744) is running...
nrdsvr (pid 1681) is running...
snmpsvr (pid 1712) is running...
nms_monitor is stopped
One-for-n redundancy means that one physical machine will back up all of your active servers, If
you choose this form of redundancy, you must modify the dbBackup.ini file on each NMS server
to ensure that the separate databases are copied to separate locations on the backup machine.
The figure below shows three servers, each copying its database to a single backup NMS. If NMS
1 fails, you will not need to run dbRestore prior to switchover since the configuration data will have
already been sent to the backup NMS. If NMS 2 or NMS 3 fails, you will need to run dbRestore
270
Network Management System iBuilder User Guide, Release 7.0.1
prior to the switchover if you want to preserve and add to the archive data in the failed servers
database.
271
Network Management System iBuilder User Guide, Release 7.0.1
272
Network Management System iBuilder User Guide, Release 7.0.1
Glossary of Terms and Acronyms
A process where by the satellite modem locks onto the proper satellite
Acquisition
carrier.
ACU Antenna control unit.
Analog-to-Digital Converter. A device that converts analog signals to a
ADC
digital representation.
Method of signal transmission in which information is relayed by
continuously altering the wave form of the electromagnetic current. An
Analog
analog signal is responsive to changes in light, sound, heat and
pressure. See also digital.
Device for transmitting and receiving radio waves. Depending on their
Antenna use and operating frequency, the form on an antenna can change from a
single piece of wire to a dish-shaped device.
The process of optimizing the orientation of a satellite antenna's main
Antenna Alignment direction of sensitivity towards the satellite to maximize the received
(pointing) signal level and to minimize the chance of receiving unwanted
interference from other satellite systems.
A cross sectional area of the antenna which is exposed to the satellite
Aperture
signal.
Point in an elliptical satellite orbit that is farthest from the surface of the
Apogee
earth.
A communications strategy that uses start and stop bits to indicate the
beginning and end of a character, rather than using constant timing to
Asynchronous transmit a series of characters. Asynchronous methods are especially
efficient when traffic comes in bursts (and not regularly paced). Modems
and terminals are asynchronous communications devices.
Weakening, usually measured in decibels, of a signal (loss) that occurs
Attenuation as it travels through a device or transmission medium (e.g. radio waves
through the atmosphere).
Attitude Control The orientation of the satellite in relationship to the earth and the sun.
The horizontal co-ordinate used to align the antenna to the satellite. See
Azimuth also Elevation.
The amount of data a cable can carry; measured in bits per second
(bps) for digital signals, or in hertz (Hz) for analog signals. A voice
transmission by telephone requires a bandwidth of about 3000 cycles
Bandwidth per channel (3KHz). A TV channel occupies a bandwidth of 6 million
cycles per second (6 MHz) in terrestrial systems. In satellite based
systems a larger bandwidth of 17.5 to 72 MHz is used to spread or
dither the television signal in order to prevent interference.
The number of times an electrical signal can be switched from one state
Baud to another within a second.
The ratio of the number of information bits received in error to the total
Bit Error Rate (BER) number of bits received, averaged over a period of time. It is used as an
overall measure of the quality of a received digital bit stream.
273
Network Management System iMonitor User Guide, Release 7.0.1
The number of bits transmitted within a second (bps) in a digital
Bit Rate
communication.
Broadcast Sending a single message to all the nodes of a network.
Band of frequencies used for satellite and terrestrial communications.
Most communications satellites use a range from 4 to 6 gigahertz (billion
C band
cycles per second). Requires larger ground antennas, usually twelve
feet in diameter, for television reception.
A proportion of the satellites bandwidth which is used to establish one
Capacity
or more communication channel.
The basic radio, television, or telephony transmit signal. The carrier in
Carrier
an analog signal.
The rate at which the carrier signal repeats, measured in cycles per
second (Hertz). This is the main frequency on which a voice, data, or
Carrier Frequency
video signal is sent. Microwave and satellite communications
transmitters operate between 1 to 14 GHz.
A band of radio frequencies assigned for a particular purpose, usually
for the establishment of one complete communication link, or a path for
Channel an electrical signal. Television signals require a 6 MHz frequency band
to carry all the necessary picture detail. Channel frequencies are
specified by governmental agencies.
CIR See Committed Information Rate.
A transmission line in which the inner conductor is completely
surrounded by an outer conductor, so that the inner and outer conductor
Coaxial Cable
are coaxially separated. The line has a wide bandwidth capacity which
can carry several television channels and hundreds of voice channels.
Two or more satellites occupying approximately the same geostationary
Collocated orbital position. To a small receiving antenna the satellites appear to be
(satellites) exactly at the same place. The satellites are kept several kilometers
apart in space to avoid collision.
Committed
Information Rate The guaranteed network bandwidth availability.
(CIR)
An organization which operates communications circuits. Common
Common Carrier carriers include the telephone companies as well as the owners of the
communications satellites.
Communications A satellite in Earth orbit which receives signals from an Earth station and
Satellite retransmits the signal to other Earth stations.
COMSAT Communication Satellite Corporation, the U.S. signatory for INTELSAT.
Continuous Wave Signal consisting of a single frequency especially used in testing satellite
(CW) modems and antennas.
The standard unit used to express the ratio of two power levels. It is
Decibel (Db) used in communications to express either a gain or loss in power
between the input and output devices.
A television set-top device that converts an electronically scrambled
Decoder television picture into a viewable signal.
274
Network Management System iMonitor User Guide, Release 7.0.1
The time it takes for a signal to go from the sending station through the
Delay
satellite to the receiving station (around one-quarter of a second).
A satellite receiver circuit which extracts or demodulates the desired
Demodulator
signals from the received carrier.
Representation of information as bits of data for transmission. Digital
communications technology permits higher transmission speeds and a
lower error rate than analog technology. As an analog signal is received
Digital and amplified at each repeater station, any noise is also amplified. A
digital signal, however, is detected and regenerated (not amplified), and
any noise is lost unless it corresponds to a value that the regenerator
interprets as digital signal.
Dish Slang for parabolic antenna.
The part of the satellite communications link that involves signal
Downlink retransmission from the satellite and reception on the ground. See also
Uplink.
Downstream carrier (synonymous to outbound carrier) is the carrier from
Downstream Carrier
the Hub to the remote modem, via the satellite.
Two-way communications. The telephone line is full duplex in that both
Duplex directions of communication occur at the same time. Walkie-talkie
communications is half-duplex only one party may transmit at a time.
A combination of devices (antenna, receivers) used to receive a signal
Earth Station
transmitted by one or more satellites.
The upward tilt (vertical coordinate) of a satellite antenna measured in
Elevation degrees, required to align the antenna with the communications
satellite. See also Azimuth.
Orbits in which the satellite path describes an ellipse, with the Earth
Elliptical Orbit
located at one focus.
A device used to electronically alter a signal so that it can only be
Encoder
understood on a receiver equipped with a special decoder.
Equatorial Orbit An orbit with a plane parallel to the Earths equator.
The bandwidth over and above the committed information rate that a
Excess Information device is allowed to use without guaranteeing that the data will always
Rate (EIR) be delivered to its destination.
Forward Error Correction is an error correction method that adds
FEC redundant bits to a bit stream, so that the receiver can detect and
correct errors in transmission.
FEC Block The basic FEC unit is a FEC block.
1) The transmission of video content from a distribution center.
Feed
2)The feed system of an antenna.
Focal Length Distance from the center feed to the center of the dish.
The geographic area over which a satellite antenna receives or directs
Footprint its signals.
275
Network Management System iMonitor User Guide, Release 7.0.1
Slots left in the dynamic sub-frame after all stream, guaranteed (CIR)
and preemptive (EIR) bandwidth requests are satisfied. Free slots are
Free Slots
allocated to all VSATs (up or down), except the master, in a round-robin
fashion.
The number of times that an alternating current goes through its
Frequency complete cycle in one second of time. One cycle per second is also
referred to as one hertz.
A process designed to eliminate frequency interference between
Frequency
different satellite systems or between terrestrial microwave systems and
Coordination
satellites.
Transmission that occurs in both directions simultaneously over the
Full duplex
communications media (e.g. telephone).
Geostationary An satellite orbiting Earth at such speed that it appears to remain
satellite stationary with respect to the earths surface. See also Clarke Orbit.
A satellite orbiting Earth at Earths rotational speed and at the same
direction. A satellite in geosynchronous orbit is known as a
Geosynchronous geosynchronous or geostationary satellite. The orbit is synchronous
satellite because the satellite makes a revolution in about 24 hours. The
satellites are about 35,800 kilometers (22,350 miles) above Earth, and
they appear to be stationary over a location.
All the Earth stations that are operating within a particular satellite
Ground Segment
system or network.
A radio station, on or near the surface of the Earth, designed to transmit
Ground Station
or receive to/from a spacecraft.
The capability for transmitting continuously and reliably at a specified
Guaranteed
transmission speed. The guarantee makes it possible to send time-
Bandwidth
dependent data (such as voice, video, or multimedia) over the line.
Slots configured per VSAT and made available to that VSAT upon its
Guaranteed Slots request. When the queue is depleted, these slots are taken away by the
master and distributed to other requesting VISNs as preemptive slots.
Guard Band A thin frequency band used to separate bands (channels) in order to
(guardband) prevent interference and signal leakage.
Unused frequency space between carriers that prevents adjacent
Guard Channel carriers from interfering each other.
A communications form in which transmissions can go in only one
direction at a time. With half-duplex operation, the entire bandwidth can
Half Duplex be used for the transmission. In contrast, full-duplex operation must split
the bandwidth between the two directions.
The upper part of the Ku band downlink frequency range, from 11.7 GHz
High Band to 12.75 GHz.
High Power Amplifier. Earth station equipment that amplifies the
HPA transmit RF signal and boosts it to a power level that is suitable for
transmission over an earth-space link.
276
Network Management System iMonitor User Guide, Release 7.0.1
Hub Radio Frequency Terminal - Equipment that includes the antenna,
U/C (up Converter), D/C (Down Converter) HPA, and LNA, which
Hub RFT
provides the up and down conversion of signals in a satellite-based
network.
Intermediate Frequency. The frequency range 70 to140 MHz used for
the distribution of satellite signals from the LNB at the dish to the users
IF satellite receiver. It is always used in direct-to-home systems and is the
most suitable for distribution of digital signals in communal systems IF
systems.
Inbound Carrier See Upstream Carrier.
The angle between the orbital plane of a satellite and the equatorial
Inclination
plane of the Earth.
The satellite modem and indoor devices (in contrast to outdoor units,
Indoor Unit (IDU)
ODU).
The user data rate including IP headers plus iDirect overhead. The
Information Rate
downstream overhead is approximately 2.75% of the information rate.
International Telecommunications Satellite Organization. Agency that
INTELSAT
operates a network of satellites for international transmissions.
Interfacility Link
The cable that connects the indoor unit with the outdoor unit.
(IFL)
Intermediate
Generally, 70 MHz or 140 MHz.
Frequency (IF)
Ka band The frequency range from 18 GHz to 31 GHz.
Frequency range from 10.9 GHz to 17 GHz, increasingly used by
Ku Band communications satellites. Requires smaller ground antennas, usually
four feet (1.2 meter) in diameter.
L-Band The frequency range from 0.5 GHz to 1.5 GHz.
Low Noise Amplifier The preamplifier between the antenna and the
earth station receiver. For maximum effectiveness, it should be located
LNA as near the antenna as possible, and is usually attached directly to the
antenna receive port.
Low Noise Block Converter is the converter on the down link that takes
the Ku, Ka, or C-Band signal from the satellite and converts it to a lower
LNB frequency (L-band) signal that can be fed through the IFL cable to the
modem.
Satellites that are not stationary from a fixed point on earth and have the
Low Earth Orbit lowest orbit of all communication satellites. Most handset-to-satellite
(LEO) satellite systems are based on LEO satellites using L-Band.
The preamplifier between the antenna and the Earth station receiver.
Low Noise Amplifier For maximum effectiveness, it must be located as near the antenna as
(LNA) possible, and is usually attached directly to the antenna receive port.
The amount of signal in dB by which the satellite system exceeds the
Margin minimum levels required for operation.
Techniques that allows a number of simultaneous transmissions to
Multiplexing travel over a single circuit.
277
Network Management System iMonitor User Guide, Release 7.0.1
ODU Outdoor unit, such as an antenna dish.
Outbound Carrier See Downstream Carrier.
The range of frequencies handled by a satellite translator or
Passband
transponder.
Perigee The point in a satellites orbit where it is closest to Earth.
Design technique used to increase the capacity of the satellite
Polarization
transmission channels by reusing the satellite transponder frequencies.
QPSK (Quadrature Digital modulation scheme used in transmission communications to
Phase Shift Keying) allow increased sending capacity.
Loss of signal at Ku or Ka Band frequencies due to absorption and
Rain Outage
increased sky noise temperature caused by heavy rainfall.
A sophisticated electronic communications relay station orbiting 22,237
Satellite miles above the equator moving in a fixed orbit at the same speed and
direction of the Earth (about 7,000 m.p.h. east to west).
The use of geostationary orbiting communication satellites to relay
Satellite
transmission from one Earth station to another or to several Earth
Communications
stations. It takes only three satellites to cover the whole Earth.
Segment of orbit during which the satellite passes nearby and in the
Satellite Pass
range of a particular ground station.
Satellite communications operations center that is shared among
Shared hub
several separate network users; often used for VSAT operations.
Single-Channel-Per- A method used to transmit a large number of signals over a single
Carrier (SCPC) satellite transponder.
Signal to Noise Ratio - In analog and digital communications, signal-to-
SNR noise ratio, (S/N or SNR), is a measure of signal strength relative to
background noise. The ratio is usually measured in decibels (dB).
Satellite signal that falls on locations outside the beam patterns defined
Spillover
edge of coverage.
In satellite television transmission, the video picture is transmitted over
the main carrier. The corresponding audio is sent via an FM subcarrier.
Subcarrier Some satellite transponders carry as many as four special audio or data
subcarriers.
Symbol Rate refers to the number of symbols that are transmitted in one
second. From the symbol rate, you can calculate the bandwidth (total
Symbol Rate number of bits per second) by multiplying the bits per symbol times the
symbol rate.
A type of multiplexing where two or more channels of information are
TDM (Time Division transmitted over the same link by allocating a different time interval
Multiplexing) (slot or slice) for the transmission of each channel. (i.e. the channels
take turns to use the link.)
TDMA (Time A communications technique that uses a common channel (multipoint or
Division Multiple broadcast) for communications among multiple users by allocating
Access) unique time slots to different users.
278
Network Management System iMonitor User Guide, Release 7.0.1
Transmission A protocol developed for the internet to get data from one network
Control Protocol device to another; TCP uses a retransmission strategy to ensure that
(TCP) data will not be lost in transmission.
Includes all over-the-air data. This includes the user data (information
Transmission Rate
rate), iDirect overhead, and FEC encoding bits.
A device in a communications satellite that receives signals from the
Transponder earth, translates and amplifies them on another frequency, and then
retransmits them.
Ultra High Frequency. Band in the 500-900 MHz range, including TV
UHF
channels 14 through 83.
The Earth station used to transmit signals to a satellite and the stream of
Uplink
signals going up to the satellite.
Upstream Upstream carrier (synonymous to inbound carrier) is the carrier from the
Carrier remote modem to the Hub, via the satellite.
Very High Frequency, Refers to electromagnetic waves between
VHF
approximately 54 MHz and 300 MHz.
Very Small Aperture Terminal. Means of transmission of video, voice,
VSAT
and data to a satellite. Used in business applications.
279
Network Management System iMonitor User Guide, Release 7.0.1
280
Network Management System iMonitor User Guide, Release 7.0.1
Index
281
Network Management System iBuilder User Guide, Release 7.0.1
using revision server 207 line card 194
modifying 182 network 194
saving protocol processor 193
TCP vs. UDP 196
saving to single elements 193
status 49
E
uploading last modified vs. existing 183 elements 19
uploading multiple modified vs. existing 186
viewing 182
context menu button 29 F
converters failover, line cards 101
adding 62 FEC blocks 71
CRTP 156 find toolbar 32
CRTP performance characteristics 156 folders 19
customers adding entries 22
adding 121 to 122 BUCs 19
listing on remotes 121 customers 20
distributors 19 to 20
empty 20
D Hub RFT components 20
LNBs 19
database locking 233
manufacturers 19
deactivating operators 20
remote 177 QoS profiles 19
details remote antenna components 19
top level of 22
choosing 40
choosing details feature 40 free slot allocation 110
creating sets of 40 frequency hopping 108
view 38 frequency translation 63
DHCP 127
distributors G
adding 121 to 122
listing on remotes 121 geo location
DNS 127 remotes 142
down converter 61 globe
adding 62 sorting
downloading globe
hide element 25
concurrently to remotes and hub 201
tree 25
images
TCP 207 globe, iDirect 19
interactions 205 GRE tunnels 133
multicast 202 guest user 232
multiple images 202
out of network remotes 204
using revision server 207 H
downloading configurations 190 high power amplifier See HPA
canceling 192 HPA 61
chassis 193
282
Network Management System iBuilder User Guide, Release 7.0.1
adding 64 using NMS GUI 23
hub commissioning 235 to 251 IP configuration on remotes 123 to 134
1 dB compression test 244 iSCPC
downloading line cards using iSite 239 adding upstream SCPC carriers 74
setting C/N for mesh inroute 248 carrier assignment to remotes 120
setting C/N for mesh outroute 247 downstream carriers 69
setting IP address on line card 237 iSCPC line cards 99
setting tx power on line card 245 iSCPC remotes 116
setting UPC margin for mesh outroute 248 overview 8
Hub RFT iSite 13
adding 82 using to download a line card 239
Hub RFT Components 61
hubs L
assigning inroute groups 111
LAN
interface 125
I
remotes 123 to 126
iBuilder large block 73
description 13 latitude
installing 15 teleport 78
images 201 legend 36
compatible versions 201 line cards
downloading 201
adding
interactions 205
receive 97
out of network 204
standby 101
TCP 207
transmit 94
downloading multiple units 202
transmit/receive 94
UDP multicast 202
automatic failover 101
iMonitor commissioning See hub commissioning
description 13 configuring for mesh 96
information rate 73 downloading using iSite 239
failover sequence 104
NetModems vs. Series models 71, 73
failure recovery 106
inroute groups free slot allocation 110
adding 107 iSCPC line cards 99
assigning to hubs 111 setting tx power 245
description 107 Tx vs. Rx-only 103
enabling CRTP for mesh remotes 111 types supporting mesh 94
enabling for mesh 110 LNB 143 to 144
enabling UDP header compression for mesh re-
locking
motes 111
enabling UDP payload compression for mesh database 233
remotes 110 logging in 16
mesh-enabled, described 108 passwords 16
uplink control parameters 113 to other servers 17
installation longitude
NMS applications 15 spacecraft 66
interface teleport 78
283
Network Management System iBuilder User Guide, Release 7.0.1
M adding receive 97
adding transmit 94
main toolbar 32 adding transmit/receive 94
management interface 125 NMS
mesh applications 12
adding a mesh inroute group 110 distributed NMS server 259
adding a mesh line card 96 main components 11
configuring remotes for mesh 119 multiple users accessing 17
configuring TCP as single-hop traffic 111 servers used 14
converting a network from star to mesh 253 to setting up a distributed environment 261
257
converting a star inroute to mesh 254
O
enabling CRTP per inroute group 111
enabling UDP header compression for mesh in- ODU Tx 10 MHz 63
route groups 111
ODU Tx DC power 63
enabling UDP payload compression for mesh in-
route groups 110 options files 181
hardware requirements 253 hub-side and remote-side 181
line card types that support 94 orbital inclination 66
mesh-enabled inroute groups 108
prerequisites for converting from star to mesh
253 P
recalibrating a star outroute for mesh 253
panes
reconfiguring a star remote for mesh 255
setting inroute C/N 248 active users 35, 227
setting outroute C/N 247 choose details 40
setting outroute UPC margin 248 configuration changes 37
transponder configuration requirements 253 details 38
uplink control parameters on mesh inroute legend 36
groups 112 network tree, See tree
uplink control parameters on mesh line cards 96 See also dialog boxes
uplink control parameters on mesh remotes 119 passwords 16, 229, 231
VLAN tagging on mesh remotes 124 profiles
mobile state 142 QoS
modifying See remotes:QoS 167
accepting changes 18 properties
viewing element 38
N protocol processor
adding 83
NAT 129
blades 85
NetManager, replaced by iSite 13 installing 12
network tree, See tree
networks Q
adding 93
free card slot allocation 110 QoS 168
inroute groups see also remotes:QoS
adding 107 changing multiple profiles 168
assigning to hubs 111 changing profile assignments 168
description 107 creating and managing profiles 157
line cards modifying profiles 159
284
Network Management System iBuilder User Guide, Release 7.0.1
profile folders 158 MUSIC 119
profiles 167, 169 NAT 129
changing assignments passwords 118
remotes 168 port forwarding 132
remotes 138 QoS 138, 167 to 169
up/downstream filters 159 modifying profiles 159
profile folders 158
profiles 167, 169
R up/downstream filters 159
receive line card receive properties 120
carrier name 120
adding 97
reconfiguring for mesh 255
receive properties remote antenna 144
remotes 120 resetting 206
remotes 115 roaming remotes 145 to 153
applying changes 199
activating 177 to 178 beam switching for 152
adding 115 to 144 configuration changes 198
antenna 144 managing configuration of 149
applying configurations 196 options files for 198
BUC 143 to 144 pending changes across networks 199
cloning 145 serial number 118
configuring serial number, system-generated 118
actions to perform beforehand 115
static routes 129
data to know beforehand 115 switch tab 134 to 138
configuring for mesh 119 copying data to a spreadsheet 138
configuring RIPv2 on 124 dedicating a port to a VLAN 135
customers 121 to 122 default settings 135
deactivating 177 to 178 setting a port as a trunk 136
deactivating before deleting 182 setting the port speed and port mode 137
DHCP 127 transmit properties 120
distributors 121 to 122 power 120
DNS 127 power, max 120
downloading uplink control parameters on 119
using revision server 207
upstream SAR on mesh-enabled remotes 140
downloading configurations VLAN 123 to 126
out of network 204
VSAT 143
geo location 142 to 143
information tab 116 to 123 requirements
IP configuration 123 to 134 system 15
iSCPC remotes 116 resetting 206
LAN 123 to 126
resetting elements 192
LAN "same as" option 125
LAN interface 125 retrieving configurations
link encryption on NetModem II Plus 119 modified vs. existing 186
listing customers 121 multiple 186
listing distributors 121 single
LNB 143 to 144 last modified vs. existing 183
management interface 125 revision server 207 to 214
mobile state 142 cancelling an upgrade 214
model type 118 duty cycle explained 208
moving 179 starting 210
multicast groups 131
285
Network Management System iBuilder User Guide, Release 7.0.1
status pane 212 longitude 78
using to download remotes 207 toolbars
when to use 209
choose details 40
right mouse button 29 configuration changes 37
right-click details 38
menu options 34 find 32
icons 32
RIP, see RIPv2
legend 36
RIPv2 124 to 125, 130 main 32
roaming remotes, see remotes: roaming remotes main menu 34
status bar 34
view menu 34
RTP header compression performance character-
istics 156 translation frequency 67
transmission rate 71, 73
S transmit line card
adding 94
SAR 139 transmit properties
on mesh enabled remotes 140 remotes 120
saving configurations transmit/receive line card
single elements 193 adding 94
TCP vs. UDP 196
transponder
servers 14
adding 66
slot allocation
tree
free 110
description 29
small block 73 elements 19
spacecraft 65 to 66 folders 19
adding 65 tree view, See tree
longitude 66 treebar, See tree
spectral inversion 63
static routes 129
U
status
elements 49 UDP payload compression 156
status bar 34 up converter 61
super user 232 adding 62
switch, eight-port: see remote: switch tab upgrade assistant
symbol rate 71, 73 See revision server
286
Network Management System iBuilder User Guide, Release 7.0.1
active users pane 227 global vs. customized 56
adding user accounts 224 of line cards 97
changing passwords 229 of protocol processors 85
cloning user accounts 225 of remotes 145
conversion during upgrade 215 setting global properties for network elements
deleting user accounts 227 56
guest 232 windows, See panes
levels of 230
See also dialog boxes
locking others out 233
managing 230
modifying user accounts 224 to 225
multiple 17
passwords 231
permissions 230
privileges
defined 230
predetermined 230 to 231
super user 232
types 230
viewing user accounts 226
VNO guest 232
VNO super user 232
V
VLAN
adding 88
default vs. upstream 125
on eight-port switch: see remote: switch tab
remotes 123 to 126
tagging on mesh remotes 124
upstream interface 88
VNO guest, see users: VNO guest
VNO super user, see users: VNO super user
VNO User Groups
adding and modifying 218
creating and managing 218
modifying visibility and access 222
setting rate limits 221
visibility and access 216
VSAT 143
W
warning properties 55 to 59
categories of warnings 55
clearing customized properties 59
configurable properties 55
customizing for specific network elements 58
distinguishing customized warnings 59
287
Network Management System iBuilder User Guide, Release 7.0.1
288
Network Management System iBuilder User Guide, Release 7.0.1