QualNet 4.0 InstallationGuide

QualNet 4.
0 Installation Guide
December 7, 2006
Scalable Network Technologies, Inc.

6701 Center Drive West, Suite 520
Los Angeles, CA 90045
Phone: 310-338-3318
Fax: 310-338-7213
http://www.scalable-networks.com
http://www.qualnet.com
Copyright Information
© 2006 Scalable Network Technologies, Inc. All rights reserved.
QualNet is a registered trademark of Scalable Network Technologies, Inc.
All other trademarks and trade names used are property of their respective companies.
Scalable Network Technologies, Inc.

6701 Center Drive West, Suite 520
Los Angeles, CA 90045
Phone: 310-338-3318
Fax: 310-338-7213
http://www.scalable-networks.com
http://www.qualnet.com
ii
Table of Contents
Preface ......................................................................................... v
Installation Guide for Windows ..................................................... 1

System Requirements .................................................................................................. 1
Installing QualNet ......................................................................................................... 2
Installing Third-Party Software .................................................................................... 8
Java Support ............................................................................................................... 8
C++ Compiler .............................................................................................................. 8
Setting Environment Variables .................................................................................... 8
Compiling and Testing ................................................................................................. 9
Compiling from Command Line................................................................................... 9
Compiling 32-bit QualNet ........................................................................................ 9
Compiling 64-bit QualNet ...................................................................................... 10
Compiling from GUI................................................................................................... 11
Testing QualNet ........................................................................................................ 14
Installing and Activating Addons .............................................................................. 14
Installing Addons....................................................................................................... 15
Activating Addons ..................................................................................................... 15
Debugging ................................................................................................................... 16
Debugging in Microsoft Visual C++ .NET 2002 or Later ........................................... 16
Debugging in Microsoft Visual C++ 2005.................................................................. 17
Helpful Links ............................................................................................................... 18
Installation Guide for Linux/Solaris/Mac OS X ............................ 19

System Requirements ................................................................................................ 19
Linux .......................................................................................................................... 19
Solaris ....................................................................................................................... 20
Table of Contents iii

Mac OS X.................................................................................................................. 20
Installing QualNet ....................................................................................................... 21
Installing Third-Party Software .................................................................................. 22
Java Support ............................................................................................................. 22
C++ Compiler ............................................................................................................ 22
Setting Environment Variables .................................................................................. 22
Compiling and Testing ............................................................................................... 24
Installing and Activating Addons .............................................................................. 25
Installing Addons....................................................................................................... 25
Activating Addons ..................................................................................................... 26
Debugging ................................................................................................................... 26
Helpful Links ............................................................................................................... 26
iv QualNet 4.0 Installation Guide

Preface
QualNet 4.0 Installation Guide describes the system requirements, installation process, compilation,
running, and debugging QualNet on Windows and UNIX/Linux systems.
QualNet Document List

The following list shows the QualNet documentation set and offers a brief description of each document.
QualNet 4.0 API Reference Guide This reference guide describes the function and parameters of
QualNet APIs.
QualNet 4.0 Distributed Reference Guide This guide gives instructions for running QualNet on a distributed
architecture.
QualNet 4.0 Installation Guide This guide provides detailed steps for installing QualNet 4.0 on
UNIX/Linux/MAC and Windows platforms.
QualNet 4.0 Product Tour This document is designed to quickly cover the basic features of
QualNet 4.0 for experienced network modelers. It includes
exercises and example scenarios.
QualNet 4.0 Programmer’s Guide This is a guide to the QualNet programming interface and functions,
allowing users to develop and customize protocol models.
QualNet 4.0 User’s Guide This guide is a detailed look at the QualNet 4.0 environment and
works in combination with the new QualNet Model Libraries set of
documents to provide extensive information on QualNet protocols
for the 4.0 release.
Preface v
QualNet 4.0 Model Libraries This set of documents contains detailed reference information on all
of the protocols and models used in QualNet 4.0. The set of
documents includes the following protocol libraries. See QualNet
4.0 Index to Model Libraries for an alphabetical list of all our
protocols and models and a reference to which library they can be
found in.
Advanced Propagation - ALE/ASAPS
Advanced Propagation - TIREM
Advanced Propagation - Urban Propagation
Advanced Wireless
Cellular
Developer
Military Radios
Multimedia and Enterprise
Network Emulation Interface
Satellite
Standard Interfaces
Wireless
Document Conventions
QualNet documents use the following conventions:
Book Title The title of a book. On the web and on the Instant
Information CD, it may be a hot link to the book itself.
Command Input A command name or qualified command phrase, daemon,
file, or option name.
Command Output Text displayed by the computer.
Note: Information of special interest.
[]{} In syntax definitions, square brackets indicate items that are

optional and braces indicate items that are required.
Code Segment Segment of code from QualNet source files used for
illustration.
Added Code Example of code that the user should add to existing
QualNet functions and declarations to add a custom model
to QualNet. A vertical margin in the left column indicates
new lines of code that need to be added.
Ellipses (...) Ellipses are used to indicate lines of code from QualNet
source files that have been omitted from an example for the
sake of brevity.
vi QualNet 4.0 Installation Guide

