База знаний
Войти

Интерфейс командной строки rv-dr-sync

Rv-dr-sync ‒ утилита, работающая на хосте, где расположен ЦУ (СУСВ). Её задача: применить инкременты базы данных (основной виртуализации), полученные в ходе синхронизации Disaster Recovery. Применение инкрементов осуществляется автоматически (за счет установки сервиса rv-dr-sync.service) при запуске ovirt-engine. Инкременты базы данных представляют собой SQL-дамп с метаданными о синхронизируемой ВМ, состоянии дисков, хеш-суммы и т. п.

rv-dr-sync

usage: rv-dr-sync [-h] [--debug] [--stdout-level {debug,info,warning,error}]
[--syslog-level {debug,info,warning,error}] [-v]
...
rv-dr-sync [0.1]‒ Specialized utility for managing database increments.
Do not use this utility if you are unsure of its purpose, as it may damage the database!
optional arguments:
-h, --help show this help message and exit
--debug Enable debug mode.
--stdout-level {debug,info,warning,error}
Logging level for stdout.
--syslog-level {debug,info,warning,error}
Logging level for syslog.
-v, --version Show program version.
subcommands:
status Check service status.
list Retrieve various information. The database must be online.
run Launch the utility—only if you are sure.
setup Service setup, including first launch.
ovirt-run Temporarily start ovirt-engine without the rv-dr-sync dependency.
ovirt-stop Stop the temporary service "ovirt-engine-tmp". See the "ovirt-run" command.

где:

  • -h, --help ‒ вызов справки;
  • -v, --version ‒ показать текущую версию rv-dr-sync;
  • --debug ‒ режим отладки (более подробное логирование и вывод);
  • --stdout-level {debug,info,warning,error} ‒ выбор уровня критичности сообщений для вывода в терминал;
  • --syslog-level {debug,info,warning,error} ‒ выбор уровня критичности сообщений для вывода в syslog;
  • status ‒ отобразить текущее состояние сервиса rv-dr-sync.service.

Пример вывода:

{
'Id': 'rv-dr-sync.service',
'Description': 'Processes database increments after PostgreSQL has started and before oVirt Engine launches.',
'LoadState': 'loaded',
'ActiveState': 'failed',
'SubState': 'failed',
'FragmentPath': '/etc/systemd/system/rv-dr-sync.service'
}
  • list ‒ работа со списками: кластеры, CPU-профили, сети. По умолчанию, если вызывать без аргументов, отобразит комбинированный список, содержащий вышеперечисленное в одной таблице (для подробностей см. раздел rv-dr-sync list);
  • run ‒ ручной запуск применения инкрементов (для подробностей см. раздел rv-dr-sync run);

Важно – Команда run используется для отладки.

  • setup ‒ набор команд для установки в системе rv-dr-sync (для подробностей см. раздел rv-dr-sync setup);
  • ovirt-run ‒ запустить сервис ovirt-engine.service без зависимости от сервиса rv-dr-sync.service. В этом случае будет создан временный сервис ovirt-engine-tmp.service.
  • ovirt-stop ‒ остановить временный сервис ovirt-engine-tmp.service.
  • Важно – Команда ovirt-stop используется для отладки.
    Пример:
    rv-dr-sync -h
rv-dr-sync list -h
rv-dr-sync run -h
rv-dr-sync status
rv-dr-sync setup -h
rv-dr-sync ovirt-run
rv-dr-sync ovirt-stop

rv-dr-sync list

