프로덕션 데이터로 테스트 스테이징 환경 설정

이 주제에서는 실제 프로덕션 데이터를 사용하여 스테이징 환경을 준비하기 위해 서버 이름 바꾸기 기능을 사용하는 방법에 대해 설명합니다. 스테이징 환경은 프로덕션 환경과 분리된 테스트 샌드박스입니다. 이 환경은 프로덕션 데이터베이스에 영향을 주지 않고 실제 데이터로 새 피처 또는 기능을 시도해 보는 데 사용할 수 있습니다.

이 태스크 정보

중요사항: 이 프로시저는 이전 릴리스에서 환경을 업그레이드하는 데는 사용할 수 없습니다. 서버 이름 바꾸기는 버전 4 이상 릴리스에서만 지원됩니다. 따라서 버전 4로 업그레이드하는 것은 서버 이름 바꾸기를 사용하여 스테이징 환경을 설정하기 위한 전제조건입니다.

서버 이름 바꾸기 기능은 맵핑 파일을 사용하여 이름을 바꿔야 하는 URL을 판별합니다. 초기 맵핑 파일이 자동으로 생성되도록 repotools 명령이 제공됩니다. 맵핑 파일에는 Jazz™ Team Server와 모든 애플리케이션의 소스-대상 쌍과 애플리케이션이 컨트리뷰션하는 다른 URL이 포함됩니다. 맵핑 파일에 대한 자세한 정보는 서버 이름 바꾸기에 사용하는 맵핑 파일 이해의 내용을 참조하십시오. 샘플 토폴로지 다이어그램과 맵핑 파일은 테스트 스테이징 환경을 설정하기 위한 토폴로지와 맵핑 파일의 내용을 참조하십시오.

스테이징 환경을 계획할 때 프로덕션 데이터를 오염시키지 않도록 특히 주의해야 합니다(그 반대의 경우도 마찬가지임). 이는 환경에서 호스트 파일에 항목을 추가할 수 있는 경우 추가하는 방법과 스테이징 환경에 없는 모든 서버를 마스크하기 위해 맵핑을 작성하는 두 가지 방법을 사용할 수 있습니다. 프로덕션 서버에 연결될 수 있는 추가 CLM 서버나 비CLM 제품을 맵핑에 포함하도록 하십시오. 세부사항은 3.c 및 스테이징 환경을 위한 더미 맵핑 단계를 참조하십시오.

예를 들어, 한 프로덕션 서버의 CCM(Change and Configuration Management) 애플리케이션에 다른 프로덕션 서버의 CCM에 대한 링크가 있고, 또 다른 프로덕션 서버에 있는 QM(Quality Management)에 대한 링크가 있습니다. 또한 비CLM 제품(예: Rational® ClearQuest®)과의 통합이 있습니다. 이 경우 추가 CCM 및 QM 서버의 URL을 먼저 마스크 처리한 다음 Rational ClearQuest도 마스크 처리되었는지 확인하십시오. 그렇지 않으면 스테이지된 Rational ClearQuest 게이트웨이 서버에 맵핑되었는지 확인하십시오.

중요사항: Rational Team Concert 클라이언트를 프로덕션과 스테이징 저장소 둘 다에 연결하지 마십시오. 항상 스테이징 작업공간을 사용하여 스테이징 서버에 연결하십시오.

아래 다이어그램은 서버 이름 바꾸기를 사용하여 스테이징 환경을 설정하는 데 필요한 기본 단계를 표시합니다. 이 경우, 최신 버전의 CLM(버전 4)와 RRDI(버전 2)가 이미 설치되어 있다고 간주합니다.

프로덕션에서 스테이징으로 시나리오

