OPNET Modeler Installation Instructions

Choose the platform for your installation: Installation Instructions for OPNET Modeler on Windows Installation Instructions for OPNET Modeler on Linux

Installation Instructions for OPNET Modeler on Windows

These installation instructions apply to OPNET Modeler Release 17.5. Installing OPNET Modeler on Windows applies to all installations. Installing and Configuring a Compiler applies to all installations. Adding Licenses for a First-Time Installation applies only if you make specific licensing choices during the installation procedure. Viewing Online Product Documentation describes the web-browser requirements for viewing the online product documentation. You can find the latest version of these installation instructions on Riverbed Support (support,riverbed.com).

NoteAfter installing this release, we strongly recommend that you read the Release Notes in the product documentation. The Release Notes contain important information about new features, enhancements, and significant changes from the previous release. This information might be especially important if you want to use models and files that were created in the previous release.

NoteIf you are upgrading from a release prior to 15.0, you must perform a license file upgrade. For more information, see Riverbed Support.

NoteIf you are installing OPNET Report Server with OPNET Modeler, we recommend that you install and configure Report Server before you install OPNET Modeler. The Report Server installation configures the Report Server port that is referenced when you install OPNET Modeler. For more information, see Report Server Installation Instructions.

2013 Riverbed Technology

Installing OPNET Modeler on Windows

Use the following procedure to install OPNET Modeler from the OPNET CDs/DVDs.
Procedure IN-1 Installing OPNET Modeler on Windows 1 Log in as Administrator before inserting a CD/DVD. 2 If you plan to use Report Server, install it now. (See Report Server Installation Instructions that come with the Report Server install package.) 3 Insert the Modeler Software CD/DVD in your CD/DVD-ROM drive. The installation program should start automatically. If it does not start, double-click on the icon that represents the CD/DVD-ROM and click on the setup.exe icon. You are prompted for a directory in which to install the software. Typically, the install directory is C:\Program Files\OPNET. However on Windows Server 2008, Windows Vista, and Windows 7, the default install directory is C:\OPNET. NoteOPNET documentation refers to the installation directory as <install_dir>. 4 When prompted to specify the type of licensing system to install, the following might help you decide: Standalone is recommended if you are the only OPNET user. Floating: access licenses from remote server is the correct choice if you already have an OPNET license server running on a remote machine and you want this installation to get its licenses from that machine. Floating: serve licenses from this computer is the correct choice if the current machine will be the license server. 5 When the software install is complete, run the following installers, in this order: NoteYou must install all components in the same directoryfor example, C:\Program Files\OPNET. NoteMake sure that you install all of the following components before you run OPNET Modeler: Modeler Software OPNET Development Kit (only if you have an ODK license) OPNET Model Library OPNET Modeler Documentation 6 If installing on Windows 2000, reboot the machine after the installation. Failing to reboot the Windows 2000 machine may cause OPNET Modeler to behave unpredictably. End of Procedure IN-1

2013 Riverbed Technology

Installing and Configuring a Compiler

You must install an external compiler if you want to develop your own process, pipeline, and other types of models. Configuration requirements are highly platformand compiler-specific. For information about supported compilers, go to support.riverbed.com/software, go to the OPNET Modeler page, and follow the System Requirements link under Related Information. For information about configuring specific compilers, go to support.riverbed.com and follow the Knowledge Base link. You might find the following FAQs especially useful: S20337What are the proper system environment settings for Microsoft Visual Studio 2008 compiler to work with release 14.5 or later (for 32-bit and 64-bit Windows)? S20336How do I configure my Windows environment variables for MSVS 2008 Express Edition for 32- and 64-bit machines to run Modeler 14.5? S20335What are the proper system environment settings for Microsoft Visual Studio 2005 compiler to work with release 12.0 or later? S20295What are the proper system environment settings for Microsoft's Visual Studio .NET 2003 compiler?

2013 Riverbed Technology

