diff --git a/README.md b/README.md index 151d06b8eca60c6eae6f4f2df3296c2ba9985d4e..e7e0ea924afe8a218254daa9ad4d1f1862a2ff6e 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 v2017.1 && make update`. +and switch to one by running `git checkout v2017.1.1 && 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 e509a990b5611251e5f226b4734570ac281ad2ac..53c5012a857ce1198dbb3020428dd9c55958f1b4 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -64,6 +64,7 @@ Several Freifunk communities in Germany use Gluon as the foundation of their Fre :caption: Releases :maxdepth: 1 + releases/v2017.1.1 releases/v2017.1 releases/v2016.2.6 releases/v2016.2.5 diff --git a/docs/releases/v2017.1.1.rst b/docs/releases/v2017.1.1.rst new file mode 100644 index 0000000000000000000000000000000000000000..7a3cf65378ec36acf60f9897c006f86c5c44ddf5 --- /dev/null +++ b/docs/releases/v2017.1.1.rst @@ -0,0 +1,41 @@ +Gluon 2017.1.1 +============== + +Bugfixes +~~~~~~~~ + +* The autoupdater manifest has been extended to allow automatic upgrades from + old *x86-kvm* and *x86-xen_domu* systems to the new *x86-generic* image + (`869ceb4 <https://github.com/freifunk-gluon/gluon/commit/869ceb425cd5f9db3eafddcc52377fd94c6ba0dd>`_) + +* Make flash writable again on Ubiquiti PicoStations with certain bootloader + versions (and possibly other devices) + (`9a787c9 <https://github.com/freifunk-gluon/gluon/commit/9a787c9878069158151c843b8fd9aa338815d61e>`_) + + Units affected by this issue running Gluon v2017.1 can't leave config mode and + no regular sysupgrades are possible. TFTP recovery is necessary to make them + work again. + +* Add workaround to prevent sporadic segfaults of busybox (ash) when running shell scripts on ar71xx + (`#1157 <https://github.com/freifunk-gluon/gluon/issues/1157>`_) + +* Disable batman-adv multicast optimizations to work around issue causing large + amounts of management traffic + (`819758f <https://github.com/freifunk-gluon/gluon/commit/819758f4250af8820851945ba1a6c17748b0ab4b>`_) + + Multicast optimizations will be enabled again when a proper fix is available. + +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. diff --git a/docs/user/getting_started.rst b/docs/user/getting_started.rst index 1330bd919dfbe6df853b0efcab0e7415c995c615..dc158efa43c238b7f4e7eb62892a1699521006ed 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*. Always get Gluon using git and don't try to download it +e.g. *v2017.1.1*. 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*. +version you'd like to checkout, e.g. *v2017.1.1*. ::