Rumba - Revision history

Dimitri: /* Install Rumba */

2026-01-18T10:07:51Z

Install Rumba

← Older revision		Revision as of 10:07, 18 January 2026
Line 30:		Line 30:
	git clone https://ouroboros.rocks/git/rumba		git clone https://ouroboros.rocks/git/rumba
	cd rumba		cd rumba
	# Recommended: create/enter python virtual environment (e.g. the same created for [[Ouroboros Metrics\|InfluxDB & grafana]])		# Recommended: create/enter python virtual environment (e.g. the same created for [[Ouroboros Metrics\|InfluxDB & grafana]]), or to create one:
			python -m venv ./venv
			source venv/bin/activate
			pip install --upgrade pip
	# If not, then it will install system-wide (use sudo in that case)		# If not, then it will install system-wide (use sudo in that case)
	pip install .		pip install .

Thijs: fix link

2026-01-10T12:02:55Z

fix link

← Older revision		Revision as of 12:02, 10 January 2026
Line 1:		Line 1:
	{{Under construction}} (see https://ouroboros.rocks/docs/tools/rumba/)		{{Under construction}} (see https://ouroboros.rocks/docs/tools/rumba/)

	Rumba is a Python framework for setting up Ouroboros and RINA networks in a test environment that was developed during the [[History of Ouroboros#~~ARCFIRE~~ \| ARCFIRE]] project. Its main objectives are to configure networks and to evaluate the impact of the architecture on configuration management and devops in computer and telecommunications networks. The original Rumba project page is [https://gitlab.com/ARCFIRE/Rumba here].		Rumba is a Python framework for setting up Ouroboros and RINA networks in a test environment that was developed during the [[History of Ouroboros#2016:_ARCFIRE_and_the_start_of_Ouroboros \| ARCFIRE]] project. Its main objectives are to configure networks and to evaluate the impact of the architecture on configuration management and devops in computer and telecommunications networks. The original Rumba project page is [https://gitlab.com/ARCFIRE/Rumba here].

	Rumba can quickly set up test networks for Ouroboros that are made up of many IPCPs and Layers. We keep a version on this site up-to-date with the Ouroboros prototype.		Rumba can quickly set up test networks for Ouroboros that are made up of many IPCPs and Layers. We keep a version on this site up-to-date with the Ouroboros prototype.

Thijs: Add usage hint

2025-11-29T23:14:16Z

Add usage hint

← Older revision		Revision as of 23:14, 29 November 2025
Line 39:		Line 39:
	The Rumba model is heavily based on [[RINA]] terminology (since it was originally developed within a RINA research project). We will probably align the terminology in Rumba with Ouroboros in the near future. I will break down a typical Rumba experiment definition and show how to use Rumba in Python interactive mode. You can download the complete example experiment definition [https://{{SERVERNAME}}/docs/tools/rumba_example.py here]. The example uses the Ouroboros prototype, and we will run the setup on the local testbed since that is available on any machine and doesn’t require additional dependencies. We use the local testbed a lot for quick development testing and debugging. I will also show the experiment definition for the virtual wall server testbed at Ghent University as an example for researchers who have access to this testbed. If you have docker or qemu installed, feel free to experiment with these at your leisure.		The Rumba model is heavily based on [[RINA]] terminology (since it was originally developed within a RINA research project). We will probably align the terminology in Rumba with Ouroboros in the near future. I will break down a typical Rumba experiment definition and show how to use Rumba in Python interactive mode. You can download the complete example experiment definition [https://{{SERVERNAME}}/docs/tools/rumba_example.py here]. The example uses the Ouroboros prototype, and we will run the setup on the local testbed since that is available on any machine and doesn’t require additional dependencies. We use the local testbed a lot for quick development testing and debugging. I will also show the experiment definition for the virtual wall server testbed at Ghent University as an example for researchers who have access to this testbed. If you have docker or qemu installed, feel free to experiment with these at your leisure.

			If you want to test Ouroboros locally (no docker/qemu), then the only example script you can run without modification is:
			python3 examples/scalingtime.py --prototype ouroboros local

	==Notes==		==Notes==
	<references />		<references />

Thijs at 21:58, 18 January 2024

2024-01-18T21:58:32Z

← Older revision		Revision as of 21:58, 18 January 2024
Line 37:		Line 37:

	== Use Rumba ==		== Use Rumba ==
	The Rumba model is heavily based on [[RINA]] terminology (since it was originally developed within a RINA research project). We will probably align the terminology in Rumba with Ouroboros in the near future. I will break down a typical Rumba experiment definition and show how to use Rumba in Python interactive mode. You can download the complete example experiment definition here. The example uses the Ouroboros prototype, and we will run the setup on the local testbed since that is available on any machine and doesn’t require additional dependencies. We use the local testbed a lot for quick development testing and debugging. I will also show the experiment definition for the virtual wall server testbed at Ghent University as an example for researchers who have access to this testbed. If you have docker or qemu installed, feel free to experiment with these at your leisure.		The Rumba model is heavily based on [[RINA]] terminology (since it was originally developed within a RINA research project). We will probably align the terminology in Rumba with Ouroboros in the near future. I will break down a typical Rumba experiment definition and show how to use Rumba in Python interactive mode. You can download the complete example experiment definition [https://{{SERVERNAME}}/docs/tools/rumba_example.py here]. The example uses the Ouroboros prototype, and we will run the setup on the local testbed since that is available on any machine and doesn’t require additional dependencies. We use the local testbed a lot for quick development testing and debugging. I will also show the experiment definition for the virtual wall server testbed at Ghent University as an example for researchers who have access to this testbed. If you have docker or qemu installed, feel free to experiment with these at your leisure.


	==Notes==		==Notes==
	<references />		<references />

Thijs at 00:41, 6 January 2024

2024-01-06T00:41:04Z

← Older revision		Revision as of 00:41, 6 January 2024
Line 32:		Line 32:
	# Recommended: create/enter python virtual environment (e.g. the same created for [[Ouroboros Metrics\|InfluxDB & grafana]])		# Recommended: create/enter python virtual environment (e.g. the same created for [[Ouroboros Metrics\|InfluxDB & grafana]])
	# If not, then it will install system-wide (use sudo in that case)		# If not, then it will install system-wide (use sudo in that case)
	.~~/setup~~.~~py install~~		pip install .
			# OR, if you want all 3 extra features
			pip install ".[NumpyAcceleration,graphs,visualizer]"

	== Use Rumba ==		== Use Rumba ==

Thijs at 01:49, 5 January 2024

2024-01-05T01:49:58Z

← Older revision		Revision as of 01:49, 5 January 2024
Line 35:		Line 35:

	== Use Rumba ==		== Use Rumba ==
			The Rumba model is heavily based on [[RINA]] terminology (since it was originally developed within a RINA research project). We will probably align the terminology in Rumba with Ouroboros in the near future. I will break down a typical Rumba experiment definition and show how to use Rumba in Python interactive mode. You can download the complete example experiment definition here. The example uses the Ouroboros prototype, and we will run the setup on the local testbed since that is available on any machine and doesn’t require additional dependencies. We use the local testbed a lot for quick development testing and debugging. I will also show the experiment definition for the virtual wall server testbed at Ghent University as an example for researchers who have access to this testbed. If you have docker or qemu installed, feel free to experiment with these at your leisure.


	==Notes==		==Notes==
	<references />		<references />

Thijs at 00:14, 5 January 2024

2024-01-05T00:14:53Z

← Older revision		Revision as of 00:14, 5 January 2024
Line 31:		Line 31:
	cd rumba		cd rumba
	# Recommended: create/enter python virtual environment (e.g. the same created for [[Ouroboros Metrics\|InfluxDB & grafana]])		# Recommended: create/enter python virtual environment (e.g. the same created for [[Ouroboros Metrics\|InfluxDB & grafana]])
	# If not, then it will install system-wide		# If not, then it will install system-wide (use sudo in that case)
	~~sudo~~ ./setup.py install		./setup.py install

	== Use Rumba ==		== Use Rumba ==

Thijs at 00:12, 5 January 2024

2024-01-05T00:12:24Z

← Older revision		Revision as of 00:12, 5 January 2024
Line 1:		Line 1:
			{{Under construction}} (see https://ouroboros.rocks/docs/tools/rumba/)

	Rumba is a Python framework for setting up Ouroboros and RINA networks in a test environment that was developed during the [[History of Ouroboros#ARCFIRE \| ARCFIRE]] project. Its main objectives are to configure networks and to evaluate the impact of the architecture on configuration management and devops in computer and telecommunications networks. The original Rumba project page is [https://gitlab.com/ARCFIRE/Rumba here].		Rumba is a Python framework for setting up Ouroboros and RINA networks in a test environment that was developed during the [[History of Ouroboros#ARCFIRE \| ARCFIRE]] project. Its main objectives are to configure networks and to evaluate the impact of the architecture on configuration management and devops in computer and telecommunications networks. The original Rumba project page is [https://gitlab.com/ARCFIRE/Rumba here].

Line 22:		Line 24:
	* rudimentary support for drawing these networks (using pydot)		* rudimentary support for drawing these networks (using pydot)

	~~{{Under construction}}~~, ~~see~~ https://ouroboros.rocks/~~docs~~/~~tools~~/~~rumba~~/		== Install Rumba ==
			We forked Rumba with the Ouroboros website, and you should get this forked version for use with Ouroboros.
			It should work with most python versions, but I recommend using a recent version (currently >= Python3.9).

			git clone https://ouroboros.rocks/git/rumba
			cd rumba
			# Recommended: create/enter python virtual environment (e.g. the same created for [[Ouroboros Metrics\|InfluxDB & grafana]])
			# If not, then it will install system-wide
			sudo ./setup.py install

			== Use Rumba ==

	==Notes==		==Notes==
	<references />		<references />

Thijs at 23:59, 4 January 2024

2024-01-04T23:59:13Z

← Older revision		Revision as of 23:59, 4 January 2024
Line 1:		Line 1:
	~~{{Under construction}}~~

	Rumba is a Python framework for setting up Ouroboros and RINA networks in a test environment that was developed during the [[History of Ouroboros#ARCFIRE \| ARCFIRE]] project. Its main objectives are to configure networks and to evaluate the impact of the architecture on configuration management and devops in computer and telecommunications networks. The original Rumba project page is [https://gitlab.com/ARCFIRE/Rumba here].		Rumba is a Python framework for setting up Ouroboros and RINA networks in a test environment that was developed during the [[History of Ouroboros#ARCFIRE \| ARCFIRE]] project. Its main objectives are to configure networks and to evaluate the impact of the architecture on configuration management and devops in computer and telecommunications networks. The original Rumba project page is [https://gitlab.com/ARCFIRE/Rumba here].

Line 9:		Line 7:
	* easily define network topologies		* easily define network topologies

	* Support for different prototypes]:		* Support for different prototypes:
	** Ouroboros		** Ouroboros<ref>Only Ouroboros is maintained in our git clone, it may not work anymore with rlite and IRATI.</ref>
	** rlite		** rlite
	** IRATI		** IRATI
Line 18:		Line 16:
	** docker container		** docker container
	** virtual machine (qemu)		** virtual machine (qemu)
	** jFed testbeds		** [https://jfed.ilabt.imec.be/ jFed] testbeds

	* script experiments		* script experiments

	* rudimentary support for drawing these networks (using pydot)		* rudimentary support for drawing these networks (using pydot)

			{{Under construction}}, see https://ouroboros.rocks/docs/tools/rumba/

			==Notes==
			<references />

Dimitri at 13:11, 8 November 2023

2023-11-08T13:11:25Z

← Older revision		Revision as of 13:11, 8 November 2023
Line 1:		Line 1:
	{{Under construction}}		{{Under construction}}

	Rumba is a Python framework for setting up Ouroboros (and RINA) networks in a test environment that was ~~originally~~ developed during the [[History of Ouroboros#ARCFIRE \| ARCFIRE]] project. Its main objectives are to configure networks and to evaluate ~~a bit~~ the impact of the architecture on configuration management and devops in computer and telecommunications networks. The original Rumba project page is [https://gitlab.com/ARCFIRE/Rumba here].		Rumba is a Python framework for setting up Ouroboros and RINA networks in a test environment that was developed during the [[History of Ouroboros#ARCFIRE \| ARCFIRE]] project. Its main objectives are to configure networks and to evaluate the impact of the architecture on configuration management and devops in computer and telecommunications networks. The original Rumba project page is [https://gitlab.com/ARCFIRE/Rumba here].

	Rumba can quickly set up test networks for Ouroboros that are made up of many IPCPs and ~~layers~~. ~~I try to~~ keep it up-to-date ~~for~~ the Ouroboros prototype.		Rumba can quickly set up test networks for Ouroboros that are made up of many IPCPs and Layers. We keep a version on this site up-to-date with the Ouroboros prototype.

	== Features ==		== Features ==