You are on page 1of 5

Installing NS-2 and the TEL Mobile WiMAX Module

TEL-WIMAX-NS2 project documentation [www.TEL.unl.edu] Page 1

NS2 INSTALLATION GUIDE
1. Download the file ns-allinone-2.29.tar.gz from sourceforge at
https://sourceforge.net/projects/tel-wimax-ns2/files/ns2-allinone/ns-allinone-
2.29.tar.gz and save it into the folder C:\cygwin\opt.
2. Open Cygwin Bash Shell by executing “cygwin.bat” file in your C:\cygwin folder.
You will be greeted by the screen of Figure 1.

Figure 1: Cygwin Bash Shell
3. Type “cd c:/cygwin/opt” as shown in Figure 2.

Figure 2: Unzipping NS-2
4. Type “tar -zvxf ns-allinone-2.29.tar.gz” to extract the ns-2 files as shown in Figure
2.
Installing NS-2 and the TEL Mobile WiMAX Module

TEL-WIMAX-NS2 project documentation [www.TEL.unl.edu] Page 2

5. After the files are extracted type cd ns-allinone-2.29 (or cd ns* for shortcut) and
then type “./install” as shown in Figure 4. Note the dot (“.”) in front of the slash.

Figure 3: Starting Installation Process
6. NS-2 installation will start and you will get a screen as shown in Figure 4.

Figure 4: Installation in progress

7. If you are warned about missing files, just type “y” and go ahead with the
installation.
8. After installation is complete you will see the screen of Figure 5.
Installing NS-2 and the TEL Mobile WiMAX Module

TEL-WIMAX-NS2 project documentation [www.TEL.unl.edu] Page 3


Figure 5: Installation Complete
9. If you have the “.bashrc” file in your $HOME folder located at
C:\cygwin\home\your_name (e.g. “C:\cygwin\home\developer”)

i) Goto C:\cygwin\home\your_name, find the “.bashrc” file and modify it. By
adding the following text


# Functions#
#########
export NS_HOME=/opt/ns-allinone-2.29
export PATH=$NS_HOME/bin:$NS_HOME/tcl8.4.11/unix:$NS_HOME/tk8.4.11/unix:$PATH
export LD_LIBRARY_PATH=$NS_HOME/otcl-1.11:$NS_HOME/lib:\ $NS_HOME/otcl-
1.8:$NS_HOME/lib:$LD_LIBRARY_PATH
export TCL_LIBRARY=$NS_HOME/tcl8.4.11/library
Installing NS-2 and the TEL Mobile WiMAX Module

TEL-WIMAX-NS2 project documentation [www.TEL.unl.edu] Page 4


ii) Restart cygwin.

Note: Please use a LINUX based test editor or software like UltraEdit for text
editing and choose line terminator as UNIX Terminators-LF while saving.

10. If you don’t have the file in your $HOME folder, copy .bashrc file from
C:\cygwin\etc\defaults\etc\skel to C:\cygwin\home\your_name and modify
and save it as in step 11.
11. Open the file “profile” from C:\cygwin\etc using a text editor and add the line


. "$HOME/.bashrc"

Note that there is a space between the first dot and "$HOME/.bashrc".

12. Using the Cygwin bash shell prompt cd into /opt/ns-allinone-2.29
13. Rename the folder ns2.29 into something else. It is used for backup purposes
only. We typically rename it to “ns2.29_old”. For example, type:

mv ns2.29 ns2.29_old

14. Using SVN (Subversion) check out the latest stable code from sourceforge. To
do so, execute the following from within Cygwin, in folder /opt/ns2-allinone-2.29

svn co https://tel-wimax-ns2.svn.sourceforge.net/svnroot/tel-wimax-ns2/trunk ns2.29

15. When the SVN checkout completed, cd to /opt/ns-allinone-2.29/ns2.29 as shown
in Figure 6.
16. Type “./configure;make clean;make” at the prompt and hit enter.

Figure 6: Installing NS-2 (TEL version)
Installing NS-2 and the TEL Mobile WiMAX Module

TEL-WIMAX-NS2 project documentation [www.TEL.unl.edu] Page 5

17. The compilation process will begin. This is a lengthy process. After NS-2 has
been successfully compiled, you should see a screen as shown in Figure 7.


Figure 7: NS-2 installation complete
18. After successful compilation, try running one of our scripts for verification. Three
samples are provided in the “sample” folder inside the checked out ns-2.29
directory structure. The way to create and execute NS-2 scripts is documented in
the accompanying tutorials. It is better to change the current working folder to the
folder containing the scripts for file management purposes.