Apache Tomcat으로 실행 중인 Rational Engineering Lifecycle Manager 업그레이드

Rational® Engineering Lifecycle Manager를 업그레이드하려면, 새 제품 버전을 설치하고 구성 파일을 업데이트하고 기존 데이터베이스 저장소에서 테이블을 추가하거나 업데이트한 후 기존 데이터를 버전 5.0.1로 마이그레이션하십시오.

시작하기 전에

프로시저

  1. Rational Engineering Lifecycle Manager를 설치하십시오.
    이 단계에서는 다음을 설치합니다.
    • Rational Engineering Lifecycle Manager 5.0.1
    • Jazz™ Team Server 5.0.1
    • 구성 관리 애플리케이션 5.0.1
    중요사항:
    • 원래 설치에 사용한 것과 다른 패키지 그룹과 디렉토리를 선택하십시오.
    • 이전 설치와 동일한 컨텍스트 루트를 선택하십시오.

      Rational Engineering Lifecycle Manager 버전 5.0 또는 이전 버전에서 업그레이드하는 경우 기존 Jazz Reporting Service 또는 SPARQL Gateway 컨텍스트 루트는 SPARQL_Gateway이고 애플리케이션 파일 이름은 SPARQL_Gateway.war입니다. Rational Engineering Lifecycle Manager 5.0.1 설치 시, 사용자 정의 컨텍스트 루트 옵션을 선택하고 애플리케이션 컨텍스트 루트 값 필드에 SPARQL_Gateway를 입력하십시오.

  2. 이전 Tomcat 서버를 중지하십시오.
  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에서 Jazz Team Server 애플리케이션의 이전 설치에서 사용된 데이터베이스를 찾으십시오.
    3. Jazz Team Server 애플리케이션에서 사용되는 각 데이터베이스를 백업하십시오.
    4. 변경사항을 저장하십시오.
    데이터베이스 백업 및 복원에 대한 자세한 정보는 Rational solution for Collaborative Lifecycle Management의 문서를 참조하십시오.
    SQL Server

    다음은 가이드라인으로 사용될 수 있는 SQL Server용 샘플 데이터베이스 백업 프로세스입니다.

    • 올바른 사용자 이름과 비밀번호가 있어야 합니다.
    • 업그레이드 프로세스를 시작하기 전에 데이터베이스를 백업했는지 확인하십시오.
    • JDBC(Java Database Connectivity) 드라이버가 설치되었고 sqljdbc4.jar을 사용하는지 확인하십시오. 버전 5.0.1에서 JRE 버전 5.0은 더 이상 지원되지 않습니다. JRE 버전 6.0 및 7.0만 지원됩니다.
    • SQL 서비스가 시작되었는지 확인하십시오.
    전체 지시사항은 데이터베이스 벤더가 제공하는 문서를 참조하십시오.
    Oracle Oracle JDBC 드라이버 ojdbc.jar$newRELMHome/JazzTeamServer/server/oracle 디렉토리에서 사용 가능한지 확인하십시오.
  4. 구성 관리 애플리케이션을 업그레이드하십시오.
    vvc_upgrade 스크립트를 실행하여 구성 및 데이터베이스 파일을 업그레이드하고 텍스트 색인을 다시 빌드하십시오. 이것은 매개변수 예제입니다.
    cd $newRELMHome/server/
    upgrade/vvc/vvc_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
    • 분산(복수 서버) 설치 토폴로지를 업그레이드하려는 경우, vvc_upgrade 스크립트에 다음 매개변수를 사용하십시오.
      -oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck
    팁: 구성 관리 애플리케이션도 Rhapsody® Design Manager로 설치할 수 있습니다. Rational Engineering Lifecycle Manager를 설치하는 경우, 구성 관리 애플리케이션 설치 옵션이 제공됩니다. - 이 옵션은 Rhapsody Design Manager와 다른 서버에 애플리케이션을 설치하려는 경우 유용합니다. 구성 관리 애플리케이션 하나만 Rational Engineering Lifecycle Manager와 통합하십시오. 이 컴포넌트를 여러 서버에 설치할 경우, 설치 및 업그레이드할 컴포넌트를 올바르게 선택했는지 확인해야 합니다.
  5. Rational Engineering Lifecycle Manager를 업그레이드하십시오.
    relm_upgrade.sh 명령을 실행하여 구성 및 데이터베이스 파일을 업그레이드하고 텍스트 색인을 다시 빌드하십시오.
    $newRELMHome/server/upgrade/relm/relm_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
  6. 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.propertiesapp.properties로 이름 변경하십시오.
    mv $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway.properties $newRELMHome/server/conf/SPARQL_Gateway/app.properties
    SPARQL_Gateway_runtime.propertiesapp_runtime.properties로 이름 변경하십시오. (기본적으로, SPARQL_Gateway_runtime.properties는 존재하지 않습니다. 그러나 연결 제한시간 설정 구성에 필요하다면 파일을 작성할 수 있습니다.)
    mv $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway_runtime.properties $newRELMHome/server/conf/SPARQL_Gateway/app_runtime.properties
  7. Apache Tomcat 서버를 시작하십시오.
  8. 버전 4.x에서 업그레이드하는 경우 Lifecycle Query Engine을 업그레이드하십시오.

    Lifecycle Query Engine 관리 페이지(https://relm_host_name:port/lqe/web/admin)를 여십시오. Lifecycle Query Engine 업그레이드가 진행 중이며 애플리케이션이 사용 불가능하다는 메시지가 표시됩니다. 업그레이드 시작을 클릭하십시오. 업그레이드 프로세스가 완료되면 데이터 소스를 사용할 수 있습니다.

  9. 구성 관리 애플리케이션을 업그레이드하십시오.
    1. credentials.txt 파일이 존재하며 adminUserId, adminPassword, repositoryURL, smartCard, certificateFile을 포함하는지 확인하십시오.

      이 파일이 없으면 작성하십시오. 신임 정보 파일 예제는 다음과 같습니다.

      adminUserId=yourAdminUserId
      adminPassword=yourAdminPassword 
      repositoryURL=https://yourserver.com:9443/vvc 
      smartCard=<none>
      certificateFile=<none>
    2. Configuration_Application_install_dir/server 디렉토리에서 repotools-vvc 명령을 실행하십시오.
      • Linux./repotools-vvc.sh -vvc_online_migrationCommand credentialsFile=credentials.txt fromVersion=<previous_version> logPort=52000 logLevel=DEBUG
      • Windowsrepotools-vvc.bat -vvc_online_migrationCommand credentialsFile=credentials.txt fromVersion=<previous_version> logPort=52000 logLevel=DEBUG
    3. Jazz Team Server를 다시 시작하십시오.
    구성 관리 애플리케이션 repotools 명령이 실행 중인 구성 관리 애플리케이션에 요청을 발송하고 응답을 기다립니다. repotools-vvc 명령이 권한 부여 오류와 함께 즉시 중지되는 경우 서버가 실행 중이며 신임 정보 파일의 사용자 ID 및 비밀번호가 올바른지 확인하십시오.
  10. Tomcat 서버를 다시 시작하십시오.
  11. Rational Engineering Lifecycle Manager 서버를 다시 시작하여 마이그레이션된 데이터를 새 애플리케이션 버전에 필요한 형식으로 자동으로 업그레이드하십시오. 이 프로세스를 온라인 업그레이드라고 합니다. 업그레이드 상태 페이지를 보려면 로그온하십시오.

결과

온라인 업그레이드가 완료되면, 웹 브라우저가 새로 고쳐지고 Rational Engineering Lifecycle Manager 환영 페이지가 열립니다. 업그레이드 단계에 실패하는 경우 relm.log 파일을 검사하여 실패 원인을 판단하십시오. Rational Engineering Lifecycle Manager에 여러 제품이 정의된 경우, 온라인 업그레이드를 완료하는 데 시간이 오래 소요됩니다(최대 몇 시간).

다음에 수행할 작업


피드백