From ea5d1a581b1ed3d0f35a5cbc23f28e1e3e5ad9ec Mon Sep 17 00:00:00 2001 From: Vladislav Belogrudov Date: Mon, 19 Jun 2017 16:54:58 +0300 Subject: [PATCH] Add documetation for kolla-mergepwd tool Change-Id: I7b542cacb9f21dd84a7e3864c7cd95565dbbf8fb Implements: blueprint kolla-merge-passwords --- doc/operating-kolla.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/doc/operating-kolla.rst b/doc/operating-kolla.rst index 1bdaa88971..7aec11025c 100644 --- a/doc/operating-kolla.rst +++ b/doc/operating-kolla.rst @@ -102,3 +102,18 @@ tests. .. note:: In order to do smoke tests, requires ``kolla_enable_sanity_checks=yes``. + +``kolla-mergepwd --old OLD_PASSWORDS --new NEW_PASSWORDS --final FINAL_PASSWORDS`` +is used to merge passwords from old installation with newly generated passwords +during upgrade of Kolla release. The workflow is: + +- save old passwords from ``/etc/kolla/passwords.yml`` into ``passwords.yml.old`` +- generate new passwords via ``kolla-genpwd`` as ``passwords.yml.new`` +- merge ``passwords.yml.old`` and ``passwords.yml.new`` into ``/etc/kolla/passwords.yml`` + +For example:: + + mv /etc/kolla/passwords.yml passwords.yml.old + cp kolla-ansible/etc/kolla/passwords.yml passwords.yml.new + kolla-genpwd -p passwords.yml.new + kolla-mergepwd --old passwords.yml.old --new passwords.yml.new --final /etc/kolla/passwords.yml