Rational Engineering Lifecycle Manager 업그레이드

Rational® Engineering Lifecycle Manager 버전을 최신 버전으로 업그레이드하려면 새 버전을 병렬로 설치합니다.

시작하기 전에

Rational Engineering Lifecycle Manager와 통합된 제품을 업데이트하는 경우 Rational Engineering Lifecycle Manager 제품 스택 업그레이드의 안내에 따르십시오.

프로시저

  1. Rational Engineering Lifecycle Manager 및 Lifecycle Query Engine 설치 지시사항에 따라 Rational Engineering Lifecycle Manager를 설치하십시오. 이는 다음을 설치합니다.
    • Rational Engineering Lifecycle Manager v4.0.6
    • Jazz™ Team Server v 4.0.6
    • 구성 관리 애플리케이션
    중요사항:
    • 원래 설치에 사용한 것과 다른 패키지 그룹과 디렉토리를 선택해야 합니다.
    • 이전 설치와 동일한 컨텍스트 루트를 선택해야 합니다.
  2. WebSphere® Application Server를 사용 중인 경우 다음을 완료하십시오.
    1. WebSphere Application Server 프로파일을 백업하십시오. 명령 프롬프트를 열고 WebSphere Application Server 설치 디렉토리의 바이너리 폴더로 변경하십시오. 예를 들어, C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\bin입니다.다음 명령을 실행하십시오. WebSphere Application Server 보안이 켜져 있는 경우 사용자 이름 및 비밀번호도 제공해야 합니다.
      backupConfig.bat <프로파일의 백업을 작성하는 새 압축 파일의 경로> <WAS 기본 관리 사용자 이름> <WAS 관리자 비밀번호>
      (예: backupConfig.bat C:\WAS_backup\clm_40_profile.zip -username WAS admin -password WAS admin password)
    2. WebSphere Application Server에서 기존 애플리케이션을 설치 제거하십시오. 애플리케이션 war 파일을 설치 제거하려면 각 애플리케이션 서버로 가서 다음 단계를 수행하십시오.
      1. https://hostname:9043/ibm/console/logon.jsp의 WebSphere Application Server Integrated Solutions Console에 로그온하십시오.
      2. 애플리케이션 > 애플리케이션 유형 > WebSphere 엔터프라이즈 애플리케이션을 클릭하십시오.
      3. relm.war, vvc.war, lqe.war, SPARQL_Gateway.war 애플리케이션을 중지하고 설치 제거하십시오.
      4. 프롬프트가 표시되면 마스터 구성에 대한 변경사항을 저장하십시오.
    3. JAZZ_HOME 및 log4j.configuration 사용자 정의 특성을 업데이트하십시오.
      1. https://hostname:9043/ibm/console/logon.jsp의 WebSphere Application Server Integrated Solutions Console에 로그온하십시오.
      2. 서버>서버 유형>WebSphere Application Server를 클릭하십시오.
      3. 서버를 열려면 서버 이름을 클릭하십시오. 기본 서버 이름은 server1입니다.
      4. 서버 인프라 섹션에서 Java 및 프로세스 관리 > 프로세스 정의를 클릭하십시오.
      5. 추가 등록 정보에서 JVM(Java Virtual Machine)을 클릭하십시오.
      6. Lifecycle Query Engine 및 SPARQL Gateway의 경로를 새 위치로 변경하십시오.
      7. 일반 JVM 인수 텍스트 필드를 찾은 후 JVM 시작 프로세스에 환경 변수 -Dlqe.config.location=file://drive:\lqe_installation_folder\server\conf\lqe를 추가하십시오.
      8. 추가 특성에서 사용자 정의 특성을 클릭하십시오.
      9. JAZZ_HOME을 클릭하고 해당 값을 file:///4.0.6_install_dir/server/conf로 업데이트하십시오. 예를 들어 file:///C:/PROGRA~2/IBM/JazzTeamServer_4.0.6/server/conf입니다.
      10. log4j.configuration을 클릭하고 해당 값을 file:///4.0.6_install_dir/server/conf/startup_log4j.properties로 업데이트하십시오. 예를 들어 file:///C:/PROGRA~2/IBM/JazzTeamServer_4.0.6/server/conf/startup.log4j.properties입니다.
      11. Oracle 데이터베이스에 연결하는 경우 ORACLE_JDBC_DRIVER_FILE이 올바른 JDBC 드라이버 파일을 가리키는지 확인하십시오.
      12. 프롬프트가 표시되면 마스터 구성에 대한 변경사항을 저장하십시오.
    4. WebSphere Application Server를 중지하십시오.
    5. WebSphere Application Server temp 디렉토리를 정리하십시오. 각 애플리케이션 서버로 이동하여 프로파일의 다음 wscachetemp 디렉토리에서 Rational Engineering Lifecycle Manager 관련 컨텐츠를 제거하십시오. 이전에 설치된 애플리케이션에 따라, 프로파일 아래에 relm_war, lqe_war, sparql 및 vvc related data 디렉토리가 있으며 이를 제거하면 됩니다.
      WAS_profile_root\wscache (예: C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\wscache)
      WAS_profile_root\temp (예: C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\temp)
    6. logs 디렉토리를 정리하십시오. 각 애플리케이션 서버로 이동하여 프로파일의 로그 디렉토리에서 Rational Engineering Lifecycle Manager 관련 로그를 제거하십시오. 일반적인 logs 디렉토리 경로는 C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\logs입니다.
  3. 데이터베이스를 마이그레이션하려면 다음을 수행하십시오.
    옵션 설명
    Derby 업그레이드를 통해 설치된 Derby 데이터베이스를 삭제하고 원래 설치의 Derby 파일로 바꾸십시오.
    rm -rf $newRELMHome/server/conf/jts/derby/repositoryDB
    rm -rf $newRELMHome/server/conf/jts/indices
    rm -rf $newRELMHome/server/conf/relm/derby/repositoryDB
    rm -rf $newRELMHome/server/conf/vvc/derby/repositoryDB
    cp -R $oldRELMHome/server/conf/jts/derby/repositoryDB $newRELMHome/server/conf/jts/derby
    cp -R $oldRELMHome/server/conf/jts/indices $newRELMHome/server/conf/jts
    cp -R $oldRELMHome/server/conf/relm/derby/repositoryDB $newRELMHome/server/conf/relm/derby
    cp -R $oldRELMHome/server/conf/relm/indices $newRELMHome/server/conf/relm
    cp -R $oldRELMHome/server/conf/vvc/derby/repositoryDB $newRELMHome/server/conf/vvc/derby
    cp -R $oldRELMHome/server/conf/vvc/indices $newRELMHome/server/conf/vvc
    DB2® 또는 Oracle 전체 지시사항은 데이터베이스 벤더가 제공하는 문서를 참조하십시오. 다음은 가이드라인으로 사용될 수 있는 DB2용 샘플 프로세스입니다.
    1. 이전 Jazz Team Server를 중지하십시오.
    2. DB2에서 JTS 애플리케이션의 이전 설치에서 사용된 데이터베이스를 찾으십시오.
    3. JTS 애플리케이션에서 사용되는 각 애플리케이션을 백업하십시오.
    4. 각 데이터베이스를 마우스 오른쪽 단추로 클릭하고 복원 > 새 데이터베이스로 복원을 선택하십시오.
    5. 데이터베이스 이름을 입력하고 백업이 있는 디렉토리를 선택하십시오.
    6. <JazzInstallDir>/server/conf/jts/teamserver.properties 파일을 여십시오.
    7. 다음 예제에서 표시된 대로 Jazz 데이터베이스의 이름을 제공된 이름으로 바꾸십시오.
      #
      # DB2 configuration
      #
      
      # Comment out above lines, uncomment the following three lines and customize example location to use DB2
      #com.ibm.team.repository.db.vendor = DB2
      #com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:fullyMaterializeLobData=false;user=db2admin;password={password};
      #com.ibm.team.repository.db.jdbc.password=db2admin
    8. 복원할 각 데이터베이스에 대해 d - g단계를 반복하십시오.
    9. 변경사항을 저장하십시오.
  4. vvc_upgrade.bat 스크립트를 사용하여 구성 관리 애플리케이션을 업그레이드하십시오. 구성 파일, 데이터베이스 파일이 업그레이드되고 텍스트 색인이 다시 빌드됩니다. 구성 관리 애플리케이션을 업그레이드한 방법에 대한 자세한 설명은 구성 관리에 대한 대화식 업그레이드 안내서에서 사용할 수 있는 업그레이드 안내서를 참조하십시오. Linux용 매개변수의 예는 다음과 같습니다.
    cd $newRELMHome/server/
    upgrade/vvc/vvc_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
    • 분산(복수 시스템) 설치 토폴로지를 업그레이드하려는 경우 vvc_upgrade 스크립트에 -oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck 매개변수를 추가해야 합니다.
    • WebSphere Application Server를 사용 중인 경우 Tomcat을 업그레이드하지 않도록 매개변수를 vvc_upgrade 스크립트에 추가해야 합니다. -oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck -updateTomcatFiles=no
    참고: 구성 관리 애플리케이션은 또한 Rhapsody® Design Manager로 설치될 수 있습니다. Rational Engineering Lifecycle Manager를 설치 중인 경우 구성 관리 애플리케이션 설치를 위한 옵션도 제공됩니다. - 이 옵션은 Rhapsody Design Manager와 다른 시스템에 애플리케이션을 설치하려는 경우 유용합니다. 이 중 하나만 Jazz Team Server와 통합되어야 합니다. 이 컴포넌트를 여러 시스템에 설치할 경우, 컴포넌트를 설치하고 업그레이드할 때 잘못된 컴포넌트를 선택하지 않도록 주의하십시오.
  5. relm_upgrade.sh를 실행하여 Rational Engineering Lifecycle Manager를 업그레이드하십시오.
    $newRELMHome/server/upgrade/relm/relm_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
    세 가지의 업그레이드가 수행됩니다. 첫 번째는 구성 파일을 업그레이드하는 것입니다. 두 번째는 데이터베이스 파일을 업그레이드하는 것입니다. 세 번째는 텍스트 색인을 다시 빌드하는 것입니다.
    참고: 업그레이드 스크립트를 실행하기 전에 relm_params 스크립트에 이전 버전 매개변수를 설정해야 합니다. 이 매개변수 및 기타 사용 가능한 매개변수에 대한 설명은 relm_upgrade 스크립트 참조에 있습니다.
  6. Lifecycle Query Engine 및 SPARQL Gateway 컴포넌트의 모든 구성 정보를 새로 설치한 버전으로 가져와야 합니다. 이전 버전을 새 Jazz Team Server에 수동으로 복사해야 합니다.
    rm -rf $newRELMHome/server/conf/lqe
    cp -R $oldRELMHome/server/conf/lqe $newRELMHome/server/conf/lqe
    rm -rf $newRELMHome/server/conf/SPARQL_Gateway
    cp -R $oldRELMHome/server/conf/SPARQL_Gateway $newRELMHome/server/conf/SPARQL_Gateway
  7. SPARQL Gateway 특성을 편집하여 DBLocation 특성을 제거하십시오. $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway.properties 파일에서 DBLocation 행을 제거하십시오.
  8. Oracle을 사용 중인 경우 Oracle ojdbc.jar(JDBC 드라이버)가 $newRELMHome\JazzTeamServer\server\oracle 디렉토리에 있어야 합니다.
  9. WebSphere Application Server를 사용 중인 경우 relm.war, vvc.war, lqe.war, sparql_gateway.war 파일을 배치하십시오. WebSphere Application Server를 다시 시작하십시오.
  10. Jazz Team Server를 시작하십시오.
  11. LQE 관리 페이지 https://server:port/lqe/web/admin을 여십시오. LQE가 업그레이드 모드에 있으며 사용 불가능함을 나타내는 메시지가 표시됩니다. 업그레이드 시작을 클릭하십시오. 이를 완료하면 데이터 소스가 사용 가능하게 됩니다.
  12. credentials.txt 파일에 다음 컨텐츠가 있는지 확인하십시오. adminUserId, adminPassword, repositoryURL, smartCard, certificateFile 아직 없는 경우 파일을 작성하십시오. 예를 들어, 신임 정보 파일은 다음과 같을 수 있습니다.
    adminUserId=yourAdminUserId
    adminPassword=yourAdminPassword 
    repositoryURL=https://yourserver.com:9443/vvc 
    smartCard=<none>
    certificateFile=<none>
  13. Configuration_Application_install_dir/server 디렉토리에서 다음 명령을 실행하십시오.
    • Linux: ./repotools-vvc.sh -migration_vvc_updateResourcesCommand credentialsFile=credentials.txt
    • Windows: repotools-vvc.bat -migration_vvc_updateResourcesCommand credentialsFile=credentials.txt

