서버 이름 바꾸기에 사용하는 맵핑 파일 이해

이 주제에서는 generateURLMappings 명령이 생성하는 맵핑 파일의 구조에 대해 설명하고 사용자 배치에 맞도록 맵핑 파일을 편집하는 방법에 대한 지시사항을 제공합니다.

맵핑 파일을 생성할 준비가 되면 맵핑 파일 준비의 지시사항에 따르십시오. 추가 예제는 테스트 스테이징 환경을 설정하기 위한 토폴로지와 맵핑 파일 및 파일럿에서 프로덕션으로 이동 시나리오를 위한 토폴로지 및 맵핑 파일의 내용을 참조하십시오.

맵핑 파일에는 Jazz™ Team Server과 해당 등록 CLM 애플리케이션의 소스-대상 URL 쌍과 애플리케이션이 컨트리뷰션하는 기타 URL이 포함됩니다. URL은 다음 두 유형으로 구분됩니다.

이름 바꾸기의 일부인 URL 쌍은 Jazz Team Server의 도메인에 있는 모두를 포함합니다. 해당 URL에는 Jazz Team Server 공용 URL, 애플리케이션 공용 URL 및 애플리케이션이 컨트리뷰션한 기타 URL이 있습니다.

영향 받은 URL에는 이 토폴로지와 상호작용하지만 이 Jazz Team Server의 도메인에 없는 기타 시스템이 포함됩니다. 다른 Jazz Team Server에 등록되었지만 이 Jazz Team Server와 동반자인 CLM 애플리케이션은 영향 받은 URL을 나타냅니다. Rational ClearQuest와 같은 외부 통합도 영향 받은 URL을 나타냅니다.

샘플 맵핑 파일의 설명

# JTS
source=https://clmhost.example.org:9443/jts
target=https://clmhost2.example.org:9443/jts
#Additional Urls included in rename by clmhost.example.org:9443/jts
# ADMIN
source=https://clmhost.example.org:9443/admin
target=https://clmhost2.example.org:9443/admin
#(CLM Help URL)
source=https://clmhost.example.org:9443/clmhelp
target=https://clmhost2.example.org:9443/clmhelp
# CCM
source=https://clmhost.example.org:9443/ccm
target=https://clmhost2.example.org:9443/ccm
# RM
source=https://clmhost.example.org:9443/rm
target=https://clmhost2.example.org:9443/rm
# ADDITIONAL URLs included in rename by RM
source=https://clmhost.example.org:9443/converter/htmlgen
target=https://clmhost2.example.org:9443/converter/htmlgen
# QM
source=https://clmhost.example.org:9443/qm
target=https://clmhost2.example.org:9443/qm

#The following list of URLs represent external servers that integrate with this Jazz Team Server or with applications registered to it.
# https://friend1.example.org:9443/jts/rootservices (Friend Entry)
# https://cqconnector.example.org:9084/cqconnector/gateway

생성된 맵핑 파일은 importURLMappings를 실행하기 전에 편집해야 하는 템플리트입니다. 토폴로지에 있는 모든 시스템의 이름을 올바르게 바꾸려면 맵핑 파일의 모든 사항을 이해해야 합니다. 파일의 상단 섹션에는 이름 바꾸기의 일부인 URL 쌍이 포함되어 있습니다. 이 예에는 Jazz Team Server와 등록된 애플리케이션 모두의 공용 URL에 대한 URL 쌍이 표시됩니다. 애플리케이션이 컨트리뷰션한 URL 쌍도 표시될 수 있습니다(예: Jazz Team Server가 컨트리뷰션한 CLM 도움말 URL 쌍과 RM 애플리케이션이 컨트리뷰션한 변환기 URL 쌍).

각 URL을 검색하고 변경될 URL을 판별하십시오. 새 값으로 이름이 바뀔 소스 URL의 대상을 업데이트하십시오. 지정된 소스 URL의 이름이 바뀌지 않는 경우 ' #'을 사용하여 쌍을 주석 처리하십시오.

