iDirect Features and Chassis

Licensing Guide

iDX Release 3.0

July 08, 2011

Copyright © 2011 VT iDirect, Inc. All rights reserved. Reproduction in whole or in part without permission is
prohibited. Information contained herein is subject to change without notice. The specifications and information
regarding the products in this document are subject to change without notice. All statements, information, and
recommendations in this document 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 document 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 product's
rightful owner.

Document Name: UG_Features and Chassis Licensing iDX 3.0_Rev B_07082011.pdf

Document Part Number: T0000384

ii iDX 3.0 iDirect Features and Chassis Licensing Guide

 Revision History

The following table shows all revisions for this document. If you are not sure if this is the
latest version, you can check the TAC web page at http://tac.idirect.net.

Revision Date Released Reason for Change(s) Who Updated?

A 06/03/2011 First release of document for iDX 3.0 JVespoli
B 07/08/2011 Update for SatManage Standard Edition JVespoli

iDX 3.0 iDirect Features and Chassis Licensing Guide iii

Contents

About This Guide

Purpose. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Contents Of This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Document Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
Related Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

1 What Is iDirect Licensing?

2 Acquiring and Applying iDirect Chassis Licenses

2.1 Using Chassis Manager in Multi-NMS Configurations . . . . . . . . . . . . . . . . . . . . . 5
2.2 How Do I Get a Hub Timing Group License? . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Step 1. Request a Hub Timing Group License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Step 2. Enable Download Permissions on Chassis Manager . . . . . . . . . . . . . . . . . . . . . . . . . 7
Step 3. Import the Hub Timing Group License File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Step 4. Validate the Chassis Serial Number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Step 5. Assign Hub Line Cards to Slots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

3 Feature Licensing
3.1 What Feature Licenses Are Available? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
3.2 How Do I Acquire a Feature License? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Step 1. Fill Out a Purchase Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Step 2. Create a License Request File and Request a License . . . . . . . . . . . . . . . . . . . . . 14
Step 3. Import the License File Into Your iDirect Network . . . . . . . . . . . . . . . . . . . . . . . . 18
Step 4. Activate the Licensed Feature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

4 Protocol Processor Blade Feature Licensing

Step 1. Request a PP Blade Encryption License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Step 2. Install a PP Blade License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Step 3. Enable the Link Encryption Feature on the NMS Server . . . . . . . . . . . . . . . . . . . . 22

iv iDX 3.0 iDirect Features and Chassis Licensing Guide

List of Figures

Figure 1. License Toolbar Selected . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Figure 2. Import/Export Button Icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Figure 3. Please Select License Type Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . 8
Figure 4. Choose License File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Figure 5. Validate the Chassis Serial Number . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Figure 6. Chassis Dialog Box: Assigning Hub Line Cards to Slots . . . . . . . . . . . . . . 11
Figure 7. License Toolbar Selected . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Figure 8. Import/Export Button Icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Figure 9. iBuilder Tree: Parent Element Selected . . . . . . . . . . . . . . . . . . . . . . . 15
Figure 10. Data for Licensing Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Figure 11. Select Units for Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Figure 12. Save As Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Figure 13. Sample License Request File Exported from iBuilder . . . . . . . . . . . . . . . 17
Figure 14. License Toolbar Selected . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Figure 15. Import/Export Button Icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Figure 16. Please Select License Type Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . 19
Figure 17. Choose License File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

iDX 3.0 iDirect Features and Chassis Licensing Guide v

vi iDX 3.0 iDirect Features and Chassis Licensing Guide
 About This Guide

Purpose
The purpose of this guide is to introduce you to iDirect’s licensing feature and to explain how
to acquire licenses and apply them to your iDirect networks.

Intended Audience
This guide is written for network operators using the iDirect iDX iBuilder/iMonitor software
suite; network architects; other personnel who operate or monitor iDirect networks; and
personnel responsible for purchasing or installing iDirect licenses.

Contents Of This Guide

This document contains the following chapters:
• Chapter 1, What Is iDirect Licensing?
• Chapter 2, Acquiring and Applying iDirect Chassis Licenses
• Chapter 3, Feature Licensing
• Chapter 4, Protocol Processor Blade Feature Licensing

iDX 3.0 iDirect Features and Chassis Licensing Guide vii

Document Conventions

Document Conventions
This section illustrates and describes the conventions used throughout the manual. Take a
look now, before you begin using this manual, so that you’ll know how to interpret the
information presented.

Convention Description Example