Adding Licenses for a First-Time Installation

Do this procedure only if you chose one of the following options when prompted to specify the type of licensing system: Standalone Floating: serve licenses from this computer
Procedure IN-2 Adding Licenses 1 Start the License Manager (Start > Programs > OPNET Modeler 17.5 > License Manager). The License Manager dialog box appears. 2 Choose Tools > Register New License and follow the on-screen prompts. NoteMore detailed instructions for adding licenses are posted at Riverbed Support (support.riverbed.com). End of Procedure IN-2

2013 Riverbed Technology

Viewing Online Product Documentation

The online product documentation requires a web browser that supports HTML frames and JavaScript. The following browsers have been tested: Internet Explorer 5.x and higher Safari 5.x and earlier Netscape 7.x and 8.x Opera 7.54u2 and 8.x Mozilla Firefox 1.x or higher Other browsers might also work, but they have not been tested.
Configuring the Browser

If you experience problems viewing and/or navigating the online product documentation, try the following: Configure the browser so that it always accepts cookies. If the text is too small, increase the browser's default font size. To use a different font for the help text, change your browser's default font. If text or graphics become unclear or distorted, use the browsers Refresh option. All online product documentation features (including the display of the current topic and related topics in PDF using Adobe Acrobat) function correctly with the default settings of the tested browsers. If you experience unexpected behavior, restore the browsers default settings.

2013 Riverbed Technology

Installation Instructions for OPNET Modeler on Linux

These installation instructions apply to OPNET Modeler Release 17.5. Installation Notes includes notes for installing on different Linux platforms. Installing OPNET Modeler on Linux applies to all installations. Adding Licenses for a First-Time Installation applies only if you make specific licensing choices during the installation procedure. Configuring OPNET Modeler to Run Automation Tasks applies only if you have a license for the Automation module. Viewing Online Product Documentation describes the web-browser requirements for viewing the online product documentation. You can find the latest version of these installation instructions on Riverbed Support (support.riverbed.com).

NoteAfter installing this release, we strongly recommend that you read the Release Notes in the product documentation. The Release Notes contain important information about new features, enhancements, and significant changes from the previous release. This information might be especially important if you want to use models and files that were created in the previous release.

NoteIf you are upgrading from a release prior to 15.0, you must perform a license file upgrade. For more information, see Riverbed Support.

NoteIf you are installing OPNET Report Server with OPNET Modeler, we recommend that you install and configure the Report Server before you install OPNET Modeler. The Report Server installation configures the Report Server port that is referenced when you install OPNET Modeler. For more information, see Report Server Installation Instructions.

2013 Riverbed Technology

Installation Notes
If you are installing OPNET Modeler on a 64-bit Linux platform

You must ensure that the 32-bit version of the following package is installed: xorg-x11 (provides 'libX11.so.6') If this library is not installed, OPNET Modeler might not run and instead may show error messages about missing libraries or files. You can install this package using your system's package manager (such as yum on Fedora or up2date on Red Hat Enterprise Linux). For more information about installing packages, refer to the product documentation for your specific platform. The full package names for these 32-bit versions have suffixes such as .i386 and .i686. To use these files, you might also need to install additional packages as dependencies.
If you are installing OPNET Modeler on Red Hat Enterprise Linux 6

You must ensure that the following packages are installed: glibc.i686 glibc-devel.i686 libX11.i686 libXmu.i686 libXext.i686 libXtst.i686 libXi.i686 libXau.i686 libxcb.i686 xorg-x11-fonts-75dpi.noarch libXrender.i686

2013 Riverbed Technology

Some of the listed packages may be missing, depending upon the Red Hat Enterprise Linux installation options. If any of the listed packages are not installed, OPNET Modeler might not run and will instead show error messages about missing libraries or files. NoteTo use these files, you might also need to install additional packages as dependencies. To check if packages are installed, use your systems package manager. For example, in yum, use the following command:
yum list installed <package name>

