*HWWLQJ6WDUWHGZLWKIx1HWZRUN

Release 7.00 EA
Part No. 913-1625 Rev A
December 2012
[This page intentionally left blank]
Copyright and Disclaimer
Copyright © 2012 Ixia. All rights reserved.
This publication may not be copied, in whole or in part, without Ixia's consent.
RESTRICTED RIGHTS LEGEND: Use, duplication, or disclosure by the U.S. Government is subject to the restrictions set forth in
subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 and FAR 52.227-19.
Ixia, the Ixia logo, and all Ixia brand names and product names in this document are either trademarks or registered trademarks of
Ixia in the United States and/or other countries. All other trademarks belong to their respective owners.
The information herein is furnished for informational use only, is subject to change by Ixia without notice, and should not be
construed as a commitment by Ixia. Ixia assumes no responsibility or liability for any errors or inaccuracies contained in this
publication.

Ixia Worldwide
Headquarters
Web site: www.ixiacom.com
26601 W. Agoura Rd.
General: [email protected]
Calabasas, CA 91302
Investor Relations: [email protected]
Corporate USA
Training: [email protected]
Headquarter- +1 877 FOR IXIA (877
s 367 4942) Support: [email protected]

+1 818 871 1800 +1 818 595 2599

(International) For the online support form, go to:
(FAX) +1 818 871 1805 http://www.ixiacom.com/support/inquiry/
[email protected]
Ixia Europe Limited
One Globeside,
Fieldhouse Lane
Support: [email protected]
Marlow, SL7 1HZ
+44 1628 405797
EMEA United Kingdom
For the online support form, go to:
+44 1628 405750 http://www.ixiacom.com/support/inquiry/?location=em-
ea
FAX +44 1628 405790
[email protected]
m
Ixia Pte Ltd Support: [email protected]
210 Middle Road +65 6332125
Asia Pacific
#08-01 IOI Plaza For the online support form, go to:
Singapore 188994 http://www.ixiacom.com/support/inquiry/
Ixia Communications
KK
Support: [email protected]
Aioi Sampo Shinjuku
Building, 16th Floor +81 3 5365 4690
Japan
3-25-3 Yoyogi Shibuya- For the online support form, go to:
Ku http://www.ixiacom.com/support/inquiry/

Tokyo, Japan 151-0053

Ixia Technologies Pvt Support: [email protected]
Ltd +91 80 49396400
India
Tower 1, 7th Floor, For the online support form, go to:
UMIYA Business Bay http://www.ixiacom.com/support/inquiry/?location=ind-
 Cessna Business Park
Survey No. 10/1A,
10/2, 11 & 13/2
Outer Ring Road,
Varthur Hobli
Kadubeesanahalli ia
Village
Bangalore East Taluk
Bangalore-560 037,
Karnataka, India
+91 80 42862600

For viewing the FAQs related to the product, go to Ixia Technical Support Online: https://ebsoprod.ixiacom.com/OA_
HTML/jtflogin.jsp

Product Release Number Part Number Release Date

Part Number: 913-1625
IxNetwork Release 7.00 EA December 2012
RevA
 Getting Started with IxNetwork

Contents

Copyright and Disclaimer 3

Contents 5
Introduction to IxNetwork 7
Benefits of IxNetwork 7
GUI Framework 8
Enhanced Port Management 8
Enhanced Protocol Configuration 9
Traffic Wizard 10
Test Composer 12
Enhanced Statistics Reporting 13
Log View Window 13
Application Traffic 13
Quick Tests 14
Flow Tracking 15
Capture Settings 16
Analyzer 17
Data Miner 18
Installation and Licensing 19
General Licensing Steps 19
Chassis Installation 19
IxNetwork International Language Support 20
IxNetwork Installation 20
IxNetwork TCP Ports 27
Python Client Installation 27
IxNetwork and Test Conductor – Installation 27
Configuring IxNetwork for Silent Installation 28
Preparing an Ixia Chassis for Silent Installation 28
IxNetwork Silent Install using .exe Package 29
Features 30
Properties 30
IxNetwork setup.exe Package Examples 31
Uninstall/Modify a Current Installation 31
Silent Repair/Modify 31
IxNetwork Linux/Solaris Installation 32
Location of Linux and Solaris Installers 32
Installation/Uninstallation Commands 32
Location of Log Files 32
Installation Sequence 33
AES Scriptgen Setup 36
Running a Test with IxNetwork 37
Requirements 37
A Simple IxNetwork Test 37

-5-
 Getting Started with IxNetwork

Connect the Ports 38

Start IxNetwork 38
Select the Ports 39
Configure the Protocol 40
Review the Protocol Configuration 45
Ping the DUT 46
Start the BGP Protocol 47
Configure Traffic 48
Set Up the Test Composer 56
Set Up the Test Composer 56
Creating a Test Composer Script 58
Creating a Sample Test Composer Script 58
Test Overview 58
Creating the Composer Test 59
Set Up CSV Logging 60
Set Up a Quick Test 61
IxNetwork Licensing 63
IxNetwork-Specific License Information 63
IxNetwork License Management 65
Date-based versus Version-based Licensing 66
Temporary Licenses 66
Evaluation Licenses 66
Tcl Notes for Use with Licensing 66
Prerequisites 67
Installation Scenarios 69
Licensing to a Chassis or Workstation via the Internet 69
Licensing to a Chassis or Workstation Without the Internet 70
License Installation Examples 70
Regular License Installation 70
Temporary License Installation 74
Troubleshooting 77
Disk ID Reset Utility 77
Index 79

-6-
 Getting Started with IxNetwork : Introduction to IxNetwork

Introduction to IxNetwork
IxNetworkª of Ixia is specifically targeted for the performance and functionality testing of high-speed, high-capacity routers
and switches. IxNetwork operates only on port-CPU-based test modules of Ixia. With these modules, each test port
supports an independent PowerPC running Windows and protocol state machines.
IxNetwork provides a powerful, yet easy-to-use, graphical user interface (GUI) that you can use to configure and run
complex tests. With IxNetwork you can quickly and easily configure protocol variables and parameters to suit a particular
device under test (DUT). Combined with Ixia family of Chassis and port-CPU-based Load Modules, you can use
IxNetwork to create a test environment tailored to your specific requirements.
IxNetwork offers the flexibility to customize the application to meet a wide range of requirements for testing complex
network topologies, consisting of thousands of routing or switching devices. You can emulate millions of routes and
reachable hosts within the topology. You can also, easily scale the size of the emulated topologies by adding additional
test ports.
IxNetwork also provides with the ability to customize millions of traffic flows to stress the data plane performance. You
can create sophisticated configurations using powerful wizards and grid controls in the graphical user interface. With its
enhanced real-time analysis and statistics, IxNetwork is capable of reporting comprehensive protocol status and detailed
per-flow traffic performance metrics.

Benefits of IxNetwork
IxNetwork 6.30 SP1 is designed to replace, and improve upon, IxNetwork 6.30. IxNetwork 6.30 SP1 adds enhanced
protocol capability and testing features.
The following sections describe the features of IxNetwork:

• GUI Framework
• Enhanced Port Management
• Traffic Wizard
• Test Composer
• Enhanced Statistics Reporting
• Log View Window
• Application Traffic
• Quick Tests
• Flow Tracking
• Capture Settings
• Analyzer
• Data Miner

- 7 of 80-
Getting Started with IxNetwork : GUI Framework

GUI Framework
IxNetwork provides a GUI framework, with a main IxNetwork window that displays sub-windows for Port Configuration,
Protocol Configuration, Creation of QuickTests and Traffic Configuration (for L2-L3 Traffic or Application Traffic).
Additional panels display Statistics and Captures. You can toggle the Configuration and Statistics information display on
and off. With this design, you can simultaneously view protocol configurations, statistics for traffic and protocols, and
statistics information. An example of the GUI framework is shown in the following figure.

Figure 4-1. IxNetwork GUI Framework Example

Enhanced Port Management

IxNetwork Port Management feature allows you to assign physical ports for immediate configuration. As an alternative,
you can create a port configuration ÒimageÓ for a port type, such as Ethernet, without tying up an actual physical port.
You can configure protocols for this Òtest portÓ and save the resulting configuration for later use on a physical port. An
example of the Port Management window Port Selection dialog box is shown in the folloiwng figure.

- 8 of 80-
 Getting Started with IxNetwork : Enhanced Protocol Configuration

Figure 4-2. IxNetwork Port Selection Example

Enhanced Protocol Configuration

IxNetwork supports emulation of Internet-scale routing topologies to determine the scalability limits, and is designed to
emulate a wide variety of bridging and routing protocols. Easy-to-use Protocol Wizards allow you to quickly and precisely
set up complex topologies, in a step-by-step process for initial setup of small to large-scale test topologies across multiple
Ixia ports. The wizards simplify the setup of complex network scenarios across multiple protocols simultaneously. In
addition, IxNetwork spreadsheet GUI paradigm provides the entry, editing, and viewing of large configurations across
multiple test ports. Once you create a network topology, you can copy it easily across any supported Ixia test port. An
example of an IxNetwork configuration wizard is shown in Figure 1-3.
BFD, L2TP, and PPPoX protocol support are present in IxNetwork. Authentication support for DHCP, Static IP, and
MAC addresses are also present. Protocol wizard is enhanced with the addition of BGP VPLS (Kompella Draft) to the L2
VPN wizard. Support for use of RSVP-TE and ISIS together in wizards is added.
You can integrate previously configured protocol interfaces into Interface Groups and use in setting up traffic
configurations, with filtering based on IP version, presence of VLANs, or the type of ATM encapsulation (in case of ATM
ports). Support to protocol interfaces for Stacked VLANs (QinQ) is also present.
Traffic Groups option is present, which you can automatically configure and display in the Traffic Group window while
configuring L2 and L3 VPNs, and Multicast VPNs (MVPNs) using the protocol wizards. You can also manually configure
Traffic Groups in the Traffic Group window. The use of Traffic Groups simplifies the setup of traffic for complex
topologies such as L2 and L3 VPNs, and MVPNs.

- 9 of 80-
Getting Started with IxNetwork : Traffic Wizard

Figure 4-3. IxNetwork Protocol Configuration Wizard Example

