В этом разделе описывается процедура подготовки файла
связей, который будет использоваться при фактическом переименовании
сервера
Jazz Team Server.
Файл связей можно настроить и проверить
до фактического переименования, пока серверы продолжают оставаться подключенными.
Прежде чем начать
Важное замечание: Для того чтобы включить переименование сервера, необходимо получить файл ключа услуги от
IBM® Software Support. При обращении в службу поддержки IBM, укажите, пожалуйста, что запрашивается файл ключа услуги по переименованию сервера ("Server Rename
Feature Key File").
Об этой задаче
Перед тем как приступить к фактическому переименованию сервера, необходимо выполнить несколько действий. По
большей части они включают подготовку и проверку файла связей, который будет использоваться для выполнения операции
переименования.
В файле связей перечислены существующие исходные URL и переименованные целевые URL в развертывании. Это адреса
Jazz Team Server, приложений Jazz и любых других приложений, на которые повлияет переименование.
Эти действия можно выполнять как
в среде развертывания "все-в-одном", когда Jazz Team Server и все
приложения Jazz установлены на одном и том же компьютере, так и в распределенной
среде развертывания, когда приложения Jazz установлены на разных компьютерах. Эти
подготовительные действия можно использовать в разных сценариях, например при перемещении компьютера в новое
физическое расположение, при настройке локальной зоны тестирования на новом компьютере или в случае консолидации центра
обработки данных, которая включает переименованную среду на новых компьютерах.
- После обновления Jazz Team Server (JTS)
и всех приложений Jazz запустите
Jazz Team Server
и убедитесь в том, что приложения были правильно зарегистрированы на сервере.
- Войдите на страницу Администрирование Jazz Team Server.
В веб-браузере введите адрес https://хост:порт/jts/admin.
- Перейдите на вкладку Сервер.
- На левой панели в разделе Конфигурация выберите Зарегистрированные приложения.
- Убедитесь в том, что зарегистрированы все приложения.
Если нет, зарегистрируйте их.
- Если какие-то приложения регистрировались на предыдущем шаге,
перезапустите
Jazz Team Server.
- Откройте командную строку на том компьютере, где установлен Jazz Team Server,
и перейдите в каталог JazzInstallDir\server.
Прим.: Обязательно выполните этот шаг и последующие шаги на исходном Jazz Team Server, даже если
планируется переход на новое аппаратное обеспечение.
- С помощью команды repotools-jts -generateURLMappings сгенерируйте начальный файл связей,
который будет использоваться в качестве шаблона для дальнейшего редактирования (как показано ниже). Если эта команда
уже выполнялась или файл уже существует, добавьте параметр overwrite=true.
- Windows: repotools-jts.bat
-generateURLMappings toFile=mappings.txt adminUserId=<adminId>
adminPassword=<adminPassword> additionalURLFile=additionalurl.txt
- Linux: ./repotools-jts.sh
-generateURLMappings toFile=mappings.txt adminUserId=<adminId>
adminPassword=<adminPassword> additionalURLFile=additionalurl.txt
В результате выполнения этой команды создается файл связей со
списком существующих исходных внешних URL и целевых URL по умолчанию
для
Jazz Team Server
и каждого приложения Jazz
(Rational Engineering Lifecycle
Manager,
Lifecycle
Query Engine,
Jazz
Reporting Service), зарегистрированного в
Jazz Team Server.
Кроме того, в файле определяются исходные и целевые URL для файла WAR справки и любых известных внешних систем, которые используются.
Кроме того, создается второй файл со списком всех URL, для которых может требоваться связывание. В этом файле также
перечисляются URL, ссылающиеся на интеграции других фирм и, возможно, требующие рассмотрения. Эти URL можно добавить в файл связей. Для простых развертываний этот файл может не содержать никаких
дополнительных URL. Параметр additionalURLFile=additionalurl.txt позволяет изменить имя этого файла. Дополнительные сведения об этом параметре приведены в разделе Команда инструментов хранилища для создания файла связей для переименования сервера.
Убедитесь в отсутствии ошибок в файле протокола JazzInstallDir/server/repotools-jts_generateURLMappings.log.
- Проверьте и, соблюдая осторожность, измените сгенерированный файл связей. Проверьте, нет ли опечаток в имени
хоста, номере порта или корневых контекстах.
Некоторые из этих ошибок не отслеживаются утилитами переименования сервера, и могут привести к отказу в работе
продукта. Со структурой файла связей можно ознакомиться в разделе Файл связей для переименования сервера.
- Убедитесь в том, что для каждого приложения, которое переименовывается, и для файла WAR справки существует пара исходного и целевого URL.
- Измените target= urls для записей, которые требуется переименовать, указав правильные целевые URL.
Прим.: При переименовании номера порта JTS или любого приложения потребуется обновить информацию о порте на сервере
приложений
после переименования, но
до перезапуска серверов. При переименовании корневого контекста JTS
или любого приложения обратитесь к разделу
Изменение корневого контекста.
- Пары исходных-> целевых URL, которые не требуется переименовывать, можно сделать комментарием с помощью символа
'#'.
- Проверьте список изменившихся URL. Хотя команда отыскивает все известные URL в развертывании,
возможно, что некоторые из них пропущены. Если нужно связать любой из этих изменившихся URL, удалите символ комментария
для пары исходного/целевого адреса для изменившегося URL и укажите новый целевой URL. Если у вас есть какие-то сомнения
относительно среды, то перед продолжением переименования проконсультируйтесь с администратором.
- Проверьте файл additionalurls.
Дополнительная информация приведена в разделе Команда инструментов хранилища для создания файла связей для переименования сервера.
Прим.: Если перед переходом к фактическому переименованию в конфигурацию развертывания были внесены изменения,
включая регистрацию дополнительных приложений, то файл связей необходимо сгенерировать повторно.
- Проверьте файл связей с помощью команды repotools-jts -verifyURLMappings.
- repotools-jts.bat -verifyURLMappings
mappingFile=mappings.txt repositoryURL=<serverURL> adminUserId=<adminId>
adminPassword=<adminPassword>
- ./repotools-jts.sh -verifyURLMappings
mappingFile=mappings.txt repositoryURL=<serverURL> adminUserId=<adminId>
adminPassword=<adminPassword>
Дополнительные сведения о типах проверки, выполняемой этой командой, приведены в разделе
Команда инструментов хранилища для проверки файла связей.
- Если сценарий включает новое аппаратное обеспечение, установите
Rational Engineering Lifecycle
Manager
на новых компьютерах. Не запускайте Jazz Team Server и мастер
настройки Jazz.
Дальнейшие действия
Перейдите к переименованию сервера. За информацией обратитесь к разделу
Перемещение пробного или полнофункционального развертывания путем переименования сервера .