# JTS
#source=https://clmhost.example.org:9443/jts
#target=https://clmhost2.example.org:9443/jts

맵핑 파일의 하단 섹션에는 주석 처리된 영향 받은 URL 목록이 포함되어 있습니다. 이러한 URL은 이 이름 바꾸기의 일부가 아니지만 변경되는 URL의 영향을 받습니다. 이러한 URL은 참조용일뿐이므로 주석 처리된 상태로 두어야 합니다. 해당 URL이 지원되는 시나리오의 일부인지도 확인해야 합니다. 토폴로지의 서버 이름 바꾸기 문서를 확인하여 이를 수행하십시오.

스테이징 환경에 있는 경우 스테이징 서버와 프로덕션 서버 사이에 교차 링크되지 않도록 영향 받은 URL을 항상 마스크 처리해야 합니다. 세부사항은 아래를 참조하십시오.

스테이징 환경을 위한 더미 맵핑

스테이징 환경을 설정할 때 맵핑 파일의 영향 받은 URL에 대해 더미 맵핑을 작성해야 합니다. 영향 받은 URL은 이 배치 서버 또는 외부 서버와 동반자인 기타 CLM 애플리케이션을 포함할 수 있습니다. 동반자 항목의 경우 동반자의 공용 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

동일한 대상을 두 번 이상 사용할 수 없습니다. 여러 동반자 항목이 있으면 dummyhost2, dummyhost3 등을 사용하십시오. Jazz Team Server와 애플리케이션이 모두 동일한 호스트와 포트에 있는 단일 서버 배치가 있는 경우 아래 설명된 대로 단순화된 맵핑을 사용할 수 있습니다.

동반자 항목이 아닌 영향 받은 URL의 경우 맵핑 파일의 맨 아래에 다음 URL 쌍을 추가하십시오.

source=https://externalserver.example.org:9555/
target=https://dummyhost.example.org:9555/

단순화된 맵핑 파일 사용

모든 URL의 프로토콜, 호스트, 도메인 및 포트가 공통된 단순 토폴로지가 있는 경우 맵핑 파일은 하나의 소스-대상 항목만 포함하도록 축소될 수 있습니다. 예를 들어, clmhost.example.org에 통합 배치가 있으며 모두 newhost.example.org를 사용하도록 이름을 바꾸려면 다음 URL만 포함하도록 생성된 맵핑 파일을 편집할 수 있습니다.

참고: clmhost.example.org에서 newhost.example.org로의 단순 맵핑은 Jazz Team Server 및 CLM 애플리케이션 이름을 변경합니다. 다른 모든 Rational 또는 써드파티 통합의 이름은 바꾸지 않습니다. 항상 generateURLMappings를 실행하여 시나리오가 지원되는지 판별하고 토폴로지 전체가 제대로 맵핑되는지 판별하십시오.
source=https://clmhost.example.org:9443
target=https://newhost.example.org:9443

기본 포트를 사용하는 URL

임의의 소스 URL이 기본 포트를 사용하지만 기본 포트 번호가 명시적으로 포함되지 않은 경우 두 개의 맵핑 세트(기본 포트를 사용하는 세트와 기본 포트를 사용하지 않는 세트)가 필요합니다. generateURLMappings 명령이 자동으로 추가 맵핑을 생성합니다. 기본 포트는 https의 경우 443이고 http의 경우 80입니다.

예를 들어, https://clmhost.example.org/ccm에서 실행 중인 기존 CCM이 있다고 가정하십시오. 이 경우 CCM은 기본 포트를 사용하여 서버에 배치됩니다(애플리케이션 서버의 포트를 구성하거나 기본 포트에서 실행 중인 되돌리기 프록시 http 서버를 사용하여 수행). CLM에서는 URL에 포트가 명시적으로 포함된 자원의 URL에 대해서도 링크를 저장할 수 있습니다. 예를 들어 다음과 같습니다.

