3.8.0

Changelog

• ⚠️ BREAKING: The ltest command has been removed (#358). Please use the kathara-lab-checker tool as its replacement with enhanced functionalities. For further information, visit: https://github.com/KatharaFramework/kathara-lab-checker
• Add the possibility to mount additional volumes on devices using the volume metadata (#332)
• Allow to run a single device in privileged mode using the privileged metadata (#354)
• Add the possibility to specify custom entrypoint and arguments for a device using the entrypoint and args metadata (#355)
• Allow specifying per-network-scenario kathara.conf configuration file (#340)
• (Python API) Add retrieve_files method to copy files from devices to the host (#357)
• Minor fixes (#352 #353 #356 #360 #361)

Contributors:
@Skazza94
@tcaiazzi

3.7.9

Changelog

• (Docker) Fix user-defined interface-specific sysctls on Docker Engine >= v27.0.0 (#348)
• Open device terminals when --privileged flag is set (#349 #329)
• Assign device FQDN in /etc/hosts (if no /etc/hosts is passed by the user) (#341)
• Fix TMUX issues (#333)

Contributors:
@Skazza94
@tcaiazzi

3.7.8

Deprecation

⚠️ WARNING: The ltest command is deprecated and will be removed in the next releases. Please use the kathara-lab-checker tool as its replacement with enhanced functionalities.

For further information, visit: https://github.com/KatharaFramework/kathara-lab-checker

New Features and Improvements

• Add --topology argument to kathara linfo that displays a list of collision domains and the devices connected to each of them (#323)
• kathara linfo now displays a column with the connected interfaces of each device (#321)
• kathara exec now returns the exact exit code of the command (#292)
• API Improvements in the Lab object (#325 #326)
• (Docker) Add the possibility to specify ulimits in network scenario metadata (thanks to @g4br-i) (#302)
• (Kubernetes) Add the support to private image registries through the docker.json file (thanks to @GioBar00) (#282)

Bug Fixes

• (Docker) Fix compatibility with docker-io version numbers (#309)
• (Docker) Fix rp_filter sysctl assigment on Docker Engine >= v27.0.0 (#320)
• Minor bug fixes (#322 #324)

Contributors:
@tcaiazzi
@Skazza94
@g4br-i
@GioBar00

3.7.7

Bug Fixes

• Properly set driver options to disable/enable IPV6 (#306)
• Minor adjustments and optimizations

NOTE
We encountered some issues while compiling the package on Arch Linux. Our team is actively working on resolving these problems to release the Arch (and AUR) package as soon as possible.

We apologize for any inconvenience this may cause and appreciate your patience.

3.7.6

New Features and Improvements

• Add the possibility to exclude machines while deploying a network scenario, both from CLI and Python APIs (#294)

Bug Fixes

• Fix IPv6 disabling issue (#293)
• Minor

Contributors:
@tcaiazzi
@Skazza94

3.7.5

• (Docker) Fix rp_filter issue on all platforms and Docker versions (#278)
• (Docker) Fix Docker API objects reloading (#285)
• Minor fixes (#284)

⚠️ NOTE: Differently from version 3.7.4, the new version is compatible with any Docker version.

Contributors:
@tcaiazzi
@Skazza94

3.7.4

• (Docker) Fix rp_filter on eth0 that was causing startup errors on some distributions (#278) (thanks to @whatever4711)
• (Megalos) Fix watch methods while starting/stopping devices that were causing lstart/lclean to hang indefinitely (#277)
• Minor fixes

⚠️ WARNING! Update to this version only AFTER updating Docker Engine to v26.0.0!

Contributors:
@whatever4711
@Skazza94
@tcaiazzi

3.7.3

• New CLI UI using rich library! (#269)
• (Docker) Show progress during Docker image pull (#267)
  • Similarly to the official docker pull command
• (Docker) It is now correctly possible to specify a linux/amd64 image on Apple Silicon (#268)
  • They can be run using Rosetta
• Add gnome-terminal as official supported terminal emulator (#264)
• Several API improvements and bug fixes (#271)

Contributors:
@tcaiazzi
@Skazza94

3.7.1

• It is now possible to specify a MAC Address for a network interface (#137)
  • The MAC Address can be specified in the lab.conf and using the vstart/lstart/vconfig/lconfig commands when declaring an interface. The syntax is <COLLISION_DOMAIN>/<MAC_ADDRESS>.
  • For example, in a lab.conf file: machine[0]="A/00:00:00:00:00:01".
• (Docker) Collision domains are now created per-network-scenario by default (#256)
  • Previously, they were shared between different scenarios. It is possible to change the default behaviour from kathara settings.
• (Docker) If a .shutdown file is present in the network scenario, Kathará now correctly waits for the script termination before removing the container (#255)
• Several fixes of lconfig and vconfig commands (#252)
• Add lab object parameter to all Manager methods (#254)
  • Methods now correctly check if only one of the parameters between lab_hash, lab_name, and lab is passed.
• Minor fixes and improvements (#257 #258 #259 #261)

Contributors:
@tcaiazzi
@Skazza94

3.7.0

• Add support for the new Kathará Network Plugin based on VDE software switches. It is possible to select the legacy Network Plugin (based on Linux Bridges) from kathara settings (#241)
  • For further information on the new Network Plugin, please visit the corresponding repository.
• Switch the default image to kathara/base for new installations (#243)
• Fix Docker images fetching in kathara settings with new Docker Hub API format (#244)

Contributors:
@Skazza94
@tcaiazzi