В этом разделе описана процедура переименования компактного пробного или
полнофункционального рабочего развернутого экземпляра.
Прежде чем начать
Поскольку автоматическая миграция LQE не поддерживается, его необходимо удалить из списка зарегистрированных приложений Jazz Team Server и перезапустить Jazz Team Server перед тем, как приступать к переименованию сервера.
- Войдите на страницу Администрирование продукта
Jazz Team Server.
Введите в веб-браузере следующий адрес: https://имя-хоста:порт/jts/admin.
- Откройте вкладку Сервер.
- На левой панели выберите пункт Зарегистрированные приложения в разделе Конфигурация.
- Удалите Lifecycle
Query Engine из списка зарегистрированных приложений.
- Остановите сервер Lifecycle
Query Engine.
- Перезапустите Jazz Team Server.
Прим.: После выполнения процедуры переименования необходимо вручную отключить исходный сервер во
избежание повреждения рабочей среды.
Об этой задаче
Функция переименования сервера использует файл связей для поиска URL, которые
необходимо переименовать. Первоначальный файл связей можно создать с помощью команды
repotools. Файл связей содержит парные исходные и целевые URL сервера
Jazz Team Server
и всех приложений, а также любые другие URL, которые используются приложениями.
Дополнительные сведения о файле связей приведены в разделе
Файл связей для переименования сервера.
Процедура
- Подготовьте и проверьте файл связей до того, как приступать к переименованию, пока
серверы еще работают. Следуйте инструкциям из раздела
Подготовка файла связей.
В результате подготовки должен быть получен файл связей, созданный на основе информации из исходного
экземпляра
Jazz Team Server.
Файл связей содержит парные исходные и целевые URL сервера
Jazz Team Server
и всех приложений, а также любые другие URL, которые используются приложениями.
- Создайте резервную копию исходной среды и скопируйте текстовые индексы и файлы
конфигурации приложений в новый целевой экземпляр. Если используются распределенные
системы, скопируйте файлы с соответствующего сервера.
Прим.: Если переименование выполняется в локальной системе без замены оборудования,
информация о среде копируется из одного установленного экземпляра в другой установленный
экземпляр в пределах одной системы.
- Остановите работу сервера
Jazz Team Server
и всех распределенных приложений, зарегистрированных в
Jazz Team Server.
Кроме того, остановите работу любых других приложений и поддерживаемых интегрированных продуктов, которые может затронуть
переименование сервера.
Прим.: Пока серверы не работают, у пользователей не будет возможности создавать ссылки или переходить по ним во внешних системах, интегрированных с развернутым экземпляром Rational Engineering Lifecycle
Manager, который планируется переименовать.
- Создайте резервную копию баз данных в исходной среде, в том числе базы данных
Jazz Team Server,
баз данных приложений и базы данных хранилища данных.
Если планируется сменить сервер базы данных или его поставщика, обратитесь к разделу
Перемещение базы данных за информацией о дополнительных действиях.
- Скопируйте JFS и текстовые индексы из исходного экземпляра в целевой экземпляр.
В приведенных ниже примерах для сервера Linux
предполагается, что накопители целевых рабочих компьютеров смонтированы как сетевые диски.
Если это невозможно сделать в вашей среде, используйте любой другой способ передачи
файлов для копирования файлов.
cp -R исходный-каталог-установки-Jazz/server/conf/jts/indices целевой-каталог-установки-Jazz/server/conf/jts
cp -R исходный-каталог-установки-Jazz/server/conf/relm/indices целевой-каталог-установки-Jazz/server/conf/relm
- Скопируйте файлы конфигурации приложений из исходного экземпляра в целевой рабочий экземпляр. Ниже приведены примеры для сервера Linux, в
которых (как и на предыдущем шаге) предполагается, что накопители целевых рабочих
компьютеров смонтированы как сетевые диски.
cp исходный-каталог-установки-Jazz/server/conf/jts/teamserver*.properties целевой-каталог-установки-Jazz/server/conf/jts
cp исходный-каталог-установки-Jazz/server/conf/relm/teamserver*.properties целевой-каталог-установки-Jazz/server/conf/relm
cp исходный-каталог-установки-Jazz/server/conf/admin/admin.properties* целевой-каталог-установки-Jazz/server/conf/admin
cp исходный-каталог-установки-Jazz/server/conf/admin/friends.rdf* целевой-каталог-установки-Jazz/server/conf/admin
- Скопируйте файл связей в каталог
целевой-каталог-установки-Jazz\server на целевом рабочем сервере. Дополнительные сведения о файле связей приведены в разделе Подготовка файла связей.
- Выполните автономную часть процедуры переименования сервера,
импортировав файл связей на целевой рабочий сервер
Jazz Team Server,
используя команду repotools-jts -importURLMappings.
- В случае комплексного развертывания импортируйте файл связей с помощью команды
repotools-jts -importURLMappings, как показано ниже:
- repotools-jts.bat -importURLMappings
fromFile=".\mappings.txt"
- ./repotools-jts.sh -importURLMappings
fromFile="./mappings.txt"
На сервере
Jazz Team Server
начнется автономная процедура переименования, выполняемая до перезапуска сервера.
- В распределенной среде, позволяющей подключать сетевые диски, подключите диск хоста
Jazz Team Server
в качестве сетевого диска на всех хостах приложений. После этого создайте файл (например,
serverConfFile.txt) со списком удаленных каталогов
server/conf в имеющейся среде развертывания, используя следующий формат:
# Удаленный сервер CCM
x:/JazzTeamServer/server/conf
# Удаленный сервер QM
y:/JazzTeamServer/server/conf
# Удаленный сервер RM
z:/JazzTeamServer/server/conf
Вызовите команду repotools-jts -importURLMappings, добавив
параметр serverConfFile=, как показано ниже.
- repotools-jts.bat -importURLMappings
fromFile=".\mappings.txt" serverConfFile=".\serverConf.txt"
- ./repotools-jts.sh -importURLMappings
fromFile="./mappings.txt" serverConfFile="./serverConf.txt"
- В распределенной среде, не позволяющей подключить сетевой диск, вызовите команду
repotools-jts -importURLMappings (без параметра serverConfFile=).
Затем скопируйте файл server/conf/jts/.mappingEvent в удаленные
каталоги конфигурации приложений
(server/conf/имя-приложения), таких как
ccm, qm и rm.
Файл событий создается во время импорта связей. Файл .mappingEvent
необходимо скопировать после импорта файла связей, но до запуска сервера.
Файл .mappingEvent содержит информацию, которая используется
приложениями для подключения к
Jazz Team Server
в новом расположении. Содержимое файла .mappingEvent одинаково на
сервере
Jazz Team Server
и в приложениях, зарегистрированных на этом сервере.
Убедитесь в том, что переименование было успешно выполнено, просмотрев вывод на
консоли и содержимое файла
каталог-установки-Jazz/server/repotools-jts_importURLMappings.log.
Если возникли какие-либо ошибки, либо вы поняли, что в файле связей была допущена ошибка,
обратитесь к разделу Устранение неполадок при переименовании сервера за инструкциями
по выявлению и устранению неполадки.
- Запустите сервер
Jazz Team Server
и установленные распределенные приложения.
Приложения выполнят синхронизацию с сервером
Jazz Team Server,
чтобы применить связи URL и обновить данные в своих хранилищах. Обычно это занимает от 5
до 30 минут в зависимости от объема данных.
- Войдите на сервер
Jazz Team Server,
используя URL https://новый хост:порт/jts/serverRenameStatus.
Начнется фактический процесс переименования. После его выполнения вам будет предоставлена
возможность проверить результаты переименования и внести необходимые исправления. В
течение проверки сервер
Jazz Team Server
и все приложения будут работать в режиме только для чтения, однако у вас будет
возможность просмотреть данные, найти неработающие ссылки и непреобразованные URL.
Дополнительные сведения приведены в разделе Проверка URL и связей после переименования сервера.
- В завершении выполните все дополнительные проверки, необходимые для отдельных
продуктов, которые описаны в разделе Выполнение процесса проверки переименования сервера. После того как вы будете уверены в правильности информации о переименовании, выберите
вариант Я проверил(а) переименование сервера ... и нажмите кнопку
Готово.
После этого сервер
Jazz Team Server
и все зарегистрированные приложения выйдут из режима только для чтения и начнут работать
в обычном режиме.
- Только в полнофункциональной рабочей среде: при наличии второго сервера
Jazz Team Server
или дополнительных приложений, ссылающихся на переименованный сервер
Jazz Team Server,
необходимо вызвать команду repotools-jts -importURLMappings на втором сервере Jazz Team Server.
Этот шаг необходим для обновления ссылок на переименованный сервер, существующих на втором сервере.
Важное замечание: Не создавайте новый файл связей. Необходимо использовать тот файл
связей, который применялся для первого переименованного сервера.
- Скопируйте отредактированный файл связей с первого сервера на второй сервер.
Он должен включать в себя все исправления, внесенные в ходе процедуры проверки.
- Проверьте файл связей и, при необходимости, удалите те парные исходные и целевые
URL, которые не требуется применять на втором сервере.
- Выполните процедуру переименования на втором сервере, повторив шаги с
3 по
6 на втором сервере
Jazz Team Server.
Дальнейшие действия
После выполнения всех шагов этой задачи выполните инструкции из раздела
Переименование сервера для Lifecycle Query Engine,
чтобы заново добавить LQE и создать индекс.