버전 2에서 3.0.1로 수동 업그레이드

이 주제에서는 Rational Team Concert™ 버전 2를 버전 3.0.1로 업그레이드하는 수동 프로세스에 대해 설명합니다.

시작하기 전에

서버를 업그레이드하기 전에, Rational Team Concert v2 저장소 데이터베이스의 최신 및 올바른 백업을 완전히 보유하는지 확인하십시오.

모든 서버의 클럭이 NTP(Network Time Protocol)를 사용하여 동기화되었는지 확인하십시오. 시간은 한 네트워크 노드의 이벤트를 다른 위치의 해당 이벤트에 맵핑할 수 있도록 하는 중요한 요소입니다. 문제점을 방지하려면 이러한 과제는 NTP 서비스의 엔터프라이즈 배치에서 해결될 수 있습니다. NPT에 대한 자세한 정보는 http://www.ntp.org/를 방문하십시오. 또한 모든 서버가 해당 사용자에 대해 동일한 인증 방법을 사용해야 합니다.

Rational Team Concert v2 서버용 Derby를 사용하는 경우, 저장소 데이터베이스는 RTC2.X_install_dir/server/repositoryDB에서 3.0.1CCM_install_dir/server/conf/jazz/derby 디렉토리로 복사되는지 확인하십시오.

여러 제품을 업그레이드할 계획인 경우, 먼저 업그레이드 순서를 참조하면 업그레이드할 제품을 결정하는 데 도움이 됩니다.

