From 1a6d5bfa08b4ba618dcab68e4ed524c4db07da2b Mon Sep 17 00:00:00 2001 From: Richard van der Hoff Date: Thu, 20 Dec 2018 11:33:29 +0000 Subject: Debian packaging via dh_virtualenv (#4285) --- debian/NEWS | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) create mode 100644 debian/NEWS (limited to 'debian/NEWS') diff --git a/debian/NEWS b/debian/NEWS new file mode 100644 index 0000000000..367e08f851 --- /dev/null +++ b/debian/NEWS @@ -0,0 +1,22 @@ +matrix-synapse-py3 (0.34.0) stable; urgency=medium + + matrix-synapse-py3 is intended as a drop-in replacement for the existing + matrix-synapse package. The replacement should be relatively seamless, + however, please note the following important differences to matrix-synapse: + + * Most importantly, the matrix-synapse service now runs under Python 3 rather + than Python 2.7. + + * Synapse is installed into its own virtualenv (in /opt/venvs/matrix-synapse) + instead of using the system python libraries. (This may mean that you can + remove a number of old dependencies with `apt-get autoremove`). + + matrix-synapse-py3 will take over responsibility for the existing + configuration files, including the matrix-synapse systemd service. + + Beware, however, that `apt-get purge matrix-synapse` will *disable* the + matrix-synapse service (so that it will not be started on reboot), even + though that service is no longer being provided by the matrix-synapse + package. It can be re-enabled with `systemctl enable matrix-synapse`. + + -- Richard van der Hoff Wed, 19 Dec 2018 14:00:00 +0000 -- cgit 1.4.1 From d731b75c7bcada708f1acbb83e2521da6a7d97a9 Mon Sep 17 00:00:00 2001 From: Richard van der Hoff Date: Thu, 20 Dec 2018 14:55:41 +0000 Subject: Clarify that py2 packages will continue to exist --- debian/NEWS | 4 ++++ 1 file changed, 4 insertions(+) (limited to 'debian/NEWS') diff --git a/debian/NEWS b/debian/NEWS index 367e08f851..8f0d9d0acf 100644 --- a/debian/NEWS +++ b/debian/NEWS @@ -19,4 +19,8 @@ matrix-synapse-py3 (0.34.0) stable; urgency=medium though that service is no longer being provided by the matrix-synapse package. It can be re-enabled with `systemctl enable matrix-synapse`. + The matrix.org team will continue to provide Python 2 `matrix-synapse` + packages for the next couple of releases, to allow time for system + administrators to test the new packages. + -- Richard van der Hoff Wed, 19 Dec 2018 14:00:00 +0000 -- cgit 1.4.1 From a7aca672dfbd21f6dc3bbf8fba15ffabb1ffb5db Mon Sep 17 00:00:00 2001 From: Richard van der Hoff <1389908+richvdh@users.noreply.github.com> Date: Thu, 20 Dec 2018 22:05:27 +0000 Subject: clarify that installing -py3 removes the old pkg --- debian/NEWS | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) (limited to 'debian/NEWS') diff --git a/debian/NEWS b/debian/NEWS index 8f0d9d0acf..b70ed098e7 100644 --- a/debian/NEWS +++ b/debian/NEWS @@ -1,7 +1,8 @@ matrix-synapse-py3 (0.34.0) stable; urgency=medium matrix-synapse-py3 is intended as a drop-in replacement for the existing - matrix-synapse package. The replacement should be relatively seamless, + matrix-synapse package. When the package is installed, matrix-synapse will + be automatically uninstalled. The replacement should be relatively seamless, however, please note the following important differences to matrix-synapse: * Most importantly, the matrix-synapse service now runs under Python 3 rather @@ -9,12 +10,12 @@ matrix-synapse-py3 (0.34.0) stable; urgency=medium * Synapse is installed into its own virtualenv (in /opt/venvs/matrix-synapse) instead of using the system python libraries. (This may mean that you can - remove a number of old dependencies with `apt-get autoremove`). + remove a number of old dependencies with `apt autoremove`). matrix-synapse-py3 will take over responsibility for the existing configuration files, including the matrix-synapse systemd service. - Beware, however, that `apt-get purge matrix-synapse` will *disable* the + Beware, however, that `apt purge matrix-synapse` will *disable* the matrix-synapse service (so that it will not be started on reboot), even though that service is no longer being provided by the matrix-synapse package. It can be re-enabled with `systemctl enable matrix-synapse`. -- cgit 1.4.1 From ad1c68ad940b2313471723bf64c1948825bd196b Mon Sep 17 00:00:00 2001 From: Richard van der Hoff Date: Thu, 20 Dec 2018 23:27:29 +0000 Subject: Mention updating extensions --- debian/NEWS | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) (limited to 'debian/NEWS') diff --git a/debian/NEWS b/debian/NEWS index b70ed098e7..7b032d86bd 100644 --- a/debian/NEWS +++ b/debian/NEWS @@ -1,8 +1,8 @@ matrix-synapse-py3 (0.34.0) stable; urgency=medium matrix-synapse-py3 is intended as a drop-in replacement for the existing - matrix-synapse package. When the package is installed, matrix-synapse will - be automatically uninstalled. The replacement should be relatively seamless, + matrix-synapse package. When the package is installed, matrix-synapse will be + automatically uninstalled. The replacement should be relatively seamless, however, please note the following important differences to matrix-synapse: * Most importantly, the matrix-synapse service now runs under Python 3 rather @@ -12,6 +12,11 @@ matrix-synapse-py3 (0.34.0) stable; urgency=medium instead of using the system python libraries. (This may mean that you can remove a number of old dependencies with `apt autoremove`). + * If you have previously manually installed any custom python extensions + (such as matrix-synapse-rest-auth) into the system python directories, you + will need to reinstall them in the new virtualenv. Please consult the + documentation of the relevant extensions for further details. + matrix-synapse-py3 will take over responsibility for the existing configuration files, including the matrix-synapse systemd service. -- cgit 1.4.1