Утилита вывода версии миграции базы данных

Примечание

Все указанные в разделе команды выполняются только на контроллере.

Описание утилиты

Консольная утилита openstack tnx db list позволяет отслеживать версию миграции базы данных модуля.

Аргументы утилиты
Параметр Описание
-h, --help Вывод справки. Необязательный параметр.
-n, --names MODULE_NAMES Вывод версии миграции базы данных модулей, наименование которых задается параметром MODULE_NAMES. При нескольких наименованиях параметр разделяется пробелом. Необязательный параметр.
-v, --verbose Флаг для вывода детализированного сообщения об ошибке миграции базы данных. Необязательный параметр.

Примеры использования

Просмотр версии миграции модуля

Для просмотра версии миграции базы данных конкретных модулей используйте команду:

openstack tnx db list --names tnx_dashboard tnx_node_control

Где tnx_dashboard tnx_node_control - наименования модулей.

Пример результата:

openstack tnx db list --names tnx_dashboard tnx_node_control

Show actual db migrate versions for: tnx_dashboard, tnx_node_control

=========================
DB migrate versions table
=========================
+---+--------------------+---------+
| N | Module name        | Version |
+---+--------------------+---------+
| 1 │ TIONIX.Dashboard   |      10 |
+---+--------------------+---------+
| 2 │ TIONIX.NodeControl |      24 |
+---+--------------------+---------+

Для просмотра версии миграции базы данных сразу всех модулей используйте команду:

openstack tnx db list

Пример результата:

openstack tnx db list

Processing modules: tnx_client, tnx_dashboard, tnx_monitor, tnx_node_control, tnx_scheduler, tnx_vdi_server

=========================
DB migrate versions table
=========================
+---+---------------------+--------+---------+
| N | Module name         | Status | Version |
+---+---------------------+--------+---------+
| 1 | TIONIX.Client       | OK     | 4       |
+---+---------------------+--------+---------+
| 2 | TIONIX.Dashboard    | OK     | 11      |
+---+---------------------+--------+---------+
| 3 | TIONIX.Monitor      | OK     | 8       |
+---+---------------------+--------+---------+
| 4 | TIONIX.NodeControl  | OK     | 64      |
+---+---------------------+--------+---------+
| 5 | TIONIX.Scheduler    | OK     | 35      |
+---+---------------------+--------+---------+
| 6 | TIONIX.VDIserver    | OK     | 30      |
+---+---------------------+--------+---------+

Возникновение ошибок

Команда:

openstack tnx db list

Пример возникновения ошибок:

Processing modules: tnx_client, tnx_dashboard, tnx_monitor, tnx_node_control, tnx_scheduler, tnx_vdi_server

=========================
DB migrate versions table
=========================
+---+--------------------+------------------------------------------------------+
| N | Module name        | Version                                              |
+---+--------------------+------------------------------------------------------+
| 1 | TIONIX.Client      | Unknown DB Error. Please contact your administrator. |
+---+--------------------+------------------------------------------------------+
| 2 | TIONIX.Dashboard   | Unknown DB Error. Please contact your administrator. |
+---+--------------------+------------------------------------------------------+
| 3 | TIONIX.Monitor     | Unknown DB Error. Please contact your administrator. |
+---+--------------------+------------------------------------------------------+
| 4 | TIONIX.NodeControl | Unknown DB Error. Please contact your administrator. |
+---+--------------------+------------------------------------------------------+
| 5 | TIONIX.Scheduler   | Unknown DB Error. Please contact your administrator. |
+---+--------------------+------------------------------------------------------+
| 6 | TIONIX.VDIserver   | Unknown DB Error. Please contact your administrator. |
+---+--------------------+------------------------------------------------------+

Для вывода детализированного сообщения об ошибке повторите команду с флагом --verbose:

openstack tnx db list --verbose

Пример ответа:

Show actual db migrate versions for: tnx_dashboard, tnx_node_control, tnx_scheduler, tnx_vdi_server

=========================
DB migrate versions table
=========================
+---+--------------------+----------------------------------------------------------------+
| N | Module name        | Version                                                        |
+---+--------------------+----------------------------------------------------------------+
| 1 | TIONIX.Dashboard   | Error while getting migrate versions:                          |
|   |                    | (_mysql_exceptions.OperationalError) (2003, 'Can\'t connect to |
|   |                    | MySQL server on \'controller\'')                               |
+---+--------------------+----------------------------------------------------------------+
| 2 | TIONIX.Dashboard   | Error while getting migrate versions:                          |
|   |                    | (_mysql_exceptions.OperationalError) (2003, 'Can\'t connect to |
|   |                    | MySQL server on \'controller\'')                               |
+---+--------------------+----------------------------------------------------------------+
| 3 | TIONIX.Monitor     | Error while getting migrate versions:                          |
|   |                    | (_mysql_exceptions.OperationalError) (2003, 'Can\'t connect to |
|   |                    | MySQL server on \'controller\'')                               |
+---+--------------------+----------------------------------------------------------------+
| 4 | TIONIX.NodeControl | Error while getting migrate versions: Unable to get database   |
|   |                    | engine from engine facade                                      |
+---+--------------------+----------------------------------------------------------------+
| 5 | TIONIX.Scheduler   | Error while getting migrate versions:                          |
|   |                    | (_mysql_exceptions.OperationalError) (2003, 'Can\'t connect to |
|   |                    | MySQL server on \'controller\'')                               |
+---+--------------------+----------------------------------------------------------------+
| 6 | TIONIX.VDIserver   | Error while getting migrate versions: Unable to get database   |
|   |                    | engine from engine facade                                      |
+---+--------------------+----------------------------------------------------------------+

Описание таблицы результатов

Наименование поля Описание
N Порядковый номер модуля TIONIX.
Module name Наименование модуля TIONIX.
Version Версия миграции базы данных или ошибка, возникшая при миграции.