NS-2 Installation Manual Acknowledgments Installation Process

NS-2 installation is not an easy task, unless you follow the proper instructions. This manual will help you in installing NS-2 easily. The procedures given in this manual are taken from different websites and put together. This document contains installation instructions based on my personal experience, starting from installation of Linux Fedora 11 till NS-2 complete installation. See the links given at the end, and you will be able to grasp majority of the ideas from there. Infact, I myself have taken the commands and procedures from these sites and managed to install NS-2. Let us start with the installation process. Step I First step is to install Linux. In my case it is Fedora 11. Just go to the Fedora web site (http://fedoraproject.org/en/get-fedora) and download iso image of Fedora 11. You can use the conventional way of installing Linux on your machine. Step II It is not the installation which creates problems, but post installation procedures which have to be kept in mind if you want to install NS-2 properly. See the following steps given below: 1. 2. 3. After Linux installation is successfully done, it is time to install NS-2. If you are a newbie to this environment I would suggest to install ns-2 all in one package. I have done the same. Download ns-allinone-2.34 from the ns-2 website (http://www.isi.edu/nsnam/ns/ns-build.html#allinone). Before installation you have to update your current version of Linux. In my case one very common problem was unavailability of repositories. You have to have gcc and tcl/tk already to install NS-2 because NS-2 has dependency on gcc and tcl/tk. These two dependencies do not come with iso image and when you try updating your repositories, it usually gives an error stated "Error:Cannot retrieve repository metadata (repomd.xml) for repository: fedora. Please verify its path and try again" How to resolve this issue? Simple do the following steps and you will start getting the repositories: 5.1. You need to edit two of your repository files: (1) /etc/yum.repos.d/fedora.repo and (2) /etc/yum.repos.d/fedora-updates.repo. While editing comment (put #) all the lines that start with 'mirrorlist' and un-comment (delete #) all the lines that start with 'baseurl'. Save both the files and close them.



Bilal A. Khan: bilal26@hotmail.co.uk

Page 1

5.2. Once the step given above is successfully done now its turn to edit the file located at /etc/hosts. Delete what ever is written in this file and replace both the lines with the following: mirrors.fedoraproject.org mirrors.rpmfusion.org

5.3. Save the file named hosts and close it now. 5.4. First job done. You can now download the repositories successfully. Step III 6. 7. Its time to download and install the dependencies before we jump onto installation of NS-2. For getting the dependencies we need to 'yum' a few dependencies. 'yum' is a very powerful command which downloads and installs the dependencies from the repositories. You also have to keep in mind that you have to be a power user (root user) to run these commands. For coming into the power mode write 'su' in the terminal. It will ask you for the root password. Put in the password and there you go... You are in root mode. Follow the series of command given and let it get downloaded and installed. You will automatically understand once you look at the terminal. 7.1. yum install autoconf 7.2. yum install automake 7.3. yum install gcc-c++ 7.4. yum install libX11-devel 7.5. yum install xorg-x11-proto-devel 7.6. yum install libXt-devel 7.7. yum install libXmu-devel 8. This should be kept in mind that all these commands will take some time to complete their course of action, so one has to be patient. 9. As NS-2 has already been downloaded, you have to untar it. Write the following command to untar the file. 9.1. tar -xzf ns-allinone-2.34.tar.gz 9.2. cd ns-allinone-2.34.tar.gz 9.3. ./install 10. Sit back and relax, it will take a bit of a time to get NS-2 installed. 11. Once NS-2 is installed successfully, a message will be displayed on the terminal that NS-2 is installed successfully. 12. If you are excited that NS-2 is installed successfully, you are wrong. Its not over yet. You yet have to register the variables in the environment. Reason for doing so is that it creates the linkage to all the executables created by NS-2. tcl scripts usually call these executables. Without setting the variable to their environment NS-2 will not work. Follow the following instructions to register the variables to the environment: 12.1. Go to /etc folder from terminal and type:

Bilal A. Khan: bilal26@hotmail.co.uk

Page 2

gedit ~/.bashrc This will open the bashrc file and now you can edit in this file 12.2. Remember to replace user/local by your installation path like I have mentioned in the lines below: At the end of the file, type the following (do not forget to give your installation path):

# LD_LIBRARY_PATH OTCL_LIB=/home/BilalAKhan/Desktop/ns-allinone-2.34/otcl-1.13 NS2_LIB=/home/BilalAKhan/Desktop/ns-allinone-2.34/lib X11_LIB=/home/X11R6/lib USR_LOCAL_LIB=/home/BilalAKhan/Desktop/local/lib export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$OTCL_LIB: $NS2_LIB:$X11_LIB:$USR_LOCAL_LIB # TCL_LIBRARY TCL_LIB=/home/BilalAKhan/Desktop/ns-allinone-2.34/tcl8.4.18/library USR_LIB=/home/lib export TCL_LIBRARY=$TCL_LIB:$USR_LIB # PATH XGRAPH=/home/BilalAKhan/Desktop/ns-allinone-2.34/bin:/home/BilalAKhan/ns -allinone-2.34/tcl8.4.18/unix:/home/BilalAKhan/Desktop/ns-allinone-2.34/tk8.4.1 8/unix NS=/home/BilalAKhan/Desktop/ns-allinone-2.34/ns-2.34/ NAM=/home/BilalAKhan/Desktop/ns-allinone-2.34/nam-1.14/ PATH=$PATH:$XGRAPH:$NS:$NAM

Bilal A. Khan: bilal26@hotmail.co.uk

Page 3

12.3. Once you have written the code above. Save the file and write the folowing command on the terminal: source ~/.bashrc 12.4. Once this step is done, try validating your installed NS-2 by writing ./validate on the terminal. It will take a long time till it completely validates the system. With me it took approx 1.5 hours to validate. 13. Once the successful validation is done, NS-2 is ready to use. On the terminal type 'ns' and a % sign will appear. If you see this sign, which means that NS-2 is ready to use. Go to the tutorials given on the web and start using NS-2.

Reference and Bibliography
[1] http://www.linuxforums.org/forum/linux-newbie/134588-ns2-installation-guide-fedora-7-a.html [2] http://nsnam.isi.edu/nsnam/index.php/Downloading_and_installing_ns-2 [3] http://yonghoon.livejournal.com/4799.html [4] http://www.fedoraguide.info/index.php?title=Main_Page#How_to_Upgrade_Fedora

Bilal A. Khan: bilal26@hotmail.co.uk

Page 4

[5] http://digitizor.com/2009/06/17/how-to-fix-the-cannot-retrieve-repository-metadata-repomd-xml -error-in-fedora-11/ [6] http://lowfatlinux.com/linux-rpm-uninstall.html [7] http://www.linuxforums.org/forum/linux-newbie/64514-newbie-needs-help-ns2-software-installat ion.html

Bilal A. Khan: bilal26@hotmail.co.uk

Page 5

Sign up to vote on this title
UsefulNot useful