usage: rv-dr-sync list [-h] [-s SEARCH] [--json] [RESOURCE]
positional arguments:
Select RESOURCE to display:
clusters‒ get list of available clusters.
cpu-profiles‒ get list of available CPU profiles.
networks‒ get list of available networks.
combined‒ (default) display a combined list of CPU profiles and networks mapped to the cluster.
optional arguments:
-h, --help show this help message and exit
-s SEARCH, --search SEARCH
Filter entries for resources whose names contain the given text.
--json Output entries as JSON.
Example: rv-dr-sync list clusters -s "50fb"
```
где:
  • -h, --help ‒ вызов справки;
  • -s SEARCH, --search SEARCH ‒ искать и отобразить только те записи, которые содержат текст SEARCH. Возможно частичное совпадение. Обнаруженная часть будет подсвечена в таблице;
  • --json ‒ форматировать вывод в JSON;
  • clusters ‒ отобразить список кластеров резервной виртуализации;

Пример вывода:

cluster_id  name   description
─────────────────────────────────────────────
7c9a549e-bfe4-11f0-8554-000005a0b0c0 Default The default server cluster
  • cpu-profiles ‒ отобразить список CPU-профилей резервной виртуализации;

Пример вывода:

id name cluster_id description
────────────────────────────────────────────────
58ca604e-01a7-003f-01de-000000000250 Default 7c9a549e-bfe4-11f0-8554-000005a0b0c0
  • networks ‒ отобразить список сетевых интерфейсов резервной виртуализации;

Пример вывода:

id name    description
─────────────────────────────────────────────
00000000-0000-0000-0000-000000000009 ovirtmgmt Management Network
  • combined ‒ отобразить список кластеров, CPU-профилей и сетевых интерфейсов в одной таблице.

Пример вывода:

cluster_id cpu_profile_id network_ids
─────────────────────────────────────────────
7c9a549e-bfe4-11f0-8554-000005a0b0c0 58ca604e-01a7-003f-01de-000000000250 00000000-0000-0000-0000-000000000009

Пример:

rv-dr-sync list
rv-dr-sync list clusters
rv-dr-sync list cpu-profiles
rv-dr-sync list networks
rv-dr-sync list combined
rv-dr-sync list networks -s bfe4
rv-dr-sync list --search bfe4

rv-dr-sync run

Важно – Эта команда используется автоматически; ручное использование ‒ только для отладки.

usage: rv-dr-sync run [-h] UUID [url]
positional arguments:
UUID UUID (or name) of the disaster storage.
url Storage path in the format [user@]<host>[:port]/<path>".
Where:
user‒ SSH username
host‒ storage host address
port‒ SSH port
path‒ storage directory path.
optional arguments:
-h, --help show this help message and exit
Example: rv-dr-sync run 458750b3-2e3d-4aa9-9fb7-c0a2680afc20 root@host1.local:22/NFS

где:

  • -h, --help ‒ вызов справки;
  • <UUID> ‒ UUID или имя резервного хранилища. Если при указании имени резервного хранилища возникают ошибки, можно попробовать указать UUID;
  • <url> = [user@]<host>[:port]/<path> ‒ полный адрес (включая пользователя для авторизации на хосте, где расположено резервное хранилище) директории резервного хранилища, например root@host2.local/data/hosted_storage, используется для подключения по SSH., где:
  • user ‒ имя пользователя при авторизации на хосте с резервным хранилищем;
  • host ‒ адрес хоста с резервным хранилищем;
  • port ‒ (необязательный) SSH-порт хоста с резервным хранилищем;
  • path ‒ путь к точке монтирования резервного хранилища на хосте.

Пример:

rv-dr-sync run hosted_storage root@host2.local/data/hs
rv-dr-sync run ecec600d-3e8c-428c-a113-b3e111d58a7e root@host2.local/data/hs

rv-dr-sync setup

usage: rv-dr-sync setup [-h] ...
Commands required to configure the service, including for the first run.
optional arguments:
-h, --help show this help message and exit
subcommands:
service Install systemd service.
storage Configure SSH or local access to the disaster storage.
uninstall Uninstall systemd service.

где:

  • -h, --help ‒ вызов справки;
  • service ‒ установить systemd-сервис rv-dr-sync.service. Этот сервис будет установлен в качестве зависимости для ovirt-engine.service;

Важно – Эта команда должна вызываться до команды storage. Обе эти команды должны быть использованы вместе.

  • storage <UUID> <url> ‒ настроить rv-dr-sync.service для работы с резервным хранилищем;

Важно – Эта команда должна вызываться после команды service. Обе эти команды должны быть использованы вместе.

Примечание ‒ Эта команда подерживает переменную окружения RV_DR_SYNC_SSH_PASS. С её помощью можно передать в команду пароль для авторизации (SSH) на хосте с смонтированным резервным хранилищем, чтобы избежать интерактивного диалога с вводом пароля.

  • <UUID> ‒ UUID или имя резервного хранилища. Если при указании имени резервного хранилища возникают ошибки, можно попробовать указать UUID;
  • <url> = [user@]<host>[:port]/<path> ‒ полный адрес (включая пользователя для авторизации на хосте, где расположено резервное хранилище) директории резервного хранилища, например root@host2.local/data/hosted_storage, используется для подключения по SSH, где:
  • user ‒ имя пользователя при авторизации на хосте с резервным хранилищем;
  • host ‒ адрес хоста с резервным хранилищем;
  • port ‒ (необязательный) SSH-порт хоста с резервным хранилищем;
  • path ‒ путь к точке монтирования резервного хранилища на хосте;
  • uninstall ‒ удалить сервис rv-dr-sync.service и восстановить оригинальный ovirt-engine.service.

Пример:

rv-dr-sync setup service
rv-dr-sync setup storage hosted_storage root@host2.local/data/hs
rv-dr-sync setup storage ecec600d-3e8c-428c-a113-b3e111d58a7e root@host2.local/data/hs
RV_DR_SYNC_SSH_PASS='my_password' rv-dr-sync setup storage hosted_storage root@host2.local/data/hs
rv-dr-sync setup uninstall