Installation - Revision history

Tomh: redirect people to the new installation guide

2023-03-08T05:27:36Z

redirect people to the new installation guide

← Older revision		Revision as of 05:27, 8 March 2023
Line 1:		Line 1:
	{{TOC}}		{{TOC}}

	~~This is~~ a ~~detailed installation~~ guide ~~for ns-3. Basic installation instructions can be found in~~ the [https://www.nsnam.org/~~docs~~/~~tutorial/html/index~~.~~html ns-3 tutorial] (see~~ the ~~[https://www~~.~~nsnam.org/docs/tutorial/html/quick-start.html Quick Start] chapter or else~~ the ~~more complete [https://www.nsnam.org/docs/tutorial/html/getting~~-~~started.html Getting Started] chapter)~~.		'''Important Note:''' As of March 7, 2023, this information has migrated to a new manual-- the Installation guide linked from the main [https://www.nsnam.org/documentation/ documentation page]. You can read the below for historical interest, but it is probably stale information.

			This wiki page used to be the installation guide for ns-3.

	== Supported platforms ==		== Supported platforms ==

Tommaso at 10:45, 4 December 2022

2022-12-04T10:45:51Z

← Older revision		Revision as of 10:45, 4 December 2022
Line 82:		Line 82:
	\|-		\|-
	! Real-time simulator		! Real-time simulator
	\| Y \|\| Y \|\| N		\| Y \|\| Y \|\| Y
	\|-		\|-
	! Emulated Net Device		! Emulated Net Device

Tomh: /* Linux */

2022-10-27T23:36:30Z

Linux

Show changes

Tomh: /* Ubuntu/Debian/Mint */

2022-10-20T23:28:45Z

Ubuntu/Debian/Mint

← Older revision		Revision as of 23:28, 20 October 2022
Line 220:		Line 220:
	==== Ubuntu/Debian/Mint ====		==== Ubuntu/Debian/Mint ====

	The following list of packages should be accurate through the Ubuntu 21.04 release; other releases or other Debian-based systems may slightly vary. Ubuntu 16.04 LTS release is probably the oldest release that is known to work with the most recent ns-3 releases.		The following list of packages should be accurate through the Ubuntu 22.10 release; other releases or other Debian-based systems may slightly vary. Ubuntu 16.04 LTS release is probably the oldest release that is known to work with the most recent ns-3 releases.

	~~'''Note:''' As~~ of ns-3.30 release ~~(August 2019), ns-~~3 ~~uses Python 3 by default, but earlier releases depend on Python 2 packages,~~ and ~~at least a Python 2 interpreter is recommended. If working with an earlier release, one may in general substitute~~ '~~python~~' ~~for~~ '~~python3' in the below (e.~~g~~. install 'python-dev' instead of '~~python3-~~dev').~~		The list of packages depends on which version of ns-3 you are trying to build.

			* '''minimal recommended requirements for release 3.36 and later:'''

			apt install g++ python3 cmake ninja-build git

	* '''minimal requirements for ~~C++ users (~~release 3.35 ~~and earlier)~~:''' ~~This is the minimal set of packages needed to run ns-3 from a released tarball.~~		* '''minimal recommended requirements for release 3.30-3.35:'''

	apt install g++ python3		apt install g++ python3

			* '''minimal recommended requirements for release 3.29 and earlier:'''

			apt install g++ python2

			'''Note:''' As of ns-3.30 release (August 2019), ns-3 uses Python 3 by default, but earlier releases depend on Python 2 packages, and at least a Python 2 interpreter is recommended. If working with an earlier release, one may in general substitute 'python' for 'python3' in the below (e.g. install 'python-dev' instead of 'python3-dev').

	'''Note:''' As of January 2022 (ns-3.36 release and ns-3-dev), the minimum g++ version is g++-8. Older Ubuntu releases (18.04, 16.04) come with an older default g++. On Ubuntu 18.04, this StackOverflow answer can be followed to install and prefer g++-8: https://askubuntu.com/a/1028656. On older Ubuntu such as 16.04, to use the most recent code, you must install g++-8 or g++-9 from the Ubuntu toolchain: https://launchpad.net/%7Eubuntu-toolchain-r/+archive/ubuntu/test		'''Note:''' As of January 2022 (ns-3.36 release and ns-3-dev), the minimum g++ version is g++-8. Older Ubuntu releases (18.04, 16.04) come with an older default g++. On Ubuntu 18.04, this StackOverflow answer can be followed to install and prefer g++-8: https://askubuntu.com/a/1028656. On older Ubuntu such as 16.04, to use the most recent code, you must install g++-8 or g++-9 from the Ubuntu toolchain: https://launchpad.net/%7Eubuntu-toolchain-r/+archive/ubuntu/test

	* '''~~minimal requirements for C++ users (release 3.36 and development):~~''' ~~For~~ ns-3~~-dev and ns-3.36 (and later) releases, CMake and a build system (make or ninja-build) is also needed~~.		The remaining are needed for '''optional''' ns-3 components.

	~~apt install g++ python3 cmake ninja-build~~

	* '''minimal requirements for Python API users (release 3.30 and newer, and ns-3-dev):''' This is the minimal set of packages needed to work with Python bindings from a released tarball.		* '''minimal requirements for Python API users (release 3.30 and newer, and ns-3-dev):''' This is the minimal set of packages needed to work with Python bindings from a released tarball.

Tomh: update dead links

2022-10-20T23:18:41Z

update dead links

← Older revision		Revision as of 23:18, 20 October 2022
Line 1:		Line 1:
	{{TOC}}		{{TOC}}

	This is a detailed installation guide for ns-3. Basic installation instructions can be found in the [https://www.nsnam.org/docs~~/release~~/tutorial/html/index.html ns-3 tutorial] (see [https://www.nsnam.org/docs/~~release~~/tutorial/html/getting-started.html Getting Started chapter]).		This is a detailed installation guide for ns-3. Basic installation instructions can be found in the [https://www.nsnam.org/docs/tutorial/html/index.html ns-3 tutorial] (see the [https://www.nsnam.org/docs/tutorial/html/quick-start.html Quick Start] chapter or else the more complete [https://www.nsnam.org/docs/tutorial/html/getting-started.html Getting Started] chapter).

	== Supported platforms ==		== Supported platforms ==

Tomh: /* Support for optional features */

2022-10-20T22:59:52Z

Support for optional features

← Older revision		Revision as of 22:59, 20 October 2022
Line 39:		Line 39:
	=== Support for optional features ===		=== Support for optional features ===

	There are a few options that are not enabled by default and are not available on all platforms. At the end of the configuration process (explained below), the status of these options are shown as detected by a '''waf''' script:		There are a few options that are not enabled by default and are not available on all platforms. At the end of the configuration process (explained below), the status of these options are shown as detected by a '''waf''' or '''ns3''' script:

	<pre>		<pre>

Tomh: update installation

2022-10-20T22:59:16Z

update installation

← Older revision		Revision as of 22:59, 20 October 2022
Line 1:		Line 1:
	{{TOC}}		{{TOC}}

	This is a detailed installation guide for ns-3. Basic installation instructions can be found in the [~~http~~://www.nsnam.org/docs/release/tutorial/html/index.html ns-3 tutorial] (see [~~http~~://www.nsnam.org/docs/release/tutorial/html/getting-started.html Getting Started chapter]).		This is a detailed installation guide for ns-3. Basic installation instructions can be found in the [https://www.nsnam.org/docs/release/tutorial/html/index.html ns-3 tutorial] (see [https://www.nsnam.org/docs/release/tutorial/html/getting-started.html Getting Started chapter]).

	== Supported platforms ==		== Supported platforms ==

	ns-3 is primarily developed on GNU/Linux and macOS platforms, and the minimal requirements to run basic simulations are a C++ compiler; either [~~http~~://gcc.gnu.org/ g++] or [~~http~~://clang.llvm.org/ clang++] compiler, and [http://www-python.org/ Python (version 3)] interpreter. The below instructions are per-platform instructions for supplemental packages that enable optional features of ns-3 or companion tools.		ns-3 is primarily developed on GNU/Linux and macOS platforms, and the minimal requirements to run basic simulations are a C++ compiler; either [https://gcc.gnu.org/ g++] or [https://clang.llvm.org/ clang++] compiler, build system ([https://cmake.org CMake] and either [https://www.gnu.org/software/make/ make] or [https://ninja-build.org/ ninja]), and [http://www-python.org/ Python (version 3)] interpreter. The below instructions are per-platform instructions for supplemental packages that enable optional features of ns-3 or companion tools.

	=== Operating system and compiler support ===		=== Operating system and compiler support ===
Line 11:		Line 11:
	ns-3 is supported and currently tested on the following primary platforms:		ns-3 is supported and currently tested on the following primary platforms:

	# Linux (x86 and x86_64): gcc/g++ versions 7 and above		# Linux (x86 and x86_64): gcc/g++ versions 8 and above
	## '''Note:''' If you are using RHEL or Centos, you will likely need to install a more up-to-date compiler than the default; search for how to enable 'software collections' or 'devtoolset' on these distributions. Other Linux distributions typically have a suitable default compiler (at least version 4.9).		## '''Note:''' If you are using RHEL or Centos, you will likely need to install a more up-to-date compiler than the default; search for how to enable 'software collections' or 'devtoolset' on these distributions. Other Linux distributions typically have a suitable default compiler (at least version 4.9).
	# MacOS Apple LLVM: version 11.0.0 and above		# MacOS Apple LLVM: version 11.0.0 and above
Line 25:		Line 25:

	=== Integrated development environment support ===		=== Integrated development environment support ===

			Please see [https://www.nsnam.org/docs/tutorial/html/getting-started.html#building-with-ides this tutorial section] on configuring IDEs.

	==== Eclipse ====		==== Eclipse ====
	The [~~http~~://www.eclipse.org/ Eclipse IDE] is not an officially supported platform, but some developers use it and have compiled a [[HOWTO configure Eclipse with ns-3\|HOWTO]].		The [https://www.eclipse.org/ Eclipse IDE] is not an officially supported platform, but some developers use it and have compiled a [[HOWTO configure Eclipse with ns-3\|HOWTO]].

	==== NetBeans ====		==== NetBeans ====
Line 228:		Line 230:
	'''Note:''' As of January 2022 (ns-3.36 release and ns-3-dev), the minimum g++ version is g++-8. Older Ubuntu releases (18.04, 16.04) come with an older default g++. On Ubuntu 18.04, this StackOverflow answer can be followed to install and prefer g++-8: https://askubuntu.com/a/1028656. On older Ubuntu such as 16.04, to use the most recent code, you must install g++-8 or g++-9 from the Ubuntu toolchain: https://launchpad.net/%7Eubuntu-toolchain-r/+archive/ubuntu/test		'''Note:''' As of January 2022 (ns-3.36 release and ns-3-dev), the minimum g++ version is g++-8. Older Ubuntu releases (18.04, 16.04) come with an older default g++. On Ubuntu 18.04, this StackOverflow answer can be followed to install and prefer g++-8: https://askubuntu.com/a/1028656. On older Ubuntu such as 16.04, to use the most recent code, you must install g++-8 or g++-9 from the Ubuntu toolchain: https://launchpad.net/%7Eubuntu-toolchain-r/+archive/ubuntu/test

	* '''minimal requirements for C++ users (release 3.36 and development):''' For ns-3-dev and ns-3.36 (and later) releases, CMake is also needed.		* '''minimal requirements for C++ users (release 3.36 and development):''' For ns-3-dev and ns-3.36 (and later) releases, CMake and a build system (make or ninja-build) is also needed.

	apt install g++ python3 cmake		apt install g++ python3 cmake ninja-build

	* '''minimal requirements for Python API users (release 3.30 and newer, and ns-3-dev):''' This is the minimal set of packages needed to work with Python bindings from a released tarball.		* '''minimal requirements for Python API users (release 3.30 and newer, and ns-3-dev):''' This is the minimal set of packages needed to work with Python bindings from a released tarball.

Tomh: /* Fedora/RedHat */

2022-03-16T21:12:08Z

Fedora/RedHat

← Older revision		Revision as of 21:12, 16 March 2022
Line 412:		Line 412:

	dnf install python3-sphinx dia texlive texlive-latex texlive-fncychap texlive-capt-of texlive-tabulary texlive-eqparbox		dnf install python3-sphinx dia texlive texlive-latex texlive-fncychap texlive-capt-of texlive-tabulary texlive-eqparbox
	dnf install texlive-epstopdf texlive-titlesec texlive-framed texlive-dvipng texlive-threeparttable texlive-wrapfig		dnf install texlive-epstopdf texlive-titlesec texlive-framed texlive-dvipng texlive-threeparttable texlive-wrapfig texlive-tabulary
	dnf install texlive-multirow ImageMagick		dnf install texlive-multirow ImageMagick

Tomh: /* Ubuntu/Debian/Mint */

2022-01-08T16:31:50Z

Ubuntu/Debian/Mint

← Older revision		Revision as of 16:31, 8 January 2022
Line 226:		Line 226:
	apt install g++ python3		apt install g++ python3

	'''Note:''' As of January 2022 (ns-3.36 release and ns-3-dev), the minimum g++ version is g++-9. Older Ubuntu releases (18.04, 16.04) come with an older g++. On such ~~systems~~, to use the most recent code, you must install g++-9 from the Ubuntu toolchain: https://launchpad.net/%7Eubuntu-toolchain-r/+archive/ubuntu/test		'''Note:''' As of January 2022 (ns-3.36 release and ns-3-dev), the minimum g++ version is g++-8. Older Ubuntu releases (18.04, 16.04) come with an older default g++. On Ubuntu 18.04, this StackOverflow answer can be followed to install and prefer g++-8: https://askubuntu.com/a/1028656. On older Ubuntu such as 16.04, to use the most recent code, you must install g++-8 or g++-9 from the Ubuntu toolchain: https://launchpad.net/%7Eubuntu-toolchain-r/+archive/ubuntu/test

	* '''minimal requirements for C++ users (release 3.36 and development):''' For ns-3-dev and ns-3.36 (and later) releases, CMake is also needed.		* '''minimal requirements for C++ users (release 3.36 and development):''' For ns-3-dev and ns-3.36 (and later) releases, CMake is also needed.

Tomh: /* Ubuntu/Debian/Mint */

2022-01-06T21:20:39Z

Ubuntu/Debian/Mint

← Older revision		Revision as of 21:20, 6 January 2022
Line 225:		Line 225:

	apt install g++ python3		apt install g++ python3

			'''Note:''' As of January 2022 (ns-3.36 release and ns-3-dev), the minimum g++ version is g++-9. Older Ubuntu releases (18.04, 16.04) come with an older g++. On such systems, to use the most recent code, you must install g++-9 from the Ubuntu toolchain: https://launchpad.net/%7Eubuntu-toolchain-r/+archive/ubuntu/test

	* '''minimal requirements for C++ users (release 3.36 and development):''' For ns-3-dev and ns-3.36 (and later) releases, CMake is also needed.		* '''minimal requirements for C++ users (release 3.36 and development):''' For ns-3-dev and ns-3.36 (and later) releases, CMake is also needed.