More Information
This section describes how to contact us for more information on QualNet products and documentation. It
provides links to helpful QualNet sites and information on getting in touch with QualNet.
• For more information on QualNet products, please contact QualNet Sales at sales@scalable-
networks.com or visit the Scalable Network Technologies website (www.scalable-networks.com) and
click on Products.
• For help on QualNet products, please contact QualNet Support at support@scalable-networks.com or
visit the Scalable Network Technologies website (www.scalable-networks.com) and click on Training
and Support.
• For help on QualNet documentation, please contact QualNet Support at support@scalable-
networks.com or visit the Scalable Network Technologies website (www.scalable-networks.com) and
click on Documentation.
Preface vii
viii QualNet 4.0 Installation Guide
1 Installation Guide for Windows
This section covers the system requirements, installation process, compilation, running, and debugging
QualNet on Windows.
1.1 System Requirements

QualNet is supported on Windows 2000 Professional, Windows XP (Home and Professional), and
Windows XP Professional x64 Edition. The minimum platform requirements to run QualNet on a Windows
system are listed in Table 1-1.
TABLE 1-1. QualNet Minimum Requirements for Windows
Item Requirements
CPU x86 compatible (including Intel Core Duo, Pentium, Xeon,
and AMD Athlon).
Or
AMD64 compatible (including AMD Opteron, Athlon 64, Intel
Core 2 Duo, and Pentium/Xeon EM64T) .
Memory - 512 MB for simulations of networks with up to 100 nodes.
- 768 MB for simulations of networks with up to 250 nodes.
- 1 GB for simulations of networks with up to 1000 nodes.
Disk 500 MB free disk space.
Java Sun Java™ 2 SDK, Standard Edition, version 1.4.2 or higher.
C++ Compiler Microsoft Visual C++ .NET 2002 or higher.
The following is the recommended configuration to run QualNet on Windows:

• 3.2 GHz Pentium 4, or an equivalent AMD chip
• 1 GB memory
• 700 MB free disk space
• Sun Java™ 2 SDK, Standard Edition, version 1.4.2
• Microsoft Visual C++ .NET 2002 or higher
Installation Guide for Windows 1

Installation Guide for Windows
1.2 Installing QualNet

To install QualNet on Windows, perform the steps listed below.
Notes:
a. The examples in this installation guide use the filename for the QualNet 4.0 Commercial
Release. Users may need to modify the filename to match the name of the file delivered.
b. For help with installation procedures or problems, contact support@scalable-networks.com.
1. Download the installation package (file qualnet-4.0-commercial-installer.exe) from the QualNet

download page or load it from the installation CD.
2. Double click on the file qualnet-4.0-commercial-installer.exe.
3. After reading the license agreement, agree to it by selecting the “I accept…” option in the License
Agreement dialog box and click Next.
2 QualNet 4.0 Installation Guide

4. The ReadMe information dialog box is displayed. Click Next.
5. Select the components to install in the Choose Components dialog box.The default type of install is
Full. Click Next. (It is recommended that you select Desktop Shortcuts. Although this is not required, it
will make compilation from command line easier.)

6. The Destination Folder dialog box is displayed. Select an installation folder and click Install to begin
the installation.
Note: The default folder is C:\qualnet\4.0.
In the rest of this guide, QUALNET_HOME refers to the folder where QualNet is installed.
Note: If any of the setup information needs to change, click Back to make those changes.

7. The following screen will be displayed while QualNet installs:
8. The installer will ask the user to copy the license file to the license directory so that QualNet may be
executed after the installation is complete.
If a license server is not used, the license file name is of the form qualnet-<date>.lic, where <date> is
the license expiration date. For example, the license file may be named qualnet-2007.03.31.lic. If a
license server is used, the license file name is of the form client-<ip-address>.lic, where <ip-address> is
the IP address of the client.
Copy the license file into QUALNET_HOME\license_dir, where QUALNET_HOME is the directory
where QualNet is installed.
Notes:
a. Be sure to check the file extension on your license file. It should end in “.lic”. Depending on
your system and method of copying, you may end up with an extra extension, such as qualnet-
-2007.03.31.lic.txt, which will not work.

b. If this file cannot be located, inquire with the purchaser of QualNet. For users with the
evaluation version of QualNet, the license file is sent as an email attachment from Scalable
Network Technologies.
c. If a license server is used, follow the instructions provided with the license files to install the
server and client license files.
9. Once the installation process has finished, the following screen will be displayed:
Click Next.

10. The following screen will be displayed:
Select from the options and click Close.
The Installer will place the following two icons on the desktop if the Desktop Shortcuts option was selected
in Step 5:

1.3 Installing Third-Party Software

QualNet requires Java support and a C++ compiler to run. This section describes how to install the
required software on a Windows system.
1.3.1 Java Support