Traffic Wizard
The Basic Traffic Wizard and Advanced Traffic Wizard allow you to create millions of traffic flows for validating
emulated networks and hosts. The wizards provide great flexibility to set up wire-rate traffic streams to validate every
reachable network and host.
With the help of the Basic Traffic Wizard you can configure traffic with endpoints that have the same encapsulation type.
You can configure bi-directional traffic movement easily and quickly with the help of the newly introduced checkbox.
Multi-field tracking also can be enabled easily with the Basic Traffic Wizard. An example of the IxNetwork Basic Traffic
Wizard is shown in Figure 1-4.

- 10 of 80-
 Getting Started with IxNetwork : Traffic Wizard

Figure 4-4. IxNetwork Basic Traffic Wizard Example

The Advanced Traffic Wizard allows to configure flexible traffic set-ups. It has the ability to support mixed encapsulation
types and allows bi-directional traffic movement. The Advanced Wizard allows to edit and increment field values for
optimized QoS testing with the help of the Packet Editor.
Flow Groups feature provides the ability to create traffic groups based on selected criteria such as rate, frame size, and
transmit properties. Unique traffic profiles can be created with the help of this function.
An example of the IxNetwork Advanced Traffic Wizard is shown in the following figure.

Figure 4-5. IxNetwork Advanced Traffic Wizard Example

- 11 of 80-
Getting Started with IxNetwork : Test Composer

The final step of the traffic wizard is to set up the receive ports to track the traffic flows with detailed QoS measurements
of packet loss, throughput, and latency. You can track the traffic flow based on MAC addresses, IP addresses, TOS/DSCP,
MPLS labels, or custom fields. The traffic wizard also provides optional capability for custom-editing the actual packet
headers in the new version of the Packet Editor window, such as inserting additional layers of protocol headers. Much of
the packet customization capability provided by IxExplorer of Ixia is included in the traffic wizard. An example of the
Advanced Traffic Wizard -Packet QoS Editor is shown in Figure 1-6.

Figure 4-6. IxNetwork Traffic Wizard Packet QoS Example

Test Composer
Test Composer is an Ixia software component, integrated into IxNetwork that permits the creation of complex multi-step
test scripts integrating events, DUT configuration commands, local or external procedure calls, and flow control
instructions that permit branching the script flow based on a step result evaluation.
Test scripts created using the Test Composer plug-in support multiple simultaneous connections to test devices that can
be configured using a variety of protocol interfaces: Telnet, TL1, SSH1/SSH2/SSHAuto, CmdTool, TclSh, Raw, SNMP,
Syslog, and COM.
In addition to these protocol interfaces, Test Composer scripts also support a default session of the IxNetwork type. For
this default IxNetwork session that is automatically created for every Test Composer script, a number of pre-configured
events are available for configuring Ixia chassis ports, applying test configuration files, starting protocol traffic, launching
tests, and retrieving test run results.
The TestComposer Online Help provides detailed information on the Test Composer window features. Press F1 to access
the online help in the Test Composer window.

- 12 of 80-
 Getting Started with IxNetwork : Enhanced Statistics Reporting

Enhanced Statistics Reporting

Statistics reporting for protocols has been greatly expanded, to provide far more detailed information about the protocol
setup process. Available statistics views include port statistics, global protocol statistics, traffic statistics, quicktests, and
individual statistic views for each of the protocols that you configure. You can tile up to four statistic windows for
simultaneous viewing. An example of the IxNetwork Statistics window, is shown in Figure 1-7.

Figure 4-7. IxNetwork Statistics Window Example

Log View Window

A global LogView window provides real-time information about the status of Port Management, Interfaces, Traffic, Test
Composer, and Statistics. You can save the information in this window for later evaluation. In addition, the Port Trace
window found in IxNetwork is still available at the port level for every protocol listed in the Protocol Window. An example
of the IxNetwork LogView window, showing the progress of Port Manager, is shown in Figure 1-8.

Figure 4-8. IxNetwork LogView Window Example

Application Traffic
The IxNetwork Traffic Wizard allows the user to create traffic flows for Layer 4 through Layer 7 Application traffic, for
transmission over protocol routes, by providing a subset of the IxLoad capabilities within IxNetwork. This subset of the
IxLoad features is called IxLoadLite. Refer to the IxLoad User Guide for additional information on the use of the
IxLoadLite features.
When used for Application Traffic, the traffic wizard provides a step-by-step procedure to set up traffic between IPv4
Application endpoints, running over routes that have been set up via one of the routing protocols, such as BGP. Users can
select which source and destination items will send and receive traffic, how they will be mapped to each item (one-to-one
or fully-meshed), and how the flows will be generated between advertised routes (one-to-one or fully-meshed). The traffic

- 13 of 80-
Getting Started with IxNetwork : Quick Tests

wizard will then automatically create fully-meshed or one-to-one application flows between all participating endpoints.
After the traffic endpoint type and source/destination pair has been set up, an Application Traffic Profile can be selected to
emulate the Layer 4-7 scenario. An example of the traffic window for Application Traffic is shown in Figure 1-9.

Figure 4-9. Application Traffic Window

Quick Tests
The Quick Tests feature allows you to use pre-defined tests.You can add, access, run, and customize these tests according
to your requirements. Step-by-step wizards allow you to set up the Quick Tests. You can view the results of current tests,
and previously run tests, and compared them in the Results window. An example of the Quick Tests window is shown in
the following figure.

Figure 4-10. Integrated Test Window

- 14 of 80-
 Getting Started with IxNetwork : Flow Tracking

Flow Tracking
The Flow Tracking feature in the Traffic wizard allows an Ixia interface to track flows based on one or more fields. This
feature enables a Traffic window to be opened from Statistics; this view shows L2-L3 statistics for a single flow. The flow
tracking settings apply to all traffic items transmitted to a particular port. Ingress tracking by source/destination endpoint
pair, egress tracking by VLAN, and latency tracking is shown in the following figure.

Figure 4-11. Ingress and Egress Tracking and Latency Measurements

- 15 of 80-
Getting Started with IxNetwork : Capture Settings

Capture Settings
You can access the Capture settings by selecting Captures on the Test Configuration pane. They control the various
capture options available for both control and data packets, and allows the creation of capture filters. You can set capture
options for each port, chassis, or for each packet type.The capture settings are shown in the following figure.

Figure 4-12. Captures Dialog Box

- 16 of 80-
 Getting Started with IxNetwork : Analyzer

Analyzer
Analyzer allows you to select a captured traffic stream and examine the contents of each packet in detail. You can access

this feature by clicking on the Packet Capture tab. You can save streams and export these streams to
IxNetworkÕs traffic controls and then re-send. The Analyzer view is shown in the following figure.

Figure 4-13. IxNetwork Analyzer

- 17 of 80-
Getting Started with IxNetwork : Data Miner

Data Miner
Data Miner allows you to inspect the results of an integrated test. You can access Data Miner by clicking on the
Results/Reports tab. Data Miner dialog box is shown in the following figure.

Figure 4-14. Data Miner

- 18 of 80-
 Getting Started with IxNetwork : Installation and Licensing

Installation and Licensing

The procedures explained in this chapter helps to install IxNetwork and the licenses necessary to run IxNetwork. For
more detailed information on licensing, refer to IxNework Licensing and the Ixia License Management User Guide.
The topics covered in this chapter are:

• General Licensing Steps

• IxNetwork International Language Support
• IxNetwork Installation
• Configuring IxNetwork for Silent Installstion
• IxNetwork Linux/Solaris Installation
• AES Scriptgen Setup

NOTE: The minimum resolution for viewing the IxNetwork GUI is 1024x768, with a DPI
setting of Normal Size (96 DPI).

General Licensing Steps

The following steps indicate the general sequence to use when installing and licensing IxNetwork. These steps assume
that you will be installing the license server on your Ixia chassis. If you will be using a dedicated/standalone PC as a
licensing server, see the Ixia License Management User Guide for detailed instructions. The Ixia license installation utility
is included in the IxNetwork CD build or download file.

CAUTION: To avoid licensing problems, be careful as you proceed through

the licensing utility program. Do not just automatically click Next to
proceed through the program, or licensing will not be successful and you
will not be able to use IxNetwork. You must read each installer screen and
provide the requested information. Although the installer steps you through
the license installation process, the overview information here is provided to
ensure that you do not overlook important installation details. For more
detailed information on each step, refer to the License Management User
Guide.

IMPORTANT: The IxNetwork installer must be run on both the Ixia chassis
and the client PC. When the installer is run on the chassis, it installs the
license server component and the statistics engine. However, it does not
install the client GUI software. When the installer is run on the client PC,
the client software is installed.

There is a separate IxNetwork chassis installer available that is significantly

faster than the full installer. Both version can be used to install IxNetwork
on the chassis.

Chassis Installation
To install an IxNetwork license onto an Ixia chassis:

1. Download IxNetwork to Ixia chassis from the Ixia Web site or the IxNetwork CD.
2. Launch the installer and answer the questions as required.

- 19 of 80-
Getting Started with IxNetwork : IxNetwork International Language Support

3. Once IxNetwork is installed on the chassis, licensing is installed as well.

4. If you already have a registration number and password, then launch the Ixia Registration Utility
(IRU) and register the software on the chassis. Make sure that the chassis is connected to the
Internet. If it is not, follow the offline registration steps in the License Management User Guide.
If you do not have a registration number and password, you do not need to launch the IRU at
this time. A temporary license will be issued to you when you first attempt to run a test from the
client PC. At run time, a message appears, asking if you would like a temporary license. Make sure
that the client PC is connected to the Internet. If it is not, follow the offline temporary license steps
on the License Management User Guide.
5. Select register, and then follow the prompts that appear.
6. Accept the default localhost as the location for the features to be used.
7. When prompted with, ÒDo you want the Ixia application to automatically find your license on the
chassis?Ó select Yes. If using a license server, follow the steps in the License Management User
Guide for registering on a license server.
8. Complete the license installation procedure by clicking Finish.

IxNetwork International Language Support

IxNetwork can be installed and run on the following language versions of each of the supported
Windows operating systems:
• US English
• Hebrew
• German
• Italian
• French
• Swedish
• Japanese
• Simplified Chinese
• Traditional Chinese
• Spanish

