Rational® Engineering
Lifecycle Manager를 업그레이드하려면,
새 제품 버전을 설치하고 구성 파일을 업데이트하고 기존 데이터베이스 저장소에서 테이블을 추가하거나 업데이트한 후
데이터를 버전 5.0.1로 마이그레이션하십시오.
시작하기 전에
- Rational Engineering
Lifecycle Manager와 통합된 제품을 업데이트하는 경우,
Rational Engineering Lifecycle Manager 제품 스택 업그레이드를 위한 체크리스트의 순서를 따르십시오.
- 버전 4.x에서 업그레이드하는 경우 버전 5.x 애플리케이션의 새 라이센스를 가져와야 합니다. 버전 5.x 애플리케이션은 버전 4.x 라이센스로 작동하지 않습니다. 그러나 버전 4.x 애플리케이션은 버전 5.x 라이센스로 작동합니다. 라이센스에 대한 자세한 정보는 라이센스 관리로 이동하십시오.
- 버전 4.x에서 업그레이드하는 경우, Lifecycle
Query Engine에서 Rational Engineering
Lifecycle Manager 데이터 소스를 제거하십시오.
- Lifecycle
Query Engine 관리 페이지(https://lqe_host_name:port/lqe/web)를 여십시오.
- 를
클릭하십시오. Rational Engineering
Lifecycle Manager 데이터 소스를 선택하십시오.
- 데이터 소스 분할창에서 제거를 클릭한 후 저장하십시오.
프로시저
- Rational Engineering Lifecycle
Manager를 설치하십시오.
이 단계에서는 다음을 설치합니다.
- Rational Engineering
Lifecycle Manager 5.0.1
- Jazz™ Team Server 5.0.1
- 구성 관리 애플리케이션 5.0.1
- 애플리케이션 서버를 구성하십시오.
- 이전 서버가 실행 중인지 확인하십시오.
- WebSphere® Application
Server 프로파일을 백업하십시오.
- 명령 프롬프트를 열고 WebSphere Application
Server 설치 디렉토리의 bin 디렉토리로 이동하십시오.
- 이 명령을 실행하십시오. WebSphere Application Server 보안이 켜져 있는 경우,
사용자 이름 및 비밀번호를 지정하십시오.
팁: 백업 프로세스를 시작하기 전에 압축 파일의 디렉토리 경로가 있어야 합니다.
backupConfig.sh <Path_to_a_new_compressed_file_to_create_backup_of_profile> -username <WAS_primary_administrative_user_name> -password <WAS_administrative_password>
예를 들어 다음과 같습니다. backupConfig.sh /root/WAS_backup/relm_50_profile.zip -username <WAS_admin> -password <WAS_admin_password>
backupConfig.bat <Path_to_a_new_compressed_file_to_create_backup_of_profile> -username <WAS_primary_administrative_user_name> -password <WAS_administrative_password>
예를 들어 다음과 같습니다. backupConfig.bat C:\WAS_backup\relm_50_profile.zip -username <WAS_admin> -password <WAS_admin_password>
이 명령은 백업 프로세스를 시작하기 전에 서버를 종료합니다.
- WebSphere Application Server에서 기존 애플리케이션을 설치 제거하십시오.
- 서버를 시작하십시오.
- WebSphere Application
Server Integrated Solutions Console에 로그온하십시오(https://host_name:9043/ibm/console/logon.jsp).
- 을
클릭하십시오.
- 다음 애플리케이션을 중지하고 설치 제거하십시오. relm.war,
relmhelp.war, vvc.war, lqe.war, SPARQL_Gateway.war
- 프롬프트가 표시되면 마스터 구성에 대한 변경사항을 저장하십시오.
- JAZZ_HOME 및 log4j.configuration 사용자 정의 특성을 업데이트하십시오.
- WebSphere Application
Server Integrated Solutions Console에 로그온하십시오(https://host_name:9043/ibm/console/logon.jsp).
- 를
클릭하십시오.
- 서버를 열려면 서버 이름을 클릭하십시오. 기본 서버 이름은
server1입니다.
- 서버 인프라 섹션에서 를 클릭하십시오.
- 추가 특성에서 JVM(Java Virtual Machine)을 클릭하십시오.
- Lifecycle
Query Engine 및
Jazz
Reporting Service의 경로를 새 위치로 변경하십시오.
- 일반 JVM 인수 텍스트 필드를 찾은 후 JVM 시작 프로세스에 이 환경 변수를 추가하십시오.
-Dlqe.config.location=file://drive:/lqe_installation_dir/server/conf/lqe
- 추가 특성에서 사용자 정의 특성을 클릭하십시오.
- JAZZ_HOME and update its value to file:///<new_version_install_dir>/server/conf를 클릭하십시오.
예를 들어, file:///C:/PROGRA~2/IBM/JazzTeamServer_5.0.1/server/conf입니다.
- log4j.configuration을 클릭하고 이 값을 file:///<new_version_install_dir>/server/conf/startup_log4j.properties로 업데이트하십시오.
예를 들어,
file:///C:/PROGRA~2/IBM/JazzTeamServer_5.0.1/server/conf/startup.log4j.properties입니다.
- Oracle 데이터베이스에 연결하는 경우 ORACLE_JDBC_DRIVER_FILE이 올바른 JDBC 드라이버 파일을 가리키는지 확인하십시오.
- 프롬프트가 표시되면 마스터 구성에 대한 변경사항을 저장하십시오.
- Jazz
Reporting Service 공유 라이브러리를 설정하십시오.
- 관리 콘솔에서 로 이동하십시오.
- 목록에서 JRS 공유 라이브러리를 클릭하십시오.
- 기존 Jazz
Reporting Service 설치 위치에서 새 위치로 클래스 경로를 변경하십시오.
예를 들어, 5.0.1_install_dir/server/conf/SPARQL_Gateway/SharedLibrary와 같습니다.
- 클래스 로딩에서 공유 라이브러리에 대해 격리된 클래스 로더 사용이 선택되었는지 확인하십시오.
적용 및 저장을 클릭하십시오.
- WebSphere Application
Server를 중지하십시오.
stopServer.sh 명령을 실행하십시오.
stopServer.bat 명령을 실행하십시오.
- WebSphere Application
Server temp 디렉토리를 정리하십시오.
프로파일의 wscache 및 temp 디렉토리에서 Rational Engineering Lifecycle
Manager 관련 컨텐츠를 제거하십시오. 설치된 애플리케이션에 따라, 프로파일 아래에 다음 디렉토리가 있으며 이를 제거할 수 있습니다. relm_war, lqe_war, sparql, 구성 관리 애플리케이션 관련 데이터

WAS_profile_root/wscache(예: opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp/wscache)
WAS_profile_root/temp(예: opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp)

WAS_profile_root\wscache(예: C:\IBM\WebSphere\AppServer\profiles\AppSrv01\wscache)
WAS_profile_root\temp(예: C:\IBM\WebSphere\AppServer\profiles\AppSrv01\temp)
- WebSphere Application
Server 로그 디렉토리를 정리하십시오.
각 애플리케이션 서버로 이동하여 프로파일의 logs 디렉토리에서
Rational Engineering Lifecycle
Manager 관련 로그를
제거하십시오. 일반 로그 디렉토리는 다음과 같습니다.
opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs
C:\IBM\WebSphere\AppServer\profiles\AppSrv01\logs
- WebSphere Application Server를 시작하십시오.
startServer.sh 명령을 실행하십시오.
startServer.bat 명령을 실행하십시오.
- 데이터베이스를 마이그레이션 또는 백업하십시오.
Oracle JDBC 드라이버 ojdbc.jar이 $newRELMHome/JazzTeamServer/server/oracle 디렉토리에서 사용 가능한지 확인하십시오.
- 구성 관리 애플리케이션을 업그레이드하십시오.
vvc_upgrade 스크립트를 실행하여 구성 및 데이터베이스 파일을 업그레이드하고 텍스트 색인을 다시 빌드하십시오.
이것은 매개변수 예제입니다.
cd $newRELMHome/server/
upgrade/vvc/vvc_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
팁: 구성 관리 애플리케이션도
Rhapsody® Design Manager로 설치할 수 있습니다.
Rational Engineering
Lifecycle Manager를 설치 중인 경우 Rhapsody Design Manager 시스템과 다른 시스템에서 컴포넌트를 설치하려면 구성 관리 애플리케이션을 선택하십시오. 구성 관리 애플리케이션 하나만 Rational Engineering Lifecycle
Manager와 통합하십시오.
이 컴포넌트를 여러 서버에 설치할 경우,
설치 및 업그레이드할 컴포넌트를 올바르게 선택했는지 확인해야 합니다.
- Rational Engineering Lifecycle
Manager를 업그레이드하십시오.
relm_upgrade.sh 명령을 실행하여 구성 및 데이터베이스 파일을 업그레이드하고
텍스트 색인을 다시 빌드하십시오.
$newRELMHome/server/upgrade/relm/relm_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
- Lifecycle
Query Engine 및 기존 Jazz
Reporting Service 또는 SPARQL Gateway 구성 정보를 새 제품 버전으로 복사하십시오.
이전 설치의
SPARQL_Gateway 디렉토리의 컨텐츠를 새로운
SPARQL_Gateway 디렉토리로 복사하십시오.
cp -R $oldRELMHome/server/conf/SPARQL_Gateway/* $newRELMHome/server/conf/SPARQL_Gateway
5.0 버전에서 5.0.1로 업그레이드하려면 단계 7을 계속 진행하십시오.
버전 4.x에서 5.0.1로 업그레이드하려면,
문서 편집기를 사용하여 다음 특성을
$newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway.properties에 추가하십시오.
- support.query.editing=false
- support.db.derby=false
- support.dwse=false
- query.results.limit=3000
- query.results.cache.timeout=300
- user.account.cache.timeout=480
SPARQL_Gateway에서
app.properties를 제거하십시오.
rm $newRELMHome/server/conf/SPARQL_Gateway/app.properties
SPARQL_Gateway.properties를
app.properties로 이름 변경하십시오.
mv $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway.properties $newRELMHome/server/conf/SPARQL_Gateway/app.properties
SPARQL_Gateway_runtime.properties를
app_runtime.properties로 이름 변경하십시오.
(기본적으로,
SPARQL_Gateway_runtime.properties는 존재하지 않습니다. 그러나 연결 제한시간 설정 구성에 필요하다면 파일을 작성할 수 있습니다.)
mv $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway_runtime.properties $newRELMHome/server/conf/SPARQL_Gateway/app_runtime.properties
- relm.war, relmhelp.war, vvc.war, lqe.war 및 SPARQL_Gateway.war 파일을 배치하십시오.
- WebSphere Application Server 관리 콘솔에서
을
선택하십시오.
- 엔터프라이즈 애플리케이션 페이지에서 설치를 클릭하십시오.
- 새 애플리케이션 경로에서 $newRELMHome/server/webapps/relm.war을 선택하고
열기를 클릭하십시오.
- 빠른 경로를 선택한 후 다음을 클릭하십시오.
- 설치 마법사에서 기본값을 수락하고 다음을 클릭하십시오.
웹 모듈에 대한 컨텍스트 루트 맵핑 페이지에서
컨텍스트 루트 /relm을 입력하십시오. 그런 다음, 완료를 클릭하십시오.
- relm.war가 설치되었다는 메시지가 표시됩니다.
마스터 구성에 직접 저장을 클릭하십시오.
- Rational Engineering Lifecycle
Manager 문서, relmhelp.war을 설치하십시오.
위 단계 a - f를 사용하십시오. 경로에 $newRELMHome/server/webapps/relmhelp.war을 사용하고 컨텍스트 루트로 /relmhelp를 사용하십시오.
- 구성 관리 애플리케이션(vvc.war)을 설치하십시오.
위 단계 a - f를 사용하십시오. 경로에 $newRELMHome/server/webapps/vvc.war를
컨텍스트 루트에 /vvc를 사용하십시오.
- Lifecycle
Query Engine용 WebSphere Application
Server 설정을 수행하고 lqe.war 파일을 배치하십시오.
- Jazz
Reporting Service 애플리케이션, SPARQL_Gateway.war을 설치하십시오.
위 단계 a - f를 사용하십시오. 경로에 $newRELMHome/server/webapps/SPARQL_Gateway.war을 사용하십시오. 컨텍스트 루트로 SPARQL_Gateway를 사용하십시오.
- Jazz
Reporting Service 라이브러리 참조를 추가하십시오.
- 으로 이동하여 애플리케이션 목록에서 SPARQL_Gateway_war을 클릭하십시오.
- 참조 섹션에서 공유 라이브러리 참조를 클릭하십시오.
- SPARQL_Gateway_war 옆에 있는 선택란을 선택하고 공유 라이브러리 참조를 클릭하십시오.
- JRS 공유 라이브러리를 선택하고 오른쪽 화살표를 클릭하십시오.
- 확인을 클릭하십시오. 그런 다음, 확인을 다시 클릭하여
마스터 구성에 설정을 저장하십시오.
- Jazz
Reporting Service 클래스 로딩 순서가
올바르게 구성되었는지 확인하십시오.
- 으로 이동하여 애플리케이션 목록에서 SPARQL_Gateway_war을 클릭하십시오.
- 세부사항 특성 섹션에서 클래스 로딩 및 업데이트 검색을 클릭하십시오.
- 클래스 로더 순서 섹션에서 로컬 클래스 로더가 가장 먼저 로드된 클래스(상위 마지막)를 선택하십시오.
- 확인을 클릭하고 마스터 구성에 저장을 클릭하십시오.
- WebSphere Application Server를 다시 시작하십시오.
- 버전 4.x에서 업그레이드하는 경우 Lifecycle
Query Engine을 업그레이드하십시오.
Lifecycle
Query Engine 관리
페이지(https://relm_host_name:port/lqe/web/admin)를 여십시오.
Lifecycle
Query Engine 업그레이드가 진행 중이며
애플리케이션이 사용 불가능하다는 메시지가 표시됩니다. 업그레이드 시작을 클릭하십시오.
업그레이드 프로세스가 완료되면 데이터 소스를 사용할 수 있습니다.
- 구성 관리 애플리케이션을 업그레이드하십시오.
- credentials.txt 파일이 존재하며 adminUserId, adminPassword, repositoryURL,
smartCard, certificateFile을 포함하는지 확인하십시오.
이 파일이 없으면 작성하십시오. 신임 정보 파일 예제는 다음과 같습니다.
adminUserId=yourAdminUserId
adminPassword=yourAdminPassword
repositoryURL=https://yourserver.com:9443/vvc
smartCard=<none>
certificateFile=<none>
- Configuration_Application_install_dir/server 디렉토리에서
repotools-vvc 명령을 실행하십시오.
./repotools-vvc.sh -vvc_online_migrationCommand
credentialsFile=credentials.txt fromVersion=<previous_version>
logPort=52000 logLevel=DEBUG
repotools-vvc.bat -vvc_online_migrationCommand
credentialsFile=credentials.txt fromVersion=<previous_version>
logPort=52000 logLevel=DEBUG
- Jazz Team Server를 다시 시작하십시오.
구성 관리 애플리케이션 repotools 명령이
실행 중인 구성 관리 애플리케이션에 요청을 발송하고 응답을 기다립니다.
repotools-vvc 명령이 권한 부여 오류와 함께 즉시 중지되는 경우 서버가 실행 중이며 신임 정보 파일의 사용자 ID 및 비밀번호가 올바른지 확인하십시오.
- 애플리케이션 서버를 다시 시작하십시오.
stopServer.sh 및 startServer.sh 명령을 실행하십시오.
stopServer.bat 및 startServer.bat 명령을 실행하십시오.
- Rational Engineering Lifecycle
Manager 서버를
다시 시작하여 마이그레이션된 데이터를 새 애플리케이션 버전에 필요한 형식으로 자동으로 업그레이드하십시오.
이 프로세스를 온라인 업그레이드라고 합니다. 업그레이드 상태 페이지를 보려면 로그온하십시오.
결과
온라인 업그레이드가 완료되면, 웹 브라우저가 새로 고쳐지고
Rational Engineering
Lifecycle Manager 환영 페이지가 열립니다. 업그레이드 단계에 실패하는 경우
relm.log 파일을
검사하여 실패 원인을 판단하십시오.
Rational Engineering
Lifecycle Manager에 여러 제품이 정의된 경우,
온라인 업그레이드를 완료하는 데 시간이 오래 소요됩니다(최대 몇 시간).