Installation of OMNeT++ and IPSuite

helmetpastoralSoftware and s/w Development

Dec 13, 2013 (3 years and 9 months ago)

99 views

Installation of OMNeT++

and IPSuite


This document aims to give the necessary steps in order to install OMNeT++

and the IPSuite
simulation model
. Unstable versions of OMNeT++ (alpha, beta, etc.) are not delivered in binary format
and so must entirely be co
mpiled. This document presents especially the installation of the version 3.0
alpha 3 of OMNeT++ (release of 03/22/2004) under a Microsoft based platform. The computer used
runs with the XP version of Windows (including SP1) with
Microsoft Visual C++ (vers
ion 6.0).

The
IPSuite version used here is can only be run with OMNeT++ v3.0 alpha 3: t
he simulation model is a
snapshot of 03/22/2004.


The configuration of th
e

computer
used
is:

-

Processor: Intel Pentium III E @800MHz

-

Memory: SD
-
Ram PC100 4x128Mo (512Mo)

-

Motherboard
:
AsusTek CUBX
-
L Intel i440BX

-

Video: nVidia Riva TNT2 64 Pro

-

HDD: 40Go

-

Ethernet: 3Com EtherLink XL 10/100 PCI

-

Etc.

I.
Microsoft Visual C++
:

It is recommended to have the Microsoft Visual C++ software installed on the computer, if not,
just find
an already running version on an other computer and copy the “Common” and “VC98” folders (by
default these folders are in the “C:
\
Program Files
\
Microsoft Visual Studio” folder). In the case where
the Microsoft Visual C++ software was not installed you must

copy the two following files: “RC.exe”
and “RCDLL.dll” from the “Common
\
MSDev98
\
Bin” folder into the “
VC98
\
Bin” folder. By precaution,
you can run the “VCVARS32.bat” batch program located in the “VC98” folder: this batch will include
the compiler as being

executable from anywhere. Then some environment variables must be added
(Configuration Panel


System


Advanced


Environment variables):

-

Name:

INCLUDE

, Value:
“C:
\
Program Files
\
Microsoft Visual Studio
\
VC98
\
Include”

-

Name: “LIB”, Value: “C:
\
Program File
s
\
Microsoft Visual Studio
\
VC98
\
Lib”

-

Name: “Path”, Value: “C:
\
Program Files
\
Microsoft Visual Studio
\
VC98
\
Bin”

Of course values indicated here must be changed if your Microsoft Visual C++ program is not installed
in the same directory than above.

II. Require
d components:

Some components are required because not included in this distribution of OMNeT++. It is possible
that one or two components are not very useful for OMNeT++ but they can become with a
model
(IPSuite for example).

You can create a “Tools” fold
er to install inside the different components, our
“Tools” folder is here located in “C:
\
Tools”.

a. ActivePerl:

Perl is strongly recommended for the installation of OMNeT++ and a version which is quite easy to
install under Windows is “Active Perl”.
This p
rogram can be found at the following URL:
http://www.activestate.com/Products/ActivePerl/more_information.plex#638
, the versio
n used during
the installation
5.8.3 Bui
ld 809

(MSI version is easier to install).

Just proceed the installation of this
component in the “C:
\
Tools
\
Perl” for example.

b. Iconv & Libxml:

These two components must also be installed, they can be found at these URLs:

-

http://www.dm4lab.to/~usa/ruby
:
i
conv
-
1.8.win32

-

http://www.rdg.mirror.ac.uk/sites/master.us.finkmirrors.net/distfiles/libx
ml2
-
2.5.4.tar.bz2%5Bpeek%5D
:
l
ib
xml2
-
2.5.4.win32

-

http://www.zlatkovic.com/pub/libxml
: iconv
-
1.9.1.win32 and libxml2
-
2.6.7.win32

Only the oldest version of iconv must be installed but both versions of li
bxml have to be.

These
components are generally available in archive format, so de
-
zip them into:

-

C:
\
Tools
\
iconv
-
1.8.win32

-

C:
\
Tools
\
libxml2
-
2.5.4.win32

-

C:
\
Tools
\
libxml2
-
2.6.7.win32

When this is done you have to copy the “lib” folder of libxml2
-
2.6.7.win32
into the installation folder of
libxml2
-
2.5.4.win32.

c. TCL
-
TK

& BLT
:

Th
e
s
e

component
s

are

also necessary for the in
stallation of OMNeT++.

A binary version
of TCL
-
TK
for Windows can be found at this URL:
ftp://ftp.scriptics.com/pub/tcl/tcl8_4

and the executable downloaded here is “tcl84a1.exe” (so version 8.4a1).

Just install TCL
-
TK into the “C:
\
Tools
\
Tcl” folde
r, you may have to restart the computer at the end of
the installation.

An auto
-
executable v
ersion of BLT is available at this URL:
http://sourceforge.net/project/showfiles.php?group_id=18616
, the file downloaded for the installation is

blt24z
-
for
-
tcl84.ex
e”

and has been installed into

C:
\
Tools
\
Tcl”.

d. Expat:

(Required component)

The version 1.95.7 (10/19/2003) has been found at this URL:
http://sourceforge.net/projects/expat

The component has been installed to this path: “
C:
\
Tools
\
Expat
-
1.95.7
”.

e.

Gnuplot & Grep:

These two components are not necessary but permit to use the “Plove” tool included into OMNeT++
(this tools can plot gr
aphs from vectors).

Gnuplot can be downloaded in its version 4.0.0 from:
http://sourceforge.net/project/showfiles.php?group_id=2055&package_id=1996

