From cd21cba7d80f5e111bf857282fb4cfc94ef2cf36 Mon Sep 17 00:00:00 2001 From: Mike McLean Date: Jul 27 2020 19:48:24 +0000 Subject: some migrations notes changes --- diff --git a/docs/source/migrations/migrating_to_1.22.rst b/docs/source/migrations/migrating_to_1.22.rst index cd5d701..45f6289 100644 --- a/docs/source/migrations/migrating_to_1.22.rst +++ b/docs/source/migrations/migrating_to_1.22.rst @@ -6,13 +6,13 @@ You should consider the following changes when migrating to 1.22: DB Updates ---------- -There are no big database schema changes in this release. +There are two minor schema changes in this release. -We've updated all ``timestamp`` fields to ``timestamptz`` with the return value of -``get_event_time()`` function to avoid unexpected time offset caused by PostgreSQL timezone setting -(`PR#2237 `_) and regenerate -``sessions_active_and_recent`` index for ``session`` table for better performance (`PR#2334 -`_) +* we've updated all ``timestamp`` fields to ``timestamptz`` with the return value of + ``get_event_time()`` function to avoid unexpected time offset caused by PostgreSQL timezone + setting (`PR#2237 `_). +* we've updated the ``sessions_active_and_recent`` index for the ``session`` table for better + performance (`PR#2334 `_) As in previous releases, we provide a migration script that updates the database. @@ -24,19 +24,26 @@ As in previous releases, we provide a migration script that updates the database Dropped python2 support of hub and web -------------------------------------- -As Python2 has retired since Jan 1, 2020, we are now only providing python3 hub and web since koji -1.22. CLI, builder, and utils are not impacted. (`PR#2218 -`_) +Python 2 was `sunset `_ on January 1, 2020. +Starting with Koji 1.22, hub and web will only support Python 3. +The CLI, builder, and utils retain Python 2 support for now. +For more information see: `PR#2218 `_ Dropped krbV authentication support ----------------------------------- -As python-krbV is for python2 only, we dropped all the code related to krbV, and are now only -providing GSSAPI auth. For ``ClientSession`` object, ``krb_login()`` is redirected to -``gssapi_login()`` now, and you'd better change your client code to call the latter directly. Making -sure you have ``python-requests-kerberos`` installed on old client with koji 1.22 hub. (`PR#2244 -`_) +We have dropped all the code related to the old python-krbV library, and are now only +providing GSSAPI auth. +For ``ClientSession`` objects, ``krb_login()`` is redirected to +``gssapi_login()`` with a printed warning. +Any code still calling ``krb_login()`` directly should be updated. + +The newer gssapi authentication mechanism requires either ``python-requests-kerberos`` or +``python-requests-gssapi``. + +For more information see: `PR#2244 `_ and +`PR#2280 `_ Other changes