For any missing packages, use your systems package manager to install them. For example, you can use the following command in yum:
yum install <package name>

For more information about checking for or installing packages, refer to the product documentation for your specific platform.

2013 Riverbed Technology

Installing OPNET Modeler on Linux

WARNINGBefore you install OPNET Modeler 17.5, verify that you have a supported version of Linux installed as well as any required system patches. For information about system requirements, go to the OPNET Modeler page on Riverbed Support (support.riverbed.com) and follow the System Requirements link. Use the following procedure to install OPNET Modeler from the OPNET CDs/DVDs.
Procedure IN-3 Installing OPNET Modeler on Linux 1 Log in as root. 2 Verify that the root account is setup for graphical display: 2.1 Check that the DISPLAY shell variable is setup appropriately. NoteBecause this check is shell-specific and environment-specific, it may be best to verify the setting with your system administrator. 3 If you plan to use Report Server, install it now. (See Report Server Installation Instructions.) 4 Run the Software installer. 4.1 Insert the Software installation CD/DVD in your CD/DVD-ROM drive. 4.2 Move to the root directory on the CD/DVD. The method for moving to the root directory depends in part on the version of Linux and the type of hardware installed. The most common method for Red Hat Linux is as follows: First, mount the CD/DVD-ROM drive by entering the following command: # mount /media/cdrom Then enter the following commands: # cd /media/cdrom NoteThe method for accessing the root directory on the CD/DVD might differ depending on your specific machine and configuration. If you have problems moving to this directory, contact your system administrator. 4.3 Enter the following command: # ls *lin* The command window shows the file name of the Linux installer. For example: modeler_171A_PL1_6217_linux86.bin 4.4 Enter the full file name of the installer at the command prompt, using the following syntax. Be sure to include the ./ path prefix and the *bin file name suffix:

2013 Riverbed Technology

# ./<filename>.bin The installer wizard appears and guides you through the installation process. 4.5 When you are prompted to specify the type of licensing system to install, the following might help you decide: Standalone is recommended if you are the only OPNET user. Floating -- access licenses from remote server is the correct choice if you already have an OPNET license server running on a remote machine and you want this installation to get its licenses from that machine. Floating -- serve licenses from this computer is the correct choice if the current machine will be the license server. 4.6 When the installation wizard finishes installing, click Done. 4.7 In the command prompt window, change directories to /tmp to allow the CD/DVD to be ejected. 4.8 Eject the CD/DVD with the eject command. 5 Set the users PATH variable to point to the directory where the OPNET Modeler binary executable files are stored. For example, if you installed OPNET Modeler in the directory /usr/opnet, you would run the following command for csh or tcsh: setenv PATH /usr/opnet/17.5.A/sys/unix/bin:$PATH NoteThe specific command for setting the PATH environment variable might differ, depending on the specific shell you are using. 6 Do step 4.1 through step 4.8 for all installers in the package. NoteMake sure that you install all of the following components before you run OPNET Modeler: Modeler software OPNET Development Kit (only if you have an ODK license) OPNET Model Library OPNET Modeler Documentation End of Procedure IN-3

10

2013 Riverbed Technology

Adding Licenses for a First-Time Installation

Do this procedure only if you chose one of the following options when prompted to specify the type of licensing system: Standalone Floating -- serve licenses from this computer
Procedure IN-4 Adding Licenses 1 Set permissions for the OPNET license directory: 1.1 Verify that you are logged in as root on the host where you want to install the licenses. 1.2 Verify that the opt/OPNET_license directory exists: Enter the following command to see if the directory exists: # ls /opt If the OPNET_license directory is not listed in the output, create the directory by entering the following command: # mkdir /opt/OPNET_license 1.3 Set permissions on the directory by entering the following command: # chmod 777 /opt/OPNET_license 2 Log in to a user account; if you have not already done so, modify the users PATH as described in step 5 of Procedure IN-3. 3 Launch the License Manager by typing the command:
op_license_manager

