diff --git a/docs/releasenotes.rst b/docs/releasenotes.rst index d0fbc0316d2fbd09ef4ed4bed06d3a455c8fd4aa..d872c4d583f823e163b51b6d355b276476fc0ba9 100644 --- a/docs/releasenotes.rst +++ b/docs/releasenotes.rst @@ -2,6 +2,31 @@ Release notes ============= +NEXT RELEASE +------------ + +Breaking changes: + +* ``xmpp_server`` role + + * Installs Prosody nightly builds (default version 0.10) instead of + latest stable. Change made to improve reproducability, and to + avoid future breakages after new major/minor releases of + Prosody. Prosody package name can be specified through the + ``xmpp_prosody_package`` variable. + + This should most likely not break anything, but is included as + possibly breaking change nevertheless since it is a big change in + how Prosody is installed. + + This change had to be done because LDAP integration broke with + Prosody 0.11 due to missing LDAP bindings for Lua 5.2. See + `MAR-137: XMPP server LDAP integration not working for Prosody + 0.11.x + `_ + for more details. + + 2.0.0 ----- diff --git a/docs/rolereference.rst b/docs/rolereference.rst index 68af373fba627fde71e08d398f3d34d87ceabf68..64181e092e44b42165bdc41b1fcaf4b906d68e65 100644 --- a/docs/rolereference.rst +++ b/docs/rolereference.rst @@ -894,6 +894,12 @@ Parameters Fully qualified domain name, hostname, or IP address of the LDAP server used for user authentication and listing. +**xmpp_prosody_package** (string, optional, ``prosody-0.10``) + Name of Prosody package from the Prosody repositories to + install. This makes it possible to easily test the latest Prosody or + to switch to a different nightly builds. It should be noted that + only the default version is getting properly tested. + **xmpp_tls_certificate** (string, optional, ``{{ lookup('file', tls_certificate_dir + '/' + fqdn + '_xmpp.pem') }}``) X.509 certificate used for TLS for XMPP service. The file will be stored in directory ``/etc/ssl/certs/`` under name ``{{ ansible_fqdn }}_xmpp.pem``.