diff --git a/README.md b/README.md index 3488b842566841e1da248f86cc21d428c0534bdb..00d3f2e064dfa2dc47fc007d57f6569e8c5f9dab 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 releases by running `git tag` -and switch to one by running `git checkout v2017.1.5 && make update`. +and switch to one by running `git checkout v2017.1.6 && 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 3f4d78a870ac2caf56ed70ae8777ecbaba0455b4..d864279acfcbd79a77345c8162c44ce8c65317dd 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -67,6 +67,7 @@ Several Freifunk communities in Germany use Gluon as the foundation of their Fre :caption: Releases :maxdepth: 1 + releases/v2017.1.6 releases/v2017.1.5 releases/v2017.1.4 releases/v2017.1.3 diff --git a/docs/releases/v2017.1.6.rst b/docs/releases/v2017.1.6.rst new file mode 100644 index 0000000000000000000000000000000000000000..2a05ebb82749f8d02d701cced455600bc130e297 --- /dev/null +++ b/docs/releases/v2017.1.6.rst @@ -0,0 +1,91 @@ +Gluon 2017.1.6 +============== + +Bugfixes +~~~~~~~~ + +* Remove broken DNS cache feature + (`#1362 <https://github.com/freifunk-gluon/gluon/issues/1362>`_) + + It was found that dnsmasq does not handle all answer records + equally. In particular, its cached answers are missing DNSKEY and DS + records, breaking DNSSEC validation on clients. + + Nodes can still resolve the next-node hostname locally and will continue to + work as DNS forwarders. The DNS cache feature may return if dnsmasq is fixed + or if we switch to a different resolver. + +* Ensure that corefiles are stored in /tmp rather than cluttering the root + filesystem + (`00df8b76e54c <https://github.com/freifunk-gluon/gluon/commit/00df8b76e54c9bb89299df4b2ec49e972046d6b6>`_) + + Nodes upgrades from Gluon v2016.2.x or earlier did not set kernel.core_pattern + correctly, leading to corefiles being stored in the current directory (usually + / for system services) in the case of crashes. + + This is a regression introduced in Gluon v2017.1. + +* Only request a single IPv6 address instead of a prefix on the WAN interface + (`5db54ba78c3 <https://github.com/freifunk-gluon/gluon/commit/5db54ba78c3e245f06e4a407371608f6cb247b49>`_) + +* Fix signal graph on status page when there are many neighbours + (packages/`d1e0b6e0bdae <https://github.com/freifunk-gluon/packages/commit/d1e0b6e0bdaea14d8b9425cee6ca83087be1a905>`_) + +* Fix config files managed by opkg not being saved on sysupgrades on ar71xx-tiny + (LEDE/`17c0362178ca <https://git.openwrt.org/?p=openwrt/openwrt.git;a=commit;h=17c0362178caf837680a4631b8d0de94e5393448>`_, + LEDE/`75be005e8bdc <https://git.openwrt.org/?p=openwrt/openwrt.git;a=commit;h=75be005e8bdcbf86f9ad167a8737126dda98a444>`_) + +* Fix kernel crash in batman-adv-14 + (`#1358 <https://github.com/freifunk-gluon/gluon/issues/1358>`_) + + Starting with Gluon v2017.1, respondd could trigger a kernel crash caused by + a use-after-free in batman-adv-14, in particular after a gateway disappeared. + + batman-adv-15 is not affected. + +* Increase bridge multicast querier timeout ("robustness") to avoid + "querier appeared/disappeared" log spam by batman-adv in the presence of + an external querier + (`e305a8c01917 <https://github.com/freifunk-gluon/gluon/commit/e305a8c019179472dbfc6fccea6c87cf40c08a75>`_) + +* Fix "broken pipe" log spam caused by the status page + (`883c32f2f1dc <https://github.com/freifunk-gluon/gluon/commit/883c32f2f1dc368626069865c07a5701e3e9bcae>`_) + +* Reduce memory limit of WLAN packet queues to 256KB on devices with small RAM + (`e63c6ca01f50 <https://github.com/freifunk-gluon/gluon/commit/e63c6ca01f50c96d76e5570faa290617a8a312b4>`_) + + Will hopefully make out-of-memory crashes in busy meshes less likely. + +* Improve image validation for TP-Link CPE/WBS 210/510 and make it ready for + future images + (LEDE/`6577fe2198f5 <https://git.openwrt.org/?p=openwrt/openwrt.git;a=commit;h=6577fe2198f5c75acb1dba789941d96a036f4dae>`_) + + Future OpenWrt/Gluon images will move the image metadata ("support-list") of + the CPE/WBS 210/510 images to a different offset. Make sysupgrade ready + to allow installing such images. + + This change was also backported to Gluon v2016.2.x to allow direct updates + to future Gluon master versions without installing v2017.1.x first. + +* Sporadic segfaults of busybox (ash) when running shell scripts on ar71xx + have disappeared with the latest updates + (`#1157 <https://github.com/freifunk-gluon/gluon/issues/1157>`_) + + +Known issues +~~~~~~~~~~~~ + +* 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. + +* Frequent reboots due to out-of-memory on weak hardware in larger meshes + (`#1243 <https://github.com/freifunk-gluon/gluon/issues/1243>`_) diff --git a/docs/user/getting_started.rst b/docs/user/getting_started.rst index 0ca98091e80b0f01bb818929472ca2f261c47f83..ab2521061d3c1a11eee88e3f230dd73151b9a937 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. *v2017.1.5*. Always get Gluon using git and don't try to download it +e.g. *v2017.1.6*. 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. *v2017.1.5*. +version you'd like to checkout, e.g. *v2017.1.6*. ::