Для создания файла связей следуйте инструкциям, приведенным в разделе Подготовка файла связей.
Файл связей содержит пары исходный URL-целевой URL для Jazz Team Server, его реестра приложений, а также другие URL, добавленные приложениями. URL делятся на два типа:
Пары URL, являющиеся частью переименования, включают любые объекты в домене Jazz Team Server. Это могут быть внешние URL Jazz Team Server, внешние URL приложений и другие URL, добавленные приложениями.
Затронутые URL включают все остальные системы, взаимодействующие с этой топологией, но не входящие в домен Jazz Team Server. Приложение Rational Engineering Lifecycle Manager, зарегистрированное в других продуктах Jazz Team Server, дружественных по отношению к этому экземпляру Jazz Team Server, представляет собой затронутый URL. Внешняя интеграция, такая как Rational ClearQuest, также представляет затронутый URL.
# JTS
source=https://relmhost.example.org:9443/jts
target=https://relmhost2.example.org:9443/jts
#Дополнительные Url, включенные в переименование relmhost.example.org:9443/jts
# ADMIN
source=https://relmhost.example.org:9443/admin
target=https://relmhost2.example.org:9443/admin
#(URL справки relm)
source=https://relmhost.example.org:9443/relmhelp
target=https://relmhost2.example.org:9443/relmhelp
# RELM
source=https://relmhost.example.org:9443/relm
target=https://relmhost2.example.org:9443/relm
# Служба отчетов Jazz
source=https://relmhost.example.org:9443/sparql
target=https://relmhost2.example.org:9443/sparql
#Следующий список URL представляет внешние серверы, интегрируемые
С этим
Jazz Team Server или с зарегистрированными в нем
приложениями.
#Не удаляйте символ комментария из этих строк, так как они приведены только для справки.
# Дружественная запись
#source=https://friend1.example.org:9443/jts/rootservices
#target=https://friend1.example.org:9443/jts/rootservices
#source=https://cqconnector.example.org:9084/cqconnector/gateway
#target=https://cqconnector.example.org:9084/cqconnector/gateway
Созданный файл связей - это шаблон, который необходимо изменить перед запуском importURLMappings. Для обеспечения правильного переименования всех систем в топологии важно понимать все элементы файла связей. Верхняя часть файла содержит пары URL, являются частью переименования. В этом примере демонстрируются пары URL для внешних URL Jazz Team Server и всех его зарегистрированных приложений. Также в нем приведены пары URL, добавленные приложениями.
Просмотрите все URL и определите измененные. Замените новыми значениями целевые URL для всех исходных URL, которые будут переименованы. Если указанный исходный URL не переименовывается, перед парой добавьте символ ' #'.
# JTS
#source=https://relmhost.example.org:9443/jts
#target=https://relmhost2.example.org:9443/jts
В нижней части файла связей содержится список затронутых URL в строках комментариев. Эти URL не участвуют в переименовании, но на них влияет изменение URL. Эти URL должны оставаться в виде комментариев, пока не потребуется замаскировать URL рабочей системы, так как они приведены только для справки.
В промежуточной среде необходимо всегда маскировать затронутые URL для гарантии отсутствия перекрестных ссылок между промежуточными и рабочими серверами. Подробные сведения приведены ниже.
При необходимости замаскировать затронутые URL потребуется убрать признак комментария с пары исходный/целевой URL и указать пустой целевой URL.
При настройке промежуточной среды требуется создать пустые связи для всех затронутых URL в файле связей. Затронутые URL могут включать другие приложения relm, являющиеся друзьями для этой установки или внешних серверов. Для записей друзей создайте пустую связь для внешнего URL друга.
Например, для URL записи друга https://friendhost.example.org:9443/jts/rootservices внешний URL обычно выглядит как https://friendhost.example.org:9443/jts. Добавьте пару URL в нижнюю часть файла связей для маскирования этого URL с помощью указания фальшивого имени хоста. Перед выбором пустого целевого имени хоста убедитесь в его недоступности.
# Friend
source=https://friendhost.example.org:9443/jts
target=https://dummyfriendhost.example.org:9443/jts
Для всех затронутых URL, не являющихся записями друзей, добавьте в нижней части файла связей следующую пару URL:
source=https://externalserver.example.org:9555/
target=https://dummyhost.example.org:9555/
Один целевой объект не разрешено использовать больше одного раза. При наличии нескольких записей друзей используйте dummyhost2, dummyhost3 и т. д. В среде с одним сервером, в которой Jazz Team Server и все приложения используют один хост и порт, можно применить упрощенное преобразование, как описано ниже.
Для простой топологии, в которой параметры протокола, хоста, домена и порта являются общими для всех URL, можно упростить файл связей таким образом, чтобы он содержал только одну запись источник-приемник. Например, для общего развертывания в relmhost.example.org и при необходимости переименования всех объектов для использования newhost.example.org можно изменить созданный файл связей таким образом, чтобы он содержал только следующие URL:
source=https://relmhost.example.org:9443
target=https://newhost.example.org:9443
Если любой из исходных URL использует порт по умолчанию, который не указан явно, то потребуется два набора связей: один с портом по умолчанию и один без этого порта. Команда generateURLMappings автоматически создает дополнительные связи. Значения портов по умолчанию: 443 для https и 80 для http.
Например, Rational Engineering Lifecycle Manager использует адрес https://relmhost.example.org/relm. В этом случае Rational Engineering Lifecycle Manager развернуто на сервере с использованием порта по умолчанию (с помощью настройки порта для сервера приложений или с помощью сервера http обратного proxy, запущенного со значением порта по умолчанию). В Rational Engineering Lifecycle Manager также могут храниться ссылки для URL ресурсов, в которых порт явно задан в URL, например:
https://relmhost.example.org:443/resource/...
Так как URL можно хранить в двух этих видах, для каждого требуется связь. Например, relmhost.example.org переименовывается в newhost.example.org. В этом случае для переименования могут понадобиться следующие связи. Пары формируются автоматически командой generateURLMappings.
source=https://relmhost.example.org/relm
target=https://newhost.example.org/relm
source=https://relmhost.example.org:443/relm
target=https://newhost.example.org:443/relm
Рекомендуется записывать URL строчными буквами. В URL учитывается регистр символов.
Из-за большого числа используемых процессов возможно возникновение ошибок. Некоторые ошибки определяются просто, например попытка создания файла связей до запуска сервера или использование неправильных идентификационных данных. Другие ошибки не так очевидны. Сведения об ошибках переименования сервера приведены в разделе Устранение неполадок при переименовании сервера.
После создания и изменения файла связей запустите команду repotools-jts -verifyURLMappings для проверки отсутствия пропущенных связей, а также для других проверок. В некоторых случаях можно игнорировать отсутствующие связи, которые не требуются для преобразования URL. Дополнительные сведения приведены в разделе Команда инструментов хранилища для проверки файла связей.