업그레이드 스크립트를 사용하여 Rational Quality Manager에서 3.0.1로 업그레이드

이 주제에서는 qm_upgrade 스크립트를 사용하여 Rational® Quality Manager 버전 2를 버전 3으로 업그레이드하는 방법에 대해 설명합니다.

시작하기 전에

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

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

중요사항: Jazz™ Team Server와는 별도로 Quality Management를 설치한 분산 환경에서 업그레이드 스크립트를 사용하려면 업그레이드 스크립트에서 Jazz Team Server가 설치된 드라이브 또는 파일 시스템에 액세스할 수 있어야 합니다. Windows의 경우 맵핑 양식은 mapped drive letter:\server\conf여야 합니다. 절대 경로(\\machine name\installdir\server\conf)는 작동하지 않습니다. 마운트된 드라이브는 관리 계정에 대한 읽기-쓰기-실행 권한으로 구성되어야 합니다.

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

버전 2.0.1 iFix02 이상에서 업그레이드하는 경우, 데이터를 내보내기 전에 먼저 버전 2.0.1.1 이상으로 업그레이드하십시오. 그런 다음, 다음 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로 가져오는 것을 완료한 후에 다시 시작할 수 있습니다.
  5. 데이터베이스 및 teamserver.properties 파일을 임시 위치에 백업하십시오. 기본적으로, teamserver.properties 파일은 버전 2에서 InstallDir\server\conf\jazz\teamserver.properties에 있습니다. 백업 지시사항은 다음 주제를 참조하십시오.
  6. 기존 버전 2 저장소에서 데이터를 내보내십시오.
    1. 버전 2 RQM2InstallDir\server 디렉토리로 변경하십시오.
    2. 버전 2.0.1의 다음 예제에 표시된 대로, repotools -export 명령을 실행하고 Rational Quality Manager 디렉토리 구조 외부에서 파일을 저장하십시오.

    Windows: repotools -export toFile=c:\tmp\export.tar

    Unix/Linux: ./repotools.sh -export toFile=/tmp/export.tar

    여기서 toFile은 저장소를 내보낼 TAR 파일 이름을 지정합니다.

    참고: 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. WebSphere Application Server에 배치하는 경우, 버전 2 jazz.war 및 help.war 애플리케이션을 중지시킨 후 설치 제거하십시오.
  10. 기본 Derby 데이터베이스가 아닌 다른 데이터베이스를 사용 중인 경우, 버전 3 데이터베이스를 작성하십시오.

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

    참고: Oracle 또는 SQL Server 데이터베이스를 사용하는 경우 데이터베이스 드라이버를 올바른 위치에 복사하십시오. 세부사항은 Oracle 데이터베이스 설정 및 SQL Server 데이터베이스 설정을 참조하십시오.
  11. 버전 3 설치에서 새 명령 창을 열고 JazzInstallDir\server로 이동하여 upgrade\qm_upgrade.bat 스크립트(Windows) 또는 upgrade/qm_upgrade.sh 스크립트(UNIX 시스템)를 실행하십시오.
    참고: 명령행에서 모든 인수를 지정하여 스크립트를 실행할 수 있습니다. 또는 업그레이드 스크립트를 여러 번 다시 실행하는 경우 스크립트의 매개변수 파일을 편집하고 축약된 명령행을 실행할 수도 있습니다. 매개변수 파일에 대한 지시사항은 12를 참조하십시오.
    중요사항: 스크립트 파일은 업그레이드 디렉토리 아래에 있지만, 서버 디렉토리에서 실행해야 합니다.또한 경로에 공백이 포함된 경우 큰따옴표로 묶어야 합니다.

    버전 3.0.1 Jazz Team Server를 QM 애플리케이션과 함께 설치한 경우 업그레이드하려는 첫 번째 애플리케이션 또는 유일한 애플리케이션이면 명령 구문은 다음과 같습니다.

    Windows:

    upgrade\qm_upgrade.bat -oldApplicationHome RQM201InstallDir\server\conf -importFromFile c:\tmp\export.tar -createJTSTables

    Unix/Linux:

    ./upgrade/qm_upgrade.sh -oldApplicationHome RQM201InstallDir/server/conf -importFromFile /tmp/export.tar -createJTSTables
    참고: -createJTSTables 매개변수는 Jazz Team Server 3.0.1을 처음 설치하는 경우 설치에 적용됩니다.

    분산 배치에서처럼 버전 3.0.1 Jazz Team Server를 QM 애플리케이션과 별도로 설치한 경우, 3.0.1 Jazz Team Server의 위치를 지정하고 QM 3.0.1 설치 디렉토리에서 스크립트를 실행해야 합니다. 이 경우, -newJTSHome 인수를 포함하십시오.

    Windows:

    upgrade\qm_upgrade.bat -oldApplicationHome RQM201InstallDir\server\conf -importFromFile c:\tmp\export.tar -newJTSHome JTS301InstallDir\server\conf

    Unix/Linux:

    ./upgrade/qm_upgrade.sh -oldApplicationHome RQM201InstallDir/server/conf -importFromFile /tmp/export.tar -newJTSHome JTS301InstallDir\server\conf
    참고:
    • 분산 배치이고 Jazz Team Server 버전 3.0.1을 구성하지 않은 경우 위의 명령행 예제에 -createJTSTables 매개변수를 추가할 수 있습니다.
    • -jtsURL 매개변수는 Jazz Team Server의 공용 URI입니다. 기본적으로 Jazz Team Server 공용 URI는 애플리케이션 공용 URI에서 파생됩니다. 이 매개변수는 Jazz Team Server가 QM 애플리케이션이 아닌 다른 서버 인스턴스에서 실행 중인 분산 배치에 지정해야 합니다.
    • Jazz Team Server 3.0.1이 여전히 실행 중인 경우 스크립트가 사용자 및 라이센스 정보를 마이그레이션하는 프로세스를 시작하기 전에 중지해야 합니다. Jazz Team Server 및 이에 종속된 모든 애플리케이션은 오프라인이 됩니다.

    명령행 옵션에 대한 자세한 정보가 필요한 경우, 다음 명령을 입력하십시오.

    Windows: upgrade\qm_upgrade.bat -help

    Unix/Linux: ./upgrade/qm_upgrade.sh -help

    이 스크립트는 다음 태스크를 완료합니다.

    1. 다음과 같이 버전 3 구성 파일을 업데이트하십시오.
      • -migration_qm_updateConfigurationFiles 명령을 실행하고 구성 및 Tomcat 파일을 업데이트합니다. [E]를 입력하여 명령을 실행하거나, [S]를 입력하여 단계를 건너뛰거나, [Enter]를 눌러 스크립트 실행을 취소하십시오.
        참고: 아직 Jazz Team Server 버전 3.0.1을 설치하지 않은 경우 , 앞의 10단계에서 작성한 새 Jazz Team Server 데이터베이스에 대한 데이터베이스 위치 특성을 입력해야 합니다. 또는 Quality Manager 버전 2 데이터베이스를 사용하는 경우, Quality Manager 버전 2 서버를 다시 시작해야 하는 경우에 대비하여 데이터베이스를 백업했는지 확인하십시오.
        중요사항: 데이터 웨어하우스 데이터베이스에 연결하는 데 필요한 특성이 현재 Derby로 설정되어 있더라도 이 특성을 수정하지 마십시오. 이 특성은 서버 설정 마법사에서만 수정하십시오.
      • 구성 파일이 병합된 후, 계속하려면 [C]를 입력하십시오. 메모장 창 또는 vi 편집기(AIX 또는 Linux 시스템의 경우)가 열리고, 여기에서 Jazz Team Server teamserver.properties 파일을 확인할 수 있습니다. com.ibm.team.repository.server.webapp.url 특성에 표시된 공용 URI 루트가 올바른지 확인하십시오. 또한 데이터베이스 특성이 올바른지도 확인하십시오. 완료되면, 변경사항이 있는 경우 저장하고 스크립트 실행을 계속하려면 편집기를 닫으십시오.
      • 버전 2 Tomcat 사용자 xml 파일을 복사합니다.
      • 버전 3과 교차 저장소 통합에 대해 설정된 서버 목록을 포함하는 버전 2 friendsconfig.rdf 파일을 병합합니다.
      • 버전 2 server.xml 및 web.xml(LDAP 설정) 파일의 컨텐츠를 버전 3과 병합합니다.
    2. repotools-jazz -import 명령을 사용하여 TAR 파일에서 가져온 버전 2 데이터를 버전 3 QM(Quality Management) 데이터베이스로 가져옵니다.
      참고: Quality Management 3.0.1에 대한 대형 저장소를 가져오면 OutOfMemoryException 오류가 발생할 수 있습니다. 고객이 보유한 프로젝트 및 아티팩트 수가 많으면 repotools-jazz.bat 또는 repotools-jazz.sh 스크립트에서 -Xmx 매개변수를 기본값, 1500M에서 더 높은 값으로 늘려야 합니다. 시스템에 메모리가 충분하고 64비트 OS를 실행 중인 경우 4096M이 권장됩니다.
    3. QM(Quality Management) 데이터베이스에서 사용자 및 라이센싱 데이터를 내보내십시오.
    4. QM 사용자 및 라이센싱 데이터 데이터를 Jazz Team Server로 가져오십시오.
    5. QM 데이터베이스로 사용자 맵핑 데이터를 가져옵니다. 맵핑은 QM 애플리케이션에서 Jazz Team Server 데이터베이스와 통신하는 데 사용됩니다.
    참고: 구성 파일에서 수행된 Rational Quality Manager의 자세한 변경 목록을 보려면 Rational Quality Manager 변경을 참조하십시오.
  12. 선택사항: 이전 단계의 대안으로 스크립트 매개변수 파일을 열고 기본값을 수정하고 명령행의 축약 양식을 실행할 수도 있습니다.

    매개변수 파일의 영어 버전과 번역된 버전은 JazzInstallDir\server\upgrade\params\qm_params.bat 디렉토리(Windows) 또는 ./params/qm_params.sh 디렉토리(UNIX 시스템)에 있습니다.

    1. 자국어로 된 매개변수 파일의 정확한 이름을 가져오려면, JazzInstallDir\server\upgrade 디렉토리에서 locale.bat -qm -showParamFileName(Windows) 및 ./locale.sh -qm -showParamFileName(UNIX 시스템)을 실행하십시오.
    2. 편집을 위해 qm_params 또는 번역된 버전을 열고 각 매개변수의 값을 지정하십시오. 반드시 설정해야 하는 매개변수 중 하나는 OLD_APPLICATION_HOME 디렉토리의 경로입니다. 경로에 공백이 포함된 경우 큰따옴표로 묶어야 합니다. 각 매개변수에 대한 정보는 JazzInstallDir\server\upgrade\doc\qm_help.txt를 참조하십시오.
  13. 구성 파일을 확인하십시오. 세부사항은 업그레이드 중 구성 파일 확인 및 -migration_qm_updateConfigurationFiles를 참조하십시오.
  14. 이전 릴리스와 사용하도록 보안 인증서를 작성한 경우 이전 릴리스의 인증서를 복사하거나 새 인증서를 작성하십시오. 세부사항은 보안 인증서 구성의 내용을 참조하십시오.
  15. Tomcat 애플리케이션 서버를 Windows 서비스로 실행하는 경우 서비스를 제거한 후 다시 설치해야 합니다. 명령 구문은 Apache Tomcat에서 Windows 서비스로 실행(32비트)의 내용을 참조하십시오.
  16. WebSphere Application Server에 배치하는 경우 3.0 WAR 파일을 배치하고 사용자 또는 그룹에 보안 역할을 맵핑하십시오. 세부사항은 버전 3 업그레이드를 위해 WebSphere Application Server 설정 및 WebSphere Application Server에 CLM 애플리케이션 배치를 참조하십시오.
  17. 애플리케이션 서버, 버전 3 Jazz Team Server 또는 WebSphere Application Server를 시작하십시오.
    참고: QM 애플리케이션이 별도로 설치된 경우, CLM 애플리케이션도 시작해야 합니다.
  18. 서버와 설치한 모든 CLM 애플리케이션을 구성하십시오.

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

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

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

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

다음에 수행할 작업

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

피드백