다음에 수행할 작업

필수 소프트웨어를 모두 업그레이드한 후 Lifecycle Query Engine이 컨텐츠 색인을 다시 작성해야 할 수도 있습니다. 4.0.3의 Lifecycle Query Engine에 새 어휘가 추가되었습니다. Rational Engineering Lifecycle Manager에서 이러한 어휘에 포함된 데이터를 사용하도록 하려면 애플리케이션 색인을 다시 작성해야 합니다.
표 1. 제품별 요구사항 색인 재작성 개요
제품 v1.x - v4.0.6 v4.0.3 - v4.0.6 v4.0.4 - v4.0.6 v4.0.5 - v4.0.6
Rational Team Concert™ 색인 재작성이 필요함 색인 재작성이 필요하지 않음 색인 재작성이 필요하지 않음 색인 재작성이 필요하지 않음
Rational Quality Manager 색인 재작성이 필요함 색인 재작성이 권장됩니다. oslc:shortld라는 새 특성이 모든 QM 자원에 추가되었습니다. 조회에서 이 특성을 사용하려는 경우 색인 재작성을 수행해야 합니다. 색인 재작성이 필요하지 않음 색인 재작성이 필요하지 않음
Rhapsody Design Management 색인 재작성이 필요하지 않으나 중복 색인 항목을 제거하고 성능을 향상시키는 데 도움이 될 수 있습니다. 조회에서 새 데이터를 사용하려는 경우에만 색인을 다시 작성하십시오. 색인 재작성이 필요하지 않음 색인 재작성이 필요하지 않음 색인 재작성이 필요하지 않음
Rational DOORS® 프로덕션 데이터에 대해 색인 재작성이 강력히 권장됩니다. mailto URI에 대해 조회를 작성한 경우 색인 재작성이 권장됩니다. 프로덕션 데이터에 대해 색인 재작성이 권장됩니다. mailto URI에 대해 조회를 작성한 경우 색인 재작성이 권장됩니다. 색인 재작성이 필요하지 않음 색인 재작성이 필요하지 않음
Rational DOORS Next Generation 해당 없음 해당 없음 색인 재작성이 필요하지 않음 색인 재작성이 필요하지 않음
Rational Engineering Lifecycle Manager 색인 재작성이 필요함 색인 재작성이 필요함 색인 재작성이 필요함 색인 재작성이 필요함
Jazz Team Server 사용자 TRS(jts/trsUsers) 색인 재작성이 필요함 색인 재작성이 필요하지 않음 색인 재작성이 필요하지 않음 색인 재작성이 필요하지 않음

피드백