Blue Used when the user is [SWITCH_PORT_n]
Courier required to enter a vid = vlan_id
bold command at a command
line prompt or in a console
Courier Used when showing Output similar to the following sample appears:
font resulting output from a [SECURITY]
command that was entered password =
at a command line or on a
$idi2$/bFMhf$5H8mYAaP1sTZ0m1Ny/dYyLaS40/
console.
admin_password =
$idi2$146rgm$.KtDb4OH5CEBxzH6Ds2xM.ehHCH
os_password =
$1$UTKh0V$cc/UfNThFmBI7sT.zYptQ0
Bold Used when specifying 1. If you are adding a remote to an inroute group,
Trebuchet names appearing on the right-click the Inroute Group and select Add Remote.
font screen such as dialog box
names, field names, tab
The Remote dialog box has a number of user-
names, menu selections,
selectable tabs across the top. The Information Tab is
folder names, etc.
visible when the dialog box opens.
Blue Used to show all For instructions on adding a line card to the network
Trebuchet hyperlinked text within a tree and selecting a Hub RFT for the line card, see
italics document. “Adding a Line Card” on page 108.

Bold italic Used to emphasize Note: Several remote model types support link
Trebuchet information for the user, encryption.
font such as in notes.

Red italic Used when the user needs

Trebuchet to STRICTLY follow the
WARNING! The following procedure may cause
font instructions or have
additional knowledge about
a network outage.
a procedure or action.

viii iDX 3.0 iDirect Features and Chassis Licensing Guide

Related Documents

Related Documents
The following iDirect documents are available at http://tac.idirect.net and may also contain
information relevant to this release. Please refer to these documents as needed or indicated
within this guide. It is recommended that you download the iBuilder User Guide in addition to
the this guide, as these two documents are used throughout the licensing procedures.

Note: As you determine which documents may be helpful to you, be sure to refer to
the document that pertains to the iDX release you are installing or have
installed on your iDirect network.
• Release Notes
• Software New Installation Guide for New Hubs
• Network Upgrade Procedure Guide
• iBuilder User Guide
• iMonitor User Guide
• Technical Reference Guide
• Satellite Router Commissioning and Installation Guide
• Upgrade/New Installation Survey
• Link Budget Analysis Guide

Getting Help
The iDirect Technical Assistance Center (TAC) is available to help you 24 hours a day, 365 days
a year. Software user’s guides, installation procedures, FAQ pages, and other documentation
that supports our products are available on the TAC webpage. Please access our TAC webpage
at: http://tac.idirect.net.
If you are unable to find the answers or information that you need, you can contact the TAC at
(703) 648-8151.
If you are interested in purchasing iDirect products, please contact iDirect Corporate Sales by
telephone or email.
• Telephone: (703) 648-8000
• Email: SALES@iDirect.net
iDirect strives to produce documentation that is technically accurate, easy to use, and helpful
to our customers. Your feedback is welcomed! Send your comments to techpubs@idirect.net.

iDX 3.0 iDirect Features and Chassis Licensing Guide ix

Getting Help

x iDX 3.0 iDirect Features and Chassis Licensing Guide

1 What Is iDirect Licensing?

iDirect offers several different types of licenses, depending on your iDX release, the features
you want to use on your networks, and your specific hardware.
Each license type is described in detail in the following sections.
NMS Server License — Introduced in iDS 7.0, an NMS license is required to operate the iDirect
NMS server. This license is obtained from the iDirect Technical Assistance Center (TAC) and
installed on your NMS server when you initially install or upgrade the iDirect software.
Included in the NMS license are specific features you may request, including:
• Geographic Map
• Global NMS
• SkyMonitor
• VNO User Groups
• CNO User Groups
Instructions for installing the NMS Server license are provided in the Network Upgrade
Procedure Guide for the specific release you are installing, which can be downloaded from
the TAC Web Page at http://tac.idirect.net).
Hub Timing Group License — Beginning in iDX Release 2.0, Hub Timing Group licenses are
required to enable chassis slots on both the 4-slot and 20-slot hub chassis. For new 5IF hub
owners, this method offers a way to “pay as you grow” such that you can activate one, some,
or all five timing groups as your networks grow. These licenses are obtained from the TAC,
based on specific information you provide, and are imported using the iBuilder License
Toolbar.

