8.6 Инструмент для смены доменного имени Engine
Скачать документ Синтаксис команды
Процедура смены доменного имени Engine
Когда команда engine-setup
запускается в чистой среде, она создает ряд сертификатов и ключей, в которых используется полное доменное имя Engine, указанное в процессе установки. Если полное доменное имя Engine позднее необходимо изменить (например, из-за переноса машины, на которой размещен Engine, в другой домен), записи полного доменного имени должны быть обновлены, чтобы отразить новое имя. Команда ovirt-engine-rename
автоматизирует эту задачу.
Команда ovirt-engine-rename
обновляет записи полного доменного имени Engine в следующих файлах:
/etc/ovirt-engine/engine.conf.d/10-setup-protocols.conf;
/etc/ovirt-engine/logcollector.conf.d/10-engine-setup.conf;
/etc/pki/ovirt-engine/cert.conf;
/etc/pki/ovirt-engine/cert.template;
/etc/pki/ovirt-engine/certs/apache.cer;
/etc/pki/ovirt-engine/keys/apache.key.nopass;
/etc/pki/ovirt-engine/keys/apache.p12.
Хотя команда ovirt-engine-rename
создает новый сертификат для веб-сервера, на котором работает Engine, она не влияет на сертификат для Engine или центр сертификации. В связи с этим использование команды ovirt-engine-rename
связано с определенным риском. Поэтому по возможности рекомендуется изменить полное доменное имя Engine, выполнив engine-cleanup
и engine-setup
.
В процессе обновления старое имя хоста должно быть разрешено. Если Engine Rename Tool выводит сообщение:
[ ERROR ] Host name is not valid: <OLD FQDN> did not resolve into an IP address
добавьте старое имя хоста в файл /etc/hosts, используйте Engine Rename Tool, а затем удалите старое имя хоста из файла /etc/hosts.
Синтаксис команды
Основной синтаксис команды ovirt-engine-rename
:
/usr/share/ovirt-engine/setup/bin/ovirt-engine-rename
Команда также принимает следующие параметры:
--newname=<новое_имя> - позволяет указать новое полное доменное имя для Engine без взаимодействия с пользователем;
--log=<путь_к_файлу> - позволяет указать путь и имя файла, в который должны быть записаны журналы операции переименования;
--config=<путь_к_файлу> - позволяет указать путь и имя файла конфигурации для загрузки в операцию переименования;
--config-append=<путь_к_файлу> - позволяет указать путь и имя файла конфигурации для добавления к операции переименования. Этот параметр можно использовать для указания пути и имени существующего файла ответов для автоматизации операции переименования.
--generate-answer=<путь_к_файлу> - позволяет указать путь и имя файла, в который
ovirt-engine-rename
записываются ваши ответы и значения, измененные командой.
Процедура смены доменного имени Engine
Вы можете использовать команду ovirt-engine-rename
для обновления записей полного доменного имени (FQDN) Engine.
Инструмент проверяет, предоставляет ли Engine локальный домен ISO или хранилище данных. Если предоставляет, инструмент предлагает пользователю извлечь, завершить работу или перевести в режим обслуживания любую виртуальную машину или домен хранения, подключенный к хранилищу, прежде чем продолжить операцию. Это гарантирует, что виртуальные машины не потеряют связь со своими виртуальными дисками, а домены хранения ISO не потеряют связь во время процесса переименования.
Для смены доменного имени Engine необходимо выполнить следующие действия:
1. Переведите всю систему РЕД Виртуализации в режим глобального обслуживания. Для этого на одном из хостов выполните команду:
hosted-engine --set-maintenance --mode=global
2. Подготовьте все DNS и другие соответствующие записи для создания нового полного доменного имени.
Если DNS не используется, внесите изменения в файлы с именем /etc/hosts как на хостах, так и на Engine.
3. Обновите конфигурацию DHCP-сервера, если используется DHCP.
4. Обновите имя в Engine:
hostnamectl set-hostname <новое_доменное_имя>
5. Запустите утилиту следующей командой:
/usr/share/ovirt-engine/setup/bin/ovirt-engine-rename
6. При появлении запроса введите новое полное доменное имя для Engine:
New fully qualified server name:<новое_доменное_имя>
7. При появлении запроса нажмите «Enter», чтобы остановить обслуживание Engine:
During execution engine service will be stopped (OK, Cancel) [OK]:
После этого команда ovirt-engine-rename
обновит записи полного доменного имени Engine.
8. Перезапустите службу загрузки образов, чтобы она обновила свои данные по сертификатам:
systemctl restart ovirt-imageio
9. Для self-hosted Engine выполните следующие дополнительные действия:
9.1. Выполните нижеприведенную команду на каждом существующем хосте self-hosted Engine:
hosted-engine --set-shared-config fqdn <новое_доменное_имя> --type=he_local
Данная команда изменяет полное доменное имя в локальной копии /etc/ovirt-hosted-engine/hosted-engine.conf каждого узла self-hosted Engine.
9.2. Выполните следующую команду на одном из хостов self-hosted Engine:
hosted-engine --set-shared-config fqdn <новое_доменное_имя> --type=he_shared
Данная команда изменяет полное доменное имя в основной копии /etc/ovirt-hosted-engine/hosted-engine.conf в общем домене хранения.
Теперь все новые и существующие узлы self-hosted engine будут использовать новое полное доменное имя.
10. Отключите режим глобального обслуживания. Для этого выполните на одном из улов команду:
hosted-engine --set-maintenance --mode=none
Дата последнего изменения: 07.02.2023
Если вы нашли ошибку, пожалуйста, выделите текст и нажмите Ctrl+Enter.