The License Manager appears. 4 Choose Tools > Register New License and follow the on-screen prompts. NoteMore detailed instructions for adding licenses are posted at Riverbed Support (support.riverbed.com). End of Procedure IN-4

2013 Riverbed Technology

11

Configuring OPNET Modeler to Run Automation Tasks

NoteThis section applies only if you have a license for the Automation module. When running on Linux, OPNET Modeler requires an X display to run an automation task. If the task is launched while a user is logged on to the Linux host, OPNET Modeler can use the X display of that user. If no one is logged on, however, OPNET Modeler does not have access to a user display. To run automation tasks even when no one is logged on, you must install and configure a virtual frame buffer on the host. To do this, perform the following procedures: 1) Procedure IN-5 Installing a Virtual Frame Buffer on the Linux Host on page 12 2) Procedure IN-6 Configuring OPNET Modeler to use the Virtual Buffer Display on page 13

Procedure IN-5 Installing a Virtual Frame Buffer on the Linux Host 1 Download the Xvfb program from http://www.xfree86.org. You should download the version of Xvfb that corresponds to your X server. 2 Copy Xvfb to the following location on the Linux host: /usr/X11R6/bin 3 Choose a screen that will be dedicated to Xvfb. (NOTEThe following steps assume that screen 1 is chosen.) 4 Create the file /etc/init.d/xvfb that contains the following text: #!/bin/sh mode=$1 case "$mode" in 'start') # start the X Virtual Framebuffer (Xvfb) if [ -f /usr/X11R6/bin/Xvfb ]; then echo "***Starting up the Virtual Frame Buffer on Screen 1***" /usr/X11R6/bin/Xvfb :1 -screen 0 1152x900x8 & fi ;; *)

12

2013 Riverbed Technology

echo echo echo exit ;;

" Usage: " " $0 start (start XVFB)" " $0 stop (stop XVFB - not supported)" 1

esac exit 0 ----5 Create a soft link to a file in the appropriate run-level directory. For example, to make Xvfb execute at run level 5, run the following command: ln -s /etc/init.d/xvfb /etc/rc5.d/S75xvfb 6 Reboot the Linux system. End of Procedure IN-5

Procedure IN-6 Configuring OPNET Modeler to use the Virtual Buffer Display 1 If you have not already done so, perform Procedure IN-5 Installing a Virtual Frame Buffer on the Linux Host on page 12. 2 Start OPNET Modeler. 3 Select Automation > Configure/Run Automation Tasks. 4 Click the "Display Settings" button. 5 Enter the display name for Xvfb. For example, if your host name is "my_local_host" and Xvfb is running on screen 1, you would enter the following string: my_local_host:1 6 Click OK in the Display Settings dialog box, then click OK in the Configure/Run Automation Tasks dialog box. During automated task execution, OPNET Modeler will send its windows to Xvfb. To view the "screen" at any time, you can run the following command: xwd -display :1 -root -out image.xwd End of Procedure IN-6

2013 Riverbed Technology

13

Viewing Online Product Documentation

The online product documentation requires a web browser that supports HTML frames and JavaScript. The following browsers have been tested: Internet Explorer 5.x and higher Safari 5.x and earlier Netscape 7.x and 8.x Opera 7.54u2 and 8.x Mozilla Firefox 1.x or higher Other browsers might also work, but they have not been tested.
Configuring the Browser

If you experience problems viewing and/or navigating the online product documentation, try the following: Configure the browser so that it always accepts cookies. If the text is too small, increase the browser's default font size. To use a different font for the help text, change your browser's default font. If text or graphics become unclear or distorted, use the browsers Refresh option. All online product documentation features (including the display of the current topic and related topics in PDF using Adobe Acrobat) function correctly with the default settings of the tested browsers. If you experience unexpected behavior, restore the browsers default settings.

14

2013 Riverbed Technology