3.7.8

Deprecation

⚠️ WARNING: The ltest command is deprecated and will be removed in the next release. 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

3.6.3

• Use chardet to parse all byte strings in order to correctly encode non-UTF8 characters (#208)
• Wait for startup commands execution while opening a connection to a device (the wait can be overridden by pressing [ENTER]) (#209)
• Keep correct folders/files permissions when copying files inside the device
• Fix sysctl metadata parsing for negative values (#226)
• Fix machine.is_ipv6_enabled() method to correctly follow priority of ipv6 meta (#227)
• Rename startup_commands meta to exec_commands to avoid ambiguity with .startup files (#228)
• Add new helper methods to model.Lab (#229)
• Minor fixes
• Add Homebrew tap for installing Kathará on macOS

Contributors:
@Skazza94
@tcaiazzi
@lorenzo93

3.6.2

• Add a warning message if a meta is assigned more than once on the same device (#219)
• Add support for Docker images tags in kathara settings (#218)
• Fix Python FilesystemMixin APIs for file modifications (#220)
• Fix error message in Lab.new_machine() (#221)
• Fix Docker api_object reload in Machine when disconnecting an existing link at runtime (#224)
• ⚠️ DEPRECATION WARNING: End of support for Ubuntu Bionic (18.04 LTS). Starting from this Release, the package will not be updated anymore.
• ⚠️ DEPRECATION WARNING: End of support for Ubuntu Kinetic (22.04). Starting from next Release, the package will not be updated anymore.

Contributors:
@Skazza94
@tcaiazzi