|
Click to Download the CIMS Source Code
Please note that the Columbia IP Micro-mobility Suite (CIMS) is based on
the ns-2 tool kit versions ns-2.1b6. You need to have
installed one of these version of ns before installing CIMS. (Note: The suite
currently does not work with
ns2.1b7a)
CIMS Installation Procedure
 | If you have download mircomobility.tar.gz then do the
following:
|
- Place mircomobility.tar.gz in the <ns home directory>/tcl/ and untar.
Please note that the <ns home directory> contains all
C++ codes not the ns-allinone-xxx directory.
- The 5 untared directories include:
|
directory name |
remarks |
|
C++/ |
includes
all C++ code. Copy all these files into <ns home
directory> |
| tcl-lib/ |
includes tcl lib files. Copy these files into <ns home directory>/tcl/lib |
| hawaii/ |
includes HAWAII sample script and API library. |
| hfa/ |
includes Hierarchical Mobile IP sample
script and API library. |
| cip/ |
includes Cellular IP script and API library. |
(Note that you may want to make a back up file to
preserve your original environment before making any change)
- Recompile your ns directory (Don't forget to do "make depend"
before compilation)
| The procedure is
exactly the same for ns-2.1b7-micro.tar.gz downloads as installing any other ns snapshot. Please refer to the ns web
pages for details. |
CIMS Protocols, Scenarios and Scripts
In what follows, we discuss a number of CIMS ns scripts that drive a number of
scenarios for the protocols. Please refer to the Internet-Drafts
for protocol specifications, and the scripts themselves which
include additional comments.
| HAWAII
Under the tcl/hawaii directory, you will find a sample script sample_msf.tcl
and a library file hawaii-lib.tcl which contains the tcl API
library needed to create HAWAII networks.
Run the script by simply issuing "../../ns sample_msf.tcl". You
will see a lot of event messages printing, these messages contain
important information relating to the simulation. Its interesting to pay attention
to these events (e.g., during handoff). You need to be familiar with the HAWAII protocol
specification to fully understand simulation events.
At the end of the simulation, a NAM display will pop up, as shown in the figure above. Perhaps the best way to start playing with
the micro-mobility
suite is to press the "play" button and see packets flows and
handoff events. The
sample script creates a wireless access network (as shown in the
figure) where a single mobile host (MH) moves between the Hawaii Base Station 10 and Base
Station 11 using the HAWAII Multiple Stream Forwarding scheme (note that you can change
to the Unicast Non-Forwarding scheme
by setting the value of HawaiiRoutingMSF to 0 in the sample script).
In this
scenario, the first handoff occurs at around 1.53 seconds into the
simulation. You can slow down
the display timer and observe the control message flow (red packet represent
control messaging, indicated by a "0" in the figure above) and its
impact on the forwarding data packets. A nice test is to configure the UNF
scheme and observe the differences between the MSF and UNF
schemes.
Other sample scripts for CellularIP and Hierarchical Mobile IP provide
similar scenarios. So you can run the same "base" script
against the different protocols and look at the operational differences
between the protocols. Note that each protocol directory includes scripts
for this purpose.
The sample scripts offer a simple example to play with the
micro-mobility simulator. You may create different wireless access networks
with different topologies at will by building on the sample scripts.
Likewise you can extend the protocols if you wish. For example, add paging
to Hawaii, add QOS to Cellular IP, etc. Its open to whatever you would like
to program. We are interested in any extensions to CIMS and would be happy
to add them to new releases down the road.
|
| Hierarchical Mobile IP
This release is very similar to the discussion presented above for HAWAII
case. Note that the current configuration for Hierachical Mobile IP only
includes one level of FAs. You may add more if you wish (Minor modification
to the code is needed though).
The sample script "sample_hfa.tcl"
and a library file "hfa-lib.tcl" can be found under tcl/hfa
directory. You can run the scripts and check out the protocol behavior using
nam.
|
| Cellular IP
Celluar IP is also configured to do the similar operations as discussed
above using be base script and uses the the same wireless access network
configuration. Under the tcl/cip directory, you will find two
example scripts and one library file:
-cip-test.tcl, which contains the base scenario script in which you can measure the
packet loss and throughput during handoff;
-cip-page.tcl, which shows how IP paging is achieved in Cellular IP
access network; and
-cipInit.tcl, which contains the tcl API library you need to use to create
Cellular IP networks. There are a number of CIP parameters you can change to
control
the behavior of the CIP protocol (in the access network and mobile nodes);
these are as follows:
-ROUTE_INTERVAL: Time interval for Route-Update Packets.
-PAGE_INTERVAL: Time interval for Page-Update Packets.
-PMCtimeout: Timeout value for Page-Update Cache in nodes.
-RMCtimeout: Timeout value for Route-Update Cache in nodes.
-SS_DELAY: The time a mobile host waits before initiating a handoff after sending out semisoft
handoff packet to new base station.
Please refer to the CIP Internet Draft on the home page for the detail
specification of these parameters and the protocols. |
Please submit the following form, before downloading the
source code
|