이 주제에서는 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 이전 버전 사용자는 이 단계를 무시할 수 있습니다.
프로시저
- 필요에 따라 배치 및 업그레이드 계획의 섹션에 있는 주제를 검토하십시오.
- 기존 버전 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
- jazz.net의 적절한 프로젝트 페이지에서
Rational Quality Manager
소프트웨어를 다운로드하십시오. 지시사항은
제품 설치 매체 다운로드의 내용을 참조하십시오.
- 버전 2 서버를 중지시키십시오.
참고: 분산 환경에서 작업 중이며 Jazz Team Server 3.0.1을
이미 설치한 경우, Jazz Team Server 및
기타 애플리케이션의 중단시간을 최소화하기 위해 업그레이드 스크립트가 버전 2 데이터를 버전 3
QM(Quality Management) 데이터베이스로 가져오는 것을 완료할 때까지 선택적으로
서버를 실행 상태로 유지할 수 있습니다. 이때
Jazz Team Server를 중지해야 합니다.
스크립트가 사용자 및 라이센싱 데이터를 Jazz Team Server로
가져오는 것을 완료한 후에 다시 시작할 수 있습니다.
- 데이터베이스 및 teamserver.properties 파일을 임시 위치에
백업하십시오. 기본적으로, teamserver.properties 파일은 버전 2에서
InstallDir\server\conf\jazz\teamserver.properties에
있습니다. 백업 지시사항은 다음 주제를 참조하십시오.
- 기존 버전 2 저장소에서 데이터를 내보내십시오.
- 버전 2 RQM2InstallDir\server 디렉토리로
변경하십시오.
- 버전 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 파일 이름을 지정합니다.
- 아직 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 아티팩트에 대한 링크를 보존하는 데 필요합니다. 이 옵션을 선택하는 데 실패하면
업그레이드에 실패합니다. 자세한 정보는 배치 및 업그레이드 프로세스 이해의 내용을 참조하십시오.
- 설치 종료 시 시작할 프로그램으로
없음을 선택하십시오.
- WebSphere Application Server에 배치하는 경우,
버전 2 jazz.war 및 help.war 애플리케이션을 중지시킨 후 설치 제거하십시오.
- 기본 Derby 데이터베이스가 아닌 다른 데이터베이스를 사용 중인 경우, 버전 3 데이터베이스를 작성하십시오.
데이터베이스는 Jazz Team Server, Quality Management, Change and Configuration Management 및
데이터 웨어하우스에 필요합니다. Requirements Management의 경우 데이터 저장을 위해
Jazz Team Server 데이터베이스를 사용하므로
데이터베이스를 작성하지 않아도 됩니다. 각 데이터베이스에 대한 세부사항은
데이터베이스 설정의
주제를 참조하십시오.
- 버전 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
이 스크립트는 다음 태스크를 완료합니다.
- 다음과 같이 버전 3 구성 파일을 업데이트하십시오.
- 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이 권장됩니다.
- QM(Quality Management) 데이터베이스에서 사용자 및 라이센싱 데이터를 내보내십시오.
- QM 사용자 및 라이센싱 데이터 데이터를
Jazz Team Server로 가져오십시오.
- QM 데이터베이스로 사용자 맵핑 데이터를 가져옵니다.
맵핑은 QM 애플리케이션에서
Jazz Team Server
데이터베이스와 통신하는 데 사용됩니다.
- 선택사항: 이전 단계의 대안으로 스크립트 매개변수 파일을 열고 기본값을 수정하고
명령행의 축약 양식을 실행할 수도 있습니다.
매개변수 파일의 영어 버전과 번역된 버전은
JazzInstallDir\server\upgrade\params\qm_params.bat 디렉토리(Windows) 또는
./params/qm_params.sh 디렉토리(UNIX 시스템)에 있습니다.
- 자국어로 된 매개변수 파일의 정확한 이름을 가져오려면, JazzInstallDir\server\upgrade 디렉토리에서
locale.bat -qm -showParamFileName(Windows) 및
./locale.sh -qm -showParamFileName(UNIX 시스템)을 실행하십시오.
- 편집을 위해 qm_params 또는 번역된
버전을 열고 각 매개변수의 값을 지정하십시오. 반드시
설정해야 하는 매개변수 중 하나는 OLD_APPLICATION_HOME 디렉토리의
경로입니다. 경로에 공백이 포함된 경우 큰따옴표로 묶어야 합니다. 각 매개변수에 대한 정보는
JazzInstallDir\server\upgrade\doc\qm_help.txt를 참조하십시오.
- 구성 파일을 확인하십시오. 세부사항은 업그레이드 중
구성 파일 확인 및 -migration_qm_updateConfigurationFiles를 참조하십시오.
- 이전 릴리스와 사용하도록 보안 인증서를 작성한 경우
이전 릴리스의 인증서를 복사하거나 새 인증서를
작성하십시오. 세부사항은 보안 인증서 구성의 내용을
참조하십시오.
- Tomcat 애플리케이션 서버를 Windows
서비스로 실행하는 경우
서비스를 제거한 후 다시 설치해야 합니다. 명령 구문은 Apache Tomcat에서 Windows 서비스로 실행(32비트)의 내용을 참조하십시오.
- WebSphere Application Server에
배치하는 경우 3.0 WAR 파일을 배치하고 사용자 또는 그룹에 보안 역할을
맵핑하십시오.
세부사항은
버전 3 업그레이드를 위해 WebSphere Application Server 설정 및
WebSphere Application Server에 CLM 애플리케이션 배치를
참조하십시오.
- 애플리케이션 서버, 버전 3 Jazz Team Server 또는
WebSphere Application Server를
시작하십시오.
참고: QM 애플리케이션이 별도로 설치된 경우,
CLM 애플리케이션도 시작해야 합니다.
- 서버와 설치한 모든 CLM 애플리케이션을
구성하십시오.
Jazz Team Server를
Quality Management 또는 CLM 애플리케이션과 함께 업그레이드하는 경우, 서버 설정 마법사를
실행하십시오(설정 마법사 실행 참조). Quality Management를
확립된 Jazz Team Server에 추가하는 경우,
관리 웹 인터페이스를 사용하십시오(Jazz Team Server에 애플리케이션 등록 참조).
- 버전 2에서 RM(Requirements Management) 애플리케이션으로 요구사항을
마이그레이션하십시오. 자세한 정보는 작업 항목 기반 요구사항 마이그레이션의 내용을 참조하십시오.
참고: 이 단계는 Rational Quality Manager 내에서
버전 2 요구사항을 내부적으로 유지보수한 경우에 필요합니다.
이 단계는 외부 요구사항 제공자를 사용하는 경우 필요하지 않습니다.
- 브라우저를 열고 브라우저 캐시를 지우고 프로젝트에 다시 연결하십시오.
- 라이센스를 업그레이드하십시오. 간략한 개요는
라이센싱 이해를
참조하십시오.
그런 다음, 라이센스
키 설치 및 관리의 단계를 따르십시오.
참고: 버전 2에서 Quality Manager 및 Lab Manager 라이센스를 버전 3에서는
Quality Professional 라이센스라고 합니다. 더 이상 별도의 Lab Manager 라이센스는 없습니다.
버전 2에서의 Connector 라이센스는 계속 Connector 라이센스라 칭하며,
버전 2에서의 Viewer 라이센스는 이제 Contributor 라이센스라 합니다.
- 도움말 애플리케이션(clmhelp.war)이 현재 애플리케이션과 다른 서버에 있는 경우,
도움말의 위치를 구성하십시오. 자세한 정보는 분산 환경에서 도움말 위치 구성의 내용을 참조하십시오.
- 대시보드를 업그레이드하십시오.
관리 사용자로 애플리케이션에 로그인하고 대시보드를 포함하는 페이지를 탐색하십시오.
그런 다음, 마이그레이션을 클릭하여 모든 대시보드를 업그레이드하십시오.
- 보고서를 업데이트하십시오.
- 버전 2 데이터 웨어하우스를 마이그레이션하여 시작하십시오. 자세한 정보는 버전 2에서 보고서 데이터 마이그레이션의 내용을 참조하십시오.
- 그런 다음 Rational Team Concert 클라이언트를
시작하고 최신 보고서 템플리트로 업데이트하십시오. 자세한 정보는 사전정의된 보고서 템플리트 업데이트의 내용을 참조하십시오.
- 버전 2의 Rational Common
Reporting을 사용한 경우, 보고서를 Rational Reporting for Development Intelligence로 마이그레이션해야 합니다.
자세한 내용은 Rational Reporting for Development Intelligence로 마이그레이션을 참조하십시오.
- 업그레이드가 완료되었는지 확인하십시오. 자세한 정보는 업그레이드 확인의 내용을 참조하십시오.
다음에 수행할 작업
업그레이드가 완료되면,
업그레이드 후 Jazz Team Server 및 첫 번째 애플리케이션 구성 및
RJazz Team Server에 추가 애플리케이션 등록으로 진행하십시오.
참고: Rational Common Reporting에서
마이그레이션하는 경우, 서버를 구성하기 전에 기존
Rational Common Reporting 데이터 웨어하우스 데이터베이스를
백업하십시오. 백업 지시사항은 데이터 웨어하우스를 호스트하는
관계형 데이터베이스 관리 시스템에 대한 문서를 참조하십시오.