Rational Quality Manager 및 Jazz Team Server 3.0.1로 수동 업그레이드

이 주제에서는 Rational® Quality Manager 버전 2를 버전 3으로 업그레이드하는 수동 프로세스에 대해 설명합니다.

시작하기 전에

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

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

WebSphere® Application Server 환경에서 C:\IBM\JazzTeamServer와 같이 공백을 포함하지 않는 설치 경로로 변경하도록 권장합니다. 파일 이름 또는 파일 경로 매개변수에 공백이 포함된 경우 큰따옴표로 매개변수를 묶어야 합니다.

버전 2.0.1 iFix02 이상에서 업그레이드하는 경우, 데이터를 내보내기 전에 먼저 버전 2.0.1.1 이상으로 업그레이드하십시오. 그런 다음, 버전 2 서버에서 다음 repotools 명령을 실행하여 내보내기-가져오기 프로세스에서의 잠재적 오류를 방지하십시오.

Windows: repotools -repairRequests

Unix/Linux: ./repotools.sh -clean -repairRequests

2.0.1 iFix02 이전 버전 사용자는 이 단계를 무시할 수 있습니다.

프로시저

  1. 필요에 따라 배치 및 업그레이드 계획의 섹션에 있는 주제를 검토하십시오.
  2. 기존 버전 2 teamserver.properties 파일에서 공용 URL 특성(com.ibm.team.repository.server.webapp.url)과 데이터베이스 서버에 연결하는 데 필요한 정보(일반적으로, com.ibm.team.repository.db.vendor, com.ibm.team.repository.db.jdbc.location 및 com.ibm.team.repository.db.jdbc.password)가 있는지 확인하십시오.

    버전 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. jazz.net의 적절한 프로젝트 페이지에서 Rational Quality Manager 소프트웨어를 다운로드하십시오. 지시사항은 제품 설치 매체 다운로드의 내용을 참조하십시오.
  4. 버전 2 서버를 중지시키십시오.
    참고: 분산 환경에서 작업 중이며 Jazz™ Team Server 3.0.1을 이미 설치한 경우, Jazz Team Server 및 기타 애플리케이션의 중단시간을 최소화하기 위해 버전 2 데이터를 버전 3 QM(Quality Management) 데이터베이스로 가져오는 것을 완료할 때까지 선택적으로 서버를 실행 상태로 유지할 수 있습니다. 이때 Jazz Team Server를 중지해야 합니다. 사용자 및 라이센싱 데이터를 Jazz Team Server로 가져오는 것을 완료한 후에 다시 시작할 수 있습니다(14).
  5. 버전 2 데이터베이스 및 teamserver.properties 파일을 임시 위치에 백업하십시오. 기본적으로, teamserver.properties 파일은 버전 2에서 InstallDir\server\conf\jazz\teamserver.properties에 있습니다. 백업 지시사항은 다음 주제를 참조하십시오.
  6. 다음 예제와 같이 repotools -export 명령을 사용하여 기존 버전 2 저장소에서 데이터를 추출하여 이 파일을 Rational Quality Manager 디렉토리 구조의 외부에 저장하십시오.
    repotools -export toFile=c:\export.tar teamserver.properties=c:\Program%20Files\IBM\RQM201\server\conf\jazz\teamserver.properties

    여기서 toFile은 저장소를 내보낸 TAR 파일의 이름을 지정하며 teamserver.properties는 teamserver.properties 파일의 경로를 지정합니다.

    참고: repotools 사용에 대한 자세한 지시사항은 저장소 마이그레이션 시작하기 및 Repotools 명령행 참조에 있습니다. 기존 버전 2 제품에 포함된 repotools의 버전을 사용하는지 확인하십시오.
  7. 아직 Jazz Team Server를 설치하지 않은 경우, 해당 서버와 Quality Management 애플리케이션, 그리고 필수 기본 라이센스 키를 디스크의 새 위치에 설치하십시오. 이미 해당 서버를 설치한 경우, Quality Management 애플리케이션을 설치하십시오. 지시사항은 IBM Installation Manager를 사용하여 설치의 내용을 참조하십시오.
    중요사항: 버전 2와 마찬가지로 요구사항, 결함 및 기타 작업 항목은 Quality Management 애플리케이션에서 더 이상 작성되지 않습니다. 이러한 기능을 활용하려는 테스트 팀은 Requirements Management 및 Change and Configuration Management도 설치해야 합니다. 분산 환경에서는 이러한 애플리케이션을 별도로 설치할 수 있습니다.

    설치 중에 Rational Quality Manager 2.x 컨텍스트 루트 사용을 선택하십시오. 그러면 /qm이 아닌 /jazz의 컨텍스트 루트에 QM 애플리케이션을 설치합니다. 이 옵션은 QM 아티팩트에 대한 링크를 보존하는 데 필요합니다. 이 옵션을 선택하는 데 실패하면 업그레이드에 실패합니다. 자세한 정보는 배치 및 업그레이드 프로세스 이해의 내용을 참조하십시오.

  8. 설치 종료 시 시작할 프로그램으로 없음을 선택하십시오.
  9. 기본 Derby 데이터베이스가 아닌 다른 데이터베이스를 사용 중인 경우, 버전 3 데이터베이스를 작성하십시오.

    데이터베이스는 Jazz Team Server, Quality Management, Change and Configuration Management 및 데이터 웨어하우스에 필요합니다. Requirements Management의 경우 데이터 저장을 위해 Jazz Team Server 데이터베이스를 사용하므로 데이터베이스를 작성하지 않아도 됩니다. 각 데이터베이스에 대한 세부사항은 데이터베이스 설정의 주제를 참조하십시오.

    참고: Oracle 또는 SQL Server 데이터베이스를 사용하는 경우 데이터베이스 드라이버를 올바른 위치에 복사하십시오. 세부사항은 Oracle 데이터베이스 설정 및 SQL Server 데이터베이스 설정을 참조하십시오.
  10. 버전 3.0.1(RQM301InstallDir/server)에서 새 명령 창을 열고 repotools-jazz -migration_qm_updateConfigurationFiles oldApplicationHome=RQM2InstallDir/server/conf를 입력하여 버전 2 Jazz 구성 파일을 버전 3 구성 파일과 병합하십시오.

    분산 배치에서처럼 버전 3.0.1 Jazz Team Server를 QM 애플리케이션과 별도로 설치한 경우, 다음을 수행하십시오.

    • Jazz Team Server가 설치된 드라이브 또는 파일 시스템을 마운트하십시오.
    • -migration_qm_updateConfigurationFiles 명령행에서 -newJTSHome 인수를 포함하여 3.0.1 Jazz Team Server의 위치를 지정하십시오.

    이 명령은 다음 태스크를 완료합니다.

    • 버전 2 Jazz teamserver.properties 파일의 정보에 기반하여 애플리케이션 및 JTS에 대한 버전 3 teamserver.properties 파일을 업데이트합니다.
    • Tomcat 사용자 xml 파일의 컨텐츠를 복사합니다
    • 교차 저장소 통합에 대해 설정된 서버 목록을 포함하는 friendsconfig.rdf 파일을 복사합니다.
    • 버전 2 server.xml 및 web.xml(LDAP 설정) 파일의 컨텐츠를 버전 3과 병합합니다.
  11. 구성 파일을 확인하십시오. 세부사항은 업그레이드 중 구성 파일 확인 및 -migration_qm_updateConfigurationFiles를 참조하십시오.
  12. WebSphere Application Server에 배치하는 경우, 버전 2 jazz.war 및 help.war 애플리케이션을 중지시킨 후 설치 제거하십시오.
  13. 다음 예제에 표시된 대로 repotools-jazz -import 명령을 사용하여 Rational Quality Manager 데이터를 내보낸 버전 2 저장소에서 새 버전 3 QM(Quality Management) 저장소로 가져오십시오.
    repotools-jazz -import fromFile=c:\export.tar

    여기서 fromFile은 저장소를 가져온 TAR 파일의 이름을 지정합니다.

    참고: Quality Management 3.0.1에 대한 대형 저장소를 가져오면 OutOfMemoryException 오류가 발생할 수 있습니다. 고객이 보유한 프로젝트 및 아티팩트 수가 많으면 repotools-jazz.bat 또는 repotools-jazz.sh 스크립트에서 -Xmx 매개변수를 기본값, 1500M에서 더 높은 값으로 늘려야 합니다. 시스템에 메모리가 충분하고 64비트 OS를 실행 중인 경우 4096M이 권장됩니다.
  14. 새 JTS(Jazz Team Server) 데이터베이스를 작성하고 Quality Management에서 사용자 및 라이센싱 데이터를 전송하십시오.
    1. 다음 repotools-jazz 명령을 사용하여 Quality Management 애플리케이션에서 사용자 데이터를 내보내십시오.
      repotools-jazz -migration_exportJTSData toFile=jtsData.tar 
    2. 다음 repotools-jts 명령을 사용하여 Jazz Team Server 데이터베이스로 사용자 및 라이센싱 데이터를 가져오십시오.
      중요사항: Jazz Team Server 및 CLM(Collaborative Lifecycle Management) 제품을 새로 설치할 경우 새 JTS 데이터베이스를 작성하는 createTables 매개변수를 repotools-jts 명령에 포함할 수 있습니다. 이미 기존 JTS 데이터베이스가 있는 경우 기존 데이터베이스를 겹처쓰게 되므로 명령행에 createTables 매개변수를 포함하지 마십시오.
      repotools-jts -migration_importJTSData fromFile=jtsData.tar createMappingFile=mapping-qm.txt createTables 
    3. 다음 repotools-jazz 명령을 사용하여 QM 데이터베이스로 사용자 맵핑 데이터를 가져오십시오. 맵핑은 QM 애플리케이션에서 JTS 데이터베이스와 통신하는 데 사용됩니다.
      repotools-jazz -migration_importUserMapping fromMappingFile=mapping-qm.txt   
  15. 이전 릴리스와 사용하도록 보안 인증서를 작성한 경우 이전 릴리스의 인증서를 복사하거나 새 인증서를 작성하십시오. 세부사항은 보안 인증서 구성의 내용을 참조하십시오.
  16. Tomcat 애플리케이션 서버를 Windows 서비스로 실행하는 경우 서비스를 제거한 후 다시 설치해야 합니다. 명령 구문은 Apache Tomcat에서 Windows 서비스로 실행 (32비트, Rational Quality Manager)의 내용을 참조하십시오.
  17. WebSphere Application Server에 배치하는 경우 3.0 WAR 파일을 배치하고 사용자 또는 그룹에 보안 역할을 맵핑하십시오. 세부사항은 버전 3 업그레이드를 위해 WebSphere Application Server 설정 및 WebSphere Application Server에 CLM 애플리케이션 배치를 참조하십시오.
  18. 애플리케이션 서버, 버전 3 Jazz Team Server 또는 WebSphere Application Server를 시작하십시오.
  19. 서버와 설치한 모든 CLM 애플리케이션을 구성하십시오.

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

  20. jazz/admin으로 이동하고 오류가 없는지 확인하십시오.
  21. 버전 2에서 RM(Requirements Management) 애플리케이션으로 요구사항을 마이그레이션하십시오. 자세한 정보는 작업 항목 기반 요구사항 마이그레이션의 내용을 참조하십시오.
    참고: 이 단계는 Rational Quality Manager 내에서 버전 2 요구사항을 내부적으로 유지보수한 경우에 필요합니다. 이 단계는 외부 요구사항 제공자를 사용하는 경우 필요하지 않습니다.
  22. 브라우저를 열고 브라우저 캐시를 지우고 프로젝트에 다시 연결하십시오.
  23. 라이센스를 업그레이드하십시오. 간략한 개요는 라이센싱 이해를 참조하십시오. 그런 다음, 라이센스 키 설치 및 관리의 단계를 따르십시오.
    참고: 버전 2에서 Quality Manager 및 Lab Manager 라이센스를 버전 3에서는 Quality Professional 라이센스라고 합니다. 더 이상 별도의 Lab Manager 라이센스는 없습니다. 버전 2에서의 Connector 라이센스는 계속 Connector 라이센스라 칭하며, 버전 2에서의 Viewer 라이센스는 이제 Contributor 라이센스라 합니다.
  24. 도움말 애플리케이션(clmhelp.war)이 현재 애플리케이션과 다른 서버에 있는 경우, 도움말의 위치를 구성하십시오. 자세한 정보는 분산 환경에서 도움말 위치 구성의 내용을 참조하십시오.
  25. 대시보드를 업그레이드하십시오.

    관리 사용자로 애플리케이션에 로그인하고 대시보드를 포함하는 페이지를 탐색하십시오. 그런 다음 마이그레이션을 클릭하여 모든 대시보드를 업그레이드하십시오.

  26. 보고서를 업데이트하십시오.
    1. 버전 2 데이터 웨어하우스를 마이그레이션하여 시작하십시오. 자세한 정보는 버전 2에서 보고서 데이터 마이그레이션의 내용을 참조하십시오.
    2. 그런 다음 Rational Team Concert 클라이언트를 시작하고 최신 보고서 템플리트로 업데이트하십시오. 자세한 정보는 사전정의된 보고서 템플리트 업데이트의 내용을 참조하십시오.
    3. 버전 2의 Rational Common Reporting을 사용한 경우, 보고서를 Rational Reporting for Development Intelligence로 마이그레이션해야 합니다. 자세한 내용은 Rational Reporting for Development Intelligence로 마이그레이션을 참조하십시오.
  27. 업그레이드가 완료되었는지 확인하십시오. 자세한 정보는 업그레이드 확인의 내용을 참조하십시오.

다음에 수행할 작업

업그레이드가 완료되면 업그레이드 후 Jazz Team Server 및 첫 번째 애플리케이션 구성으로 진행하십시오.
참고: Rational Common Reporting에서 마이그레이션하는 경우, 서버를 구성하기 전에 기존 Rational Common Reporting 데이터 웨어하우스 데이터베이스 데이터베이스를 백업하십시오. 백업 지시사항은 데이터 웨어하우스를 호스트하는 관계형 데이터베이스 관리 시스템에 대한 문서를 참조하십시오.

피드백