Note that the IxNetwork software and documentation are provided in English only.

IxNetwork Installation
IxNetwork protocol emulation software is available for download from Ixia Web site. Licensing is now used with
IxNetwork. Refer to General Licensing Steps , for an overview.

Important. You must have administration privileges to install IxNetwork, on both the chassis
and the client machine.

NOTE: There is a new version of IxNetwork, IxNetwork-FT, that is used in conjunction with
IxOS (it is designed to replace the older IxRouter product). Some of the screens detailed
below are not part of the IxNetwork-FT installation.

- 20 of 80-
 Getting Started with IxNetwork : IxNetwork Installation

Detailed information on obtaining and installing licenses for IxNetwork is described in IxNetwork Licensing in this guide,
and in the Ixia License Management User Guide.

NOTE:
IxOS 6.30 SP2 is supported with IxNetwork 6.30 SP1.
IxOS/IxServer and IxNetwork must be installed on the chassis prior to IxNetwork installation
on the Client PC.
There is a separate IxNetwork chassis installer available that is significantly faster than the full
installer. Both the versions can be used to install IxNetwork on the chassis. The chassis only
version provides a panel for feature selection to the users. Only the selected features are
installed.
The benefits of chassis only installer are as below:
• It consumes less disk space on a chassis for storing the IxiaInstallerCache files as
compared to the Full/main installer since we bundle only the chassis specific
components/dependencies along with it.
• Installation is faster on a chassis due to the time saved in extracting less number of files.

1. Close IxServer if it is running (and if it is installed on the chassis).

2. On a Windows PC, double-click the installation.exe file to start the installation. The installation
wizard appears as shown in the following figure.

3. Select the destination folder for installation and click Next.

4. The Welcome dialog box appears.

- 21 of 80-
Getting Started with IxNetwork : IxNetwork Installation

Note: To run HLTAPI scripts, you need to install an IxOS version that is compatible with the
IxNetwork version you are installing. You can install IxOS after IxNetwork installation. You need not
install IxOS if you work with HLTAPI scriptgen.
5. The Unpacking Files dialog box appears showing the extraction of package files to your computer.
6. The License Agreement dialog box appears next. Click I accept the terms in the license agreement
for accepting the license agreement.
7. The License Warning dialog box appears next. Select the I acknowledge this message check box
to proceed with the installation.

Note that if multiple versions of IxNetwork are installed on your computer, a Program Maintenance
dialog box appears as shown in the following figure.

NOTE: Before installing the program, you can cancel the installation by clicking Cancel. You
can then remove the existing version installed on your computer by clicking Remove.
To modify the program features installed on your computer, click Modify.
To repair installation errors like missing files or registry entries, click Repair.

8. Click Next to continue with the installation. The License Warning dialog box appears. BE SURE
to read the information in the License Warning window regarding license requirements.
9. Select the I acknowledge this message check box.
NOTE: If you do not select the check box, the Next button is not available and the installation
cannot continue.

- 22 of 80-
 Getting Started with IxNetwork : IxNetwork Installation

10. Click Next to continue the installation.The Setup Type dialog box appears, as shown in the
following figure.

11. Select from the following:

• Typical: Click this option to install the most typical features of IxNetwork.
• Custom: Click this option to select the features you want to install.
12. Click Custom. The Custom Setup for Bundle Features dialog box appears as shown in the
following figure.

- 23 of 80-
Getting Started with IxNetwork : IxNetwork Installation

13. Select the feature you want to install and then click Next. The Ready to Install the Program
dialog box appears as shown in the following figure.
NOTE: If you select Network-FT, you cannot proceed further if a compatible IxOS is missing
on the system. A message appears informing you that IxOS needs to be installed.
If you select Documentation, the IxNetwork documents and Help files will be installed along
with the program. These documents will be available under Advanced Information
Manager in the Program group.
If IxOS is not installed with IxVM Server, IxVM Server Chassis feature is not selected by
default. Even if you select it, you will not be able to proceed further and a message appears
informing you that IxOS needs to installed along with IxVM Server.

- 24 of 80-
 Getting Started with IxNetwork : IxNetwork Installation

14. Click Install to proceed with the installation of the program. The Installing IxNetwork <version
number> dialog box appears displaying the progress of the installation.
15. The Ixia setup dialog box is displayed all through the installation, as shown in the following
figure. The dialog box runs in the background and verifies if the installation is including all the
items successfully.

- 25 of 80-
Getting Started with IxNetwork : IxNetwork Installation

16. The installation continues automatically. Once it is complete, the Setup Completed dialog box
appears, as shown in the following figure.

- 26 of 80-
 Getting Started with IxNetwork : IxNetwork TCP Ports

17. Select the Create Desktop shortcut? check box to create an IxNetwork icon on your desktop, if
desired.
18. Click Finish to complete the installation and reboot the system.

IxNetwork TCP Ports

Keep the TCP ports specified in the following table open for IxNetwork use:

Table 5-1. TCP Ports for IxNetwork

Component Direction Port
Off Chassis HWM HWM Machine <--> Chassis 6809
License Management Client --> Chassis SOCKS 1080
Default is 8009, user
IxNetwork TCL Wish --> TCL Sever (client)
configurable
StatViewer Client --> Chassis 9102
Client --> Chassis, File
4500
IxOS download
23
Client --> Chassis, Telnet

Python Client Installation

To install Python Client, perform the following steps:
1. If Python 2.6 is not installed on the machine, download and install a stable release of Python 2.6 from
http://www.python.org/getit/releases/2.6/
2. Currently there is no installer, so you need to manually install the IxNetwork.py file. Normally the file will be installed
in the standard location for third-party Python modules. This location varies depending on the platform and the way you
build or install Python itself. On Unix (and Mac OS X, which is also Unix-based), it also depends on whether the module
distribution being installed is pure Python or contains extensions (non-pure).

Platform Standard Installation Location Default value

Unix (pure) prefix/lib/pythonX.Y/site-packages /usr/local/lib/pythonX.Y/site-packages/IxNetwork
Unix (non-pure) exec-prefix/lib/pythonX.Y/site-packages /usr/local/lib/pythonX.Y/site-packages/IxNetwork
Windows prefix\Lib\site-packages C:\PythonXY\Lib\site-packages\IxNetwork

3. Execute IxNetwork.py.

IxNetwork and Test Conductor – Installation

To install the combined IxNetwork and Test Conductor installer there is a separate installation.exe
which is different from the general IxNetwork installation exe.

The combined installer provides the option to install Test Conductor only on Client side (TC
installation option is unavailable on Chassis side) since Test Conductor interacts only with the
IxNetwork GUI.

Test Conductor installation choice is only provided with the ÒInstall IxNetworkÓ and ÒInstall
IxNetwork and IxNetwork-FTÓ options as described in the IxNetwork installation process (IxNetwork
Installation ).

- 27 of 80-
Getting Started with IxNetwork : Configuring IxNetwork for Silent Installation

During the installation process, the only difference between the normal IxNetwork installation and the
combined installation is that an additional Install Test Conductor window is displayed.

Click Next to go to the next dialog box in the IxNetwork Installation process.
NOTE:
• The IxNetwork installation will not manage the Test Conductor installation
post-installation. All modification and repair operations are performed via
the Add/Remove Programs entry for Test Conductor.
• The combined installer will not support silent installation or installation
through IxAdmin.
• The size of this new combined installer is higher than the IxNetwork Full
installer by about 380 MB.
• The combined installer will not support installation alongside the IxNetwork
Full, IxNetwork Chassis installer or IxNetwork-FT (from the same build) on
the same machine.

NOTE: Just before the installation is complete, a separate installation is launched for Test
Conductor and runs independent of IxNetwork.
IxNetwork does not check whether another version of Test Conductor is already installed on
the machine. Once invoked the Test Conductor installation would install or upgrade just like it
does when installed independently. Success or failure of the Test Conductor installation
would not impact the IxNetwork installation.

NOTE: While uninstalling IxNetwork, Test Conductor is not uninstalled automatically. Test
Conductor has to be separately uninstalled through Control Panel/Add Remove Programs.

Configuring IxNetwork for Silent Installation

IxNetwork Silent Install is a feature which enables you to install IxNetwork software unattended. A
silent installation of IxNetwork is ideal for test scenarios or as part of a large-scale enterprise
deployment.

You can use the IxAdmin package to perform remote silent installations on multiple machines
simultaneously.

If you want to use Silent Installation to install IxNetwork software on an Ixia chassis, you must change
the policy that controls Silent Installation. See Preparing an Ixia Chassis for Silent Installation .

IxNetwork product silent install setup is discussed in

IxNetwork Silent Install using .exe Package .

Preparing an Ixia Chassis for Silent Installation

If you try to run a Silent Install on an Ixia Chassis with Windows installed, Windows will display the
following warning message for the Ixia kernel driver:

Signature Not Found

- 28 of 80-
 Getting Started with IxNetwork : IxNetwork Silent Install using .exe Package

To prevent this warning, you must change the Windows policy that governs the installation of
unsigned drivers. Perform the following steps. You need to perform this procedure only once.
1. On the Ixia chassis, click Start, select Run, type MMC, and then click OK.
2. Press Add/Remove Snap-in, on the Console menu.
3. Press Add and select Group Policy and press Add.
4. Press Finish / Close / OK.
5. Navigate down the following tree:
Console Root
Local Computer Policy
Computer Configuration
Windows Settings
Security Settings
Local Policies
Security Options

6. Right-click unsigned driver installation behavior and press Security.

7. Change the Local policy setting to: Silently succeed.
8. Press OK.

You must reboot the chassis after this operation.

IxNetwork Silent Install using .exe Package

Setting up the silent install for IxNetwork for a chassis involves activating specific features included in
the product package, and specifying the server operation mode via a command line dialog box.

The available features and properties (operation modes) are delivered as part of the installer. Table
Features lists the features available, and Table Properties lists the properties.

To run the IxNetwork installer silently, use the IxNetwork<version><release>.exe package, where
<version> is the version of the software, and <release> is the release number for the particular
package. The .exe is extracted to %ProgramFiles%\IxiaInstallerCache\IxNetwork\<full_version>folder
by providing a -e switch, for example, IxNetwork<version><release>.exe -e. The setup.exe file is
located in this directory.