Sun Java 2 SDK, Standard Edition, version 1.4.2 or higher, is required to run the QualNet graphical tools.
• To install Java 2 SDK, Standard Edition, version 1.4.2, go to the following URL:
http://java.sun.com/j2se/1.4.2/download.html
and download J2SE Software Development Kit (SDK).
http://java.sun.com/j2se/1.5.0/download.jsp
and download JDK 5.0.
1.3.2 C++ Compiler

To compile QualNet source code or custom addons, one of the following versions of Visual C++ is
required:
• Microsoft Visual C++ .NET 2002 or later (installed alone or with Visual Studio .NET)
• Microsoft Visual C++ 2005 Express Edition
To use Microsoft Visual C++ 2005 Express Edition, Windows Platform SDK must also be installed. Both
Microsoft Visual C++ 2005 Express Edition and Windows Platform SDK are available as free downloads
at:
http://msdn.microsoft.com/vstudio/express/visualc/
The INCLUDE and LIB environment variables must be set to their respective paths within the Windows
Platform SDK installation (see Section 1.4).
1.4 Setting Environment Variables

To set the QualNet environment variables on Windows systems, perform the following steps:
1. Go to System Properties > Advanced > Environment Variables.
2. Define the environment variable QUALNET_HOME to be the root directory of the QualNet distribution.
3. Add the directories QUALNET_HOME\bin and QUALNET_HOME\gui\bin to the system path.
In addition, if you are using Microsoft Visual C++ 2005 Express Edition, then update the following
environment variables (this assumes that Windows Platform SDK was installed at the default location):
4. Update the INCLUDE environment variable to include the following:
C:\Program File\Microsoft Platform SDK\Include
5. Update the LIB environment variable to include the following:
C:\Program File\Microsoft Platform SDK\Lib

1.5 Compiling and Testing
It is not necessary to compile QualNet on WIndows if the initial installation is used with the default options.
However, QualNet will need to be recompiled if modifications are made or custom protocols or addons are
included. To compile QualNet from the command line, follow the instructions given in Section 1.5.1. If
Microsoft Visual C++ 2005 Express Edition is installed, QualNet can also be compiled from the Visual C++
2005 Express Edition GUI by following the instructions given in Section 1.5.2. After compiling Qualnet, test
the build, as described in Section 1.5.3.
1.5.1 Compiling from Command Line

QualNet can be compiled from the command line using any of the supported C++ compilers (see
Section 1.3.2). To compile the 32-bit QualNet, follow the instructions given in Section 1.5.1.1. To compile
the 64-bit QualNet, follow the instructions given in Section 1.5.1.2.
1.5.1.1 Compiling 32-bit QualNet

The 32-bit QualNet can be compiled on any of the following platforms:
• Windows 2000 Professional or Windows XP (Home or Professional) with one of the following compilers:
- Microsoft Visual C++ .NET 2002 or higher
- Microsoft Visual C++ 2005 Express Edition with Windows Platform SDK.
• Windows XP Professional x64 Edition with one of the following compilers:
- Microsoft Visual C++ .NET 2005
- Microsoft Visual C++ 2005 Express Edition with Windows Platform SDK.
To compile the 32-bit QualNet from the command line, perform the following steps:
1. If QualNet desktop shortcuts are installed, open the QualNet Developer command window by clicking
on the following icon on the desktop.
Verify that the environment variables are properly set by typing the following command: cl.
The following output verifies that the configuration is correct:
Microsoft (R) 32-bit C/C++ Optimizing Compiler Version 12.x

Copyright (C) Microsoft Corp 1984-1998. All rights reserved.
usage: cl [ option... ] filename... [ /link linkoption... ]
(The compiler version in the above output may differ depending on which version of C++ is installed.)
If the configuration is correct, then skip step 2 and go to step 3.
If a “file not found” error is displayed, then go to step 2.

2. If QualNet desktop shortcuts are not installed or a “file not found” error was displayed in step 1,
open a command window using one of the steps listed below.
• For Microsoft Visual C++ .NET (2002 or higher), use the following command:
Start > All Programs > Visual Studio .NET > Visual Studio Tools > Visual Studio
.NET Command Prompt
• For Microsoft Visual C++ 2005 Express Edition with Windows Platform SDK, use the following
command:
Start > All Programs > Visual C++ 2005 Express Edition > Visual Studio Tools >
Visual Studio 2005 Command Prompt
3. Go to QUALNET_HOME\main directory using the cd command to change directories.

4. Make a copy of the appropriate Makefile.
• For Microsoft Visual C++ .NET 2002 or Microsoft Visual C++ .NET 2003, use the following
command:
copy Makefile-windows-vc7 Makefile
• For Microsoft Visual C++ .NET 2005 or Microsoft Visual C++ 2005 Express Edition with Windows
Platform SDK, use the following command:
copy Makefile-windows-vc8 Makefile
5. Compile QualNet by using the following command (it takes several minutes for QualNet to compile):
nmake
This creates the QualNet executable in the QUALNET_HOME/bin directory. In Windows, the
executable is qualnet.exe.
To recompile QualNet, run nmake again. However, it is sometimes useful to delete all object files before
recompiling. Use the following commands to remove all object (.obj) files and recompile:
nmake clean
nmake
1.5.1.2 Compiling 64-bit QualNet

