Skip to content

Latest commit

 

History

History
120 lines (68 loc) · 4.29 KB

CHANGELOG.md

File metadata and controls

120 lines (68 loc) · 4.29 KB
Raw

Changelog

Release v4.0.0

Link to release

Introduced support to new OS and WOSS versions:

  • OS: Ubuntu 22.04 LTS

  • WOSS: 1.12.6

Moreover, starting from this release images are based on egiona/ns3-base, effectively decoupling the support for new ns-3 versions from WOSS. This choice aims at providing more granularity for end users, as well as allowing the upgrade of ns-3 version independently from WOSS.

For instance, at the time of the present release, WOSS 1.12.6 cannot be integrated with ns-3 due to the latest changes to the core module shipped in ns-3.41.

Release v3.0.1

Link to release

Users are urged to update to any of the images hereby released.

Introduced support to new OS, ns-3, and WOSS versions:

  • OS: Ubuntu 20.04 LTS

  • ns-3: 3.40

  • WOSS: 1.12.5

Differently from previous releases, new images pair all supported ns-3 versions with WOSS 1.12.5.

This release fixes these critical issues:

  • GCC version mismatch between WOSS requirements, WOSS library and ns-3

    Starting from ns-3.36, GCC 8 became the minimum supported version. More details can be found at this page.

    Images released prior to v3.0.1 bundled ns-3.37 with WOSS using Ubuntu 18.04 LTS as base image, causing the issue. Indeed, while ns-3 was being built with GCC 8, WOSS library and its dependencies were instead built and linked using the system-default GCC 7.5.0. During simulation execution, segmentation faults were occurring due such mismatch in GCC versions.

    In order to fix this issue, upgrading to Ubuntu 20.04 LTS is a quick solution since the system-default GCC version is 9.3.0. While this upgrade solved the problem for ns-3.40, it did not prove successful for ns-3.37. As a result, all ns-3.37 images are discontinued; users should upgrade to ns-3.40 introduced in v3.0.1.

  • Situational WOSS crashes (due to HDF5 and/or NetCDF-C)

    WOSS users designing simulations with long running time and/or large networks might encounter crashes from the NetCDF library. More details can be found at this page.

    In order to fix this issue, upgrading all WOSS requirements to their latest versions proved to be a solution to this problem. As a result, all images prior to v3.0.1 should NOT be used in case you encounter this problem during your WOSS-based simulations.

Minor changes:

  • Instructions in each Dockerfile have been re-arranged to reduce the number of layers

Release v2.0.1

Link to release

Various updates to all supported images (revision r2):

  • improved Dockerfile with: parametrized ns-3 and WOSS versions, separation of debug and optimized build directories

  • uniformed functionality of scripts build-debug.sh and build-optimized.sh across ns-3 versions

  • introduced utility Makefile to images released in v1.0.0

Release v1.1.0

Link to release

Introduced support to new ns-3 and WOSS versions:

  • ns-3: 3.37

  • WOSS: 1.12.4

ns-3 adopted the CMake build system starting from 3.36 release.

As a result, a new container filesystem has been designed, featuring separate ns-3 build directories depending on the profiles: ns-3.xx-debug and ns-3.xx-optimized directories respectively contain identical ns-3 source tree, permanently kept in their specific build profile.

More details can be found at this page.

Release v1.0.0

Link to release

Initial release.

Supported versions:

  • OS: Ubuntu 18.04 LTS

  • ns-3: from 3.33 to 3.35

  • WOSS: from 1.12.0 to 1.12.2