Perform the following steps to set up silent installation using the .exe package.
1. Open a command line window.
2. Enter the following command line argument, in one line:
setup.exe [-s|-q] [-n] [i|x|r] [F.Feature1=Yes|No [F.Feature2=Yes|No]]
[P.Prop1=Val1 [P.Prop2=Val2]]

3. See IxNetwork setup.exe Package Examples below for examples of using the command line to
set up silent installation.

- 29 of 80-
Getting Started with IxNetwork : Features

Table 5-2. Setup.exe Switches

Switch Definition
-s silent (progress bar only)
-q quiet (no GUI at all)
-n external controlled (by IxAdmin)
no switch
GUI installation
(default)

Table 5-3. Setup.exe Actions

Switch Definition
i install
x uninstall
r repair
no action
install
(default)

Features

F.Feature1=Yes – install the named feature.

These features represent installer components and are detailed in config.xml file, in the
ConfigOptions/CannedConfig section. If no features are provided, a default configuration will be used.

Features represent the installer components that can be selected from the GUI in standalone mode. The
command line allows the combinations of these features.
Table 5-4. Features
Feature Definition
F.Client Install Client components
F.Server Install Chassis components
F.Network_FT Install Network-FT components for client
F.Network_FT_
Install Network-FT components for chassis.
Chassis

Properties

P.Prop1 =Val1 – pass to the installer a certain property.

If no properties provided, default properties are used.

Properties correspond with settings from the installation GUI, but do not represent the standard features
from the feature selection dialog box, however, the options are presented as radio buttons, checkbox or
edit fields (like the choice of TCL version in IxNetwork). A special property is InstallDir which (if
accepted by the application installer) sets the installation folder.
Table 5-5. Properties
Property Definition
P.INSTALL_
Install IxNetwork
STANDALONE
P.INSTALL_
Install IxNetwork-FT
IXNETWORKFT
P.INSTALL_SERVER Install Chassis Components

- 30 of 80-
 Getting Started with IxNetwork : IxNetwork setup.exe Package Examples

IxNetwork setup.exe Package Examples

The following examples demonstrate various options for setting up silent installation using the
setup.exe package:
• Silent installation of IxNetwork:
setup.exe –s P.INSTALL_STANDALONE=Yes

• Quiet installation of IxNetwork:

setup.exe –q P.INSTALL_STANDALONE=Yes

• Silent Uninstall (any config)

setup.exe –s x

The following table represents the detailed list of the configuration and corresponding command lines
for IxNetwork.
Table 5-6. Command Lines for IXNETWORK
IxNetwork
Command line
configuration to install
Silent: setup.exe –s P.INSTALL_STANDALONE=Yes
Quiet: setup.exe –q P.INSTALL_STANDALONE=Yes
Install IxNetwork
Controlled by IxAdmin: setup.exe –s -n P.INSTALL_
STANDALONE=Yes
Silent: setup.exe –s P.INSTALL_IXNETWORKFT=Yes
Quiet: setup.exe –q P.INSTALL_IXNETWORKFT=Yes
Install IxNetwork-FT
Controlled by IxAdmin: setup.exe –s -n P.INSTALL_
IXNETWORKFT=Yes
Silent: setup.exe –s P.INSTALL_STANDALONE=Yes
P.INSTALL_IXNETWORKFT=Yes
Install IxNetwork and Quiet: setup.exe –q P.INSTALL_STANDALONE=Yes
IxNetwork-FT P.INSTALL_IXNETWORKFT=Yes
Controlled by IxAdmin: setup.exe –s -n P.INSTALL_
STANDALONE=Yes P.INSTALL_IXNETWORKFT=Yes
Silent: setup.exe –s P.INSTALL_STANDALONE=Yes
Install IxNetwork, P.INSTALL_IXNETWORKFT=Yes P.INSTALL_SERVER=Yes
IxNetwork-FT and IxVM Quiet: setup.exe –q P.INSTALL_STANDALONE=Yes
Server Chassis (IxOS with P.INSTALL_IXNETWORKFT=Yes P.INSTALL_SERVER=Yes
IxVM Server is mandatory Controlled by IxAdmin: setup.exe –s –n P.INSTALL_
on Client) STANDALONE=Yes P.INSTALL_IXNETWORKFT=Yes
P.INSTALL_SERVER=Yes

Uninstall/Modify a Current Installation

To remove silently uninstall the current version of IxNetwork, enter the following argument at the
command line:
Setup.exe –s x

To modify an existing installation, first uninstall it, then reinstall it with the desired features.

Silent Repair/Modify

Silent repair is the same as running silent install on a current installation. Enter the following at the
command line:
setup.exe -s r

- 31 of 80-
Getting Started with IxNetwork : IxNetwork Linux/Solaris Installation

IxNetwork Linux/Solaris Installation

The following section gives information about IxNetwork installation in Linux/Solaris environment.

Location of Linux and Solaris Installers

This is located at the root of build folders,

EXAMPLE - \\ixin-fs1\DFS\Common\Ixia-Software\Protocols\5.40\EB\5.40.68.514\
IxNetworkTclClient5.40.68.514Linux.bin
IxNetworkTclClient5.40.68.514SolarisSparc.bin

NOTE: Root-level permission is required to run IxNetwork IA installer.

Installation/Uninstallation Commands

The installation commands are in the following mode.

1. GUI Mode:

./<Installer_Name>

Example – ./IxNetworkTclClient5.40.68.514Linux.bin
2. Console Mode:

./<Installer_Name> -i console

Example – ./IxNetworkTclClient5.40.68.514Linux.bin –i console

3. Silent Mode:

<Installer_Name> –DUSER_INSTALL_DIR=<Specify_Installation_Path> -i silent

Example – ./IxNetworkTclClient5.40.68.514Linux.bin -DUSER_INSTALL_DIR=/home/vmanral/ixos-3

-i silent

Uninstallation Command

The uninstallation command is given below with an example.

./<Installation_Dir>/Uninstall_<Product_Name>/Uninstall_<Product_Name>

Example – ./IxNetworkTclClient5.40.68.515-EB/ Uninstall_IxNetworkTclClient5.40.68.515/Uninstall_

IxNetworkTclClient5.40.68.515

Location of Log Files

<Users_Home_Dir>/logs

Example – /home/vmanral/logs

- 32 of 80-
 Getting Started with IxNetwork : Installation Sequence

NOTE:
• IxOS is mandatory only during installation through GUI and Console modes.
Silent installation does not check for IxOS.
• During installation through GUI and Console modes, IxNetwork installation
directory should be same as the installation directory of an IxOS build and
all the IxNetwork resources are installed under lib folder of IxOS.

Installation Sequence

The following sequence displays the steps for GUI installation.

The following table displays the initial panel in the installation sequence.
Figure 5-1. Linux Installation – Initial Panel

1. Click Next in the next dialog box in the installation wizard as displayed in the following figure.
Figure 5-2. Linux Installation – Introduction Window

2. In the next dialog box (Installation and Licensing ), select the folder location for the installer.
Figure 5-3. Linux Installation – Choose Install Folder Window

- 33 of 80-
Getting Started with IxNetwork : Installation Sequence

3. Click Choose to select a new folder location.

4. Click Restore Default Folder to restore the default folder location.
5. Click Next, the Pre-Installation Summary dialog box (Installation and Licensing ) is displayed.
Figure 5-4. Linux Installation – Pre-Installation Summary Window

6. Click Install.

The next dialog box (Installation and Licensing ) displays the installation progress.
Figure 5-5. Linux Installation – Installation Progress Bar

- 34 of 80-
 Getting Started with IxNetwork : Installation Sequence

After the installation is complete, the Install Complete dialog box (Installation and Licensing ) is
displayed.

Figure 5-6. Linux Installation – Install Complete

7. Click Done to exit out from the installation wizard.

- 35 of 80-
Getting Started with IxNetwork : AES Scriptgen Setup

AES Scriptgen Setup

The AES ScriptGen feature of IxNetwork 6.10 requires a TCL platform with Threads and TbcLoad
support. The TCL installed with IxOS does not support thread. To make use of this feature, there are
two options:
• Use the tclsh8.4 from <IxOS_InstallDir>/lib/tcl_threaded/bin directory
• Use the new ixnetwish file located under <IxOS_InstallDir>/bin directory

Sample command lines are as follows:

1. package req ix_tc
2. package req tbcload
3. package req Thread
In GUI and Console mode, the IxNetwork installer creates two environment variables on the system viz. LD_LIBRARY_
PATH and TCLLIBPATH to support this new feature. The value of LD_LIBRARY_PATH is set to append whereas the
value of TCLLIBPATH is set to overwrite the existing setting.
If LD_LIBRARY_PATH is already set on the system and is pointing to non threaded TCL libraries then the threaded
tclsh8.4 binary would throw errors when executed. To overcome this problem, set LD_LIBRARY_PATH explicitly to the
path of the lib folder (<IxOS_InstallDir>/lib/tcl_threaded/lib) of threaded TCL.
Refer to IxNComposerScriptGenReference guide for more information.

NOTE: AES Scriptgen is meant for the Linux users.

- 36 of 80-
 Getting Started with IxNetwork : Running a Test with IxNetwork

Running a Test with IxNetwork

Follow the procedures in this guide to run a simple test and quickly gain experience with IxNetwork. If you need to
perform more advanced testing, refer to IxNetwork User Guide.
For detailed information on IxNetwork installation and licensing, refer to:

• Installation and Licensing

For detailed information on licensing, refer to:

• IxNetwork Licensing
• Ixia License Management User Guide
Following are the topics covered in this chapter:

• Requirements
• A Simple IxNetwork Test
• Connect the Ports
• Start IxNetwork
• Select the Ports
• Configure the Protocol
• Review the Protocol Configuration
• Ping the DUT
• Start the BGP Protocol
• Configure Traffic
• Set Up the Test Composer
• Set Up CSV Logging
• Set Up a Quick Test

NOTE: The minimum resolution for viewing the IxNetwork GUI is 1024x768, with a DPI
setting of Normal Size (96 DPI)