The 64-bit QualNet can be compiled on Windows XP Professional x64 Edition with one of the following
compilers:
• Microsoft Visual C++ .NET 2005
• Microsoft Visual C++ 2005 Express Edition with Windows Platform SDK
To compile the 64-bit QualNet from the command line, perform the following steps:
1. Open a command window using one of the steps listed below.

• For Microsoft Visual C++ .NET 2005, use the following command:
Start > All Programs > Microsoft Visual Studio 2005 > Visual Studio Tools >
Visual Studio 2005 x64 Win64 Command Prompt
• For Microsoft Visual C++ 2005 Express Edition with Windows Platform SDK, use the following
command:
Start > All Programs > Microsoft Platform SDK ... > Open Build Environment
WIndow > Windows Server 2003 64-bit Build Environment > Set Win Svr 2003
x64 Build Env (Debug)

3. Make a copy of the appropriate Makefile.
copy Makefile-windows-x64-vc8 Makefile
nmake
This creates the QualNet executable in the QUALNET_HOME/bin directory. In Windows, the
executable is qualnet.exe.
To recompile QualNet, run nmake again. However, it is sometimes useful to delete all object files before
recompiling. Use the following commands to remove all object (.obj) files and recompile:
nmake clean
nmake
1.5.2 Compiling from GUI

If Microsoft Visual C++ 2005 Express Edition is installed (see Section 1.3.2), then QualNet can be
compiled from a GUI. To compile QualNet from the Microsoft Visual C++ 2005 GUI, configure the Microsoft
Visual C++ 2005 GUI by performing the steps listed below. This configuration needs to be done only once.

1. Launch Microsoft Visual C++ 2005 Express Edition. Navigate to Tools > Options > Projects and
Solutions > VC++ Directories.
2. For each listing of Executable files, Include files, and Library Files, add the corresponding Platform SDK
paths Bin, Include, and Lib, respectively.
3. Create a file named Makefile in the QUALNET_HOME directory. This Makefile contains commands to
redirect to a makefile in QUALNET_HOME/main.

The new file Makefile should contain the following lines, where the indentations are tabs, not spaces:
all:
cd main
nmake -f Makefile-windows-vc8
rebuild: clean
nmake -f Makefile-windows-vc8
clean:
cd main
nmake -f Makefile-windows-vc8 clean
4. Select File > New > Project from existing code.
Set the prompted values as follows:

• Project name: qualnet
• Folder: C:\qualnet\4.0
• How do you want to build the project?: Use external build system
• Build command line: nmake
• Rebuild command line: nmake rebuild
• Clean command line: nmake clean
• Output (for debugging): bin/qualnet.exe

5. Press Finish.
Once Microsoft Visual C++ 2005 GUI has been configured, it can be used as follows:
• Select Build > Build Solution to build QualNet.
• Select Build > Rebuild Solution to clean the object files and rebuild QualNet.
• Select Build > Clean Solution to clean the object files.
1.5.3 Testing QualNet

To test the QualNet installation on Windows, after compiling, open a command window and use the
following commands:
cd %QUALNET_HOME%\bin
qualnet default.config
Note: If errors are displayed stating "Invalid (inconsistent) license key" or "Invalid
host", please see the FAQ at http://www.scalable-networks.com/distributions/license/faq.php.
1.6 Installing and Activating Addons

Addons are separate components of QualNet which provide enhanced features and functionality. They are
distributed separately, in most cases, and may contain additional source code, pre-compiled library files,
and third party utilities.

QualNet addons fall into into the following classes:
• Libraries: Protocol (model) libraries sold with QualNet
• Interfaces: External interfaces requiring third party software
• Custom addons: Special purpose addon modules and user-developed addons
• Contributed models: Models developed and provided by SNT customers for distribution
This section provides instructions for installing and activating addons on Windows systems.
1.6.1 Installing Addons

To install a QualNet addon on Windows, perform the steps listed below.
Notes:
a. The following instructions are suffcient to install most addons. Some addons may require
additional steps (typically, to install third-party software required by the addon). See the
documentation for the addon for any additional steps that need to be peformed to install the
addon.
b. The section uses the Satellite Library addon as an example. The name of the file for the
Satellite Library addon is qualnet-4.0-Satellite-installer.exe. Users should modify the filename
to match the name of the addon file they want to install.
c. If you purchased QualNet and the addon together, your license file should allow you to run
scenarios with the additional addon functionality. If you purchased the addon separately (at a
later date) and did not receive an updated license file with your purchase, please contact
license@scalable-networks.com.
1. Download the installation package (file qualnet-4.0-Satellite-installer.exe) from the QualNet download
page or load it from the installation CD.
2. Double click on the file qualnet-4.0-Satellite-installer.exe.
3. The ReadMe information dialog box is dsiplayed. Click Next.
4. If you have installed QualNet in the default folder, C:\qualnet\4.0 (step 6 of Section 1.2), then the
addon’s files are automatically placed in the appropriate subdirectories of the QualNet installation
directory. If QualNet was installed in a different lfolder, you will be prompted for the installation location.
5. Once the installation is complete, you will have the option to launch the addon documentation file. Click
Exit.
Note: Check this file for any additional installation instructions and requirements before continuing.
1.6.2 Activating Addons

