WebSphere Application Server로 실행 중인 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. 애플리케이션 서버를 구성하십시오.
    1. 이전 서버가 실행 중인지 확인하십시오.
    2. WebSphere® Application Server 프로파일을 백업하십시오.
      1. 명령 프롬프트를 열고 WebSphere Application Server 설치 디렉토리의 bin 디렉토리로 이동하십시오.
      2. 이 명령을 실행하십시오. WebSphere Application Server 보안이 켜져 있는 경우, 사용자 이름 및 비밀번호를 지정하십시오.
        팁: 백업 프로세스를 시작하기 전에 압축 파일의 디렉토리 경로가 있어야 합니다.
        • Linux
          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>
        • Windows
          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>
      이 명령은 백업 프로세스를 시작하기 전에 서버를 종료합니다.
    3. WebSphere Application Server에서 기존 애플리케이션을 설치 제거하십시오.
      1. 서버를 시작하십시오.
      2. WebSphere Application Server Integrated Solutions Console에 로그온하십시오(https://host_name:9043/ibm/console/logon.jsp).
      3. 애플리케이션 > 애플리케이션 유형 > WebSphere 엔터프라이즈 애플리케이션을 클릭하십시오.
      4. 다음 애플리케이션을 중지하고 설치 제거하십시오. relm.war, relmhelp.war, vvc.war, lqe.war, SPARQL_Gateway.war
      5. 프롬프트가 표시되면 마스터 구성에 대한 변경사항을 저장하십시오.
    4. JAZZ_HOMElog4j.configuration 사용자 정의 특성을 업데이트하십시오.
      1. WebSphere Application Server Integrated Solutions Console에 로그온하십시오(https://host_name:9043/ibm/console/logon.jsp).
      2. 서버 > 서버 유형 > WebSphere Application Server를 클릭하십시오.
      3. 서버를 열려면 서버 이름을 클릭하십시오. 기본 서버 이름은 server1입니다.
      4. 서버 인프라 섹션에서 Java 및 프로세스 관리 > 프로세스 정의를 클릭하십시오.
      5. 추가 특성에서 JVM(Java Virtual Machine)을 클릭하십시오.
      6. Lifecycle Query EngineJazz Reporting Service의 경로를 새 위치로 변경하십시오.
      7. 일반 JVM 인수 텍스트 필드를 찾은 후 JVM 시작 프로세스에 이 환경 변수를 추가하십시오.

        -Dlqe.config.location=file://drive:/lqe_installation_dir/server/conf/lqe

      8. 추가 특성에서 사용자 정의 특성을 클릭하십시오.
      9. 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입니다.

      10. 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입니다.

      11. Oracle 데이터베이스에 연결하는 경우 ORACLE_JDBC_DRIVER_FILE이 올바른 JDBC 드라이버 파일을 가리키는지 확인하십시오.
      12. 프롬프트가 표시되면 마스터 구성에 대한 변경사항을 저장하십시오.
    5. Jazz Reporting Service 공유 라이브러리를 설정하십시오.
      1. 관리 콘솔에서 환경 > 공유 라이브러리로 이동하십시오.
      2. 목록에서 JRS 공유 라이브러리를 클릭하십시오.
      3. 기존 Jazz Reporting Service 설치 위치에서 새 위치로 클래스 경로를 변경하십시오.

        예를 들어, 5.0.1_install_dir/server/conf/SPARQL_Gateway/SharedLibrary와 같습니다.

      4. 클래스 로딩에서 공유 라이브러리에 대해 격리된 클래스 로더 사용이 선택되었는지 확인하십시오. 적용저장을 클릭하십시오.
    6. WebSphere Application Server를 중지하십시오.
      • Linux stopServer.sh 명령을 실행하십시오.
      • Windows stopServer.bat 명령을 실행하십시오.
    7. WebSphere Application Server temp 디렉토리를 정리하십시오.

      프로파일의 wscachetemp 디렉토리에서 Rational Engineering Lifecycle Manager 관련 컨텐츠를 제거하십시오. 설치된 애플리케이션에 따라, 프로파일 아래에 다음 디렉토리가 있으며 이를 제거할 수 있습니다. relm_war, lqe_war, sparql, 구성 관리 애플리케이션 관련 데이터

      • Linux
        WAS_profile_root/wscache(예: opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp/wscache)
        WAS_profile_root/temp(예: opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp)
      • Windows
        WAS_profile_root\wscache(예: C:\IBM\WebSphere\AppServer\profiles\AppSrv01\wscache)
        WAS_profile_root\temp(예: C:\IBM\WebSphere\AppServer\profiles\AppSrv01\temp)
    8. WebSphere Application Server 로그 디렉토리를 정리하십시오.
      각 애플리케이션 서버로 이동하여 프로파일의 logs 디렉토리에서 Rational Engineering Lifecycle Manager 관련 로그를 제거하십시오. 일반 로그 디렉토리는 다음과 같습니다.
      • Linux opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs
      • Windows C:\IBM\WebSphere\AppServer\profiles\AppSrv01\logs
    9. WebSphere Application Server를 시작하십시오.
      • Linux startServer.sh 명령을 실행하십시오.
      • Windows startServer.bat 명령을 실행하십시오.
  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
    • Tomcat 업그레이드를 건너뛰려면 다음 매개변수를 vvc_upgrade 스크립트에 추가하십시오.
      -oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck -updateTomcatFiles=no
    팁: 구성 관리 애플리케이션도 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. relm.war, relmhelp.war, vvc.war, lqe.warSPARQL_Gateway.war 파일을 배치하십시오.
    1. WebSphere Application Server 관리 콘솔에서 애플리케이션 > 애플리케이션 유형 > WebSphere 엔터프라이즈 애플리케이션을 선택하십시오.
    2. 엔터프라이즈 애플리케이션 페이지에서 설치를 클릭하십시오.
    3. 새 애플리케이션 경로에서 $newRELMHome/server/webapps/relm.war을 선택하고 열기를 클릭하십시오.
    4. 빠른 경로를 선택한 후 다음을 클릭하십시오.
    5. 설치 마법사에서 기본값을 수락하고 다음을 클릭하십시오. 웹 모듈에 대한 컨텍스트 루트 맵핑 페이지에서 컨텍스트 루트 /relm을 입력하십시오. 그런 다음, 완료를 클릭하십시오.
    6. relm.war가 설치되었다는 메시지가 표시됩니다. 마스터 구성에 직접 저장을 클릭하십시오.
    7. Rational Engineering Lifecycle Manager 문서, relmhelp.war을 설치하십시오. 위 단계 a - f를 사용하십시오. 경로에 $newRELMHome/server/webapps/relmhelp.war을 사용하고 컨텍스트 루트로 /relmhelp를 사용하십시오.
    8. 구성 관리 애플리케이션(vvc.war)을 설치하십시오. 위 단계 a - f를 사용하십시오. 경로에 $newRELMHome/server/webapps/vvc.war를 컨텍스트 루트에 /vvc를 사용하십시오.
    9. Lifecycle Query Engine용 WebSphere Application Server 설정을 수행하고 lqe.war 파일을 배치하십시오.
    10. Jazz Reporting Service 애플리케이션, SPARQL_Gateway.war을 설치하십시오. 위 단계 a - f를 사용하십시오. 경로에 $newRELMHome/server/webapps/SPARQL_Gateway.war을 사용하십시오. 컨텍스트 루트로 SPARQL_Gateway를 사용하십시오.
    11. Jazz Reporting Service 라이브러리 참조를 추가하십시오.
      1. 애플리케이션 > 애플리케이션 유형 > WebSphere 엔터프라이즈 애플리케이션으로 이동하여 애플리케이션 목록에서 SPARQL_Gateway_war을 클릭하십시오.
      2. 참조 섹션에서 공유 라이브러리 참조를 클릭하십시오.
      3. SPARQL_Gateway_war 옆에 있는 선택란을 선택하고 공유 라이브러리 참조를 클릭하십시오.
      4. JRS 공유 라이브러리를 선택하고 오른쪽 화살표를 클릭하십시오.
      5. 확인을 클릭하십시오. 그런 다음, 확인을 다시 클릭하여 마스터 구성에 설정을 저장하십시오.
    12. Jazz Reporting Service 클래스 로딩 순서가 올바르게 구성되었는지 확인하십시오.
      1. 애플리케이션 > 애플리케이션 유형 > WebSphere 엔터프라이즈 애플리케이션으로 이동하여 애플리케이션 목록에서 SPARQL_Gateway_war을 클릭하십시오.
      2. 세부사항 특성 섹션에서 클래스 로딩 및 업데이트 검색을 클릭하십시오.
      3. 클래스 로더 순서 섹션에서 로컬 클래스 로더가 가장 먼저 로드된 클래스(상위 마지막)를 선택하십시오.
      4. 확인을 클릭하고 마스터 구성에 저장을 클릭하십시오.
    13. WebSphere Application Server를 다시 시작하십시오.
  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. 애플리케이션 서버를 다시 시작하십시오.
    • Linux stopServer.shstartServer.sh 명령을 실행하십시오.
    • Windows stopServer.batstartServer.bat 명령을 실행하십시오.
  11. Rational Engineering Lifecycle Manager 서버를 다시 시작하여 마이그레이션된 데이터를 새 애플리케이션 버전에 필요한 형식으로 자동으로 업그레이드하십시오. 이 프로세스를 온라인 업그레이드라고 합니다. 업그레이드 상태 페이지를 보려면 로그온하십시오.

결과

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

다음에 수행할 작업


피드백