프로시저

  1. 맵핑 파일 준비 주제에 설명된 단계를 수행하여 이름 바꾸기를 준비하십시오.

    맵핑 파일에서 영향을 받는 모든 URL에 대해 더미 맵핑을 작성하십시오. 이를 통해 스테이징과 프로덕션 환경 사이에서 교차 링크를 방지할 수 있습니다. 세부사항은 스테이징 환경을 위한 더미 맵핑을 참조하십시오.

    예비 단계의 종료 결과는 원본, 소스 Jazz Team Server에서 생성되는 맵핑 파일입니다. 맵핑 파일을 주의깊게 검토하여 편집한 다음 스테이징 환경의 대상 Jazz Team Server에 있는 JazzInstallDir\server 디렉토리에 복사하십시오.

  2. 버전 4 프로덕션 환경을 백업하고 텍스트 색인과 애플리케이션 구성 파일을 대상 스테이징 서버에 복사하십시오.

    이 단계를 수행하는 중에는 프로덕션 서버를 중지해야 하므로 백업을 수행하는 데 편리한 시간을 선택하십시오. 가장 많이 선택되는 시간은 스테이징 환경을 설정하기 바로 전입니다. 실제 이름 바꾸기를 진행하기 전에 프로덕션 환경을 변경한 경우 스테이징 서버에 맵핑 파일을 가져오려면 해당 파일을 다시 생성해야 합니다. 서버가 작동 중지된 동안에는 곧 이름이 바뀔 예정인 CLM 배치와 통합된 외부 시스템의 링크를 작성하거나 순회할 수 없습니다.

    1. Jazz Team Server와 프로덕션 환경에서 Jazz Team Server에 등록된 모든 분배 CLM 애플리케이션을 중지하십시오.
    2. Jazz Team Server 데이터베이스, CCM 및 QM 애플리케이션의 데이터베이스, 데이터 웨어하우스 데이터베이스, RRDI 컨텐츠 저장소 데이터베이스를 포함하여 CLM 4.0 프로덕션 환경에서 모든 데이터베이스를 백업하십시오. CLM 데이터베이스 이동 단계에 따라 프로덕션에서 스테이징 환경으로 데이터베이스를 복사하십시오.
    3. 소스 프로덕션 서버에서 대상 스테이징 서버로 JFS/text 색인을 복사하십시오. (분산 시스템의 경우 파일을 복사하려면 적절한 서버로 이동하십시오.)

      Linux 서버에 대한 다음 예제에서는 스테이징 컴퓨터의 드라이브가 네트워크로 마운트되었다고 간주합니다. 사용자 환경에서 이 가정이 불가능한 경우 다른 파일 전송 방법을 사용하여 파일이 복사되도록 하십시오.

      cp -R SourceJazzInstallDir/server/conf/jts/indices TargetJazzInstallDir/server/conf/jts
      cp -R SourceJazzInstallDir/server/conf/ccm/indices TargetJazzInstallDir/server/conf/ccm
      cp -R SourceJazzInstallDir/server/conf/qm/indices TargetJazzInstallDir/server/conf/qm
    4. 소스 프로덕션 서버에서 대상 스테이징 서버로 애플리케이션 구성 파일을 복사하십시오. (분산 시스템의 경우 파일을 복사하려면 적절한 서버로 이동하십시오.) 이전 단계에서와 같이 아래 예제는 Linux 서버용이며 스테이징 컴퓨터의 드라이브가 네트워크로 마운트되었다고 가정합니다.
      cp SourceJazzInstallDir/server/conf/jts/teamserver*.properties  TargetJazzInstallDir/server/conf/jts
      cp SourceJazzInstallDir/server/conf/ccm/teamserver*.properties  TargetJazzInstallDir/server/conf/ccm
      cp SourceJazzInstallDir/server/conf/qm/teamserver*.properties  TargetJazzInstallDir/server/conf/qm
      cp SourceJazzInstallDir/server/conf/admin/admin.properties*  TargetJazzInstallDir/server/conf/admin
      cp SourceJazzInstallDir/server/conf/admin/friends.rdf*  TargetJazzInstallDir/server/conf/admin
      cp SourceJazzInstallDir/server/conf/rm/fronting.properties  TargetJazzInstallDir/server/conf/rm
      cp SourceJazzInstallDir/server/conf/rm/friendsconfig.rdf  TargetJazzInstallDir/server/conf/rm
    5. 맵핑 파일을 프로덕션 서버의 TargetJazzInstallDir\server 디렉토리로 복사하십시오. 맵핑 파일에 대한 세부사항은 맵핑 파일 준비를 참조하십시오.
      참고: 다음 단계를 수행하기 전에 CLM 배치에 구성 변경사항이 작성된 경우 맵핑 파일을 재생성해야 합니다.
    6. 모든 CLM 서버를 다시 시작하고, 사용자가 계속 프로덕션 환경을 사용하도록 허용하십시오. 나머지 단계는 모두 스테이징 테스트 환경에 적용됩니다.
  3. 스테이징 테스트 환경에서 다음 단계를 수행하십시오.
    1. 프로덕션 환경에서 스테이징 환경으로 데이터베이스 백업을 복원하십시오. 프로덕션 데이터베이스 서버에 부담을 주지 않도록 스테이징 환경에서 별도의 데이터베이스 서버를 사용하도록 권장합니다.
    2. JazzInstallDir/server/conf/applicationName/teamserver.properties 파일의 데이터베이스 연결 매개변수가 테스트 환경에 있는 데이터베이스의 스테이징 사본에 대한 연결 매개변수를 가리키도록 바꾸십시오. 여기에는 jts 데이터베이스, ccm 및 qm 애플리케이션 데이터베이스, 데이터 웨어하우스 데이터베이스, 업데이트된 비밀번호 항목이 포함됩니다.
    3. 맵핑 파일의 더미 맵핑에 대한 추가 예방조치로서 사용자 환경에서 사용 가능한 경우 프로덕션 시스템 URL에 대한 액세스를 방지하고 프로덕션 서버의 아티팩트를 우연히 편집하지 않도록 호스트 파일을 업데이트하십시오.

      프로덕션 환경에 있는 CLM 서버에서 사용 중이지 않는 잘못된 IP 주소로 호스트 이름이 해석되지 않도록 하기 위함입니다. 따라서 스테이징 환경에 있는 서버가 프로덕션 서버에 연결을 설정하려고 시도하면 연결이 실패합니다.

      맵핑 파일에 표시되는 모든 고유 호스트 이름의 목록을 작성하십시오. 해당 이름은 소스 URL이나 영향받은 URL이 될 수 있습니다. 각 개별 호스트 이름에 대해 호스트 이름을 잘못된 IP 주소에 맵핑하는 항목을 호스트 파일에 작성하십시오. 스테이징 환경에 있는 모든 서버(써드 파티 서버와 클라이언트 워크스테이션 포함)의 호스트 파일을 편집해야 합니다. 다음 호스트 파일은 스테이징 서버의 샘플 항목을 표시합니다.

       # 10.10.10.10 refers to an IP address that does not host a clm application. 
        10.10.10.10   ProductionServerP1
        10.10.10.10   ProductionServerP2
        10.10.10.10   ProductionServerP3
    4. JazzInstallDir\server 디렉토리에서 명령 프롬프트를 열고 repotools-jts -importURLMappings 명령을 사용하여 맵핑 파일을 대상 Jazz Team Server에 가져오십시오.
      • 복합(all-in-one) 배치가 있는 경우 다음과 같이 repotools-jts -importURLMappings 명령을 사용하여 맵핑 파일을 가져오십시오.

        For Windows operating system repotools-jts.bat -importURLMappings fromFile="C:\mappings.txt"

        For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="opt/mappings.txt"

        이름 바꾸기는 서버가 다시 시작되기 전에 Jazz Team Server에서 오프라인으로 시작됩니다.

      • 분배 배치가 있고 네트워크 드라이브를 맵핑할 수 있는 경우에는 네트워크 드라이브를 Jazz Team Server호스트에서 각 애플리케이션 호스트로 맵핑하십시오. 그런 후 사용자 배치에서 다음과 같은 형식의 원격 server/conf 디렉토리 목록을 포함하는 파일(예: serverConfFile.txt)을 작성하십시오.
         # Remote CCM server
           x:/JazzTeamServer/server/conf
           # Remote QM server
           y:/JazzTeamServer/server/conf
           # Remote RM server
           z:/JazzTeamServer/server/conf

        마지막으로 repotools-jts -importURLMappings 명령을 계속 진행하고 아래 표시된 대로 serverConfFile= 매개변수를 추가하십시오.

        For Windows operating system repotools-jts.bat -importURLMappings fromFile="C:\mappings.txt" serverConfFile="C:\serverConf.txt"

        For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="/opt/mappings.txt" serverConfFile="/opt/serverConf.txt"

      • 분산 CLM 배치가 있으며 네트워크 드라이브를 다시 맵핑할 수 없으면 아래 표시된 것처럼 repotools-jts -importURLMappings 명령으로 계속 진행하십시오.

        For Windows operating system repotools-jts.bat -importURLMappings fromFile="C:\mappings.txt"

        For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="opt/mappings.txt"

        그런 다음 server/conf/jts/.mappingEvent 파일을 ccm, qm, rm인 원격 애플리케이션 구성 디렉토리(server/conf/application_name)에 복사하십시오. 맵핑 파일을 가져온 다음 서버를 시작하기 전에 .mappingEvent 파일을 복사해야 합니다.

        .mappingEvent 파일에는 새 위치에 있는 Jazz Team Server에 접속하기 위해 애플리케이션에 필요한 정보가 있습니다. 지정된 Jazz Team Server 및 해당 등록 애플리케이션의 .mappingEvent 파일 컨텐츠는 동일합니다.

      이름 바꾸기가 제대로 완료되었는지 콘솔 출력 및 server/repotools-jts_importURLMappings.log 파일을 검사하십시오. 오류가 표시되거나 맵핑 파일에 오류가 있는 경우, 문제점을 정확히 찾아 수정하려면 서버 이름 바꾸기 문제점 해결을 참조 하십시오.

      참고: z/OS®에서 실행 중인 서버는 샘플 JCL 멤버 HLQ.SBLZSAMP(BLZRENAM)를 사용하여 이름을 바꿔야 합니다. 자세한 사용자 정의 지시사항은 BLZRENAM에서 주석 헤더를 참조하십시오.
  4. Jazz Team Server에 등록된 Jazz Team Server와 분산 CLM 애플리케이션을 시작하십시오.

    이 때 CLM 애플리케이션은 URL 맵핑을 적용하고 해당 데이터 웨어하우스 데이터를 업데이트하기 위해 Jazz Team Server와 동기화합니다. 작은 데이터 세트인 경우 5분 정도 소요되고 매우 큰 데이터 세트인 경우 30분 이상 소요될 수 있습니다.

  5. https://new host:port/jts/serverRenameStatus에서 Jazz Team Server에 로그인하고 이름 바꾸기의 상태를 확인하십시오.

    모든 애플리케이션 이름 바꾸기가 완료되고 서버 이름 바꾸기 완료 단계가 완료될 때까지 대기하십시오. 다음 메시지가 표시되는지 확인하십시오. 서버 이름 바꾸기가 완료되었습니다. Jazz Team Server와 애플리케이션이 완전히 작동합니다. 서버는 바로 사용하기 시작할 수 있으며 다시 시작할 필요가 없습니다.

    오류가 표시되면 문제점을 정확히 찾아 수정하도록 서버 이름 바꾸기 문제점 해결의 내용을 참조하십시오.

    참고: 이름 바꾸기가 완료되기 전에 CLM 애플리케이션의 웹 UI에 로그인하려는 모든 시도는 이 상태 페이지로 경로 재지정됩니다.
  6. 서버 이름 바꾸기 확인에 설명된 서버 이름 바꾸기 검증 단계를 수행하십시오.
    참고: 프로덕션 환경을 보호하기 위해 더미 맵핑을 도입한 경우 스테이지된 서버의 애플리케이션 진단 페이지에서 애플리케이션 및 동반자 섹션에 이 URL에 대한 오류가 표시되어야 합니다.
  7. 선택사항: 스테이징 환경에서 RRDI(Rational Reporting for Development Intelligence)를 구성하려면 다음 단계를 수행하십시오.
    1. 프로덕션 환경에서 다음 데이터베이스를 백업하고 스테이징 환경의 새 RRDI 설치에 사용하는 새 데이터베이스 서버에 복원하십시오.
      • 컨텐츠 저장소 데이터베이스(예: RICM)
      • 데이터 웨어하우스(예: RIDW가 아직 백업되어 복원되지 않은 경우, RIDW).
    2. 스테이징 환경에 RRDI(Rational Reporting for Development Intelligence) 버전 2.0을 설치하십시오. 세부사항은 Installation Manager를 사용하여 RRDI(Rational Reporting for Development Intelligence) 설치를 참조하십시오.
    3. RRDI 설정 애플리케이션을 실행하여 보고서 서버를 구성하십시오. 세부사항은 설치 후 태스크를 참조하십시오. 다음 조치를 수행하도록 명심하십시오.
      • 컨텐츠 저장소 데이터베이스 구성 페이지에서 7.a 단계에서 복원한 컨텐츠 저장소 데이터베이스(예: RICM)의 연결 특성을 지정하십시오.
      • 데이터 웨어하우스 구성 페이지에서 7.a 단계에서 복원한 데이터 웨어하우스 데이터베이스(예: RIDW)의 연결 특성을 지정하십시오.
    4. Jazz Team Server에 로그온하여 Jazz Team Server와 CCM 및 QM 관리의 고급 특성 페이지에 저장된 보고서 서버 URL이 스테이지된 RRDI 보고서 서버를 가리키도록 업데이트하십시오.
      참고: 이 단계는 맵핑 파일에 RRDI의 URL이 누락된 경우에만 필요합니다.
    5. 프로덕션 RRDI 보고서 서버에서 이전에 가져온 모든 보고서가 계속 작동하는지 확인하십시오.
    6. 조치가 가장 최신 보고서 보기로 설정된 모든 Cognos 보고서 또는 보고서 보기는 캐시된 HTML 보고서가 업데이트되도록 CLM 서버 이름 바꾸기 후에 다시 실행해야 합니다.
      1. RRDI 보고서 서버에 로그온하십시오.
      2. 캐시된 출력 버전이 포함된 보고서 또는 보고서 보기를 검색하십시오.
        참고: 캐시된 출력 버전이 보고서나 보고서 보기에 대해 존재하는 경우, 이 보고서에 대해 출력 버전 보기를 클릭하여 캐시된 보고서를 확인할 수 있습니다. 보고서나 보고서 보기가 CLM 서버 이름 바꾸기 전에 생성된 경우 보고서나 보고서 보기를 다시 실행하여 이를 업데이트해야 합니다. 그렇지 않으면 보고서나 보고서 보기를 실행하는 사용자에게 이전 CLM 서버로 연결되는 이전 링크가 표시됩니다.
      3. 옵션으로 실행을 클릭하여 보고서나 보고서 보기를 다시 실행하십시오.
      4. 보고서 뷰어에서 이 버전 보존 > 보고서 저장을 클릭하여 보고서나 보고서 보기와 연관된 캐시된 출력 버전을 업데이트하십시오.
    7. 스테이지된 RRDI 보고서 서버에서 새 보고서를 가져오십시오. 가져오기에 성공했으며 가져온 이 보고서가 문제 없이 실행되는지 확인하십시오.
    8. RRDI에서 Rational Quality Manager 실시간 보고서를 구성한 경우 새 서버의 xdc 파일을 생성하여 32비트 ODBC 관리자에 구성하는 단계를 수행하십시오. 세부사항은 실시간 보고 설정을 참조하십시오.
  8. 스테이징 환경에 다른 컴포넌트(예: Jazz Build Engine, Rational Team Concert 클라이언트, Rational ClearQuest 또는 Rational ClearCase)를 포함시키는 경우 추가 필수 단계를 수행하십시오. 자세한 정보는 제한사항 및 추가 정보의 내용을 참조하십시오.

피드백