To activate a QualNet addon on Windows, perform the steps listed below.
1. Open the file QUALNET_HOME/main/Makefile-addons-windows with a text editor.

2. Locate and uncomment the include statement for Makefile for the addon:
For the Satellite Library, change the line
#include ../libraries/satellite/Makefile-windows
to
include ../libraries/satellite/Makefile-windows
3. Recompile QualNet, as described in Section 1.5.
Note: Delete all object (.obj) files before recompiling by using the nmake clean command.
1.7 Debugging
If QualNet crashes, a dialog box message is displayed that gives the user two options.
• Press the OK button to exit the debugger and QualNet.
• Press the Cancel button to start the debugger.
To run the debugger, QualNet must be compiled with the debug option. Perform the following steps to
recompile QualNet with the debug option and run the debugger:
1. Make sure that the QUALNET_HOME environment variable is properly defined. To print the location of
the QualNet root subdirectory, open a command window and run the command:
echo %QUALNET_HOME%
Go to the directory QUALNET_HOME\main.

2. Copy the makefile for your compiler, Makefile-windows-vc7, Makefile-windows-vc8 or Makefile-
windows-x64-vc8 (see Section 1.5.1), to Makefile. Edit Makefile as follows:
• Enable the DEBUG line by removing the ‘#’ character so it is displayed as:
DEBUG = /Zi
• Disable the OPT line by inserting a ‘#’ character at the beginning of the line so it is displayed as:
# OPT = /Ox /Ob2
Note: By default, QualNet is compiled for runtime efficiency.

3. Recompile QualNet by typing the following commands:
nmake clean
nmake
Perform the steps described in Section 1.7.1 if you are using Microsoft Visual C++ .NET 2002 or later.
Perform the steps described in Section 1.7.2 if you are using Microsoft Visual C++ 2005.
1.7.1 Debugging in Microsoft Visual C++ .NET 2002 or Later

If you are using Microsoft Visual C++ .NET 2002 or later, perform the following steps to debug a model:

1. Start Visual C++.
2. Select File > Open, choose executable files, and open QUALNET_HOME\bin\qualnet.exe.
3. Go to the Project > Settings pop-up and select the Debug tab.
4. Set the working directory to QUALNET_HOME\bin, and the command line parameters to the
configuration file for the scenario to be debugged, e.g., myscenario.config.
Note: Make sure the working directory is set to the directory where the configuration file is placed. The
location of the source files does not matter.
5. Start the program by selecting Build > Start Debug > Step Into.
6. When starting the program, several messages in one of the debugger status windows may be displayed
that look like the following:
Loaded 'C:\WINNT\SYSTEM32\COMCTL32.DLL', no matching symbolic information

found.
This is normal.
7. If the following error occurs, the configuration file specified in the Project > Settings window is not in
the working directory specified:
The thread 0x498 has exited with code 3 (0x3).

The program 'C:\qualnet\4.0\bin\qualnet.exe' has exited with code 3 (0x3).
Note: The source code for the main program and many of the utility functions is not available to the
debugger. However, wherever source is available, the breakpoints can be set and the code can be
stepped through.
To step to a particular place in the source code, do the following:

1. After opening qualnet.exe and setting the parameters as specified above, open a source file to debug.
2. Scroll down to the function to debug and leave the cursor there.
3. Choose Build > Start Debug > Run to.
The program should run until it gets to the cursor in the open file. Breakpoints can be set in several files
using the normal Visual C++ Debugger method.
1.7.2 Debugging in Microsoft Visual C++ 2005

If you are using Microsoft Visual C++ 2005, perform the following steps to debug a model:
1. Start Visual C++ 2005.

2. Select Projects > properties > Configuration Properties > Debugging. Set the debug
executable and arguments to qualnet.exe and the .config file, respectively.
3. Set the breakpoints as desired and debug using the commands listed in the Debug menu.
1.8 Helpful Links

Helpful information on installation is available in the Installation & Startup section of QualNet
Community Forums, which are accessible from the following URL:
http://www.scalable-networks.com/training_and_support/support/forums/index.php
QualNet Community Forums require a free registration for access.