Requirements
IxNetwork is a client application that runs under Windows. It operates in conjunction with one or more chassis running
IxOS/IxServer.
To run the IxNetwork test in this guide, you need the following:

• An Ixia chassis with an Ethernet-based CPU-per-port load module.

• Two ports available on the load module.
• Connection cables.
• A Windows PC to run IxNetwork. The IxNetwork Client is run on the Windows workstation, while
IxOS/IxServer is run on the chassis.

A Simple IxNetwork Test

To get acquainted with IxNetwork, perform the following steps to set up and run a simple test.

- 37 of 80-
Getting Started with IxNetwork : Connect the Ports

The test configuration used as an example in this document is the BGP protocol, hence, install the IxNetwork BGP
protocol emulation. Configure the Ixia ports to run the BGP protocol and send the traffic through the DUT to Route
Ranges advertised by BGP.
To run a simple test in IxNetwork, you need to perform the following steps:

1. Connect the Ports

2. Start IxNetwork
3. Select the Ports
4. Configure the Protocol
5. Review the Protocol Configuration
6. Ping the DUT
7. Start the BGP Protocol
8. Configure Traffic
9. Set Up the Test Composer
10. Set Up CSV Logging
11. Set Up a Quick Test

Connect the Ports

Before starting a test, connect the DUT ports to the Ixia chassis, using the correct cables for the connection as shown in A
Simple IxNetwork Test . The PC running IxNetwork is connected to Ixia chassis through a network connection to the
management port on the chassis.
In the IxNetwork client PC, use the Ping command to test the connection to the chassis, and ping the management port
on the chassis.

Figure 6-1. Ixia Chassis — DUT Cable Connections

Start IxNetwork
Before you start IxNetwork:

• Make sure IxServer is running on Ixia chassis. IxServer normally starts automatically when the
chassis boots up.
• Make sure you know the available ports on the chassis. Applications such as IxExplorer, Scriptmate,
and Tcl scripts allow you to take ownership of the ports on Ixia chassis. If the ports are already in
use, they are not available for assignment in the IxNetwork Port Management window.
• Double-click the IxNetwork icon on your Desktop.

- 38 of 80-
 Getting Started with IxNetwork : Select the Ports

Figure 6-2. IxNetwork icon

The main IxNetwork GUI window appears. Click Ports on the Test Configuration pane to view the
ports in use, as shown in {Default ¦ Font}{Hyperlink}Figure {paranumonly[Figure]}{Default ¦ Font}.
Figure 6-3. IxNetwork GUI

IxNetwork automatically logs you in using the local host name configured on your PC. When you select Ixia ports for the
test, IxNetwork uses this name to identify those ports as being reserved for your exclusive use.

Select the Ports

You can make IxNetwork configurations directly on the physical ports, or create configuration images, which you can save
and apply to the ports at a later time. For this test, apply the configuration directly on the physical ports.

1. Click the Add Ports button in the Port Manager window.

Figure 6-4. Add Ports Button

The Port Selection dialog box appears, as shown in the following figure. The available ports appear
in the left pane of the window.
Figure 6-5. Select Ports

- 39 of 80-
Getting Started with IxNetwork : Configure the Protocol

2. Click Add Ports to add the ports to the right pane.

3. Click OK.
The Ports window appears with a list of the newly added ports, as shown in the following figure.
The ports are available for protocol configuration.
Figure 6-6. Added Ports

Configure the Protocol

Configure the protocol. For this example, use the Protocol Wizards to configure the BGP protocol on Ixia ports.

1. On the Home tab, click Add Protocols. the Protocol Wizards dialog box appears as shown in the
following figure.

Figure 6-7. Protocol Wizards

- 40 of 80-
 Getting Started with IxNetwork : Configure the Protocol

2. Click BGP/BGP+, and then click Run Wizard. The BGP/BGP+ Wizard - Port Select dialog box
appears, as shown in the following figure.
Figure 6-8. BGP Configuration Wizard

The two ports that you configured are listed with their description.

- 41 of 80-
Getting Started with IxNetwork : Configure the Protocol

3. Select the Enable check box against each port, and then click Next.
4. The BGP/BGP+ Wizard - Init dialog box appears as shown in the following figure.
Figure 6-9. BGP/BGP+ Wizard – Init Dialog Box

5. Click Configure Topology & Generate, and then click Next.

The BGP/BGP+ Wizard - Peers dialog box appears as shown in the following figure.

Figure 6-10. BGP/BGP+ Wizard - Peers Dialog Box

- 42 of 80-
 Getting Started with IxNetwork : Configure the Protocol

6. Enable VLAN and configure the IP addressing for Ixia and DUT ports.
7. Configure the number of Ixia-emulated BGP routers per port, and click Next.
The BGP/BGP+ Wizard - Route Ranges dialog box appears as shown in the following figure.

- 43 of 80-
Getting Started with IxNetwork : Configure the Protocol

Figure 6-11. BGP Wizard – Route Ranges Dialog Box

8. Set the BGP route ranges and select the Advertise Routes check box.
9. Click Next.
The BGP/BGP+ Wizard - Save dialog box appears, as shown in the following figure.

- 44 of 80-
 Getting Started with IxNetwork : Review the Protocol Configuration

Figure 6-12. BGP – Save Dialog Box

10. You can save the protocol configuration for later use, or apply to the port immediately. For this
example, click Generate and Overwrite Existing Configuration.
11. Click Finish to close the dialog box and apply the protocol configuration to the ports.

Review the Protocol Configuration

The wizard automatically enables the BGP (and ARP) protocol, as shown in the following figure.

Figure 6-13. Protocol Management Window

It creates connected protocol interfaces for each port, as shown in the following figure.

- 45 of 80-
Getting Started with IxNetwork : Ping the DUT

Figure 6-14. Connected Protocol Interfaces

It also enters the BGP protocol configuration for each of the ports, as shown in the following figure.
Figure 6-15. BGP Protocol Configuration

The emulated BGP topology is shown in the following figure.

Figure 6-16. Ixia-Emulated BGP Topology

Ping the DUT

To ensure connectivity between Ixia ports and the device under test (DUT) ping the DUT.

1. Right-click the port and click Ping from the pop-up menu as shown in the following figure.

- 46 of 80-
 Getting Started with IxNetwork : Start the BGP Protocol

Figure 6-17. Ping the DUT

The Trace and StatisticsWindow appears.

2. Enter the IP address of the DUT in the Trace and Statistics Window and click Send. The received
response appears on the Ping window as shown in the following figure.
Figure 6-18. Trace and Statistics Window

Start the BGP Protocol

Start BGP Protocol on both the ports in the Protocol window (see Start BGP Protocol ).

1. Click the Start All Protocols button, to start the protocols for both the ports simultaneously.

- 47 of 80-
Getting Started with IxNetwork : Configure Traffic

Figure 6-19. Start BGP Protocol

You can view the Global Protocol Statistics in the Statistics window, as shown in the following figure.

Figure 6-20. Statistics Window

2. Verify that the BGP protocol is operating on both the ports.

Configure Traffic
You must configure a traffic for the protocol on the ports.

1. Click Traffic Configuration on the Test Configuration pane of the IxNetwork window.
The Traffic Configuration window appears, as shown in the following figure.
Figure 6-21. Traffic Window

2. On the Home tab, click Add Traffic and then click Advanced Traffic. The Advanced Traffic
Wizard window appears as shown in the following figure.

- 48 of 80-
 Getting Started with IxNetwork : Configure Traffic

Figure 6-22. Advanced Traffic Window

3. Select One-One option for Source/Dest and Fully Meshed for Routes/Hosts from the drop-down
lists to define the Mesh Type.
4. Select the source and destination IPs in Source and Destination IP Pairs .
Figure 6-23. Source and Destination IP Pairs

5. Click the apply icon for adding the source and destination pairs in the lower pane of the
window as shown in the following figure.

- 49 of 80-
Getting Started with IxNetwork : Configure Traffic

Figure 6-24. Applying the Source and Destination Pairs

6. Repeat procedures 5 and 6 to add more pairs.

As shown in Applying the Source and Destination Pairs , traffic is sent from the source (on the left
pane) to the destination (on the right pane).
The Source/Destination Mesh type is, ÒOne-One.Ó Since two Ixia ports are being used, and
bidirectional traffic is sent between the two ports, two sources and two destinations are created.
(Each port acts as both source and destination.)
The Route Mesh type is, ÒFully MeshedÓ. Since there are 10 route ranges set up for each port, a
full mesh will create 100 pairs of route ranges. The Encapsulation type is non-MPLS, and the
Endpoint type is IPv4.
Creating the pairs at the high-level of the trees saves configuration time. Each port acts as both
source and destination, so the Source / Destination Pair includes 2 source items and 2 destination
items.Ó If you select individual items from the expanded tree, you must add two Source /
Destination Pairs—one for each of the two directions of traffic.
7. Click Next to continue with the configuration.
8. The Packet QoS dialog box appears, as shown in the following figure. You need not make any
changes in the dialog box.

- 50 of 80-
 Getting Started with IxNetwork : Configure Traffic

Figure 6-25. Packet QoS Dialog Box

9. Click Next to continue with the configuration. The Flow Group Setup dialog box appears, as
shown in the following figure.
Figure 6-26. Flow Group Setup Dialog Box

10. Select the desired Flow Group from the left navigation pane. If you select None the default
distribution is taken for the configuration.
11. Click Next to continue with the configuration. The Frame Setup dialog boxappears, as shown in
the following figure. If required, increase the Frame Size from the default value (64).

- 51 of 80-
Getting Started with IxNetwork : Configure Traffic

Figure 6-27. Frame Setup Dialog Box

12. Click Next to continue with the configuration.

13. The Rate Setup dialog box appears, as shown in the following figure. You can perform the rate
setup per encapsulation or for all encapsulations by clicking the relevant option. Select the desired
transmission mode (Interleaved or Sequential) and specify 10 for % Line rate.
Figure 6-28. Rate Setup Dialog Box

14. Click Next to continue with the configuration.

15. The Flow Tracking dialog box appears, as shown in the following figure. Select the desired track
flow from the Traffic Flows by navigation pane. For this example, select Source/Dest Endpoint Pair.