프로시저

  1. 필요에 따라 배치 및 업그레이드 계획의 섹션에 있는 주제를 검토하십시오.
  2. 기존 버전 2 teamserver.properties 파일에서 공용 URL 특성(com.ibm.team.repository.server.webapp.url)이 있는지 확인하십시오.

    버전 3.0.1에서 동일한 공용 URL을 사용해야 합니다. 공용 URL를 설정하지 않은 경우, 버전 2 관리 웹 인터페이스(Advanced Properties)를 사용하여 업그레이드하기 전에 규정된 호스트 이름 URL(https://hostname.example.com:port)을 설정하십시오.

    teamserver.properties에서 공용 URL 행은 다음과 유사하게 나타납니다.
    com.ibm.team.repository.server.webapp.url=https\://<hostname.example.com>\:9443/jazz
  3. 버전 2 서버를 종료하십시오.
  4. 아직 설치하지 않은 경우, Jazz™ Team Server 및 CCM(Change and Configuration Management) 애플리케이션을 새 위치에 설치하십시오. 이미 Jazz Team Server를 설치한 경우, Change and Configuration Management 애플리케이션을 설치하십시오.
  5. 설치 중에 Rational Team Concert 2.x 컨텍스트 루트 사용을 선택하여 /jazz 컨텍스트 루트를 보존하십시오.
  6. 설치 종료 시 시작할 프로그램으로 없음을 선택하십시오.
  7. v2 데이터베이스와 동일한 매개변수지만 다른 데이터베이스 이름을 사용하여 Jazz Team Server에 대해 별도의 데이터베이스를 작성하십시오. 데이터베이스 작성에 대한 자세한 정보는 데이터베이스 설정을 참조하십시오.
    참고: CCM 데이터베이스와는 별도의 Jazz Team Server 데이터베이스가 필요합니다. 아직 수행하지 않은 경우 새 Jazz Team Server 데이터베이스를 작성하십시오.
    중요사항: 별도의 명령행 창을 열고 버전 2 및 버전 3 repotools 명령을 실행하십시오. 별도의 명령행 창을 사용하여 버전 2 및 버전 3 명령에서 사용하는 환경 변수 사이에 충돌이 없는지 확인하십시오.
  8. <3.0.1CCM_install_dir>/server를 탐색하고 다음 명령을 실행하여 Jazz 및 Tomcat 구성 파일(동반자 포함)을 병합하십시오.
    repotools-jazz -migration_ccm_updateConfigurationFiles oldApplicationHome=<2.x_install_dir>/server/conf
    기본적으로 -migration_ccm_updateConfigurationFiles 명령은 Jazz 및 Tomcat 구성 파일 모두를 업데이트합니다. Tomcat이 설치되어 있지 않고 Jazz 구성 파일만 업데이트하려면 updateTomcatFiles=false 매개변수를 지정해야 합니다.
    다음 태스크는 -migration_ccm_updateConfigurationFiles 명령과 함께 완료됩니다.
    • Jazz 구성 파일:
      • teamserver.properties(1개의 Rational Team Concert 파일을 팀 서버 및 애플리케이션용 2개의 파일로 병합)
      • friendsconfig.rdf(1개의 Rational Team Concert 파일을 1개의 애플리케이션 파일로 복사)
    • Tomcat 파일:
      • tomcat-users.xml(사본)
        알아두기: Tomcat 사용자 데이터베이스 전용. tomcat-users.xml 파일이 복사됩니다(기존 파일과 병합되지 않음). 공통 JTS로 다중 CLM 애플리케이션을 업그레이드하는 경우 수동으로 tomcat-users.xml 파일에서 사용자 및 그룹 정보를 병합해야 합니다. 사용자 및 그룹 정보는 사용자가 다른 애플리케이션의 다른 그룹에 속한 경우 다릅니다. 예를 들어 userA에는 CCM의 JazzAdmins 역할과 QM의 JazzUsers 역할이 있습니다. 또한 일부 사용자가 한 애플리케이션에 존재하지만 다른 위치에 없는 경우(또는 이와 반대의 경우) 수동으로 tomcat-users.xml 파일에 추가해야 합니다.
      • server.xml(병합\)
      • 애플리케이션 war 파일 내에 포함된 web.xml 파일(1개의 Rational Team Concert 파일이 팀 서버 및 애플리케이션용 2개의 파일로 병합)
    중요사항: Rational Team Concert 버전 2에서 다른 파일을 수정했을 수 있습니다(예: log4j.properties 파일). 수동으로 이 파일을 병합해야 합니다.

    repotools 명령에 대한 자세한 내용은 -migration_ccm_updateConfigurationFiles를 참조하십시오.

    알아두기: 다음 예제에서 teamserver.properties 파일의 위치는 기본 설치를 기반으로 합니다. 배치하기 위해 파일 레이아웃을 변경하는 경우 올바른 위치를 사용하고 있는지 확인하십시오. 또한 다음 단계에서는 하나의 서버에 배치가 있다고 가정합니다. 기본적으로, newJTSHome 매개변수값은 newApplicationHome에서 파생됩니다.CCM 및 Jazz Team Server에 대해 별도의 서버를 사용하는 경우, Jazz Team Server 위치를 가리키도록 newJTSHome 매개변수를 지정하십시오. 이러한 방법으로 LDAP, 이메일 및 데이터베이스 위치 특성은 Rational Team Concert 버전 2 teamserver.properties 파일에서 병합됩니다. 또한 tomcat 구성 파일은 Jazz Team Server 위치로 복사됩니다.
  9. 업데이트된 특성 파일에 다음 정보가 포함되어 있는지 확인하십시오.
    • 특성은 버전 2 teamserver.properties 파일에서 복사됩니다.
    • 올바른 데이터베이스 벤더 항목(/conf/jts/teamserver.properties에 지정된 데이터베이스가 있는지 확인). 자세한 정보는 업그레이드 중에 구성 파일 확인의 내용을 참조하십시오.
    • friendsconfig.rdf가 <RTC2.X_install_dir>/server/conf/jazz에서 <3.0.1CCM_install_dir>/server/conf/jazz로 복사되었는지 확인하십시오.
    • tomcat-users.xml이 복사되었는지 확인하십시오.
    • 버전 3 server.xml 파일을 열고 버전 2의 정보(포트 번호, LDAP 설정 및 기타 수정)를 포함하는지 확인하십시오.
    • 버전 3 web.xml 파일을 열고 버전 2의 정보(LDAP 설정 및 기타 수정)를 포함하는지 확인하십시오.
    • 올바른 고유 공용 URL com.ibm.team.repository.server.webapp.url은 teamserver.properties 파일에 존재합니다. (CCM 애플리케이션의 URL은 Rational Team Concert 버전 2에서 사용한 URL과 동일해야 합니다.)
  10. 명령 창을 열고 <3.0.1CCM_install_dir>/server 디렉토리로 이동하십시오.
  11. 다음 명령을 실행하여 데이터베이스에 테이블을 추가하십시오.
    repotools-jazz -addTables
  12. 다음 명령을 실행하여 사용자 정보를 Rational Team Concert 데이터베이스에서 내보내십시오.
    repotools-jazz -migration_exportJTSData toFile=jtsData.tar
    참고: 두 번 이상 이 프로세스를 따르는 경우, 두 번째 tar 파일에 대해 다른 파일 이름을 사용하십시오. 예를 들어, jtsData2.tar을 사용하십시오.
  13. Jazz Team Server가 설치된 머신에서 다음 명령을 실행하여 사용자 정보를 Jazz Team Server 데이터베이스로 가져오십시오.
    참고: 기본 Derby 데이터베이스를 사용하지 않는 경우, conf/jts/teamserver.properties 파일에서 참조된 Jazz Team Server 데이터베이스가 새 데이터베이스이고 존재하는지 확인하십시오.
    repotools-jts -migration_importJTSData fromFile=jtsData.tar createMappingFile=rtc-mapping.txt createTables
    참고: 두 번 이상 이 프로세스를 따르는 경우, 두 번째 tar 파일에 대해 다른 파일 이름을 사용하십시오. 예를 들어, jtsData2.tar을 사용하십시오.
    주의: CCM 애플리케이션의 두 번째 설치에서 Jazz Team Server 데이터를 가져오는 경우, createTables 매개변수를 사용하지 마십시오. CLM 애플리케이션이 이미 Jazz Team Server에 설치되어 있으며 createTables 매개변수를 사용하는 경우, 서버에서 사용자 데이터가 손실됩니다.
  14. 다음 명령을 실행하여 Jazz Team Server 사용자 정보를 Rational Team Concert 데이터베이스로 가져오십시오.
    repotools-jazz -migration_importUserMapping fromMappingFile=rtc-mapping.txt 
  15. 다음 명령을 실행하여 텍스트 색인을 다시 빌드하십시오.
    repotools-jazz -rebuildTextIndices
  16. 다음 명령을 실행하여 Lucene 및 RDF 색인을 다시 빌드하십시오.
    repotools-jazz -reindex
  17. 버전 2 제품에 기본 색인 위치가 없고 색인을 위해 사용자 정의된 위치를 계속 사용하려는 경우 색인 위치를 추가하려면 버전 3.0.1 teamserver.properties 파일을 수정해야 합니다.
    1. com.ibm.team.fulltext.indexLocation=conf/jts/indices/workitemindex 값을 전체 텍스트 색인의 전체 경로 위치로 변경하십시오. 예를 들어 com.ibm.team.fulltext.indexLocation=c:/indices/workitemindex와 같습니다.
    2. com.ibm.team.jfs.index.root.directory=indices 값을 JFS 색인 루트 디렉토리의 전체 경로 위치로 변경하십시오. 예를 들어 com.ibm.team.jfs.index.root.directory=c:/indices와 같습니다.
  18. 다음을 확인하십시오.
    • Jazz Team Server 데이터베이스 위치가 애플리케이션 데이터베이스 위치와 다른지 확인하십시오.
    • 색인 또는 기타 파일 관련 특성이 애플리케이션과 Jazz Team Server 사이에서 공유되지 않는지 확인하십시오.
    • friendconfig.rdf 파일 이름이 friendconfig.rdf.saved로 바뀌었는지 확인하십시오.
  19. Apache Tomcat을 사용하는 경우 Apache Tomcat 설정을 참조하십시오.
  20. Websphere Application Server를 사용하는 경우 이전에 설치한 웹 애플리케이션을 설치 제거하고 3.0.1 설치에 제공된 jts.war, ccm.war 및 clmhelp.war를 다시 배치하십시오. 추가 세부사항은 버전 3 업그레이드를 위해 WebSphere Application Server 설정을 참조하십시오.
  21. 서버와 설치한 모든 CLM 애플리케이션을 구성하십시오.

    Jazz Team Server를 Change and Configuration Management 애플리케이션 또는 다른 CLM 애플리케이션과 함께 업그레이드하는 경우, 서버 설정 마법사를 실행하십시오(설정 마법사 실행 참조). Change and Configuration Management 애플리케이션을 확립된 Jazz Team Server에 추가하는 경우, 관리 웹 인터페이스를 사용하십시오(Jazz Team Server에 애플리케이션 등록 참조).


피드백