Merge pull request #1260 from bruno-at-bareos/dev/bruno/master/docs-f…

…ix-upgrade-19-to-20-ubuntu-18.04

docs: add FAQ entry about howto upgrade from Bareos < 20 with Bareos Python packages installed

CHANGELOG.md

@@ -175,6 +175,7 @@ and since Bareos version 20 this project adheres to [Semantic Versioning](https:
 - describe Debian installation based on add_bareos_repositories.sh [PR #1238]
 - update Pull Request workflow description [PR #1243]
 - docs: improve operating system table [PR #1254]
+- add FAQ entry about howto upgrade from Bareos < 20 with Bareos Python packages installed [PR #1260]
 
 [PR #698]: https://github.com/bareos/bareos/pull/698
 [PR #768]: https://github.com/bareos/bareos/pull/768
@@ -242,6 +243,7 @@ and since Bareos version 20 this project adheres to [Semantic Versioning](https:
 [PR #1154]: https://github.com/bareos/bareos/pull/1154
 [PR #1155]: https://github.com/bareos/bareos/pull/1155
 [PR #1159]: https://github.com/bareos/bareos/pull/1159
+[PR #1161]: https://github.com/bareos/bareos/pull/1161
 [PR #1162]: https://github.com/bareos/bareos/pull/1162
 [PR #1163]: https://github.com/bareos/bareos/pull/1163
 [PR #1169]: https://github.com/bareos/bareos/pull/1169
@@ -256,6 +258,7 @@ and since Bareos version 20 this project adheres to [Semantic Versioning](https:
 [PR #1181]: https://github.com/bareos/bareos/pull/1181
 [PR #1183]: https://github.com/bareos/bareos/pull/1183
 [PR #1185]: https://github.com/bareos/bareos/pull/1185
+[PR #1186]: https://github.com/bareos/bareos/pull/1186
 [PR #1187]: https://github.com/bareos/bareos/pull/1187
 [PR #1188]: https://github.com/bareos/bareos/pull/1188
 [PR #1189]: https://github.com/bareos/bareos/pull/1189
@@ -270,6 +273,8 @@ and since Bareos version 20 this project adheres to [Semantic Versioning](https:
 [PR #1209]: https://github.com/bareos/bareos/pull/1209
 [PR #1210]: https://github.com/bareos/bareos/pull/1210
 [PR #1211]: https://github.com/bareos/bareos/pull/1211
+[PR #1213]: https://github.com/bareos/bareos/pull/1213
+[PR #1215]: https://github.com/bareos/bareos/pull/1215
 [PR #1216]: https://github.com/bareos/bareos/pull/1216
 [PR #1217]: https://github.com/bareos/bareos/pull/1217
 [PR #1218]: https://github.com/bareos/bareos/pull/1218
@@ -288,5 +293,10 @@ and since Bareos version 20 this project adheres to [Semantic Versioning](https:
 [PR #1237]: https://github.com/bareos/bareos/pull/1237
 [PR #1238]: https://github.com/bareos/bareos/pull/1238
 [PR #1242]: https://github.com/bareos/bareos/pull/1242
+[PR #1243]: https://github.com/bareos/bareos/pull/1243
+[PR #1247]: https://github.com/bareos/bareos/pull/1247
 [PR #1251]: https://github.com/bareos/bareos/pull/1251
+[PR #1253]: https://github.com/bareos/bareos/pull/1253
+[PR #1254]: https://github.com/bareos/bareos/pull/1254
+[PR #1260]: https://github.com/bareos/bareos/pull/1260
 [unreleased]: https://github.com/bareos/bareos/tree/master

docs/manuals/source/Appendix/FAQ.rst

@@ -12,6 +12,47 @@ The process for handling security-related problems is described in our GitHub `s
 
 .. _security policy: https://github.com/bareos/bareos/security/policy
 
+.. _bareos-1920-updatefaq:
+
+Upgrade of Bareos 19.2 with installed Python plugin on Debian
+-------------------------------------------------------------
+
+.. index::
+   single: Platform; Debian
+   single: bareos-19.2; Upgrade with Python packages on Debian
+
+On Debian platform, if you update from Bareos <=19.2 to Bareos >= 20 with any Python plugin installed, you will face some difficulties with :command:`apt upgrade`.
+This is due to the renaming of Python plugin packages into python2 packages and introducing the python3 packages. apt/dpkg is not able to handle this situation alone.
+
+
+.. code-block:: shell-session
+   :caption: Error upgrading from 19.2 with apt upgrade
+
+   apt upgrade bareos bareos-director bareos-filedaemon
+   Reading package lists... Done
+   Building dependency tree
+   Reading state information... Done
+   Calculating upgrade... Done
+   Some packages could not be installed. This may mean that you have
+   requested an impossible situation or if you are using the unstable
+   distribution that some required packages have not yet been created
+   or been moved out of Incoming.
+   The following information may help to resolve the situation:
+
+   The following packages have unmet dependencies:
+      bareos-director-python-plugin : Depends: bareos-common (= 19.2.12-2) but 21.1.2-1 is to be installed
+      bareos-filedaemon-python-plugin : Depends: bareos-common (= 19.2.12-2) but 21.1.2-1 is to be installed
+   E: Broken packages
+
+
+In this case, it is advised to use :command:`apt` with `full-upgrade` and directly move to new recommended python3 plugin.
+
+.. code-block:: shell-session
+   :caption: for full upgrade to python3
+
+   apt full-upgrade bareos-director-python3-plugin bareos-filedaemon-python3-plugin
+
+
 .. _bareos-1825-updatefaq:
 
 Bareos 18.2.5 FAQ