- 52 of 80-
 Getting Started with IxNetwork : Configure Traffic

Figure 6-29. Flow Tracking Dialog Box

16. Click Next to continue with the configuration.

17. The Dynamic Fields dialog box appears, as shown in the following figure. Select the MPLS Label
Values check box.
Figure 6-30. Dynamic Fields Dialog Box

18. Click Next to continue with the configuration.

The Preview dialog box appears.
19. Click View Flow Groups/Packets on the upper right corner. The Flow Groups and Packets of the
configured Traffic Item is displayed.
20. Select a flow group. The packets for the flow group are displayed in the lower pane.

- 53 of 80-
Getting Started with IxNetwork : Configure Traffic

Figure 6-31. Preview Dialog Box

21. Click Next to continue. The Validate dialog box appears.

Figure 6-32. Validate Dialog Box

22. Click Validate on the upper right corner. The result of the configured Traffic Item is displayed, as
shown in the figure.
23. Click Finish to close the wizard.
24. Click L2-3 Traffic Items under Traffic Configuration in the Test Configuration pane.
The configured Traffic Item appears in the Traffic window, as shown in the following figure.

- 54 of 80-
 Getting Started with IxNetwork : Configure Traffic

Figure 6-33. Traffic Item

25. Double-click a traffic item to display the Flow Group Editor dialog box. Note that the information
in the Properties reflects the changes that were made in Frame Setup Dialog Box .
Figure 6-34. Flow Group Editor Dialog Box

26. On the Home tab, click L2-3 Traffic and then click Apply L2-3 Traffic to write the traffic
configuration to the ports. Then click Start All L2-3.
Figure 6-35. Apply the Traffic Configuration

27. View the progress of the streams in the Statistics window, as shown in the following figure.

Figure 6-36. View Statistics

- 55 of 80-
Getting Started with IxNetwork : Set Up the Test Composer

Set Up the Test Composer

NOTE: The IxNetwork application supports the Test Composer functions.

To open the IxNetwork - Test Composer Window click on the button on the IxNetwork GUI
Views tab.
The IxNetwork - Test Composer application appears as a separate panel.
The TestComposer Online Help provides detailed information on the Test Composer
window features. Press F1 to access the online help in the Test Composer window.

Set Up the Test Composer

Test Composer is an Ixia software component, integrated into IxNetwork that permits the creation of complex multi-step
test scripts integrating Event Scheduler events, DUT configuration commands, local or external procedure calls, and flow
control instructions that permit branching the script flow based on a step result evaluation.

1. Click Test Composer on the Views tab to display the a separate panel on the right of the
IxNetwork GUI.

2. Click to add a new script as shown in the following figure.

- 56 of 80-
 Getting Started with IxNetwork : Set Up the Test Composer

Figure 6-37. Test Composer Window - Creating a Script

Refer to Chapter 27: Test Composer in TestComposer Online Help for details on the Test Composer Script.

3. Click User Events on the Test tab to add an event as shown in the following figure.

Figure 6-38. Test Composer Window - Creating an Event

- 57 of 80-
Getting Started with IxNetwork : Creating a Test Composer Script

4. . You can define global user events and associate them with executed procedures and additional
actions.
An Execute command output or a device session to configured test devices can be monitored for the
occurrence of specified messages. When a matching message is received by either an Execute or a
Watch script step, an event is triggered and processing for the event can be configured.
Refer to Chapter 3: Defining User Events in TestComposer Online Help for details on User Events.

Creating a Test Composer Script

Refer to Chapter 3: Creating and Editing a Test Composer Script in TestComposer Online Help for creating a Test
Composer Script.

Creating a Sample Test Composer Script

This section describes a sample operations sequence for defining a Composer test and saving it into the Test Conductor
database.

Test Overview

For the purpose of our example, we are considering a Composer test that established an IxExplorer session with an Ixia
chassis and executes commands on two chassis ports, the first transmitting a packet stream and the second receiving it.
The test connects to the Ixia chassis using an IxExplorer StartSession command, configures the test output using an
existing Tcl test configuration script, clears the statistics on the ports and starts the packets transmission. After
transmitting continuously for a period of 5 seconds, transmission on the first port is stopped and the values of the
framesSent (on port 6.1) and the framesReceived test statistics (on port 6.2) are retrieved into a composite variable using
a Stat Get command.
After retrieving the fsent and frecv statistics values from the composite variable using GetValue Tcl commands, the two
values are compared using an If / Else statement, and depending on the evaluation result, the test return a non-zero value
for a pass status or a zero value for a fail status.

- 58 of 80-
 Getting Started with IxNetwork : Creating the Composer Test

Figure 6-39. Sample Test Overview

Creating the Composer Test

To create the test described in {Default ¦ Font}{Emphasis}{Hyperlink}A Simple IxNetwork Test{Default ¦ Font} proceed
as follows:

1. While in the TestComposer module, click the New Composer Test button and type in a test
name and an optional description in the Information window that appears.

2. Click the link and start adding the steps sequence described below.
Add an IxExplorer StartSession step that opens a connection to an Ixia chassis (piglet for purpose of
our example) and takes ownership of chassis ports 6.1 and 6.2. A username and a path to the IxOS
installation folder on the chassis must also be configured.
   StartSession ixe IxExplorer, Session Start chassis=piglet ports="(6.1 6.2)"
ownershipmode=force loginname=cliff ixospath=//piglet/Ixia/IxOS/   5.20.401.100-EB

3. Add an Execute step that runs a ScriptGen Apply command on the session opened at step 1. This
command applies an existing IxExplorer test configuration file to port 6.1 that will be transmitting
packets.
   Execute ixe ScriptGen Apply ports=(6.1) filename=C:/   cfg6_1_tx30.tcl

4. Add an Execute Stat Clear step that resets the statistic counters on the two chassis ports.
   Execute ixe Stat Clear ports="(6.1 6.2)"

5. Add an Execute Utility CheckLinkState step verifying the link status of the two ports.
   Execute ixe Utility CheckLinkState ports="(6.1) (6.2)"

6. Add a Transmit Start step that initiates the transmission of a packets stream from chassis port 6.1.
   Execute ixe Transmit Start ports=(6.1)

7. Add a Sleep step with a duration of 5 seconds, which keeps the port transmitting packets for this
duration.
   Sleep 00:00:05.000

8. Add an Execute Transmit Stop which stops the packets transmission on port 6.1:

- 59 of 80-
Getting Started with IxNetwork : Set Up CSV Logging

   Execute ixe Transmit Stop ports=(6.1)

9. Add an Execute Stat Get step that retrieves into the composite frameStats variable the values of the
framesSent and framesReceived statistic for port 6.1 and 6.2 respectively.
   Execute ixe frameStats Stat Get ports="(6.1) (6.2)" stats="-framesReceived -
framesSent"

10. Add an Assign step that uses the GetValue Tcl command to retrieve the value of the framesSent
statistic for port 1.6.1 into the fsent variable.
   Assign fsent [GetValue frameStats framesSent Port 1.6.1]

11. Add an Assign step that uses the GetValue Tcl to retrieve the value of the framesReceived statistic
for port 1.6.2 into the frecv variable.
   Assign frecv [GetValue frameStats framesReceived Port 1.6.2]

12. Add a Trace statement that prints out the fsent and frecv values by referencing the simple variables
defined at steps 10 and 11.
   Trace "frames sent: %d ::: frames received: %d" $fsent $frecv

13. Add a TclEval step that computes the tx_fps and rx_fps frames per second rates:
   TclEval set tx_fps [expr {$fsent / 5.0}]; set rx_fps [expr {$frecv / 5.0}]

14. Add a Trace statement that prints out the tx_fps and rx_fps values computed at the previous step.
   Trace "tx rate (fps): %f ::: rx rate (fps): %f " $tx_fps $rx_fps

15. Add a StopSession step that terminates the ixe session to the Ixia chassis.
   StopSession ixe

16. Add an If step for testing the equality of the fsent and frecv values, and an Else statement within the
If step:
   If ${fsent} == ${frecv}

      <instruction 1>

   Else

     <instruction 2>

   EndIf

17. Add a Return step with a 1 Passed argument that is executed when the If step evaluates true, and
another one after the Else statement with a
0 Fail argument, to be executed when the If step evaluates false:
   If ${fsent} == ${frecv}

      Return 1 Passed

   Else

      Return 0 Failed

   EndIf

Click Save. The Composer test is saved into the Test Conductor database using the name specified at step 1 and is added
to the applicationÕs Tests table.

Set Up CSV Logging

To set up CSV Logging, perform the following steps.

- 60 of 80-
 Getting Started with IxNetwork : Set Up a Quick Test

1. On the Home tab, click Test Options. The Test Options dialog box appears.
2. On the left panel, click Stat Viewer Options.
3. On the Advanced Settings tab, select the Enable CSV Logging for All Views check box.
4. Click the File tab and then click Preferences. The Preferences dialog box appears.
5. On the left panel, click StatViewer Options. on the
6. Select location of the CSV file. The data is saved to the CSV file path. Use the CSV information
with IxReporter to create a PDF or HTML report, or export the information to an Excel sheet.
7. Click OK to save the settings.

Set Up a Quick Test

To set up a Quick Test, perform the following steps:

1. Select QuickTests on the Test Configuration pane.

2. On the configuration tab, click Add QuickTests. The QuickTest window appears.
3. Select a test from the list. For this example, select RFC 2544 Throughput/Latency test.
Figure 6-40. Quick Test Window

4. Click Next. The Ports page appears. Modify existing ports and add new ports. You can modify
existing ports only if they are unassigned (virtual) as it is assumed that any assigned ports are
already configured correctly through the Port Manager of IxNetwork. You can also add virtual ports.
5. Click Next. The Frame Data page appears. Configure the frame data.
6. Click Next. The Traffic page appears. This page dispays the ports used in the test. You can map
source/destination ports and add them.
7. Click Next. The Traffic Options page appears. This page enables you to set various parameters
related to traffic, such as the frame sizes and delays used for the validation traffic and the learning
process parameters.
8. Click Next. The Test Parameters page appears. This page enables you to configure the parameters
for the test.
9. Click Next. The Finish page appears. This page allows to give a name to the newly configured test.
10. Click Finish to complete the configuration.

