이 주제에서는 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 디렉토리로 복사되는지
확인하십시오.
여러 제품을 업그레이드할 계획인 경우, 먼저 업그레이드 순서를
참조하면 업그레이드할 제품을 결정하는 데 도움이 됩니다.
프로시저
- 필요에 따라 배치 및 업그레이드 계획의 섹션에 있는 주제를 검토하십시오.
- 기존 버전 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
- 버전 2 서버를 종료하십시오.
- 아직 설치하지 않은 경우, Jazz™ Team Server 및
CCM(Change and Configuration Management) 애플리케이션을 새 위치에 설치하십시오. 이미 Jazz Team Server를 설치한 경우,
Change and Configuration Management 애플리케이션을 설치하십시오.
- 설치 중에 Rational Team Concert 2.x 컨텍스트 루트 사용을 선택하여
/jazz 컨텍스트 루트를 보존하십시오.
- 설치 종료 시 시작할 프로그램으로
없음을 선택하십시오.
- v2 데이터베이스와 동일한 매개변수지만 다른 데이터베이스 이름을 사용하여 Jazz Team Server에 대해
별도의 데이터베이스를 작성하십시오. 데이터베이스 작성에 대한 자세한 정보는
데이터베이스 설정을
참조하십시오.
참고: CCM 데이터베이스와는 별도의 Jazz Team Server 데이터베이스가 필요합니다.
아직 수행하지 않은 경우 새 Jazz Team Server 데이터베이스를 작성하십시오.
중요사항: 별도의 명령행 창을 열고 버전 2 및 버전 3 repotools 명령을 실행하십시오. 별도의 명령행 창을 사용하여
버전 2 및 버전 3 명령에서 사용하는 환경 변수 사이에 충돌이 없는지 확인하십시오.
- <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 파일:
중요사항: 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 위치로 복사됩니다.
- 업데이트된 특성 파일에 다음 정보가 포함되어 있는지 확인하십시오.
- 특성은 버전 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과 동일해야 합니다.)
- 명령 창을 열고 <3.0.1CCM_install_dir>/server 디렉토리로 이동하십시오.
- 다음 명령을 실행하여 데이터베이스에 테이블을 추가하십시오.
repotools-jazz -addTables
- 다음 명령을 실행하여 사용자 정보를 Rational Team Concert 데이터베이스에서 내보내십시오.
repotools-jazz -migration_exportJTSData toFile=jtsData.tar
참고: 두 번 이상 이 프로세스를 따르는 경우, 두 번째 tar 파일에 대해 다른 파일 이름을 사용하십시오. 예를 들어,
jtsData2.tar을 사용하십시오.
- 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 매개변수를
사용하는 경우, 서버에서 사용자 데이터가 손실됩니다.
- 다음 명령을 실행하여 Jazz Team Server 사용자 정보를 Rational Team Concert 데이터베이스로 가져오십시오.
repotools-jazz -migration_importUserMapping fromMappingFile=rtc-mapping.txt
- 다음 명령을 실행하여 텍스트 색인을 다시 빌드하십시오.
repotools-jazz -rebuildTextIndices
- 다음 명령을 실행하여 Lucene 및 RDF 색인을 다시 빌드하십시오.
repotools-jazz -reindex
- 버전 2 제품에 기본 색인 위치가 없고 색인을 위해 사용자 정의된 위치를 계속 사용하려는 경우
색인 위치를 추가하려면 버전 3.0.1 teamserver.properties 파일을
수정해야 합니다.
- com.ibm.team.fulltext.indexLocation=conf/jts/indices/workitemindex
값을 전체 텍스트 색인의 전체 경로 위치로 변경하십시오. 예를 들어
com.ibm.team.fulltext.indexLocation=c:/indices/workitemindex와 같습니다.
- com.ibm.team.jfs.index.root.directory=indices
값을 JFS 색인 루트 디렉토리의 전체 경로 위치로 변경하십시오. 예를 들어
com.ibm.team.jfs.index.root.directory=c:/indices와 같습니다.
- 다음을 확인하십시오.
- Jazz Team Server 데이터베이스 위치가 애플리케이션 데이터베이스 위치와 다른지 확인하십시오.
- 색인 또는 기타 파일 관련 특성이 애플리케이션과 Jazz Team Server 사이에서 공유되지 않는지 확인하십시오.
- friendconfig.rdf 파일 이름이
friendconfig.rdf.saved로 바뀌었는지 확인하십시오.
- Apache Tomcat을 사용하는 경우
Apache Tomcat 설정을
참조하십시오.
- Websphere Application Server를 사용하는 경우 이전에 설치한 웹
애플리케이션을 설치 제거하고 3.0.1 설치에 제공된
jts.war, ccm.war
및 clmhelp.war를 다시 배치하십시오.
추가 세부사항은
버전 3 업그레이드를 위해 WebSphere Application Server 설정을 참조하십시오.
- 서버와 설치한 모든 CLM 애플리케이션을
구성하십시오.
Jazz Team Server를 Change and Configuration Management 애플리케이션 또는 다른 CLM 애플리케이션과 함께 업그레이드하는 경우,
서버 설정 마법사를 실행하십시오(설정 마법사 실행 참조). Change and Configuration Management 애플리케이션을
확립된 Jazz Team Server에 추가하는 경우, 관리 웹 인터페이스를 사용하십시오(Jazz Team Server에 애플리케이션 등록 참조).