Note: Refer to Chapter 2, Acquiring and Applying iDirect Chassis Licenses for
information about obtaining, installing, and activating Hub Timing Group
licenses.
Hardware-Specific Feature License — Introduced in iDX Release 2.0, Hardware-Specific
Feature licenses are software feature licenses available for specific remote modems or hub
line cards. These licenses include:
• Evolution X3 AES Link Encryption
• Evolution X5 AES Link Encryption
• Evolution eP100 AES Link Encryption
• Evolution X5 Upstream Spread Spectrum

iDX 3.0 iDirect Features and Chassis Licensing Guide 1

 • Evolution eP100 Upstream Spread Spectrum
• Evolution e8350/e800/e850mp High-Speed COTM
• Evolution eP100 High-Speed COTM
• Evolution X3 SCPC Return
• Evolution X5 SCPC Return
• Evolution XLC-11 Upstream Spread Spectrum
• Evolution XLC-11 Downstream Spread Spectrum (iNFINITI outbound carriers only)
• Evolution eM1D1 TRANSEC
• Evolution eM0DM/XLC-M TDMA multichannel support
• Evolution eM0DM/XLC-M SCPC Return multichannel support
These licenses are imported using the iBuilder License Toolbar.

Note: Refer to Chapter 3, Feature Licensing for information about obtaining,

installing, and activating Hardware-Specific Feature licenses.
Protocol Processor Blade Feature License — Beginning in iDX Release 2.1, a PP blade
encryption license is required to enable Link Encryption and TRANSEC on any PP blade that
communicates with the licensed remotes. To enable this license, a valid license file must be
copied to a specific directory on your PP blade server.

Note: Refer to Chapter 4, Protocol Processor Blade Feature Licensing for information
about obtaining, installing, and activating Protocol Processor Blade Feature
licenses.
SatManage License — Functionality within SatManage is enabled by the use of license keys. A
SatManage Core license is required for all SatManage installations. Licenses for other
SatManage packages are optional. When you order SatManage modules from iDirect, you will
be asked to include the following licensing information:
• Eth0 MAC address of your SatManage server(s)
• Serial number of your SatManage server(s)
• Duration of the license you are requesting
• Number of circuits you want to license in blocks of 250 for the packages indicated
below.

Note: If you have SatManage Enterprise Edition without the NOC Toolset enabled and
would like to purchase a license to enable that module, please include the
virtual MAC address as well. The following command issued at the Linux
command line will produce this information:
grep "ethernet0.generatedAddress" /opt/Intra/machines/SE-RACSE-RAC.vmx
| grep -v Offset
Licenses are available for the following SatManage packages:
• SatManage Core (Required. Indicate the number of circuits you want to license.)
• NOC Toolset
• Customer Management
• Mobility

2 iDX 3.0 iDirect Features and Chassis Licensing Guide

 • Auto HelpDesk
• Traffic Analysis
• ViperSat Support (Indicate the number of circuits you want to license.)
• Comtech (Indicate the number of circuits you want to license.)
iDirect offers both Standard and Enterprise editions of SatManage, differentiated by
functionality and the size of your network. For a description of the SatManage packages and
for details on installing and activating SatManage licenses, see the SatManage Integration
and Configuration Guide available on the TAC web page.

iDX 3.0 iDirect Features and Chassis Licensing Guide 3

4 iDX 3.0 iDirect Features and Chassis Licensing Guide
2 Acquiring and Applying
iDirect Chassis Licenses

Now that you have reviewed the introduction to iDirect licensing in Chapter 1, What Is iDirect
Licensing?, you are ready to learn how to acquire a license and how to apply it to your iDirect
network.

Note: The terms “Chassis License” and “Hub Timing Group License” are used
synonymously in this guide.
Introduced in iDX Release 2.0, Hub Timing Group licenses are required to enable chassis slots
on both the 4-slot and 20-slot hub chassis. For new 5IF hub owners, this method offers a way
to “pay as you grow” such that you can activate one, some, or all five timing groups as your
networks grow. These licenses are obtained from the TAC, based on specific information you
provide, and are imported using the iBuilder License Toolbar.

Note: All users who are installing or upgrading to iDX Release 2.0 or later are
required to obtain a Hub Timing Group license. Otherwise, the chassis will be
disabled following the upgrade.
Hub Timing Group licenses are required for 4-slot chassis, 20-slot chassis and daisy-chained
chassis. These licenses are controlled by a service in the NMS called the Chassis Manager
(cmsvr).

