이 주제는 서버를 오프라인에서 IBM® Rational®
Requirements Composer 버전 2에서 버전 3.0.1로 마이그레이션하기 위해 업그레이드 단계를 수동으로
수행하는 방법에 대해 설명합니다.
시작하기 전에
업그레이드를 시작하기 전에 모든 시스템의 클럭이 NTP(Network Time Protocol)를 사용하여 동기화되었는지
확인하십시오. 시간은 한 네트워크 노드의 이벤트를 다른 위치의
해당 이벤트에 맵핑할 수 있도록 하는 중요한 요소입니다. 이 문제는 NTP 서비스의
엔터프라이즈 배치를 통해 해결할 수 있습니다. NPT에 대한 자세한 정보를
보려면
http://www.ntp.org/를
방문하십시오. 또한 모든 서버가 사용자에 대해 동일한 인증 방법을 사용해야 합니다.
여러
제품을 업그레이드할 계획인 경우, 먼저 업그레이드 순서를
참조하면 업그레이드할 제품을 결정하는 데 도움이 됩니다.
IBM
WebSphere® Application Server 환경에서는
설치 경로를 공백을 포함하지 않는 설치 경로(예: C:\IBM\JazzTeamServer)로
변경하십시오. 그러나 파일 이름 또는 파일 경로 매개변수에 공백이 포함된 경우
매개변수를 큰따옴표로 묶어야 합니다. 예를 들어 "C:\Program
Files\IBM"과 같습니다.
프로시저
- 배치 및 업그레이드 프로세스 이해 주제를 검토하십시오.
필요한 경우 배치 및 업그레이드 계획 섹션의 주제도 검토하십시오.
중요사항: - 원래 RM 버전 2 컨텍스트 루트(/rdm) 및 모든 RM 아티팩트의 URI는 보존됩니다. Jazz™ Team Server의
컨텍스트 루트는 /jazz에서 /jts로 변경됩니다.
- 버전 2 설치에서 공용 URI를 설정한 경우, 버전 3.0.1에서도 동일한
공용 URI를 사용해야 합니다.
- 하드웨어 및 소프트웨어가 애플리케이션의 최소 요구사항을 충족하거나 초과하는지
확인하십시오. 시스템
요구사항을 참조하십시오. 기존 버전 2 teamserver.properties 파일에서
다음 정보를 확인하십시오.
- 공용 URI 특성 - 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에서 동일한 공용 URI를 사용해야 합니다. 공용 URI를 설정하지 않은 경우,
버전 2 관리 웹 인터페이스(고급 특성)를 사용하여 업그레이드하기 전에
규정된 호스트 이름 URI(https://hostname.example.com:port)를 설정하십시오.
teamserver.properties 파일에서 공용 URI 행은 다음 예와 유사하게 나타납니다.
com.ibm.team.repository.server.webapp.url=https\://<hostname.example.com>\:9443/jazz
- Jazz.net에 설치할
IBM Rational Requirements Composer
소프트웨어 및 CLM(Collaborative Lifecycle Management)용 Rational
솔루션의 다른 애플리케이션을 다운로드하십시오. 지시사항은
제품 설치 매체 다운로드의 내용을 참조하십시오.
- IBM Rational Requirements Composer 버전
2 서버를 중지하십시오.
- IBM Rational Requirements Composer 버전
2 데이터베이스 및 teamserver.properties 파일을
임시(tmp) 위치에 백업하십시오. teamserver.properties 파일은
각 애플리케이션이 데이터베이스에 연결하는 데 필요한 데이터베이스 위치를
포함합니다. 기본적으로 이 파일은 버전 2에서
InstallDir\server\conf\jazz\teamserver.properties에 있습니다.
백업 지시사항은 다음 주제를 참조하십시오.
- 기존 IBM Rational Requirements Composer
버전 2 데이터베이스에서 데이터를 내보내십시오.
- IBM Rational Requirements Composer 버전
2 RRC2InstallDir\server 디렉토리로 변경하십시오.
- repotools -export Windows 명령이나
./repotools.sh - export AIX® 또는 Linux
시스템 명령을 실행한 후 버전 2.0.1의 다음 예제에 표시된 것과 같이 파일을
IBM Rational Requirements Composer 디렉토리 구조
외부에 저장하십시오.
Windows: repotools
-export toFile=c:\tmp\rrcdata.tar
AIX 또는
Linux: repotools -export toFile=/tmp/rrcdata.tar
여기서 toFile 변수는 데이터베이스를 내보내는 .tar
파일의 이름을 지정합니다.
- Jazz Team Server 버전
3.0.1을 이미 설치한 경우, Jazz Team Server 및
기타 CLM 애플리케이션을 비롯한 버전 3.0.1 서버를 모두 중지한 다음
Jazz Team Server 버전
3.0.1 백업데이터베이스 및 환경을 백업하십시오. 10단계로 건너뛰십시오.
- Jazz Team Server 버전 3.0.1을
설치하지 않은 경우, Jazz Team Server를
설치하십시오. 설정 마법사를 실행하지 마십시오.
- Jazz Team Server 버전 3.0.1을
아직 설치하지 않았으며 기본 Derby 데이터베이스가 아닌 다른 데이터베이스를 사용 중인 경우,
Jazz Team Server 데이터베이스를 작성해야 합니다.
데이터베이스는 Jazz Team Server 및
데이터 웨어하우스에 필요합니다. Requirements Management 애플리케이션의 경우 데이터 저장을 위해
Jazz Team Server 데이터베이스를 사용하므로
데이터베이스를 작성하지 않아도 됩니다. 각 데이터베이스에 대한 세부사항은
데이터베이스 설정의
주제를 참조하십시오.
- 다른 머신에 Requirements Management 애플리케이션을 설치하십시오. 지시사항은
IBM Installation Manager를 사용하여 설치의 내용을 참조하십시오.
설치 중에 Requirements Composer 2.x 컨텍스트 루트 사용을 선택하십시오. 그러면
필수 옵션에 RM 애플리케이션을 설치하여 RM 아티팩트에 대한 링크를 보존하는 데 필요한 RM의 /rdm 버전 2 컨텍스트 루트가
보존됩니다. 이 옵션을 선택하지 않을 경우 업그레이드가 실패합니다.
자세한 정보는 배치 및 업그레이드 프로세스 이해의 내용을 참조하십시오.
- 설치 종료 시 시작할 프로그램에서 없음을
선택하고 완료를 클릭한 다음 종료를 클릭하십시오.
- WebSphere Application Server에 배치하는 경우,
버전 2 .war 파일(converter.war, jazz.war, rrc-help.war 및
rdm.war)을 중지한 후 설치 제거하십시오. 자세한 정보는 버전 3 업그레이드를 위해 WebSphere Application Server 설정의 내용을 참조하십시오.
- Jazz Team Server 버전
3.0.1을 설치한 위치에서 새 명령 창을 열고 JTS301InstallDir\server를
탐색한 후 repotools-jts -migration_rm_updateConfigurationFiles
oldApplicationHome=RRCS20InstallDir/server/conf 명령을 실행하여
버전 2 구성 파일을 버전 3.0.1 구성 파일과 병합하십시오.
분산 배치에서처럼 Jazz Team Server
버전 3.0.1을 RM 애플리케이션과 별도로 설치한 경우, RM 애플리케이션의 위치를 지정하고
Jazz Team Server
QM 3.0.1 설치 디렉토리에서 스크립트를 실행해야 합니다. 이 경우, newApplicationHome 인수를 포함하십시오.
repotools-jts -migration_rm_updateConfigurationFiles
oldApplicationHome=RRC2InstallDir/server/conf newApplicationHome=<JTS301_install_dir>/server/conf -jtsURL https://<fully qualified domain name>:<port>/jts
참고: -jtsURL 매개변수는
Jazz Team Server의 공용 URI입니다.
기본적으로 Jazz Team Server 공용 URI는
애플리케이션 공용 URI에서 파생됩니다. 이 매개변수는
Jazz Team Server가
RM 애플리케이션이 아닌 다른 서버 인스턴스에서 실행 중인 분산 배치에 지정해야 합니다.
이 명령은 다음 태스크를 완료합니다.
- 버전 2 Jazz JazzInstallDir/server/conf/jazz/teamserver.properties 파일의
정보에 기반하여 버전 3 JazzInstallDir/server/conf/app/teamserver.properties 파일을 업데이트합니다.
스크립트가 버전 2에서 확인할 수 없는 정보인
Jazz Team Server 데이터베이스 위치 특성 편집과 같은 값을 편집할 수 있습니다.
참고: 아직
Jazz Team Server 버전 3.0.1을 설치 및 구성하지 않은 경우,
현재
9단계에서 이전에 작성한 새
Jazz Team Server 데이터베이스에 대한
데이터베이스 위치 특성을 입력해야 합니다.
- 버전 2 Tomcat 사용자 .xml 파일을 복사합니다.
- 버전 3.0.1과 교차 저장소 통합에 대해 설정된 서버 목록을 포함하는
버전 2 friendsconfig.rdf 파일을 병합합니다.
- 버전 2 server.xml 및 web.xml(LDAP
설정) 파일의 컨텐츠를 버전 3.0.1과 병합합니다.
추가 내용은 구성 파일 병합 및
-migration_updateConfigurationFiles를 참조하십시오.
- 다음 예제에 표시된 대로, repotools-jts -importapplicationdata 명령을 사용하여
Rational Requirements Composer 데이터를
내보낸 버전 2 저장소에서 새 버전 3 RM(Requirements Management) 저장소로 가져오십시오.
repotools-jts migration_importapplicationdata fromFile=c:\export.tar
여기서 fromFile 변수는 저장소를 가져올 .tar
파일의 이름을 지정합니다.
참고: - Jazz Team Server 및 CLM(Collaborative Lifecycle Management) 제품을 새로 설치할 경우
처음으로 Jazz Team Server에 사용자 데이터를 가져올 때
createTables 매개변수를 명령 링크에 포함할 수 있습니다.
createTables 매개변수는
Jazz Team Server 데이터베이스를 작성하고
.tar 파일의 컨텐츠를 가져옵니다. 이미 기존 Jazz Team Server 데이터베이스가 있는 경우
기존 데이터베이스를 겹처쓰게 되므로 명령행에 createTables 매개변수를
포함하지 마십시오.
- IBM Rational Requirements Composer 버전 2에서
Floating 라이센스를 사용한 경우 알려진 문제가 있으므로,
IBM Rational Requirements Composer
버전 2 데이터베이스에서 데이터를 가져오기 전에 업그레이드 스크립트를 중지하고,
Jazz Team
Server를 시작한 다음 버전 3.0.1 Floating 라이센스를 설치해야 할 수 있습니다.
이를 수행하는 방법에 대한 자세한 정보는
https://jazz.net/library/article/659를
참조하십시오.
- Requirements Management 버전 3.0.1에 대한 대형 저장소를 가져오면 OutOfMemoryException 오류가
발생할 수 있습니다. 프로젝트 및 아티팩트 수가 많은 경우
repotools-jts.bat 또는 repotools-jts.sh
스크립트에서 -Xmx 매개변수를 기본값인 1500M에서 더 높은 값으로 늘려야
합니다. 최상의 결과의 결과를 위해서는 시스템 메모리가 충분한 경우 4096M를 사용하십시오.
- 구성 파일에서 수행된 Rational Requirements
Composer의 자세한 변경 목록을 보려면
Rational Requirements Composer 변경을 참조하십시오.
- 저장소 데이터 및 구성 파일을 확인하십시오. 세부사항은
업그레이드 중
구성 파일 확인을 참조하십시오.
- 오프라인 마이그레이션을 완료한 후 버전 2 데이터베이스를 백업한 위치가 아닌 다른 위치에
Jazz Team Server
버전 3.0.1 데이터베이스 및 환경을 백업하십시오. 백업은 온라인 마이그레이션을
계속하기 전에 수행하십시오. 버전 2 데이터베이스 백업을 겹쳐쓰지 마십시오.
- 이전 릴리스에서 사용하기 위해 보안 인증서를 작성한 경우 인증서를
복사하거나 인증서를 새로 작성하십시오. 세부사항은 보안 인증서 구성의 내용을
참조하십시오.
- Tomcat 애플리케이션 서버를 Windows
서비스로 실행하는 경우
서비스를 제거한 후 다시 설치해야 합니다. 명령 구문은 Apache Tomcat에서 Windows 서비스로 실행(32비트)의 내용을 참조하십시오.
- IBM WebSphere Application Server에
배치하는 경우 3.0 WAR 파일을 배치하고 보안 역할을 사용자 또는 그룹에
맵핑하십시오. 세부사항은
버전 3 업그레이드를 위해 WebSphere Application Server 설정 및
WebSphere Application Server에 CLM 애플리케이션 배치를
참조하십시오.
- 백업을 완료한 후 온라인 마이그레이션 단계를 계속하십시오. 온라인 마이그레이션 업그레이드 단계의 내용을 참조하십시오.