맵핑 파일 준비

이 주제에서는 나중에 Jazz™ Team Server의 이름을 실제로 바꿀 때 사용할 맵핑 파일을 준비하는 방법에 대해 설명합니다. 서버가 여전히 온라인인 동안 실제로 이름을 바꾸기 전에 맵핑 파일을 준비하고 검토할 수 있습니다.

시작하기 전에

중요사항: 서버 이름 바꾸기를 사용하려면 IBM® Software Support에서 기능 키 파일을 가져와야 합니다. IBM 지원 센터에 문의할 대 "서버 이름 바꾸기 기능 키 파일" 요청을 언급해야 합니다.

이 태스크 정보

실제로 서버의 이름을 바꾸기 전에 수행해야 하는 여러 단계가 있습니다. 대부분은 이름 바꾸기 오퍼레이션을 수행하는 데 사용할 맵핑 파일을 준비하고 검토하는 작업과 관련됩니다. 맵핑 파일은 기존 소스 URL과 이름이 바뀐 대상 URL을 사용자 배치에 나열합니다. 여기에는 Jazz Team Server, Jazz 애플리케이션, 영향 받은 다른 애플리케이션의 URL이 포함됩니다.

Jazz Team Server 및 Jazz 애플리케이션이 모두 동일한 컴퓨터에 설치되어 있는 통합 배치나 Jazz 애플리케이션이 서로 다른 컴퓨터에 설치되어 있는 분산 배치 모두에서 다음 단계를 수행할 수 있습니다. 이러한 예비 단계는 다양한 시나리오와 함께 사용할 수 있습니다. 예를 들어, 컴퓨터가 새 실제 위치로 이동되거나 새 컴퓨터에 테스트 샌드박스를 설정할 때 또는 새 컴퓨터에서 이름이 바뀐 환경과 관련된 데이터 센터를 통합하는 경우입니다.

프로시저

  1. Jazz Team Server(JTS) 및 모든 Jazz 애플리케이션을 업그레이드한 후 Jazz Team Server를 시작하고 애플리케이션이 서버에 올바르게 등록되었는지 확인하십시오.
    1. Jazz Team Server관리 페이지에 로그인하십시오. 웹 브라우저로 https://hostname:port/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

    이 명령의 출력은 Jazz Team ServerJazz Team Server에 등록된 각 Jazz 애플리케이션(Rational® Engineering Lifecycle Manager, Lifecycle Query Engine, Jazz Reporting Service)의 기존 소스 공용 URL과 기본 대상 URL을 나열하는 맵핑 파일입니다. 또한 알려진 영향 받은 외부 시스템과 도움말 WAR 파일의 소스 및 대상 URL도 식별합니다.

    또한 고려해야 하는 써드파티 통합을 참조하거나 맵핑되어야 하는 모든 URL 목록을 포함하는 두 번째 파일이 작성됩니다. 이러한 URL을 맵핑 파일에 추가할 수 있습니다. 단순 배치에서는 일반적으로 이 파일에 추가 URL이 포함되지 않습니다. additionalURLFile=additionalurl.txt 매개변수를 포함하는 경우 이 파일에 다른 이름을 지정할 수 있습니다. 이 매개변수에 대한 추가 세부사항은 서버 이름 바꾸기 맵핑 파일을 생성하기 위한 저장소 도구 명령의 내용을 참조하십시오.

    JazzInstallDir/server/repotools-jts_generateURLMappings.log에서 로그 파일에 오류가 없는지 확인하십시오.

  4. 생성된 맵핑 파일을 주의깊게 검토하고 편집하십시오. 호스트 이름, 포트 또는 루트 컨텍스트에서 철자 오류가 있는지 찾아보십시오. 이러한 철저 오류 중 일부는 서버 이름 바꾸기 도구가 발견할 수 없어서 제품이 작동하지 않게 될 수도 있습니다. 맵핑 파일의 구조를 익히려면 서버 이름 바꾸기에 사용할 맵핑 파일의 내용을 참조하십시오.
    1. 이름을 바꿀 모든 애플리케이션과 도움말 WAR 파일에 대해 소스-대상 쌍이 존재하는지 확인하십시오.
    2. 이름을 바꾸려는 항목이 올바른 대상이 되도록 target= urls를 편집하십시오.
      참고: JTS 또는 애플리케이션의 포트 번호에 대해 이름 바꾸기를 수행하는 경우 이름 바꾸기 후에, 그리고 서버가 다시 시작되기 전에 애플리케이션 서버에서 포트 정보를 업데이트해야 합니다. JTS 또는 애플리케이션의 컨텍스트 루트에 대해 이름 바꾸기를 수행하는 경우 컨텍스트 루트 변경의 내용을 참조하십시오.
    3. '#'를 사용하여 이름을 바꾸지 않으려는 URL의 소스-> 대상 쌍을 주석 처리하십시오.
    4. 영향 받은 URL의 목록을 검토하십시오. 명령이 배치에서 알려진 모든 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 설정 마법사를 실행하거나 Jazz Team Server를 시작하지 마십시오.

다음에 수행할 작업

서버 이름 바꾸기를 계속 진행하십시오. 자세한 정보는 서버 이름 바꾸기를 사용하여 파일럿 또는 전체 프로덕션 배치 이동의 내용을 참조하십시오.

피드백