Note: Hub Timing Group licenses are not required for private hubs or mini-hubs.
Anyone who is installing or upgrading to a new iDX release is required to complete the
applicable Upgrade/Installation Survey (available at http://tac.idirect.net) and to provide
specific information about each chassis in order to generate the licenses.

2.1 Using Chassis Manager in Multi-NMS Configurations

Now that you understand that you are required to have a Chassis license, let’s further explain
the unique situation when you are using the Chassis Manager in a multi-NMS Configuration
(running independent NMS servers in one network).
Here are some considerations that you must review before you acquire and apply a Chassis
license to your network:
• In a shared Chassis environment (when multiple NMS servers share the same Chassis), the
NMS that controls the Chassis must be upgraded to the new release before any of the
other NMS servers are upgraded.
• For HNO/VNO configurations, this means the HNO NMS must be upgraded before any
of the VNO NMS systems.

iDX 3.0 iDirect Features and Chassis Licensing Guide 5

How Do I Get a Hub Timing Group License?

• In a non-VNO environment, if the current chassis controller NMS is not the one to be
upgraded first, control of the chassis may be transferred to the first NMS Server.
• When multiple NMS servers are running this release and the Chassis is shared, all NMS
systems must have IP connectivity to the server that is running Chassis Manager.
• Each Hub line card must be assigned a Chassis slot. The Chassis Manager is the tool that is
used to assign slots on a Chassis. The Chassis Manager requires IP connectivity to
successfully perform this task.
• You may use ACLs, firewalls, or other security measures to allow shared access to the
Chassis Manager from multiple NMS servers, while at the same time preventing these NMS
servers from accessing each other.

Note: These conditions apply in all implementations for iDX Release 2.0 and later,
not just those with “Pay-As-You-Grow” 5-IF chassis and/or VNOs.
• To communicate with the Chassis Manager, use TCP port 15261 for inter-process
communication and port 15262 for console sessions.

Note: For more information about using the Chassis Manager in multi-NMS
configurations, refer to the iBuilder User’s Guide section titled “Sharing a 20-
Slot Chassis in a Multi-NMS System.”

Note: For information about changing the chassis IP address, refer to the iBuilder
User’s Guide section titled “Changing a Chassis IP Address.”

2.2 How Do I Get a Hub Timing Group License?

In order to successfully acquire a Hub Timing Group license, you must complete the following
procedures in the order shown:
• Step 1. Request a Hub Timing Group License
• Step 2. Enable Download Permissions on Chassis Manager
• Step 3. Import the Hub Timing Group License File
• Step 4. Validate the Chassis Serial Number
• Step 5. Assign Hub Line Cards to Slots

STEP 1. REQUEST A HUB TIMING GROUP LICENSE

1. Go to the TAC website (http://tac.idirect.net), download and fill out the
Upgrade/Installation Survey for your release.
2. To receive the correct Hub Timing Group license (also referred to as a “chassis license”),
you must supply the following information (along with all other requested information) on
the Upgrade/Installation Survey:
• Type of hub chassis (20-slot or 4-slot)
• Hub chassis IP address
• NMS Eth0 MAC addresses for both the primary and backup NMS
• Whether the hub chassis is daisy-chained
• If all timing groups on the 5IF hub are not active, indicate which slots are active
• Chassis model type and serial number (located on back of chassis)

6 iDX 3.0 iDirect Features and Chassis Licensing Guide

 How Do I Get a Hub Timing Group License?

When you submit your request, keep in mind that the Chassis license must be requested at
least 24 hours prior to when you need to use the license for an installation or upgrade, and
the projected installation or upgrade date must be included in the request. Once you supply
this information to iDirect and it is verified, you will receive your Hub Timing Group license
key file. The file is provided in tar.gz format. Once you receive the license file, you are ready
to continue to Step 2. Enable Download Permissions on Chassis Manager

Note: If you are purchasing a timing group upgrade for an existing chassis, you must
provide the serial number and model type at the time of ordering.

STEP 2. ENABLE DOWNLOAD PERMISSIONS ON CHASSIS MANAGER

Before you can import the chassis license file into iBuilder, you must enable download
permissions to the Chassis Manager server process (cmsvr).
To enable download permissions on the Chassis Manager:
Make sure you have completed Step 1. Request a Hub Timing Group License before you
begin this step!
1. Open a terminal window on your PC and ssh to the NMS server.
2. Confirm that cmsvr is running on this server by entering the following command:
service idirect_nms status cmsvr
If the cmsvr process is running on this NMS server, you will see output similar to the
following example:
cmsvr (pid 1239) is running...
3. Telnet to the Chassis Manager by entering the following command:
telnet <ip address> 15262
Where: <ip address> is the IP address of the server running the NMS Chassis Manager
process.
4. At the Username prompt, logon to the Chassis Manager account as admin.
5. Enter the default password: iDirect
6. Optionally, iDirect recommends that you change the default password after initial login.
Use the passwd command at the cmsvr’s command line prompt.
7. Enable the download permissions by entering the following command:
download on
8. Keep the telnet session open for use in the next step.
Chassis license downloading permission is now enabled.
Now that the downloading permissions is enabled on the Chassis Manager NMS server, you are
ready to perform Step 3. Import the Hub Timing Group License File using iBuilder to import
the license file.

iDX 3.0 iDirect Features and Chassis Licensing Guide 7

How Do I Get a Hub Timing Group License?

STEP 3. IMPORT THE HUB TIMING GROUP LICENSE FILE

Once you have acquired the license and have enabled the download permissions, you are
ready to import the license file.
To import the hub timing group license file:

Note: Make sure you have completed Step 2. Enable Download Permissions on Chassis
Manager before you begin this step!
1. Select License Toolbar from the iBuilder View Menu (Figure 1) to view the License
Toolbar.

Figure 1. License Toolbar Selected

The License Toolbar consists of two buttons (Figure 2).

• The Import button — Used to import license files provided by iDirect.
• The Export button — Used to export a license request file to send to iDirect.

Figure 2. Import/Export Button Icons

2. Click the Import button on the iBuilder License Toolbar to open the Please Select License
Type dialog box (Figure 3).

Figure 3. Please Select License Type Dialog Box

3. Select Chassis License and click OK to open the Choose license files dialog box (Figure
4).

8 iDX 3.0 iDirect Features and Chassis Licensing Guide

 How Do I Get a Hub Timing Group License?

4. Navigate to the folder where you stored the tar.gz license file you received from iDirect
and select the tar file (Figure 4).

Figure 4. Choose License File

5. Click Open to import the license file. The message, “Licenses are downloaded
successfully” displays.
6. Click OK.
7. Update the Chassis Manager by entering the following command using the telnet session
you have open with the cmsvr:
update
8. Disable the download permissions by entering the following command:
download off
You have successfully imported the Hub Timing Group license, and are ready to continue to
Step 4. Validate the Chassis Serial Number.

STEP 4. VALIDATE THE CHASSIS SERIAL NUMBER

You are now ready to validate the Chassis serial number contained in the license file.
To validate the chassis serial number:

Note: Make sure you have completed Step 3. Import the Hub Timing Group License File
before you begin this step!
1. In iBuilder, right-click the Chassis in the Network Tree, and select ModifyItem.
2. In the Chassis dialog box (Figure 5), type the six-digit Serial Number of the Chassis and
click Validate SN (Figure 5).

iDX 3.0 iDirect Features and Chassis Licensing Guide 9

How Do I Get a Hub Timing Group License?

Figure 5. Validate the Chassis Serial Number

If the Serial Number you enter for your chassis matches the serial number in the license,
you will see a message indicating that the chassis license has been successfully validated.
3. Click OK.
You have successfully entered and validated the chassis serial number. You are now ready to
continue to Step 5. Assign Hub Line Cards to Slots.

10 iDX 3.0 iDirect Features and Chassis Licensing Guide

 How Do I Get a Hub Timing Group License?

STEP 5. ASSIGN HUB LINE CARDS TO SLOTS

In order for a line card to become operational, it must be assigned to a chassis slot.
Make sure you have completed Step 4. Validate the Chassis Serial Number before you
begin this step!
1. In iBuilder, right-click the Chassis in the Network Tree, and select ModifyItem.
2. In the Chassis dialog box (Figure 6), select the State check box for the line card’s slot to
enable the slot.
3. Right-click the line card’s slot in the Hub Assignment column and select the hub line card
from drop-down list.
4. Repeat Step 2 and Step 3 for each hub line card.
5. When done, click OK.

Figure 6. Chassis Dialog Box: Assigning Hub Line Cards to Slots

6. In the iBuilder Network, right-click the chassis you just updated and apply the
configuration. (If necessary, see the iBuilder User Guide for details.)
Your chassis is now successfully licensed and updated.
For information about changing the chassis IP address, refer to the iBuilder User’s Guide
section titled “Changing a Chassis IP Address.”

iDX 3.0 iDirect Features and Chassis Licensing Guide 11

How Do I Get a Hub Timing Group License?

12 iDX 3.0 iDirect Features and Chassis Licensing Guide

3 Feature Licensing

Software features such as Link Encryption, TRANSEC, and Spread Spectrum are available for
licensing on specific remotes and hub line cards. In this way, you pay for licensed features
only on the equipment on which the features are actually used, which provides a simple,
scalable upgrade path to new features.

Note: Both the Link Encryption and TRANSEC features also require a license to be
installed on the Protocol Processor blade. See Chapter 4, Protocol Processor
Blade Feature Licensing for instructions.
This method is implemented through iBuilder, which helps you to avoid costly site visits.

3.1 What Feature Licenses Are Available?

Feature licenses are required to enable certain features in your iDirect network. Table 1
shows the feature licenses available in this release.
Table 1. Feature Licenses

Feature Remote Hub Line Card Server

Link Encryption Evolution X3 N/A All PP Blades**
Evolution X5
Evolution eP100
DVB-S2 TRANSEC N/A eM1D1 All PP Blades**
Spread Spectrum Evolution X5 (Upstream only) XLC-11* (Upstream N/A
Evolution eP100 (Upstream only) and Downstream)
TDMA Multichannel Support N/A Evolution XLC-M N/A
(4 or 8 channels) Evolution eM0DM
SCPC Return Multichannel N/A Evolution XLC-M N/A
(8 channels) Evolution eM0DM
SCPC Return Evolution X3 N/A N/A
Evolution X5
High-Speed COTM Evolution e8350 N/A N/A
(Up to 700 mph) iConnex e800/e850mp
Evolution eP100
* Separate licensing Purchase Order is not required for Spread Spectrum license on the XLC-11.
** The same PP blade license enables both Link Encryption and TRANSEC.

iDX 3.0 iDirect Features and Chassis Licensing Guide 13

How Do I Acquire a Feature License?

3.2 How Do I Acquire a Feature License?

In order to successfully acquire and apply your hardware-specific feature licenses, you must
complete the following procedures in the order shown:
• Step 1. Fill Out a Purchase Order
• Step 2. Create a License Request File and Request a License

Note: If you are unable to access iDX Release 2.0 or later, you will need to create the
license request file manually. See Option B. Creating a License Request File
Manually on page 18.
• Step 3. Import the License File Into Your iDirect Network
• Step 4. Activate the Licensed Feature

STEP 1. FILL OUT A PURCHASE ORDER

Contact your iDirect salesperson and fill out a Purchase Order to send to iDirect. In the
Purchase Order, please specify the feature you are requesting. Once your Purchase Order is
processed through iDirect, you will be contacted and asked for a license request file. You can
create this file using iBuilder iDX Release 2.0 or later, or you can create it manually.

STEP 2. CREATE A LICENSE REQUEST FILE AND REQUEST A LICENSE

There are two options available to you for creating a license request file. Procedures for these
options are included in this section.
These options are:
• Option A: Creating a License Request File in iBuilder, which explains how to create a
feature license request file for your specific hardware by exporting the license data from
iBuilder.
• Option B. Creating a License Request File Manually, which explains how to manually
create a feature license request file.

Option A: Creating a License Request File in iBuilder

To obtain your feature licenses, create a license request file and send your license request to
iDirect. This section explains how to create a feature license request file for your existing
hardware by exporting the license data from iBuilder.
The following information is required by iDirect for creating a license file, and can be
exported using iBuilder:
• Hardware Model Type
• Serial Number
• Derived ID (DID)

14 iDX 3.0 iDirect Features and Chassis Licensing Guide

 How Do I Acquire a Feature License?

To export data for licensing from iBuilder:

1. Select License Toolbar from the iBuilder View Menu (Figure 7) to view the License
Toolbar.

Figure 7. License Toolbar Selected

The License Toolbar consists of two buttons (Figure 8):

• The Import Button: Used to import license files provided by iDirect.
• The Export Button: Used to export a license request file to send to iDirect.

Figure 8. Import/Export Button Icons

2. Select the parent element in the iBuilder Network Tree that contains all of the hardware
units you want to license.

Figure 9. iBuilder Tree: Parent Element Selected

3. Click the Export button (Figure 8).

iDX 3.0 iDirect Features and Chassis Licensing Guide 15

How Do I Acquire a Feature License?

The Data for Licensing dialog box (Figure 10) displays.

Figure 10. Data for Licensing Dialog Box

4. Select all units for which you want to request licenses by clicking in the check boxes next
to your selections (Figure 11).

Figure 11. Select Units for Licensing

16 iDX 3.0 iDirect Features and Chassis Licensing Guide

 How Do I Acquire a Feature License?

5. Click the Save to File button to open the Save As dialog box (Figure 12).
6. In the Save As dialog box, navigate to the folder on your PC where you want to save the
.csv file and name the file.

Figure 12. Save As Dialog Box

7. Click Save.
Your license request file contains the DID, Serial Number, and Model Type for each unit on
which you want to license a feature. Figure 13 shows a license request file opened in Excel.

Figure 13. Sample License Request File Exported from iBuilder

iDX 3.0 iDirect Features and Chassis Licensing Guide 17

How Do I Acquire a Feature License?

8. Email the .csv file to your licensing contact person at iDirect along with the specific
licences being requested for each remote or line card.

Option B. Creating a License Request File Manually

This section explains how to manually create a feature license request file. This option is
useful if you do not have access to the iBuilder 2.0 or later client software.
1. For each piece of hardware on which you want to license a feature, determine the model
type, serial number and derived ID.
2. Create a .csv file and save the component information you gathered into the file (see
Figure 13 for a sample .csv file) to send to iDirect.
3. Send the .csv file to your iDirect licensing contact person along with the specific licences
being requested for each remote or line card.

STEP 3. IMPORT THE LICENSE FILE INTO YOUR IDIRECT NETWORK

Once your license request is received, iDirect will open a support ticket and an iDirect
iLicense representative will contact you. iDirect will then issue your licenses and email your
license key file(s) to you. You will receive one tar.gz file per model type, regardless of the
quantity of that model type you have. This file contains all license keys for the features you
have purchased.
After you receive a license key file from iDirect, you need to import the file into your iDirect
network. Save the file to a local folder on your PC or laptop.
To import your licenses into iBuilder:
1. Select License Toolbar from the iBuilder View Menu to view the License Toolbar. (Figure
14).

Figure 14. License Toolbar Selected

The License Toolbar consists of two buttons (Figure 15).

• The Import button — Used to import license files provided by iDirect.
• The Export button — Used to export a license request file to send to iDirect.

Figure 15. Import/Export Button Icons

18 iDX 3.0 iDirect Features and Chassis Licensing Guide

 How Do I Acquire a Feature License?

2. Click the Import button on the iBuilder License Toolbar to open the Please Select License
Type dialog box (Figure 16).

Figure 16. Please Select License Type Dialog Box

3. Select Feature License and click OK to open the Choose license files dialog box (Figure
17).
4. Navigate to the folder where you stored the tar.gz license file you received from iDirect
and select the file name (Figure 17).

Figure 17. Choose License File

iDX 3.0 iDirect Features and Chassis Licensing Guide 19

How Do I Acquire a Feature License?

5. Click Open to import the license file. The message, “Licenses are downloaded
successfully” displays.

6. Click OK.
7. You will see changes pending in the iBuilder tree for the remotes and/or line card for
which you imported licenses. Right-click the remotes and/or line cards with changes
pending and apply the changes.
You have successfully imported your licences and are ready to continue to Step 4. Activate
the Licensed Feature.

STEP 4. ACTIVATE THE LICENSED FEATURE

Now that you have imported the license, you can configure your remotes and line cards in
iBuilder to use the licensed feature. For example:
• If you licensed multiple TDMA channels on an XLC-M line card, you can now configure the
line card in Multiple Channel TDMA Receive Mode and you can add multiple receive
carriers to the line card.
• If you licensed link encryption for a remote, you can now enable link encryption on the
Remote Information tab.
• If you licensed and XLC-11 line card for downstream Spread Spectrum, you can now select
an iNFINITI outbound carrier configured for Spread Spectrum as the transmit carrier for
that line card.
Explaining the details of the configuration of each licensed feature is outside the scope of the
Licensing Guide. For instructions on how to configure the various features of your iDirect
network, including licensed features, see the iBuilder User Guide.
Enforcement of the high-speed COTM feature differs from the enforcement of other licensed
features. A high-speed COTM license is enforced during operation rather than by
configuration. If an unlicensed mobile remote exceeds 150 mph, the remote issues the event
“COTM License Violated” and all user traffic to the remote is stopped. User traffic is resumed
only when the unlicensed remote’s speed falls below the 150 mph limit.

20 iDX 3.0 iDirect Features and Chassis Licensing Guide

4 Protocol Processor Blade
Feature Licensing

As introduced in iDX Release 2.1, a Protocol Processor blade encryption license is required to
enable Link Encryption and TRANSEC on any PP blade that communicates with the licensed
remotes.

Note: See the iBuilder User Guide for details on configuring Link Encryption for your
remotes and/or TRANSEC for yours DVB-S2 networks.

STEP 1. REQUEST A PP BLADE ENCRYPTION LICENSE

Go to the TAC website (http://tac.idirect.net), download and fill out the
Upgrade/Installation Survey for your release. To receive the correct PP blade license, you
must supply the Eth0 MAC address of each PP blade requiring a license by completing and
submitting the Upgrade/Installation Survey.

STEP 2. INSTALL A PP BLADE LICENSE

After you receive your compressed PP blade license file from the iDirect TAC and have
upgraded to the new release, you are ready to install your link encryption license on your PP
blades.
On each PP blade on which you want to install a license:
1. Use WinSCP and log on to the PP blade as idirect.
2. Copy the compressed license file you received from iDirect to the /tmp folder.
3. Using a terminal emulator (such as puTTY) create an SSH connection to the PP blade and
log on as idirect.
4. Switch to root user by entering the following command:
su -
5. Enter the root password at the prompt.
6. Change to the /tmp directory by entering the following commands
cd /tmp

iDX 3.0 iDirect Features and Chassis Licensing Guide 21

 7. Copy the compressed PP license file to the /etc/idirect/pp directory by entering the
following command:
cp <filename> /etc/idirect/pp
Where: <filename> is the name of the compressed license file in the format
YYYY_MM_DD_PP_LINK_ENCRYPTION.tar.gz.
8. Change directory to /etc/idirect/pp by entering the following command:
cd /etc/idirect/pp
9. List the files in the directory by entering the following command:
ll
You should see your license .gz file in the directory listing. For example:
-rw-r--r-- 1 root root 976 May 12 22:41
2010_05_28_PP_LINK_ENCRYPTION.tar.gz
10. Uncompress the license file by entering the following command:
tar zxvf <filename>
Where: <filename> is the name of the compressed license file. This will result in an
uncompressed license file with a name similar to the file name in the following example:
00:10:18:1C:BE:41_license.lic
11. Copy the uncompressed license file and rename it as license.lic. Using the example file
name above, you would enter the following command:
cp 00:10:18:1C:BE:41_license.lic license.lic
12. List the files in the directory and verify that license.lic is present:
ll
13. Restart the PP blade services by entering the following command:
service idirect_hpb restart
Encryption is now enabled on the PP blade.

STEP 3. ENABLE THE LINK ENCRYPTION FEATURE ON THE NMS

SERVER
1. Using a terminal emulator (such as puTTY) create an SSH connection to the NMS Server
and log on as idirect.
2. Switch to root user by entering the following command:
su -
3. Enter the root password at the prompt.
4. Connect to the NMS configuration database with mysql by entering the following
command:
mysql nms;
5. At the mysql prompt, enter the following command:
select * from ServerConfiguration;

22 iDX 3.0 iDirect Features and Chassis Licensing Guide

 6. To determine if encryption is allowed, scroll down until you find the row
encryption_allowed in the ServerConfiguration table. For example:
| ENCRYPTION | encryption_allowed | 0
In the above example, the last column contains a zero (0) indicating that encryption is
not allowed, so you must continue with Step 7. If the last column contains a one (1)
encryption is allowed, and you can exit mysql (Step 9) and discontinue this procedure.
7. Change the encryption_allowed value from 0 to 1 by entering the following command:
update ServerConfiguration set Value="1" where
Field="encryption_allowed";
You should see the following output:
Query OK, 1 row affected (0.00 sec)
Rows matched: 1 Changed: 1 Warnings: 0
8. Confirm that this change was successful by entering the following command:
select * from ServerConfiguration;
You should see the following output, confirming that you have successfully changed the
value to 1.
| ENCRYPTION | encryption_allowed | 1
9. Exit mysql be entering the following command:
exit
10. Restart the nmssvr service by entering the following command:
service idirect_nms restart nmssvr
The following output displays.
Stopping nmssvr:[ OK ]
Testing database integrity.
Start update for QoS rules.
Starting nmssvr:[ OK ]
Encryption is now enabled on the NMS server.

iDX 3.0 iDirect Features and Chassis Licensing Guide 23