diff --git a/README.md b/README.md index 14e1fb137e421f705ee8b50c83df6bd00b4c5945..bafb1a3999195cce10c538f32b8a81e1a86e0910 100644 --- a/README.md +++ b/README.md @@ -19,7 +19,7 @@ the future development of Gluon. Please refrain from using the `master` branch for anything else but development purposes! Use the most recent release instead. You can list all relaseses by running `git tag` -and switch to one by running `git checkout v2016.2.3 && make update`. +and switch to one by running `git checkout v2016.2.4 && make update`. If you're using the autoupdater, do not autoupdate nodes with anything but releases. If you upgrade using random master commits the nodes *will break* eventually. diff --git a/docs/index.rst b/docs/index.rst index b1d40eab5371aa8892f4568a99b448d47eda1783..d5a23a8fb05f55df993050aafb747e0cf8ea1255 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -75,6 +75,7 @@ Releases .. toctree:: :maxdepth: 1 + releases/v2016.2.4 releases/v2016.2.3 releases/v2016.2.2 releases/v2016.2.1 diff --git a/docs/releases/v2016.2.4.rst b/docs/releases/v2016.2.4.rst new file mode 100644 index 0000000000000000000000000000000000000000..4fb060262c490511cede5b6606ab58492708ab2e --- /dev/null +++ b/docs/releases/v2016.2.4.rst @@ -0,0 +1,55 @@ +Gluon 2016.2.4 +============== + +Bugfixes +~~~~~~~~ + +* Fix batman-adv (compat 15) not being able to transmit packages of specific sizes (`b7eeef9 <https://github.com/freifunk-gluon/gluon/commit/b7eeef9b04b44a70b2a953c4efe35a3fdceba2db>`_) + + We suspect that this issue was also the reason for the autoupdater/wget hangs observed by many communities. + Non-Gluon nodes like gateways should be updated to batman-adv 2017.0.1 to get the fix. + +* Fix build after ftp.all.kernel.org discontinuation (`#1059 <https://github.com/freifunk-gluon/gluon/issues/1059>`_) + +* Fix high load because of frequent calls of the respondd initscript (`9a0aeb9 <https://github.com/freifunk-gluon/gluon/commit/9a0aeb9b7482df4e4515e61356b9d393e3a7eacb>`_) + + The respondd restart triggers added in v2016.2.3 ran a significant portion of the respondd initscript for each router advertisement + received. This was fixed by a backport of a netifd patch. + +* x86 sysupgrade fixes (`41fd50d <https://github.com/freifunk-gluon/gluon/commit/41fd50d20ba31d73c4796c5b2d4eb44ad2258b90>`_, + `ad37e2b <https://github.com/freifunk-gluon/gluon/commit/ad37e2b6b43b2c3389356d892b04f3873d8f6b93>`_) + + This fixes sysupgrade on mmcblk and similar devices. + +Other changes +~~~~~~~~~~~~~ + +* The manifest generator has been extended to generate SHA256 checksums in addition to SHA512 ones + (`f9d59be <https://github.com/freifunk-gluon/gluon/commit/f9d59be731efd31a26c59e049ccbdc4b1762f6b1>`_) + + We have recently switched the autoupdater to SHA256 in the Gluon master to avoid mixing two different + lengths of hashes for no good reason. This makes the manifests of Gluon v2016.2.x compatible with the + new autoupdater so it doesn't prevent backports or downgrades. + + **Note:** Downgrades of major Gluon versions are generally unsupported and will often lead to + broken configurations. + +Known Issues +~~~~~~~~~~~~ + +* x86 sysupgrade (sometimes) loses config when kernel partition grows (`#1010 <https://github.com/freifunk-gluon/gluon/issues/1010>`_) + + This issue affects upgrades from v2016.2.x and older to the Gluon master only, we hope to fix it before the next + major release. + +* Default TX power on many Ubiquiti devices is too high, correct offsets are unknown (`#94 <https://github.com/freifunk-gluon/gluon/issues/94>`_) + + Reducing the TX power in the Advanced Settings is recommended. + +* The MAC address of the WAN interface is modified even when Mesh-on-WAN is disabled (`#496 <https://github.com/freifunk-gluon/gluon/issues/496>`_) + + This may lead to issues in environments where a fixed MAC address is expected (like VMware when promicious mode is disallowed). + +* Inconsistent respondd API (`#522 <https://github.com/freifunk-gluon/gluon/issues/522>`_) + + The current API is inconsistent and will be replaced eventually. The old API will still be supported for a while. diff --git a/docs/user/getting_started.rst b/docs/user/getting_started.rst index 6c897902133c5d9e8eee5fd486b4e50694c1abf9..b42da7ea33693d74ede95a660846fb57eccb5d93 100644 --- a/docs/user/getting_started.rst +++ b/docs/user/getting_started.rst @@ -8,7 +8,7 @@ Gluon's releases are managed using `Git tags`_. If you are just getting started with Gluon we recommend to use the latest stable release of Gluon. Take a look at the `list of gluon releases`_ and notice the latest release, -e.g. *v2016.2.3*. Always get Gluon using git and don't try to download it +e.g. *v2016.2.4*. Always get Gluon using git and don't try to download it as a Zip archive as the archive will be missing version information. Please keep in mind that there is no "default Gluon" build; a site configuration @@ -43,7 +43,7 @@ Building the images ------------------- To build Gluon, first check out the repository. Replace *RELEASE* with the -version you'd like to checkout, e.g. *v2016.2.3*. +version you'd like to checkout, e.g. *v2016.2.4*. ::