이 주제에서는 WebSphere®
Application Server와 z/OS®용 DB2®를 사용하는 설정을 사용하여 서버를 CLM(Collaborative Lifecycle Management)용 Rational® 솔루션 애플리케이션의 버전 3.0.1.x에서
버전 4로 업그레이드하는 데 필요한 단계를 설명합니다.
시작하기 전에
필요한 경우 원본 파일을 검토할 수 있도록 BLZSAMP 멤버의 사본을 작성하십시오.
작업이 제출된 후 샘플의 작업 로그를 검토하십시오.
예상 리턴 코드는 0입니다.
이 태스크 정보
다음 단계는 구성을 버전 3.0.1.x에서 버전 4.0 구성으로 마이그레이션합니다.
프로시저
- SMP/E 설치를 사용하여 CLM 버전 4 패키지를 설치하십시오.
버전 4 구성 위치는 버전 3.0.1.x 구성 위치와는 달라야 합니다. SMP/E 패키지를 설치하면 업그레이드에 사용되는 새 데이터베이스 백업 도구가 제공됩니다.
자세한 정보는 SMP/E 설치 프로세스 개요의 내용을 참조하십시오.
참고: 버전 4의 FMID가 변경되었으므로 버전 3.0.1.x에서 버전 4로 업그레이드하기 위한 PTF가 없습니다.
- 제공된 z/OS용 DB2 UNLOAD와 LOAD 유틸리티를 사용하여 서버를 중지하고 3.0.1.x 저장소를 백업하십시오. 자세한 정보는 백업을 위해 DB2 로드 해제 및 로드 프로세스 사용의 내용을 참조하십시오.도구가 테스트되었고 검증된 경우 다른 도구를 사용하여 백업 사본을 만들 수 있습니다.
중요사항: 업그레이드 프로세스는 롤백할 수 없는 저장소 모델 변경사항을 작성할 수 있으므로 업그레이드를 계속 진행하기 전에 저장소의 백업 사본을 만들어야 합니다.
- 백업과 복원 프로시저를 확인하려면 새 데이터베이스와 새 스키마 접두부에 대한 UNLOAD와 LOAD 단계를 완료하십시오.
- 버전 3.0.1.x BLZCREDB 샘플 작업을 사용하여 새 데이터베이스에 테이블을 작성하십시오.
- 데이터베이스 백업과 복원 프로시저를 완전히 테스트하려면 각 저장소에 추가로
데이터베이스를 작성하십시오. 새로 작성된 데이터베이스에는 기존 데이터베이스와 같은 권한이 있어야 합니다.
- 데이터 웨어하우스의 사본을 복원 중인 경우에는 두 개의 데이터 웨어하우스가
하나의 서브시스템에 존재할 수 없으므로 서로 다른 DB2 z/OS 서브시스템으로 복원되어야 합니다.
- 각 데이터베이스마다 별도의 UNIX
시스템 서비스 디렉토리(ussWorkDir)를 작성하십시오.
- 동일한 문자 수가 있는 저장소 스키마 접두부를 사용하십시오.
- 업그레이드 단계를 계속 진행하기 전에 새 3.0.1.x 저장소가 작성되었는지 확인하십시오.
- 버전 4 SBLZSAMP 샘플 멤버 BLZCPJTS를 수정하고 제출하여 Lifecycle Project Administration 애플리케이션을 포함하여 서버 구성 구조와 작업 디렉토리를 설정하여 Jazz™ Team Server(JTS)를 구성하십시오.
참고: 업그레이드 유틸리티가 두 버전을 병합할 수 있으려면
버전 4에 작성한 구성(JAZZ_HOME)과 작업 디렉토리는 버전 3.0.1.x 디렉토리와는 달라야 합니다. 예를 들어, 버전 3.0.1.x의 기본 구성 디렉토리는
/etc/jazz이므로 버전 4에는 /etc/jazz40을 사용하십시오.
마찬가지로 작업 디렉토리의 경우 /u/jazz40을 사용하십시오.
샘플 멤버의 지시사항을 따르거나 Jazz Team Server와 CLM(Collaborative Lifecycle Management)용 Rational 솔루션 애플리케이션의 추가 디렉토리 작성의 내용을 참조하십시오.
- 버전 4
SBLZSAMP 샘플 멤버 BLZCPCCM를 수정하고 제출하여 새 서버 구성과 작업 디렉토리 구조를 CCM 정의를 사용하여 설정하여 CCM(Change and Configuration Management) 서버를 구성하십시오. 샘플 멤버의 지시사항을 따르거나 Jazz Team Server와 CLM(Collaborative Lifecycle Management)용 Rational 솔루션 애플리케이션의 추가 디렉토리 작성의 내용을 참조하십시오.
- 버전 4
SBLZSAMP 샘플 멤버 BLZCPQM을 수정하고 제출하여 새 서버 구성과 작업 디렉토리 구조를 QM 정의를 사용하여 설정하여 QM(Quality Management) 서버를 구성하십시오. 샘플 멤버의 지시사항을 따르십시오.
- 버전 4
SBLZSAMP 샘플 멤버 BLZCPRM을 수정하고 제출하여 새 서버 구성과 작업 디렉토리 구조를 RM 정의를 사용하여 설정하여 RM(Requirements Management) 서버를 구성하십시오. 샘플 멤버의 지시사항을 따르십시오.
- 다음 단계를 완료하여 WebSphere Application Server에서
3.0.1.x 애플리케이션을 설치 제거하십시오.
- WebSphere Application
Server Integrated Solutions Console(https://example.com:9043/ibm/console/logon.jsp)에 로그온하십시오.
- 애플리케이션 > 애플리케이션 유형 > WebSphere 엔터프라이즈 애플리케이션을
클릭하십시오.
- 버전 4 대응부에 맞게 이를 다시 작성할 수 있도록 다음 버전 3.0.1.x 애플리케이션의
보안 역할 맵핑을 기록해 두십시오.
- 다음 3.0.1.x 애플리케이션을 중지하고 설치 제거하십시오.
- jts_war
- ccm_war
- qm_war
- rm_war
- clmhelp_war
- admin_war
- 프롬프트가 표시되면 변경사항을 마스터 구성에 저장하십시오.
- 다음 단계를 완료하여 JAZZ_HOME과 log4j.configuration 사용자 정의 특성을 업데이트하십시오.
- WebSphere Application
Server Integrated Solutions Console(https://example.com:9043/ibm/console/logon.jsp)에 로그온하십시오.
- 서버 > 서버 유형 > WebSphere Application Server를 클릭하십시오.
- 서버를 열려면 서버 이름을 클릭하십시오. 기본 서버 이름은 "server1"입니다.
- 서버 인프라 섹션 아래에서 Java와 프로세스 관리 > 프로세스 정의를 선택하십시오.
- 추가 특성 아래에서 JVM(Java Virtual Machine)을 선택하십시오.
- 추가 특성 아래에서 사용자 정의 특성을 선택하십시오.
- JAZZ_HOME을 선택하고 해당 값을 file:///<4.0_configuration_dir>로 업데이트하십시오.
예를 들어, file:///etc/jazz40입니다.
- log4j.configuration을 선택하고 해당 값을 file:///<4.0_configuration_dir>/startup_log4j.properties로 업데이트하십시오.
예를 들어, file:///etc/jazz40/startup_log4j.properties입니다.
- 프롬프트가 표시되면 변경사항을 마스터 구성에 저장하십시오.
추가 정보는 WebSphere Application Server 설정의 내용을 참조하십시오.
- WebSphere Application
Server를 중지하십시오.
- 다음 단계를
완료하여 WebSphere 임시 파일과 디렉토리를 삭제하고 캐시를 지우십시오.
- WebSphere Application Server 프로파일 아래의 임시 디렉토리로 이동하고(일반적으로 <WAS_profile_root>/temp/<node_name>/<server_name>과 같은 모양) 모든 <application>_war 디렉토리를 삭제하십시오.
- <WAS_profile_root>/temp/wscache로 이동하고 있는 경우
<application>_war을 삭제하십시오.
- JTS 서버 구성을 마이그레이션하십시오. 저장소 도구를 사용하여 버전 4 SBLZSAMP
샘플 멤버 BLZJTSU를 수정하여 JTS의 버전
3.0.1.x 구성 파일 설정을 버전 4 구성 파일로 병합하십시오.
BLZJTSU 작업을 제출하기 전에 다음 단계를 완료하십시오.
- 다음 매개변수를 포함하는 행을 삭제하십시오.
oldTomcatHome
newTomcatHome
- 다음 행을 변경하십시오. updateTomcatFiles=yes에서 updateTomcatFiles=no로
- @pathPrefix@ 변수를 버전 4 2진 파일의 경로 접두부를 가리키도록 대체하십시오.
참고: 이 샘플 멤버가 사용하는 migration_jts_updateConfigurationFiles
저장소 도구 명령이 버전 3.0.1에서 추가되었습니다.
@pathPrefix@가 이전 버전을 가리키는 경우 저장소 도구 명령은 버전 4 업데이트 명령을 사용하지 않습니다.
- 샘플 BLZJTSU 작업에서 지시사항을 완료하십시오.
BLZJTSU 작업을 제출하고 작업 출력과 업데이트된 특성 파일을 검토하십시오.
참고: Derby 데이터 웨어하우스를 가리키는 데이터 웨어하우스 특성이 이 병합의
일부로 유지보수되었지만 이후의 단계에서 수정됩니다.
- CCM 서버 구성을 마이그레이션합니다. 저장소 도구를 사용하여 버전 4 SBLZSAMP 샘플 멤버 BLZCCMU를 수정하여 CCM의 버전
3.0.1.x 구성 파일 설정을 버전 4 구성 파일로 병합하십시오.
BLZCCMU 작업을 제출하기 전에 다음 단계를 완료하십시오.
- 다음 매개변수를 포함하는 행을 삭제하십시오.
oldTomcatHome
newJTSTomcatHome
newApplicationTomcatHome
- 다음 행을 변경하십시오. updateTomcatFiles=yes에서 updateTomcatFiles=no로
- 다음 행을 변경하십시오. applicationContextRoot=jazz에서 applicationContextRoot=ccm으로.
애플리케이션 컨텍스트는 버전 3.0.1.x 서버가 버전 2.x에서 마이그레이션되지 않는 한
/ccm이어야 합니다.
- @pathPrefix@ 변수를 버전 4 2진 파일의 경로 접두부를 가리키도록 대체하십시오.
참고: 이 샘플 멤버가 사용하는 migration_ccm_updateConfigurationFiles 저장소 도구 명령이 버전 3.0.1.x에서 추가되었습니다. @pathPrefix@가 이전 버전을 가리키는 경우 저장소 도구 명령은 버전 4 업데이트 명령을 사용하지 않습니다.
- 샘플 BLZCCMU 작업에서 지시사항을 완료하십시오.
BLZCCMU 작업을 제출하고 작업 출력과 업데이트된 특성 파일을 검토하십시오.
참고: Derby 데이터 웨어하우스를 가리키는 데이터 웨어하우스 특성이 이 병합의
일부로 유지보수되었지만 이후의 단계에서 수정됩니다.
- CCM 서버 구성을 마이그레이션합니다. 저장소 도구를 사용하여 버전 4 SBLZSAMP 샘플 멤버 BLZQMU를 수정하여 QM의 버전
3.0.1.x 구성 파일 설정을 버전 4 구성 파일로 병합하십시오.
BLZQMU 작업을 제출하기 전에 다음 단계를 완료하십시오.
- 다음 매개변수를 포함하는 행을 삭제하십시오.
oldTomcatHome
newJTSTomcatHome
newApplicationTomcatHome
- 다음 행을 변경하십시오. updateTomcatFiles=yes에서 updateTomcatFiles=no로
- @pathPrefix@ 변수를 버전 4 2진 파일의 경로 접두부를 가리키도록 대체하십시오.
참고: 이 샘플 멤버가 사용하는 migration_qm_updateConfigurationFiles 저장소 도구 명령이 버전 3.0.1.x에서 추가되었습니다. @pathPrefix@가 이전 버전을 가리키는 경우 저장소 도구 명령은 버전 4 업데이트 명령을 사용하지 않습니다.
- 샘플 BLZQMU 작업에서 지시사항을 완료하십시오.
BLZQMU 작업을 제출하고 작업 출력과 업데이트된 특성 파일을 검토하십시오.
참고: Derby 데이터 웨어하우스를 가리키는 데이터 웨어하우스 특성이 이 병합의
일부로 유지보수되었지만 이후의 단계에서 수정됩니다.
- RM 서버 구성을 마이그레이션합니다. 저장소 도구를 사용하여 버전 4 SBLZSAMP
샘플 멤버 BLZRMU를 수정하여 RM의 버전
3.0.1.x 구성 파일 설정을 버전 4 구성 파일로 병합하십시오.
BLZRMU 작업을 제출하기 전에 다음 단계를 완료하십시오.
- 다음 매개변수를 포함하는 행을 삭제하십시오.
oldTomcatHome
newJTSTomcatHome
newApplicationTomcatHome
- 다음 행을 변경하십시오. updateTomcatFiles=yes에서 updateTomcatFiles=no로
- @pathPrefix@ 변수를 버전 4 2진 파일의 경로 접두부를 가리키도록 대체하십시오.
참고: 이 샘플 멤버가 사용하는 migration_rm_updateConfigurationFiles 저장소 도구 명령이 버전 3.0.1.x에서 추가되었습니다. @pathPrefix@가 이전 버전을 가리키는 경우 저장소 도구 명령은 버전 4 업데이트 명령을 사용하지 않습니다.
- 샘플 BLZRMU 작업에서 지시사항을 완료하십시오.
BLZRMU 작업을 제출하고 작업 출력과 업데이트된 특성 파일을 검토하십시오.
참고: Derby 데이터 웨어하우스를 가리키는 데이터 웨어하우스 특성이 이 병합의
일부로 유지보수되었지만 이후의 단계에서 수정됩니다.
- 다음 단계를 완료하여 색인 파일을
복사하십시오.
- JFS/text 색인을 버전 3.0.1.x에서 버전 4로 복사하십시오. 분산 시스템의 경우 적절한 서버로 이동한 후 파일을 복사하십시오.
- 명령 프롬프트를 열고 다음 명령을 입력하여 기본 4.0 indices 디렉토리를 지우십시오.
rm -rf <4.0_configuration_dir>/jts/indices
rm -rf <4.0_configuration_dir>/ccm/indices
rm -rf <4.0_configuration_dir>/qm/indices
- 명령 프롬프트를 열고 다음 명령을
입력하여 색인을 버전 3.0.1.x에서 버전 4로 복사하십시오.
cp -R <3.0.1.x_configuration_dir>/jts/indices <4.0_configuration_dir>/jts/indices
cp -R <3.0.1.x_configuration_dir>/ccm/indices <4.0_configuration_dir>/ccm/indices
cp -R <3.0.1.x_configuration_dir>/qm/indices <4.0_configuration_dir>/qm/indices
JTS, CCM, QM teamserver.properties 파일을 편집하여
com.ibm.team.fulltext.indexLocation과 com.ibm.team.jfs.index.root.directory에 올바른 위치 정보가
있는지 확인하십시오.
- JTS 데이터베이스를 업그레이드하십시오. 저장소 도구를 사용하여 버전 4 SBLZSAMP
샘플 멤버 BLZADDTB의 사본을 수정하고 제출하여 4.0 데이터베이스 테이블을 JTS 저장소에 추가하십시오.
애플리케이션 변수 @appl@은 jts로 설정되어야 합니다. 샘플 멤버와 함께 포함된
지시사항을 수행하고 작업 출력을 주의깊게 검토하십시오.
- CCM 데이터베이스를 업그레이드하십시오. CCM 애플리케이션을 구성한 경우,
저장소 도구를 사용하여 버전 4 SBLZSAMP
샘플 멤버 BLZADDTB의 사본을 수정하고 제출하여 4.0 데이터베이스 테이블을 CCM 저장소에 추가하십시오.
애플리케이션 변수 @appl@은 ccm로 설정되어야 합니다. 샘플 멤버와 함께 포함된
지시사항을 수행하고 작업 출력을 주의깊게 검토하십시오.
- QM 데이터베이스를 업그레이드하십시오. QM 애플리케이션을 구성한 경우,
저장소 도구를 사용하여 버전 4 SBLZSAMP
샘플 멤버 BLZADDTB의 사본을 수정하고 제출하여 4.0 데이터베이스 테이블을 QM 저장소에 추가하십시오.
애플리케이션 변수 @appl@은 qm으로 설정되어야 합니다. 샘플 멤버와 함께 포함된
지시사항을 수행하고 작업 출력을 주의깊게 검토하십시오.
- 선택사항: 데이터 웨어하우스를 구성하십시오. JTS, CCM, QM
teamserver.properties 파일을 편집하여 데이터
웨어하우스 저장소의 설정을 포함하십시오. 동일 설정이 세 개의 파일 모두로 이동합니다.
중요사항: 독립형 데이터 웨어하우스를 지금 구현 중이 아닌 경우에는 이 단계를
건너뛸 수 있습니다. 그러나, 이 단계를 건너뛰는 경우, Jazz Team
Server 설정 마법사를 사용할 때 데이터 웨어하우스 구성 단계를 건너뛰어야 합니다.
데이터 웨어하우스를 지금 구성 중인 경우에는
JTS,
CCM, QM teamserver.properties 파일을 업데이트하여
db2z 데이터 웨어하우스 매개변수를 포함하고 기존
Derby 데이터 웨어하우스 특성을 제거해야 합니다. 특히, 이 예제와 같이
#을 사용하여 주석 처리하십시오.
#com.ibm.team.datawarehouse.db.net.port
#com.ibm.team.datawarehouse.db.vendor=DERBY (or derby_net)
#com.ibm.team.datawarehouse.db.jdbc.location=/directoryInYourWorkdirectory or
#com.ibm.team.datawarehouse.db.jdbc.location=//localhost\:1527// ...
Add
the following information:
com.ibm.team.datawarehouse.db.vendor = db2z
com.ibm.team.datawarehouse.db.jdbc.location=//ipAddress:ipPort/location:user=jazzDBuser;password={password};
com.ibm.team.datawarehouse.db.jdbc.password=jazzDBpswd
# The database user for whom proper permissions will be granted
com.ibm.team.datawarehouse.report.user = RPTUSERcom.ibm.team.datawarehouse.db.db2.dsn.dbname=RIDW
- 데이터 웨어하우스를 업그레이드하십시오. 데이터 웨어하우스를 구성한 경우 저장소 도구를 사용하여
버전 4 SBLZSAMP 샘플 멤버 BLZDWHUP의 사본을 수정하고 제출하여 데이터 웨어하우스 저장소를 업그레이드하십시오. 샘플 멤버와 함께 포함된
지시사항을 수행하고 작업 출력을 주의깊게 검토하십시오.
- WebSphere Application Server를 시작하십시오.
- 다음
단계를 완료하여 WebSphere Application Server에서
버전 4 war 파일을 배치하십시오.
- WebSphere Application
Server Integrated Solutions Console(https://example.com:9043/ibm/console/logon.jsp)에 로그온하십시오.
- 애플리케이션 > 애플리케이션 유형 > WebSphere 엔터프라이즈 애플리케이션을 선택하여 엔터프라이즈 애플리케이션 페이지를 여십시오.
- 다음 버전 4 .war 파일을 설치하십시오.
- jts.war
- ccm.war
- qm.war
- rm.war
- clmhelp.war
- admin.war
- 다음 버전 4 애플리케이션의 보안 역할을 이전 단계에서 이를 설치 제거할 때 기록한 사항에 따라 맵핑하십시오.
- WebSphere Application
Server Integrated Solutions Console에서 애플리케이션을 시작하십시오.
- jts_war
- ccm_war
- qm_war
- rm_war
- clmhelp_war
- admin_war
- 브라우저를 열고
다음 URL을 붙여넣어서 서버를 재설정하십시오.
https://jts_server.mydomain.com:9443/jts/admin#action=com.ibm.team.repository.admin.serverReset
https://ccm_server.mydomain.com:9443/ccm/admin#action=com.ibm.team.repository.admin.serverReset
https://qm_server.mydomain.com:9443/qm/admin#action=com.ibm.team.repository.admin.serverReset
참고: 서버 재설정을 적용하려면 서버를 다시 시작해야 합니다.
- 다음 단계를 완료하여 라이센스를 활성화하십시오.
- 관리자로서 4.0 Jazz Team Server에 로그인하십시오.
- 서버 관리 > 라이센스 키 관리
페이지로 이동하고 라이센스를 활성화하십시오.
참고: 설정이 완료되어 있으므로 4.0 시스템에서 설정을 실행할 필요가 없습니다.
라이센스 주의사항: - 이정표 릴리스를 사용할 때는 이정표와 함께 제공된 Early Access Licenses를 활성화해야 합니다.
- 버전 4.0 최종 릴리스의 경우 새 라이센스를 구입해야 합니다.
버전 4 라이센스는 버전 3 애플리케이션과 호환 가능하지만 버전 4 애플리케이션은
버전 3 라이센스와 작동하지 않습니다. 자세한 정보는 라이센스 관리의 내용을 참조하십시오.
- RRC(Rational Requirements
Composer)를 마이그레이션하십시오. RM 애플리케이션을 구성한 경우 다음
단계를 완료하여 RM 온라인 마이그레이션 유틸리티를 실행해야 합니다.
- 브라우저를 열고, 브라우저 캐시를 지우고, RM 웹 클라이언트로 이동하십시오.
다음 URL(https://server_name:port/rdm/web/projects/migration)에 서버 이름과 포트 번호를 지정하십시오.
기본 포트는 9443입니다. 페이지는 마이그레이션이 진행 중임을 발견하고 마이그레이션 마법사가 시작됩니다.
- Rational Requirements
Composer - Analyst Client Access 라이센스를 승인하십시오.
- 마이그레이션 서비스 패널 열기를 클릭하고
마이그레이션 마법사를 선택하여 Rational
Requirements Composer 마이그레이션을 시작하십시오.
마이그레이션이 진행 중인 동안에는 어떤 스토리지 영역이 처리 중인지와 색인화를
시작한 시기에 대한 상태 정보가 마이그레이션 웹 페이지에서 관리자에게 보고됩니다.
중요사항: 마이그레이션이 시작된 후에 마이그레이션을 완료하기 전까지 이 조작을
취소할 수 없습니다.
마이그레이션이 완료된 후, Rational Requirements Composer 데이터는 재색인화됩니다.
- 재색인화가 완료되면 애플리케이션은 마이그레이션된 데이터에 대해
유효성 검증 및 일관성 검사를 수행하고 관리자에게 피드백을 제공합니다.
- 마이그레이션이 완료되었음을 알리는 메시지가 표시되면
닫기를 클릭하십시오. 그런 다음 RRC 애플리케이션으로 경로 재지정됩니다.
추가 세부사항은 온라인 마이그레이션 업그레이드 단계의 내용을 참조하십시오.