X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/cf29008acd3a0730865f5ac574cd704cd5a9b3ca..e37929cd4f8349d37d59645a95be3ca7a01ed353:/doc/doxygen/pls.doc diff --git a/doc/doxygen/pls.doc b/doc/doxygen/pls.doc deleted file mode 100644 index b4ca1a0369..0000000000 --- a/doc/doxygen/pls.doc +++ /dev/null @@ -1,95 +0,0 @@ -/*! \page pls Packet level simulation - -\tableofcontents - -It is possible to use a packet-level network simulator instead of the default flow-based models. You may want to use -this feature if you have doubts about the validity of the default model or want to perform some validation experiments. - -At the moment, we support the well-known ns-3 packet-level simulator. Earlier -releases of SimGrid did support the GTNetS simulator. Its support could possibly be revived by someone who would -need it. - -\section pls_simgrid_configuration_ns3 ns-3 as a SimGrid model - -This section explains how to replace the SimGrid network models by those of the well-known -ns-3 packet-level network simulator. - -\subsection pls_simgrid_configuration_ns3_install Installing ns-3 - -The easiest is to install it with the package manager. Under Debian/Ubuntu, simply type as root: - -\verbatim -apt-get install libns3-dev ns3 -\endverbatim - -You can also install it from scratch with the following commands: - -\verbatim -# Download the source -wget http://www.nsnam.org/release/ns-allinone-3.25.tar.bz2 -tar -xf ns-allinone-3.25.tar.bz2 -cd ns-allinone-3.25/ns-3.25/ -# Configure, build and install -./waf configure --prefix="/opt/ns3" # or give another path if you prefer -./waf -./waf install -\endverbatim - -For more information, please refer to the ns-3 documentation. - -\subsection pls_simgrid_configuration_ns3_config Enabling SimGrid's support for ns-3 - -Normally, you just have to enable ns-3 in ccmake or cmake as follows. If you installed ns-3 in a regular path, just -drop the ns3_path configuration item. - -\verbatim -cmake . -Denable_ns3=ON -DNS3_HINT=/opt/ns3 # or change the path if needed -\endverbatim - -By the end of the configuration, cmake reports whether ns-3 was found. You can also double-check by executing the tests -after the compilation. - -\verbatim -$ ctest -R ns3 -(test(s) should be run) -\endverbatim - -If you have a ns-3 version that is not known to SimGrid (yet), the detection may fail. In that case, edit the -tools/cmake/Modules/FindNS3.cmake file in your SimGrid tree. The -required changes are very easy, and documented in the file header. - -If the compilation fails when linking the library because of some .a file that cannot be used dynamically, this is -probably because you only installed the libns3-dev library on your Debian, where you also need libns3-3. This is -probably a bug of the libns3-dev package that should depend on the dynamic libraries corresponding to its .so files. - -\subsection pls_simgrid_configuration_ns3_use Using ns-3 from SimGrid - -A working example of ns-3/SimGrid interactions can be found in examples/msg/network-ns3/. Basically, you just have to -run your SimGrid simulation with the configuration option "network/model" set to "NS3". The rest remains unchanged. - -The following should work from the examples/msg/network-ns3 folder (network-ns3 is the name of our example binary). - -\verbatim -./network-ns3 ./3hosts_2links_p.xml 3hosts_2links_d.xml --cfg=network/model:NS3 --log=root.threshold:info -\endverbatim - -A ns-3 platform is automatically created from the provided SimGrid platform file. However, there are some known caveats: - - - -More about ns-3 simulator (Official website) - -\subsection ns3_examples Examples - -For an example using NS3 as a SimGrid module, please refer to the -@ref msg_ex_ns3 "relevant section" of the documentation. - -*/