2 Installation Guide for Linux/Solaris/Mac OS X
This section covers the system requirements, installation process, compilation, running, and debugging
QualNet on Linux, Solaris, and MAC OS X systems. In the rest of this guide, we will refer to these three
systems by the term UNIX.
Note: This installation guide does not cover the requirements and instructions for installing, compiling,
and running the distributed version of QualNet. See QualNet 4.0 Distributed Reference Guide
for the requirements and instructions for the distributed version of QualNet.
2.1 System Requirements
2.1.1 Linux
QualNet is officially supported on Fedora Core 4, Red Hat Enterprise Linux 4, SUSE Linux versions 9.3,
10.1, and Ubuntu 6.06 on AMD64 and x86 compatible systems. QualNet is also known to work on other
distributions of Linux with glibc version 2.3 and gcc versions 3.2 and higher. The minimum platform
requirements to run QualNet on a Linux system are listed in Table 2-1.
TABLE 2-1. QualNet Minimum Requirements for Linux
Item Requirements
CPU x86 compatible (including Core Duo, Pentium, Xeon, and
Athlon).
Or
AMD64 compatible (including Opteron, Athlon 64, Core 2
Duo, and Pentium/Xeon EM64T) .
Java Sun Java™ 2 SDK, Standard Edition, version 1.4.2 or higher.
C++ Compiler gcc 3.2 or later.
The following is the recommended configuration to run QualNet on Linux:

• 3.2 GHz Pentium 4, or an equivalent AMD chip
• 1 GB memory
• gcc 3.2 or later. See Section 2.3.2 for details.
Installation Guide for Linux/Solaris/Mac OS X 19

Installation Guide for Linux/Solaris/Mac OS X
2.1.2 Solaris
The minimum platform requirements to run QualNet on a Solaris system are listed in Table 2-2.
TABLE 2-2. QualNet Minimum Requirements for Solaris
Item Requirements
CPU Sun SPARC II or higher.
Operating System Solaris 8 or higher.
Java Sun Java™ 2 SDK, Standard Edition, version 1.4.2 or
higher.
C++ Compiler gcc 3.3.
The following is the recommended configuration to run QualNet on Solaris:

• 1.5 GHz CPU
• 1 GB memory
• gcc 3.3
2.1.3 Mac OS X
The minimum platform requirements to run QualNet on a Mac OS X system are listed in Table 2-3.
TABLE 2-3. QualNet Minimum Requirements for Mac OS X
Item Requirements
CPU Apple PowerPC G4 or G5, Intel Core Duo or Xeon.
Operating System Mac OS X 10.4.
Java Sun Java™ 2 SDK, Standard Edition, version 1.4.2 or
higher.
C++ Compiler gcc 4.0 from Xcode 2.3.
The following is the recommended configuration to run QualNet on Mac OS X:

• 2.0 GHz Intel Core Duo CPU
• 1 GB memory

• gcc 4.0
2.2 Installing QualNet

To install QualNet on a UNIX system, perform the steps listed below.
Notes:
a. QualNet is small enough that each user can install a separate copy of the software in their
home directory. QualNet need not be installed in /usr/local or other shared directories.
b. The examples in this installation guide use the filename for the QualNet Commercial Release.
Users may need to modify the filename to match the name of the file delivered.
c. For help with installation procedures or problems, contact support@scalable-networks.com.
1. Download the installation package (file qualnet-4.0-commercial.tar.gz) from the QualNet download
page or load it from the installation CD.
2. Go to the home directory, and extract QualNet using the following command:
gunzip -c qualnet-4.0-commercial.tar.gz | tar xvf -
UNIX users with GNU tar can also use the following command:
tar xvfz qualnet-4.0-commercial.tar.gz
QualNet will be installed in ~/qualnet/4.0.

3. Copy the license file into the QualNet license directory.
If a license server is not used, the license file name is of the form qualnet-<date>.lic, where <date> is
the license expiration date. For example, the license file may be named qualnet-2007.03.31.lic. If a
license server is used, the license file name is of the form client-<ip-address>.lic, where <ip-address> is
the IP address of the client.
Copy the license file into QUALNET_HOME\license_dir, where QUALNET_HOME is the directory
where QualNet is installed.
Notes:
a. Be sure to check the file extension on your license file. It should end in ”.lic”. Depending on
your system and method of copying, you may end up with an extra extension, such as qualnet-
2007.03.31.lic.txt, which will not work.
b. If this file cannot be located, inquire with the purchaser of QualNet. For users with the
evaluation version of QualNet, the license file is sent as an email attachment from Scalable
Network Technologies.
c. If a license server is used, follow the instructions provided with the license files to install the
server and client license files.

2.3 Installing Third-Party Software

QualNet requires Java support and a C++ compiler to run. This section describes how to install the
required software on a UNIX system.
2.3.1 Java Support

Sun Java 2 SDK, Standard Edition, version 1.4.2 or higher, is required to run the QualNet graphical tools.
http://java.sun.com/j2se/1.4.2/download.html
and download J2SE Software Development Kit (SDK).
http://java.sun.com/j2se/1.5.0/download.jsp
and download JDK 5.0.
2.3.2 C++ Compiler

To compile QualNet source code or custom addons, a C++ compiler is required. Install the version of gcc
appropriate for your system as described below.
• For Linux systems, the version of gcc depends on the glibc version of the Linux distribution. QualNet
supports glibc 2.3.x through 2.4.x. To determine your version of glibc, run the following command:
rpm -q glibc
To determine the gcc version required for your system, see:

http://www.scalable-networks.com/products/developer/sysreq.php.
Install the right version of gcc from the Linux installation media or download site. Consult your system
administrator for help with installing gcc.
• For Solaris SPARC systems, install gcc 3.3 from the SPARC CD-ROMs or download it from the
following URL:
http://www.sunfreeware.com/l
• For Mac OS X systems, download Xcode 2 from the download site or install it from the Mac OS X
Installation DVD. Installing Xcode 2 also installs gcc 4.0 on the system.
2.4 Setting Environment Variables

To set the QualNet environment variables on a UNIX system, perform the following steps:
1. Open a command window.
2. Edit the shell startup script. To check which shell you are using, type the following command in a
command window: echo-$SHELL.

• For csh and tcsh
Open ~/.cshrc and add the following lines:
setenv QUALNET_HOME ~/qualnet/4.0

set path = ( $path ~/qualnet/4.0/bin )
• For bash
Open ~/.bashrc and add the following lines:
export QUALNET_HOME=~/qualnet/4.0
PATH=$PATH:~/qualnet/4.0/bin
• For sh
Open ~/.profile and add the following lines:
QUALNET_HOME=/home/username/qualnet/4.0; export QUALNET_HOME

PATH=$PATH:/home/username/qualnet/4.0/bin
Note: Replace/home/username with the absolute path to the home directory if necessary.
3. On some UNIX distributions (e.g, Fedora and Ubuntu), Java may be installed at a non-standard
location. In that case, update the environment variable JDK_HOME to the directory where Java is
installed.
Assuming that Java is installed in the directory ~/myjavadir, edit the shell startup script as follows:
• For csh and tcsh
Add the following line to ~/.cshrc:
setenv JDK_HOME ~/myjavadir
• For bash
Add the following line to ~/.bashrc:
export JDK_HOME=~/myjavadir
• For sh
Add the following line to ~/.profile:
JDK_HOME=/home/username/myjavadir; export JDK_HOME
To test that JDK_HOME has been set correctly, type the following command: $JDK_HOME/bin/java. This
should displayJava’s usage.

2.5 Compiling and Testing

To compile QualNet on a UNIX system, perform the following steps:
1. Open a command window.
3. Make a copy of the original Makefile using the following command:
• For Linux (GNU gcc):
Choose the Makefile for the version of gcc installed on your system.
(To check the version of gcc installed on your system, type the following command in a command
window: gcc -v.)
- For 32-bit Linux machines running gcc versions 3.2 to 3.4, use the following command:
cp Makefile-linux-glibc-2.3-gcc-3.2 Makefile
- For 32-bit Linux machines running gcc version 4.0, use the following command:
cp Makefile-linux-glibc-2.3-gcc-4.0 Makefile
- For 64-bit Linux machines running gcc versions 3.3 and 3.4, use the following command:
cp Makefile-linux-x86_64-glibc-2.3-gcc-3.3 Makefile
- For 64-bit Linux machines running gcc version 4.0, use the following command:
cp Makefile-linux-x86_64-glibc-2.3-gcc-4.0 Makefile
• For Solaris SPARC using gcc 3.3, use the following command:
cp Makefile-solaris Makefile
• For Mac OS X using gcc 4.0 on PowerPC, use the following command:
cp Makefile-darwin-ppc-gcc-4.0 Makefile
• For Mac OS X using gcc 4.0 on Intel, use the following command:
cp Makefile-darwin-x86-gcc-4.0 Makefile
make
This creates the QualNet executable in the QUALNET_HOME/bin directory. In UNIX, the executable is
qualnet.
To recompile QualNet, run make again. However, it is sometimes useful to delete all object files before
recompiling. Use the following commands to remove all object (.o) files and recompile:

make clean
make
To test the QualNet installation on UNIX, use the following commands after compiling:
cd $QUALNET_HOME/bin
./qualnet default.config
Note: If errors are displayed stating "Invalid (inconsistent)license key" or "Invalid

host", or if there is a segmentation fault (this occurs on default installations of Red Hat 9.3 and
above), please see the FAQ at http://www.scalable-networks.com/distributions/license/faq.php.
2.6 Installing and Activating Addons

Addons are separate components of QualNet which provide enhanced features and functionality. They are
distributed separately, in most cases, and may contain additional source code, pre-compiled library files,
and third party utilities.
QualNet addons fall into into the following classes:

• Libraries: Protocol (model) libraries sold with QualNet
• Interfaces: External interfaces requiring third party software
• Custom addons: Special purpose addon modules and user-developed addons
• Contributed models: Models developed and provided by SNT customers for distribution
This section provides instructions for installing and activating addons on UNIX systems.
2.6.1 Installing Addons