https://clmhost.example.org:443/resource/...

두 양식 모두를 사용하여 URL을 저장할 수 있으므로 각각에 맵핑이 필요합니다. 예를 들어, clmhost.example.org의 이름이 newhost.example.org로 바뀌었다고 가정하십시오. 이 경우 이름 바꾸기를 수행하려면 다음 맵핑이 필요합니다. generateURLMappings가 자동으로 쌍을 생성합니다.

source=https://clmhost.example.org/ccm
target=https://newhost.example.org/ccm

source=https://clmhost.example.org:443/ccm
target=https://newhost.example.org:443/ccm

대소문자 구분

CLM 애플리케이션에서는 URL의 대소문자를 구분합니다. URL https://clmhost:443/jts는 https://CLMHOST:443/jts와 다릅니다. 소스 URL의 대소문자를 있는 그대로 유지하십시오. 그렇지 않으면 맵핑되지 않습니다.

원하면 대상 URL의 대소문자를 변경할 수 없습니다. 예를 들어, 다음 맵핑이 허용됩니다.

source=https://CLMHOST:443/jts
target=https://clmhost:443/jts

단순화된 맵핑 파일을 사용하는 경우 모든 URL의 대소문자를 동일하게 하십시오. 다음 소스 URL이 있으며

https://clmhost:443/jts
https://CLMHOST:443/ccm

단순화된 맵핑 파일을 사용하는 경우

source=https://clmhost:443
target=https://clmhost:9443

첫 번째 URL만 맵핑됩니다. 두 번째 URL은 맵핑되지 않습니다. 이 문제를 수정하려면 다음에 대해 다른 맵핑을 추가하십시오.

source=https://CLMHOST:443
target=https://CLMHOST:9443

맵핑 파일 생성 중 오류 발생

관련된 처리 양으로 인해 오류가 발생할 가능성이 있습니다. 일부 오류는 명백하게 표시됩니다(예: 서버를 시작하기 전에 맵핑 파일을 생성하려고 시도하는 경우나 잘못된 로그인 신임 정보를 사용하는 경우). 기타 오류는 덜 명확합니다. 서버 이름 바꾸기 오류에 대한 세부사항은 서버 이름 바꾸기 문제점 해결의 내용을 참조하십시오.

z/OS에서 서버 이름 바꾸기

서버 이름 바꾸기는 z/OS®에서 지원되며 프로세스는 -generateURLMappings 저장소 도구 명령을 사용하지 않는다는 점을 제외하고는 다른 운영 체제에서와 동일하게 z/OS에서 수행됩니다. 대신 hlq.SBLZSAMP에서 샘플 JCL 멤버 BLZGENMP를 사용자 정의하십시오. 여기서 hlq는 SMP/E 설치 중에 지정한 상위 레벨 규정자입니다. 자세한 사용자 정의 지시사항은 BLZGENMP에서 주석 헤더를 참조하십시오.

다른 운영 체제와 동일한 프로시저를 사용하여 z/OS의 맵핑 파일을 준비할 수 있지만 맵핑 파일은 UTF-8으로 인코딩됩니다. 다음 기술 중 하나를 사용하여 z/OS UNIX에서 UTF-8 파일을 편집할 수 있습니다.
  • If you have z/OS 1.10 이상 또는 z/OS 1.9(APAR OA22250의 PTF 포함)가 있는 경우 ISPF 옵션 3.17을 사용하여 z/OS UNIX System Services의 UTF-8 파일을 편집하십시오.
  • System z®용 Rational® Developer를 사용하는 경우 원격 시스템 탐색기를 사용하여 파일에 연결하여 수정하십시오.
  • 다운로드하거나 FTP를 사용하여 파일을 Windows PC에 전송하고 수정한 다음 z/OS 시스템에 다시 전송하십시오.
  • z/OS UNIX System Services에서 UTF-8 파일을 편집하는 다른 도구가 있으면 해당 도구를 사용하십시오.

피드백