From ae9bdbaa351b9f6b30796bc3609e08990edcb3a3 Mon Sep 17 00:00:00 2001 From: Matt Riedemann Date: Thu, 18 Apr 2019 15:12:07 -0400 Subject: [PATCH] Remind people to use postgresql-migrate-db.sh when migrating data The "Upgrading from Nova to Placement" doc mentions the postgresql-migrate-db.sh script but within a big wall of text and the rest of the examples in the guide are using mysql, so people might miss the postgresql script which could result in errors later if their sequence ids are wrong. This adds a note to serve as a reminder. Change-Id: Id93531cc2d440b1adde1c0bd7c504f737b14012c Story: #2005478 Task: #30568 --- doc/source/upgrade/to-stein.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/doc/source/upgrade/to-stein.rst b/doc/source/upgrade/to-stein.rst index 645e19b45..2d89a4d09 100644 --- a/doc/source/upgrade/to-stein.rst +++ b/doc/source/upgrade/to-stein.rst @@ -120,6 +120,11 @@ Initial Steps * Create the configuration file. + .. note:: The examples in this guide are using MySQL but if you are using + PostgreSQL it is recommended to use the + `postgresql-migrate-db.sh`_ script since it handles sequences. + See `bug 2005478`_ for details. + .. code-block:: console $ mysql-migrate-db.sh --mkconfig /tmp/migrate-db.rc @@ -190,3 +195,4 @@ Finalize the Upgrade .. _alembic: https://alembic.sqlalchemy.org/en/latest/ .. _release notes: https://docs.openstack.org/releasenotes/placement/stein.html .. _osc-placement: https://docs.openstack.org/osc-placement/latest/ +.. _bug 2005478: https://storyboard.openstack.org/#!/story/2005478