in archive forma
t and
dezipped into “C:
\
Tools
\
Gnuplot
-
v4.0.0”.

Grep can be downloaded in its version 2.40 from:
http://unxutils.sourceforge.net/
, Grep is one of the
utilities present in the “UnxUtils.zip” archive (in the “
usr
\
local
\
wbin
” folder of the dezipped archive). Just
extract the “grep.exe” executable in a previously created folder located in “C:
\
Tools
\
Grep
-
v2.40”.

III.
Installation of
OMNeT++:

Firstly OMNeT++ v3.0 alpha 3 can be downloaded from
http://www.omnetpp.org/filemgmt/singlefile.php?lid=56

in zip archive format.

Just extract this folder into “C:
\
OMNetpp_v3.0_alpha_3” for example (it is recommended to not use
space and “+” characters).

Befo
re proceeding the compilation, some
manipulations

must be
made
:

-

Copy the “
mspdb60.dll
” file (just make a research on your computer to find it
) in the root folder
of OMNeT++

-

Modify the “configuser.vc” file by
modifying or verifying the following lines
:

o

OMNE
TPP_ROOT=C:/ OMNetpp_v3.0_alpha_3

o

OMNETPP_VERSION=omnetpp
-
3.0a3

o

TK_DIR=C:/
Tools
/Tcl

o

TK_VER=8.4

o

BLT_VER=2.4

o

MPI_DIR=

o

EXPAT_DIR=C:/Tools/Expat
-
1.95.7

o

PERL=perl.exe

o

XMLPARSER=expat

-

Copy the “
libexpat.dll
” file (just make a research on your computer to find it
) in the “bin” folder
of OMNeT++

Then you can compile (normally without any warnings and errors) OMNeT++:

-

Open a window command

-

Type the following lines:

o

c:

o

cd
\

o

cd
OMNetpp_v3.0_alpha_3

o

nmake
-
f Makefile.vc

-

After several minutes (about 6 minutes with this
computer) compilation is finished

Before using this compiled version of OMNeT++, you must still include some environment variables:

-

Name: “BLT_LIB”, value: “C:/Tools/Tcl/lib/BLT24.lib”

-

Name: “OMNETPP_BITMAP_PATH”, value: “
C:/OMNetpp_v3.0_alpha_3/bitmaps”

-

N
ame: “Path”, value: “C:/OMNetpp_v3.0_alpha_3/bin” (just add the value in this case)

-

Name: “TCL_LIBRARY”, value: “C:/Tools/Tcl/lib/tcl8.4”

-

Name: “BLT_LIBRARY”, value: “C:/Tools/Tcl/lib/blt2.4”

Now your OMNeT++ program must be run very well however you may h
ave a warning that ask to
install the BLT extension, if it’s the case you are not alone… Despite all the manipulations made, BLT
doesn’t work and
I don’t know why…


Remarks:

To use “Plove”
, just start it with the “plove.exe” executable (“
C:
\
OMNetpp_v3.0_al
pha_3
\
bin
” folder in
our case), go in “Options”


“External programs” and configure this:

-

“grep” = “
C:/Tools/Grep
-
v2.4/grep.exe


-

“gnuplot” = “
C:/Tools/Gnuplot
-
v4.0.0/bin/wgnuplot.exe


Normally it will work very well.

IV. Installation of IPSuite:

The snapsh
ot 03/22/2004 of IPSuite can easily be downloaded from
http://www.omnetpp.org/filemgmt/visit.php?lid=57

in zip archive format.

You can extract this archive in a previously created folder as

C:
\
OMNetpp_v3.0_alpha_3
\
models
\
opp
-
ipsuite
” for example. When the extraction is done content of several files must be modified:

-


ipsuiteconfig.vc
” in the root folder of IPSuite:

o

ROOT=C:/OMNetpp_v3.0_alpha_3/models/opp
-
ipsuite

o

OMNETPP_ROOT=C:/OMNetpp_v3.0_
alpha_3

o

ICONV_DIR=C:/Tools/iconv
-
1.8.win32

o

LIBXML_DIR=C:/Tools/libxml2
-
2.5.4.win32

-


MyTCPClient.cc
” in the “
Applications
\
TCPApp
” folder of IPSuite:

o

add the line “
#pragma optimize("",off)
” before “
void MyTCPClient::activity()


o

add the line “
#pragma optimize
("",on)
” before “
void
MyTCPClient::issueTCP_RECEIVE()


-


Makefile.vc
” in the “
Examples
\
IPSuite
\
TCPTester
” folder of IPSuite:

o

at the end of the file, modify paths indicated for “tcp.h”

-


Makefile.vc
” in the “
Examples
\
IPSuite
\
UDPSockets
” folder of IPSuite:

o

at
the end of the file, modify paths indicated for the different “.h” files

-


Makefile.vc
” in the “
Examples
\
MPLS
\
Tester
” folder of IPSuite:

o

at the end of the file, modify paths indicated for the different “.h” files

-


Makefile.vc
” in the “
Network
\
RSVP_TE
” folde
r of IPSuite:

o

at the end of the file, modify paths indicated for the different “.h” files

When done, you can compile the IPSuite simulation model
(
without errors and warnings
)
:

-

Open a command window

-

Type the following lines:

o

c:

o

cd
\

o

cd OMNetpp_v3.0_alpha_3

o

cd models

o

cd opp
-
ipsuite

o

nmake
-
f Makefile.vc

-

After several minutes (about 5 minutes with this computer) compilation is finished


Once these manipulations made, all should work perfectly…














V. Boussemart, 05/2004.