Подготовка файла связей

В этом разделе описывается процедура подготовки файла связей, который будет использоваться при фактическом переименовании сервера Jazz Team Server. Файл связей можно настроить и проверить до фактического переименования, пока серверы продолжают оставаться подключенными.

Прежде чем начать

Важное замечание: Для того чтобы включить переименование сервера, необходимо получить файл ключа услуги от IBM® Software Support. При обращении в службу поддержки IBM, укажите, пожалуйста, что запрашивается файл ключа услуги по переименованию сервера ("Server Rename Feature Key File").

Об этой задаче

Перед тем как приступить к фактическому переименованию сервера, необходимо выполнить несколько действий. По большей части они включают подготовку и проверку файла связей, который будет использоваться для выполнения операции переименования. В файле связей перечислены существующие исходные URL и переименованные целевые URL в развертывании. Это адреса Jazz Team Server, приложений Jazz и любых других приложений, на которые повлияет переименование.

Эти действия можно выполнять как в среде развертывания "все-в-одном", когда Jazz Team Server и все приложения Jazz установлены на одном и том же компьютере, так и в распределенной среде развертывания, когда приложения Jazz установлены на разных компьютерах. Эти подготовительные действия можно использовать в разных сценариях, например при перемещении компьютера в новое физическое расположение, при настройке локальной зоны тестирования на новом компьютере или в случае консолидации центра обработки данных, которая включает переименованную среду на новых компьютерах.

Процедура

  1. После обновления Jazz Team Server (JTS) и всех приложений Jazz запустите Jazz Team Server и убедитесь в том, что приложения были правильно зарегистрированы на сервере.
    1. Войдите на страницу Администрирование Jazz Team Server. В веб-браузере введите адрес https://хост:порт/jts/admin.
    2. Перейдите на вкладку Сервер.
    3. На левой панели в разделе Конфигурация выберите Зарегистрированные приложения.
    4. Убедитесь в том, что зарегистрированы все приложения. Если нет, зарегистрируйте их.
    5. Если какие-то приложения регистрировались на предыдущем шаге, перезапустите Jazz Team Server.
  2. Откройте командную строку на том компьютере, где установлен Jazz Team Server, и перейдите в каталог JazzInstallDir\server.
    Прим.: Обязательно выполните этот шаг и последующие шаги на исходном Jazz Team Server, даже если планируется переход на новое аппаратное обеспечение.
  3. С помощью команды 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.

  4. Проверьте и, соблюдая осторожность, измените сгенерированный файл связей. Проверьте, нет ли опечаток в имени хоста, номере порта или корневых контекстах. Некоторые из этих ошибок не отслеживаются утилитами переименования сервера, и могут привести к отказу в работе продукта. Со структурой файла связей можно ознакомиться в разделе Файл связей для переименования сервера.
    1. Убедитесь в том, что для каждого приложения, которое переименовывается, и для файла WAR справки существует пара исходного и целевого URL.
    2. Измените target= urls для записей, которые требуется переименовать, указав правильные целевые URL.
      Прим.: При переименовании номера порта JTS или любого приложения потребуется обновить информацию о порте на сервере приложений после переименования, но до перезапуска серверов. При переименовании корневого контекста JTS или любого приложения обратитесь к разделу Изменение корневого контекста.
    3. Пары исходных-> целевых URL, которые не требуется переименовывать, можно сделать комментарием с помощью символа '#'.
    4. Проверьте список изменившихся URL. Хотя команда отыскивает все известные URL в развертывании, возможно, что некоторые из них пропущены. Если нужно связать любой из этих изменившихся URL, удалите символ комментария для пары исходного/целевого адреса для изменившегося URL и укажите новый целевой URL. Если у вас есть какие-то сомнения относительно среды, то перед продолжением переименования проконсультируйтесь с администратором.
    5. Проверьте файл additionalurls. Дополнительная информация приведена в разделе Команда инструментов хранилища для создания файла связей для переименования сервера.
    Прим.: Если перед переходом к фактическому переименованию в конфигурацию развертывания были внесены изменения, включая регистрацию дополнительных приложений, то файл связей необходимо сгенерировать повторно.
  5. Проверьте файл связей с помощью команды 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>

    Дополнительные сведения о типах проверки, выполняемой этой командой, приведены в разделе Команда инструментов хранилища для проверки файла связей.

  6. Если сценарий включает новое аппаратное обеспечение, установите Rational Engineering Lifecycle Manager на новых компьютерах. Не запускайте Jazz Team Server и мастер настройки Jazz.

Дальнейшие действия

Перейдите к переименованию сервера. За информацией обратитесь к разделу Перемещение пробного или полнофункционального развертывания путем переименования сервера .

Комментарии