To install a QualNet addon on Windows, perform the steps listed below.
Notes:
a. The following instructions are suffcient to install most addons. Some addons may require
additional steps (typically, to install third-party software required by the addon). See the
documentation for the addon for any additional steps that need to be peformed to install the
addon.
b. The section uses the Satellite Library addon as an example. The name of the file for the
Satellite Library addon is qualnet-4.0-Satellite-tar.gz. Users should modify the filename to
match the name of the addon file they want to install.
c. If you purchased QualNet and the addon together, your license file should allow you to run
scenarios with the additional addon functionality. If you purchased the addon separately (at a
later date) and did not receive an updated license file with your purchase, please contact
license@scalable-networks.com.

1. Download the installation package (file qualnet-4.0-Satellite-tar.gz) from the QualNet download page or
load it from the installation CD.
2. Copy the compressed archive file qualnet-4.0-Satellite-tar.gz to the QualNet installation directory, ~/
qualnet/4.0.
3. Extract the contents of the package using the following command:
gunzip -c qualnet-4.0-Satellite.tar.gz | tar xvf -
UNIX users with GNU tar can also use the following command:
tar xvfz qualnet-4.0-Satellite.tar.gz
The extracted files will be automatically placed int he appropriate subdirectories.
Note: Check the addon documentation for any additional installation instructions and requirements
before continuing.
2.6.2 Activating Addons

To activate a QualNet addon on UNIX, perform the steps listed below.
1. Open the file QUALNET_HOME/main/Makefile-addons-unix with a text editor.
2. Locate and uncomment the include statement for Makefile for the addon:
For the Satellite Library, change the line
#include ../libraries/satellite/Makefile-unix
to
include ../libraries/satellite/Makefile-unix
3. Recompile QualNet, as described in Section 2.5.
Note: Delete all object (.o) files before recompiling by using the make clean command.
2.7 Debugging
QualNet can be run from within gdb or dbx.
The UNIX Makefiles already contain the -g compiler option to include debugging information in the
QualNet executable.
2.8 Helpful Links

Helpful information on installation is available in the Installation & Startup section of QualNet
Community Forums, which are accessible from the following URL:
http://www.scalable-networks.com/training_and_support/support/forums/index.php
QualNet Community Forums require a free registration for access.

QualNet 4.0 InstallationGuide

Uploaded by

Copyright:

Available Formats

QualNet 4.0 InstallationGuide

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

QualNet 4.0 InstallationGuide

Uploaded by

Copyright:

Available Formats

QualNet 4.

Scalable Network Technologies, Inc.

© 2006 Scalable Network Technologies, Inc. All rights reserved.

QualNet is a registered trademark of Scalable Network Technologies, Inc.

Scalable Network Technologies, Inc.

Installation Guide for Windows ..................................................... 1

Installation Guide for Linux/Solaris/Mac OS X ............................ 19

Table of Contents iii

iv QualNet 4.0 Installation Guide

QualNet Document List

[]{} In syntax definitions, square brackets indicate items that are

vi QualNet 4.0 Installation Guide

1.1 System Requirements

TABLE 1-1. QualNet Minimum Requirements for Windows

The following is the recommended configuration to run QualNet on Windows:

Installation Guide for Windows 1

1.2 Installing QualNet

1. Download the installation package (file qualnet-4.0-commercial-installer.exe) from the QualNet

2 QualNet 4.0 Installation Guide

Installation Guide for Windows 3

4 QualNet 4.0 Installation Guide

Installation Guide for Windows 5

6 QualNet 4.0 Installation Guide

Select from the options and click Close.

Installation Guide for Windows 7

1.3 Installing Third-Party Software

1.3.1 Java Support

1.3.2 C++ Compiler

1.4 Setting Environment Variables

8 QualNet 4.0 Installation Guide

1.5.1 Compiling from Command Line

1.5.1.1 Compiling 32-bit QualNet

Microsoft (R) 32-bit C/C++ Optimizing Compiler Version 12.x

usage: cl [ option... ] filename... [ /link linkoption... ]

Installation Guide for Windows 9

3. Go to QUALNET_HOME\main directory using the cd command to change directories.

copy Makefile-windows-vc7 Makefile

copy Makefile-windows-vc8 Makefile

1.5.1.2 Compiling 64-bit QualNet

10 QualNet 4.0 Installation Guide

2. Go to QUALNET_HOME\main directory using the cd command to change directories.

copy Makefile-windows-x64-vc8 Makefile

1.5.2 Compiling from GUI

Installation Guide for Windows 11

12 QualNet 4.0 Installation Guide

4. Select File > New > Project from existing code.

Set the prompted values as follows:

Installation Guide for Windows 13

1.5.3 Testing QualNet

1.6 Installing and Activating Addons

14 QualNet 4.0 Installation Guide

1.6.1 Installing Addons

1.6.2 Activating Addons

Installation Guide for Windows 15

3. Recompile QualNet, as described in Section 1.5.

Go to the directory QUALNET_HOME\main.

# OPT = /Ox /Ob2

Note: By default, QualNet is compiled for runtime efficiency.

1.7.1 Debugging in Microsoft Visual C++ .NET 2002 or Later