- 61 of 80-
Getting Started with IxNetwork : Set Up a Quick Test

11. Click to begin the test.

12. Select Data Miner on the Test Configuration pane. The results of the test appears in the Results
section of the Data Miner window.

- 62 of 80-
 Getting Started with IxNetwork : IxNetwork Licensing

IxNetwork Licensing

This appendix covers the license information for IxNetwork software in the following sections:

• IxNetwork-Specific License Information

• IxNetwork License Management
• Troubleshooting

NOTE: The Ixia IxOS/IxServer and IxNetwork software must be installed on the chassis prior
to installation of the Ixia IxNetwork software on the client PC.

IxNetwork-Specific License Information

Licenses for the IxNetwork base software and protocol emulation packages for load modules are
available for separate purchase, including:
• IxNetwork base Software, Layer 2-3 Performance Test Application, which supports traffic
generation and analysis.
• IxNetwork Protocol Emulation Bundles with multiple protocol emulations, for CPU-per-port load
modules. The Protocol Emulation Bundles are described in IxNetwork Protocol Emulation
Bundles .
• IxNetwork Protocol Emulations (individual), for CPU-per-port load modules. The individual
Protocol Emulation options are described in IxNetwork Individual Protocol Emulations .
Table 7-1. IxNetwork Protocol Emulation Bundles
Part Number Bundle Name Bundle Contents
Base Software, Layer 2-3
Supports Traffic Generation and Analysis.
930-1999 Performance Test
Includes Media Kit.
Application
Includes 930-2005 BGP-4 Emulation, 930-
Optional Software Bundle, 2008 OSPFv2 Emulation, 930-2010 IS-IS
930-2001
IPv4 Routing Protocols Emulation, 930-2012 RIPv2 Emulation.
REQUIRES 930-1999 Base software.
Includes 930-2007 BGP4 with IPv6 Support,
930-2009 OSPFv3 with IPv6 Emulation, 930-
2011 IS-IS IPv6 Support, 930-2013 RIPng
Optional Software Bundle,
930-2002 Emulation.
IPv6 Routing Protocols
REQUIRES 930-1999 Base software and 930-
2001 Optional Software Bundle, IPv4 Routing
Protocols.
Includes 930-2006 Layer 3 MPLS/VPLS
Support, 930-2014 RSVP-TE Emulation, 930-
Optional Software Bundle, 2015 LDP Emulation.
930-2003
MPLS VPNs REQUIRES 930-1999 Base software and 930-
2001 Optional Software Bundle, IPv4 Routing
Protocols.

- 63 of 80-
Getting Started with IxNetwork : IxNetwork-Specific License Information

Table 7-2. IxNetwork Individual Protocol Emulations

Part Number Protocol Emulation Description
Includes IGMPv1/v2/v3, MLD v1/v2, PIM-
Optional Software,
930-2004 SM/SSMv4/v6, and Multicast VPN Support.
Multicast Emulation
REQUIRES 930-1999 Base software.
Optional Software, BGP4 BGP-4 Emulation.
930-2005
Emulation REQUIRES 930-1999 Base software
BGP-4 Emulation with additional Layer 3
Optional Software, BGP4
MPLS/VPN and Multicast VPN support.
930-2006 Emulation with VPN
REQUIRES 930-1999 Base software and
support
930-2005 BGP4 Emulation.
BGP-4 Emulation with additional IPv6
Optional Software, BGP4
support.
930-2007 Emulation with IPv6
REQUIRES 930-1999 Base software and
support
930-2005 BGP4 Emulation.
Optional Software, OSPFv2 Emulation.
930-2008
OSPFv2 Emulation REQUIRES 930-1999 Base software.
Optional Software, OSPFv3 Emulation.
930-2009
OSPFv3 Emulation REQUIRES 930-1999 Base software.
Optional Software, IS-IS IS-IS Emulation.
930-2010
Emulation REQUIRES 930-1999 Base software.
IS-IS Emulation with additional IPv6
Optional Software, IS-IS
support.
930-2011 Emulation with IPv6
REQUIRES 930-1999 Base software and
support
930-2010 IS-IS Emulation.
Optional Software, RIPv2 RIPv2 Emulation.
930-2012
Emulation REQUIRES 930-1999 Base software.
Optional Software, RIPng RIPng IPv6 Emulation.
930-2013
IPv6 Emulation REQUIRES 930-1999 Base software.
Optional Software, MPLS MPLS RSVP-TE Emulation.
930-2014
RSVP-TE Emulation REQUIRES 930-1999 Base software.
MPLS LDP Emulation includes Layer 2
Optional Software, MPLS
930-2015 MPLS VPN and VPLS support.
LDP Emulation
REQUIRES 930-1999 Base software.
Optional Software, STP/RSTP Emulation.
930-2017
STP/RSTP Emulation REQUIRES 930-1999 Base software.
MSTP Emulation.
Optional Software, MSTP
930-2018 REQUIRES 930-1999 Base software and
Emulation
930-2017 STP/RSTP Emulation.
Optional Software, PVST+/RPVST+ Emulation.
930-2019 PVST+/RPVST+ REQUIRES 930-1999 Base software and
Emulation 930-2017 STP/RSTP Emulation.
Optional Software, EIGRP EIGRP Emulation.
930-2020
Emulation REQUIRES 930-1999 Base software.
Application Traffic Performance Test
Optional Software,
930-2021 Application.
Application Traffic Support
REQUIRES 930-1999 Base software.
RFC 2544 and Custom Integrated Tests
Optional Software,
over Advertised Topologies.
930-2022 RFC 2544 and Custom
REQUIRES 930-1999 Base Software
Integrated Test Emulation.

BFD emulation for use with OSPF, BGP, or

ISIS.
Optional Software, REQUIRES 930-1999 Base Software AND
930-2023
BFD Emulation either 930-2008 OSPFv2 Emulation, OR
930-2009 OSPFv3 Emulation, OR 930-

- 64 of 80-
 Getting Started with IxNetwork : IxNetwork License Management

Part Number Protocol Emulation Description

2005 BGP4 Emulation, OR 930-2006 BGP4
Emulation with Layer 3 MPLS/VPN &
Multicast VPN Support, OR 930-2007 BGP4
Emulation with IPv6 support, OR 930-2010
IS-IS Emulation, OR 930-2011 IS-IS
Emulation with IPv6 support
Optional Software, PPP and L2TPv2 emulation; Operates with
930-2024 PPP and L2TPv2 930-2027 Control Plane Tests.
Emulation REQUIRES 930-1999 Base Software
802.1x emulation; Operates with 930-2027
Optional Software,
930-2025 Control Plane Tests.
802.1x Emulation
REQUIRES 930-1999 Base Software
Layer 2/3 Cisco NAC emulation.
Optional Software,
REQUIRES 930-1999 Base Software;
930-2026 Layer 2/3 Cisco NAC
Operates with Optional Software 930-2027
Emulation
Control Plane Tests
Control Plane Tests for PPP/L2TPv2,
Optional Software, 802.1x, and NAC.
930-2027 Generic Control Plane REQUIRES 930-1999 Base Software AND
Integrated Test Emulation either 930-2024 PPP and L2TPv2
emulation, OR 930-2025 802.1x emulation
Optional Software,
Web Authentication emulation.
930-2028 Web Authentication
REQUIRES 930-1999 Base Software
Emulation
Optional Software, Device Device Configuration Module (DCM)
Configuration Module advanced device configuration and control
930-2031
(DCM) software for quickly automating DUT.
REQUIRES 930-1999 Base Software
Optional Software,
Ethernet CFM IEEE Ethernet CFM IEEE 802.1ag and ITU-T
930-2032 802.1ag and ITU-T Y.1731 Protocol Emulation. REQUIRES
Y.1731 Protocol 930-1999 Base Software
Emulation.
Optional Software,
Ethernet PBT Protocol Emulation.
Ethernet PBT Protocol
930-2033 REQUIRES 930-1999 Base Software
Emulation.

930-2034 Optional Software, LACP Protocol Emulation. REQUIRES 930-

LACP Protocol Emulation. 1999 Base Software

IxNetwork License Management

A growing number of Ixia software products use a new technique of licensing. Licensing is managed using the Ixia
Registration Utility (IRU). The IRU is automatically installed and run with the installation of licensed Ixia products.
IxiaÕs license management technique is the means by which Ixia:

• Ensures that its software is licensed and used appropriately.

• Allows Ixia customers to centralize and monitor their software usage.
Licenses are purchased from Ixia and issued to the customer via email. These licenses must be installed on-site in order
for the licensed software to operate correctly. License installation for an Ixia software product can occur either:

• At the time of the software installation.

• Sometime after the software installation, but before software usage.

IMPORTANT: Licensed software cannot be used until the licensing process is complete.

- 65 of 80-
Getting Started with IxNetwork : Date-based versus Version-based Licensing

The licensing operation is accomplished with a simple wizard process and can be run from:

• The same computer on which the software was installed, or

• Some other Windows-based PC.
The computer used to perform the licensing process must be connected to the Ixia chassis and workstations in the lab
environment. If at all possible, it should also be connected to the Internet. If simultaneous connections to the lab network
and Internet are not feasible, it is still possible to complete all licensing operations; the process for off-line installation is
covered in the License Management User Guide.
Depending on the Ixia product, there are two types of licenses that can be purchased:

• A node-locked license (the only type used by IxNetwork) — this type of license is locked to a
particular chassis or workstation, and allows only certain software functions to run on that chassis or
workstation.
• A floating license — this type of license is stored on a License Server, and allows a set number of
chassis or workstations to use various software features. All chassis or workstations that will use this
license must be connected to the License Server, and the server must be running for the licensed Ixia
product to function. Once the set number of users is reached for a particular license feature,
additional users of the product are denied.
Both types of licenses are available from Ixia, and can be mixed to provide the best solution for the testing environmentÕs
needs.

Date-based versus Version-based Licensing

