맵핑 파일을 생성할 준비가 되면 맵핑 파일 준비의 지시사항에 따르십시오.
맵핑 파일에는 Jazz Team Server와 등록된 해당 애플리케이션의 소스-대상 URL 쌍과 애플리케이션이 컨트리뷰션하는 다른 URL이 포함됩니다. URL은 다음 두 유형으로 구분됩니다.
이름 바꾸기의 일부인 URL 쌍은 Jazz Team Server의 도메인에 있는 모두를 포함합니다. 해당 URL에는 Jazz Team Server 공용 URL, 애플리케이션 공용 URL 및 애플리케이션이 컨트리뷰션한 기타 URL이 있습니다.
영향 받은 URL에는 이 토폴로지와 상호작용하지만 이 Jazz Team Server의 도메인에 없는 기타 시스템이 포함됩니다. 다른 Jazz Team Server에 등록되었지만 이 Jazz Team Server와 동반자인 Rational® Engineering Lifecycle Manager 애플리케이션은 영향 받은 URL을 나타냅니다. Rational ClearQuest®와 같은 외부 통합도 영향 받은 URL을 나타냅니다.
# JTS
source=https://relmhost.example.org:9443/jts
target=https://relmhost2.example.org:9443/jts
#Additional Urls included in rename by relmhost.example.org:9443/jts
# ADMIN
source=https://relmhost.example.org:9443/admin
target=https://relmhost2.example.org:9443/admin
#(relm Help URL)
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 Reporting Service
source=https://relmhost.example.org:9443/sparql
target=https://relmhost2.example.org:9443/sparql
#The following list of URLs represent external servers that integrate
with this Jazz Team Server or with applications registered to it.
#Do not uncomment these lines as they are for reference purposes only.
# Friend Entry
#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 쌍이 포함되어 있습니다. 이 예에는 Jazz Team Server와 등록된 모든 해당 애플리케이션의 공용 URL에 대한 URL 쌍이 표시됩니다. 또한 애플리케이션이 컨트리뷰션한 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은 이 배치 또는 외부 서버와 동반자인 다른 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 명령이 자동으로 추가 맵핑을 생성합니다. 기본 포트는 https의 경우 443이고 http의 경우 80입니다.
예를 들어, Rational Engineering Lifecycle Manager는 https://relmhost.example.org/relm에서 실행 중입니다. 이 경우, Rational Engineering Lifecycle Manager는 기본 포트를 사용하여 서버에 배치됩니다(애플리케이션 서버의 포트를 구성하거나 기본 포트에서 실행 중인 되돌리기 프록시 http 서버를 사용하여 수행). 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을 맵핑할 필요가 없는 일부 경우에는 발견된 누락된 맵핑을 무시할 수 있습니다. 추가 세부사항은 맵핑 파일을 확인하기 위한 저장소 도구 명령의 내용을 참조하십시오.