X-Git-Url: https://code.grnet.gr/git/ganeti-local/blobdiff_plain/bcba4e013eee9eac35943efde857de13f6f8b878..82fca490d19922d567197de520b3b5aa5a707bba:/UPGRADE

diff --git a/UPGRADE b/UPGRADE
index a769b92..e193cfb 100644
--- a/UPGRADE
+++ b/UPGRADE
@@ -55,6 +55,14 @@ To run commands on all nodes, the `distributed shell (dsh)
 
     $ /usr/lib/ganeti/ensure-dirs --full-run
 
+#. Create the (missing) required users and make users part of the required
+   groups on all nodes::
+
+    $ /usr/lib/ganeti/tools/users-setup
+
+   This will ask for confirmation. To execute directly, add the ``--yes-do-it``
+   option.
+
 #. Restart daemons on all nodes::
 
     $ /etc/init.d/ganeti restart
@@ -64,8 +72,8 @@ To run commands on all nodes, the `distributed shell (dsh)
     $ gnt-cluster redist-conf
 
 #. If you use file storage, check that the ``/etc/ganeti/file-storage-paths``
-#. is correct on all nodes. For security reasons it's not copied
-#. automatically, but it can be copied manually via::
+   is correct on all nodes. For security reasons it's not copied
+   automatically, but it can be copied manually via::
 
    $ gnt-cluster copyfile /etc/ganeti/file-storage-paths
 
@@ -126,6 +134,16 @@ revert the configuration **before** installing the old version.
    upgrading again.
 
 #. Install the old Ganeti version on all nodes
+
+   NB: in Ganeti 2.8, the ``cmdlib.py`` file was split into a series of files
+   contained in the ``cmdlib`` directory. If Ganeti is installed from sources
+   and not from a package, while downgrading Ganeti to a pre-2.8
+   version it is important to remember to remove the ``cmdlib`` directory
+   from the directory containing the Ganeti python files (which usually is
+   ``${PREFIX}/lib/python${VERSION}/dist-packages/ganeti``).
+   A simpler upgrade/downgrade procedure will be made available in future
+   versions of Ganeti.
+
 #. Restart daemons on all nodes::
 
     $ /etc/init.d/ganeti restart