In the past, licenses were linked to the version of the software being licensed. For example, if a license for IxProduct 3.00
was purchased, then the license was only good for the 3.00 version of IxProduct. If IxProduct was upgraded to version
3.1, a new license was required. This is version-based licensing, and required the customer to frequently update their
licenses.
From now on, all licenses issued are date-based licenses. Date-based licenses are valid for the entire period of the
productÕs service contract. For example, if a license is purchased for IxProduct 3.00, with a service contract of one year,
IxProduct can be upgraded to a new version (or a service pack) any time during that year without requiring a new license.
This requires less customer license management.
The new date-based licensing is backward-compatible with the old version-based licensing.

Temporary Licenses
Temporary licenses are offered in the event that a purchased license is not available. This allows the customer to use
purchased applications even if there is a delay in obtaining a valid license.
Temporary licenses have a time limit (measured in days) and become invalid after the time limit expires. Warnings are
presented when the term of a license drops below 30 days.
A sample of a temporary license installation is shown in Temporary License Installation .

Evaluation Licenses
Evaluation licenses are used to evaluate Ixia software products. They can be used for a limited number of days. They act in
all respects as a regular license (they must be installed using the IRU), save for the fact that they have a time limit.

Tcl Notes for Use with Licensing

Although the GUI offers the user the ability to create a temporary license, this cannot be offered while running a Tcl script.
If a temporary license is required, the IRU should be run independently.
If your license resides on the chassis being used by your Tcl program, no adjustment is necessary. If you are using a
License Server, please continue reading.
Although the GUI offers the user the ability to designate an independent license server as a menu option, no such option
is available to a Tcl program. Instead, an environment variable named IXN_LICENSE_SERVER must be set.

- 66 of 80-
 Getting Started with IxNetwork : Prerequisites

If you are running your Tcl program on a Unix client, the environment variable must be set on the host running the Tcl
Server. If you are running your Tcl program on a Windows client, it must be set on that client. Environment variables are
set on a Unix host through the userÕs shell initialization script. Environment variables are set on a Windows host by
using the following steps:

1. Right-click on the My Computer icon on the desktop and then left-click on Properties.
2. Choose the Advanced tab from the System Properties dialog box.
3. Press the Environment Variables button at the bottom of the page.
4. In either the ÒUser variables for <user>Ó or ÒSystem variablesÓ list, if IXN_LICENSE_SERVER
does not exist in the list, press New, otherwise Edit.
5. The name of the variable should be IXN_LICENSE_SERVER and the value should be the name or
IP address of the license server machine.
Prerequisites
Before installing a license, obtain the following:

• The Ixia generated registration email for the licenses being installed. The key contents of this email
are:
• A Registration Number (RN) — a unique number for the license.
• A Password — required to install the license.
• An understanding of which Ixia software products and chassis the license applies to.
• An understanding of whether a License Server is used in the Test Lab.
An example of this email is shown in the following figure (see IxNetwork License Management .). Be sure to note the
Registration number and Password, circled in the email example.

Figure 7-1. Example Registration Email – Part 1

- 67 of 80-
Getting Started with IxNetwork : Prerequisites

Figure 7-2. Example Registration Email – Part 2

- 68 of 80-
 Getting Started with IxNetwork : Installation Scenarios

Installation Scenarios
There are four possible installation scenarios, described in the following sections:

• Licensing to a Chassis or Workstation via the Internet

• Licensing to a Chassis or Workstation Without the Internet
The Installation Host is the computer that is used to perform the licensing installation. This can be the same computer
on which the Ixia software was installed, an Ixia chassis, a License Server, or a separate workstation.

Licensing to a Chassis or Workstation via the Internet

In this case, the Installation Host is connected to the Internet and licenses are installed to the workstation or Ixia chassis
to which the license pertains (the workstation and the Installation Host can be the same machine). The Installation Host
must also be connected to the workstation/chassis (if they are not the same machine).

Figure 7-3. Licensing to a Chassis or Workstation via the Internet

- 69 of 80-
Getting Started with IxNetwork : Licensing to a Chassis or Workstation Without the Internet

Licensing to a Chassis or Workstation Without the Internet

In this case, the Installation Host is not connected to the Internet and the licenses are installed to the workstation or
Ixia chassis to which the license pertains (the workstation and the Installation Host can be the same machine). The
Installation Host must also be connected to the workstation/chassis (if they are not the same machine).
In order to complete the installation process, an additional computer is necessary —an Online Host. This machine must
be connected to the Internet. It is necessary to transfer small amounts of information from the Online Host to the
Installation Host to complete the process. Email or a portable USB drive may be appropriate.

Figure 7-4. Licensing to a Chassis or Workstation Disconnected from the Internet

License Installation Examples

The following sections detail a simple online license installation for both a regular and temporary license:

• Regular License Installation

• Temporary License Installation

Regular License Installation

The following example shows a typical online installation of a node-locked license on a local machine, with no license
server. Depending on the testing environment, other installations may have more steps.

Note: Depending on whether the license is being installed to a computer or a chassis, the
wording in the IRU dialogs is slightly different.

1. If the IRU is not running, start it by selecting Start>Programs>Ixia>Licensing>IRU.

2. Click Register in the IRU, as shown in Licensing Start .

- 70 of 80-
 Getting Started with IxNetwork : Regular License Installation

Figure 7-1. Licensing Start

3. Click Start. Enter the Registration Number and Password exactly as specified in the Ixia generated
email, as shown in Registration Information .

Figure 7-2. Registration Information

- 71 of 80-
Getting Started with IxNetwork : Regular License Installation

4. Click NextEnter the host name or IP address of the Ixia chassis or workstation that will use the
licensed software, shown in the following figure. Localhost is the default and refers to the
Installation Host.
Figure 7-3. Node Machine

5. Click Next. If a license server is used, click No and enter the name or IP address of the license
server. Otherwise, click Yes as shown in the following figure.

Figure 7-4. License Server

- 72 of 80-
 Getting Started with IxNetwork : Regular License Installation

6. Click Next. Review the information for the license to make sure it is accurate, as shown in the
following figure.
Figure 7-5. License Installation

7. Click Next. The license is installed to the workstation or chassis specified (see Node Machine ) or
to the license server (see License Server ). Once the license is installed, a confirmation screen is
displayed (see Finish ). Print or save the confirmation screen for record.

Figure 7-6. Finish

- 73 of 80-
Getting Started with IxNetwork : Temporary License Installation

8. Click Finish.

Temporary License Installation

The following example shows an online installation of a temporary license to a local machine, with no license server.
Depending on the testing environment, other installations may have more steps.
When you attempt to use a licensed software, without a valid license the following message is displayed.

Figure 7-7. Temporary License Prompt

You can obtain a temporary license to use the software for a limited period.
To get a temporary license, do the following:

1. Start the un-licensed version of the software. The License Manager window opens (see Temporary
License Prompt ).
2. Select Yes. The Ixia Temporary License wizard opens as shown in the following figure.

Figure 7-8. Temporary License Step 1 – Registration Number

- 74 of 80-
 Getting Started with IxNetwork : Temporary License Installation

3. Configure the following in the Ixia Temporary License dialog box:

a: Select the correct product from the pull-down list.
b: Enter the Company, User Name, and E-Mail address. The Node Name is the workstation or
chassis where the licensed product is used. The License Location is where the license is installed.
Both fields can be a hostname or IP address. In some cases, by default it is set to localhost and
cannot be changed.
c: A valid email address must be entered in the E-Mail field (for example, [email protected]). The
email address must be one from the company that is licensing the software. No private email
addresses (for example, [email protected]) are accepted.
d: Click Next.
The following window opens. Verify the information that is displayed.

Figure 7-9. Temporary License Step 2 – Save License

- 75 of 80-
Getting Started with IxNetwork : Temporary License Installation

4. Click Next to install the license. A license file (extension .lic) is installed in the chassis or
workstation specified in Step {Default ¦ Font}{Hyperlink}{Default ¦ Font}. The default installation
directory is C:\Program Files\Ixia\licensing\licenses.
5. After the license has been installed, a Receipt is displayed, similar to the one shown in the
following figure. This is a record of the license's registration. Save the information as a file or a
printout.
Figure 7-10. Temporary License Step 3 – Print Receipt

- 76 of 80-
 Getting Started with IxNetwork : Troubleshooting

6. To save the receipt to disk, press the Save Receipt... button and designate a file. To make a printout
of the receipt, press the Print Receipt... button and select a printer.
7. Press Finish to exit the registration process.
The license is now available for use on the chassis or workstation.

Troubleshooting

NOTE: Please refer to the License Management User Guide for any additional information
on troubleshooting license management issues.

Disk ID Reset Utility

If the IxNetwork application is installed on a chassis with an invalid Volume Serial Number (VSN), then the setdiskid
utility will launch automatically during the installation of the application. After the VSN has been changed, the user will be
prompted to reboot the chassis. Upon rebooting, an autoupdate utility will then run and will check for any licenses that
exist, based on the old VSN. If licenses exist, the utility will automatically de-register/re-register the licenses and inform
the user that the process is complete.
When the utility is run at the time of the IxNetwork license installation, a dialog box similar to the one shown in the
following figure is displayed.

Figure 7-1. Set Disk ID Warning

Select OK to continue with the change in the Disk ID number, or select Cancel to retain the old Disk ID. When finished,
a dialog box similar to the one shown in the following figure is displayed.

Figure 7-2. Set Disk ID Complete

Select OK to complete the process.

The old disk ID number is stored in a file called restorediskid.bat. By running this batch file, the user can restore the
old disk ID.

NOTE: Changing the Disk ID requires that you re-register all licensed applications on the
chassis. To assist in this process, a script is included with the Licensing that de-registers and

- 77 of 80-
Getting Started with IxNetwork : Disk ID Reset Utility

re-registers all existing Ixia licenses automatically. The utility is named UpdateUtil.exe and
is located at C:\Program Files\Ixia\Licensing.
This utility is automatically run if the Disk ID is reset.

- 78 of 80-
 Getting Started with IxNetwork: Index

Index

I
IRU 65
Ixia registration utility (IRU) 65
IxNetwork installation 20
IxNetwork International Language Support 20
IxNetwork silent installation 28
IxRouter
Installation 63
L
licensing scenarios
workstation/chassis offline 70
workstation/chassis online 69
P
Python client installation 27
R
registering licenses 65

- 79 of 80-