GloMoSim is a scalable wireless and wired network simulator that has been built on top of the PARSEC simulation environment.

The latest version of the Glomosim package for GSL/CSIL computers can be downloaded HERE.

This tarball contains

./LICENCE.txt: License agreement

./README.txt : Installation instruction file

./glomosim/  : GloMoSim

Parsec, which is needed to compile the Glomosim, has been installed on the GSL/CSIL computers for you to use.

It can be found in the /usr/local/parsec subdirectory on GSL/CSIL computers.

Steps:

1.    Un-tar the tarball using the “tar xvf glomosim_gsl-2.03.tar.gz” command. This will create a glomosim-2.03 directory with the above directories and files.

2.    Set the environment variable “PCC_DIRECTORY” to /usr/local/parsec.

For example, you can set the variable by typing "export PCC_DIRECTORY=/usr/local/parsec" if you are using bash.

3.    Then set /usr/local/parsec/bin in the path such that pcc is recognizable from the command line.

4.    Once pcc is recognizable from then command line, go to ./glomosim/main and type "make" for UNIX based systems. When the compilation is successful, you will see the GloMoSim executable "glomosim" under ./glomosim/bin. To check if GloMoSim is installed correctly, run "./glomosim config.in" and you will get an output file "glomo.stat." Compare "glomo.stat" with "glomo.stat.sample" under the same directory to ensure that the executable generates the expected output. The sample scenario file "config.in" includes descriptions how to set up the network and protocols to simulate. You will also find "radiorange" program under the same directory, which shows the radio range under no interference condition.

The latest Version of the complete Glomosim package can be downloaded HERE.

This tarball contains

./LICENCE.txt: License agreement

./README.txt : Installation instruction file

./parsec/    : PARSEC compiler and runtime libraries

./glomosim/  : GloMoSim

Un-tar the tarball using the “tar xvf glomosim-2.03.tar.gz” command. This will create a glomosim-2.03 directory with the above directories and files in it.

STEP 1: In order to install Glomosim, you first need to install PARSEC. Parsec is a C-based simulation language, developed by the Parallel Computing Laboratory at UCLA, for sequential and parallel execution of discrete-event simulation models. GlomoSim needs this to run.

PARSEC requires a C compiler to run. While it works with most C/C++ compilers on many common platforms, the tarball includes pre-compiled PARSEC runtime libraries for the following operating systems:

./parsec/windowsnt-4.0-vc6/  : MS Windows NT or 2000

                              with Visual C++ ver. 6.0

./parsec/freebsd-3.3/        : FreeBSD 3.3

./parsec/redhat-6.0/         : Red Hat 6.0 or higher

./parsec/solaris-2.5.1/      : Sun SPARC Solaris 2.5.1 or higher

                             with gcc/g++

./parsec/solaris-2.5.1-cc/   : Sun SPARC Solaris 2.5.1 or higher

                              with Sun C compiler

./parsec/x86-solaris-2.5.1/  : Sun X86 Solaris 2.5.1 or higher

                              with gcc/g++

Those students who want to install Glomosim/PARSEC on their personal computers should create a subdirectory

/usr/local/parsec. Then depending on the platform, copy the whole subdirectory with the name of target platform under /usr/local/parsec.

Then set the designated directory to an environment variable “PCC_DIRECTORY”. For instance, you can set the variable by typing "setenv PCC_DIRECTORY /usr/local/parsec" if you are using (t)csh.

Finally set /usr/local/parsec/bin in the path such that pcc is recognizable from the command line.

STEP 2: GloMoSim Installation

Once PARSEC is installed and pcc is recognizable from the command line, go to ./glomosim/main and type "make" for UNIX based systems. When the compilation is successful, you will see the GloMoSim executable "glomosim" under ./glomosim/bin. To check if GloMoSim is installed correctly, run "./glomosim config.in" and you will get an output file "glomo.stat." Compare "glomo.stat" with "glomo.stat.sample" under the same directory to ensure that the executable generates the expected output. The sample scenario file "config.in" includes descriptions how to set up the network and protocols to simulate. You will also find "radiorange" program under the same directory, which shows the radio

range under no interference condition.

Some other PARSEC environment variables and compiler options that you should be aware of and pcc checks when executed are:

  PCC_DIRECTORY      : Directory that pcc looks up

  PCC_CC             : C compiler used for preprocessing and compiling

  PCC_LINKER         : Linker used for linking

  PCC_PP_OPTIONS     : Options for preprocessing

  PCC_CC_OPTIONS     : Options for compiling

  PCC_LINKER_OPTIONS : Options for linking

These variables do not usually need to change. PARSEC also has the command line options each of which corresponds to the environment variable above:

  -pcc_directory

  -pcc_cc

  -pcc_linker

  -pcc_pp_optoins

  -pcc_cc_options

  -pcc_linker_options

These command line options can override the environment variables and are useful when changing options temporarily. There are other command line options besides those. You can see brief descriptions of those options by typing "pcc -help"

For detailed descriptions, you can read the manual for PARSEC on the web:

   http://pcl.cs.ucla.edu/projects/parsec

All these installation instructions have been compiled from the README file in the glomosim Directory.

Hope this helps,

Uday