업그레이드 스크립트를 사용하여 오프라인을 3.0.1로 업그레이드

이 주제는 rm_upgrade 스크립트를 사용하여 IBM® Rational® Requirements Composer를 버전 2에서 버전 3.0.1로 업그레이드하는 방법에 대해 설명합니다.

시작하기 전에

업그레이드를 시작하기 전에 모든 시스템의 클럭이 NTP(Network Time Protocol)를 사용하여 동기화되었는지 확인하십시오. 시간은 한 네트워크 노드의 이벤트를 다른 위치의 해당 이벤트에 맵핑할 수 있도록 하는 중요한 요소입니다. 문제점을 방지하려면 이러한 과제는 NTP 서비스의 엔터프라이즈 배치에서 해결될 수 있습니다. NPT에 대한 자세한 정보를 보려면 http://www.ntp.org/를 방문하십시오. 또한 모든 서버가 사용자에 대해 동일한 인증 방법을 사용해야 합니다.

여러 제품을 업그레이드할 계획인 경우, 먼저 업그레이드 순서를 참조하면 업그레이드할 제품을 결정하는 데 도움이 됩니다.

중요사항: Jazz™ Team Server와는 별도로 RM(Requirements Management) 애플리케이션을 설치한 분산 환경에서 업그레이드 스크립트를 사용하려면 업그레이드 스크립트에서 RM이 설치된 드라이브 또는 파일 시스템에 액세스할 수 있어야 합니다. 예를 들어 Windows의 경우 마운트는 mounted drive letter:\server\conf 형식이어야 합니다. 절대 경로(예: \\<machine name>\JTS301InstallDir\server\conf)는 작동하지 않습니다. 마운트된 드라이브는 관리자 계정에 대한 읽기-쓰기-실행 권한으로 구성되어야 합니다.

단일 서버 배치인 경우 또는 분산 배치이며 Jazz Team Server 및 Requirements Management에서 드라이브를 맵핑할 수 있는 경우, 업그레이드 스크립트 사용 시 이러한 업그레이드 지시사항을 따를 수 있습니다.

분산 네트워크 배치를 사용하는데 드라이브를 마운트할 수 없는 경우 또는 고급 관리자이고 각 단계를 수동으로 완료하려는 경우 오프라인을 3.0.1로 수동 업그레이드 지시사항을 따를 수 있습니다. 수동 단계에서는 스크립트가 수행하는 내용을 자세히 설명합니다.

IBM WebSphere® Application Server 환경에서는 설치 경로를 공백을 포함하지 않는 설치 경로(예: C:\IBM\JazzTeamServer)로 변경하십시오. 그러나 파일 이름 또는 파일 경로 매개변수에 공백이 포함된 경우 매개변수를 큰따옴표로 묶어야 합니다(예: "C:\Program Files\IBM").

프로시저

  1. 배치 및 업그레이드 프로세스 이해 주제를 검토하십시오. 필요한 경우 배치 및 업그레이드 계획 섹션의 주제도 검토하십시오.
    중요사항:
    • 원래 RM 버전 2 컨텍스트 루트(/rdm) 및 모든 RM 아티팩트의 URI는 보존됩니다. Jazz Team Server의 컨텍스트 루트는 /jazz에서 /jts로 변경됩니다.
    • 버전 2 설치에서 공용 URI를 설정한 경우, 버전 3.0.1에서도 동일한 공용 URI를 사용해야 합니다.
  2. 하드웨어 및 소프트웨어가 애플리케이션의 최소 요구사항을 충족하거나 초과하는지 확인하십시오(시스템 요구사항 참조). 현재 버전 2 teamserver.properties 파일에서 다음 정보를 확인하십시오.
    • 공용 URI 특성 - com.ibm.team.repository.server.webapp.url
    • 데이터베이스 서버에 연결하는 데 필요한 정보(일반적으로, com.ibm.team.repository.db.vendor, com.ibm.team.repository.db.jdbc.location 및 com.ibm.team.repository.db.jdbc.password)

    버전 3.0.1에서 동일한 공용 URI를 사용해야 합니다. 공용 URI를 설정하지 않은 경우, 버전 2 관리 웹 인터페이스(고급 특성)를 사용하여 업그레이드하기 전에 규정된 호스트 이름 URI(https://hostname.example.com:port)를 설정하십시오.

    teamserver.properties 파일에서 공용 URI 행은 다음과 유사하게 나타납니다.
    com.ibm.team.repository.server.webapp.url=https\://hostname.example.com\:9443/jazz
  3. Jazz.net의 해당 프로젝트 페이지에서 설치할 IBM Rational Requirements Composer 소프트웨어 및 CLM(Collaborative Lifecycle Management)용 Rational 솔루션의 다른 애플리케이션을 다운로드하십시오. 지시사항은 제품 설치 매체 다운로드의 내용을 참조하십시오.
  4. IBM Rational Requirements Composer 버전 2 서버를 중지하십시오.
  5. IBM Rational Requirements Composer 버전 2 데이터베이스 및 teamserver.properties 파일을 임시(tmp) 위치에 백업하십시오. teamserver.properties 파일은 각 애플리케이션이 데이터베이스에 연결하는 데 필요한 데이터베이스 위치를 포함합니다. 기본적으로 이 파일은 버전 2에서 InstallDir\server\conf\jazz\teamserver.properties에 있습니다. 백업 지시사항은 다음 주제를 참조하십시오.
  6. 기존 IBM Rational Requirements Composer 버전 2 데이터베이스에서 데이터를 내보내십시오.
    1. IBM Rational Requirements Composer 버전 2 RRC2InstallDir\server 디렉토리로 변경하십시오.
    2. repotools -export Windows 명령이나 ./repotools.sh - export AIX® 또는 Linux 시스템 명령을 실행한 후 버전 2.0.1의 다음 예제에 표시된 것과 같이 파일을 IBM Rational Requirements Composer 디렉토리 구조 외부에 저장하십시오.

    Windows: repotools -export toFile=c:\tmp\rrcdata.tar

    AIX 또는 Linux: repotools -export toFile=/tmp/rrcdata.tar

    여기서 toFile 변수는 데이터베이스를 내보내는 .tar 파일의 이름을 지정합니다.

    참고:
  7. Jazz Team Server 버전 3.0.1을 이미 설치한 경우, Jazz Team Server 및 기타 CLM 애플리케이션을 비롯한 버전 3.0.1 서버를 모두 중지한 다음 Jazz Team Server 버전 3.0.1 백업데이터베이스 및 환경을 백업하십시오. 10단계로 건너뛰십시오.
  8. Jazz Team Server 버전 3.0.1을 설치하지 않은 경우, Jazz Team Server를 설치하십시오. 설정 마법사를 실행하지 마십시오.
  9. Jazz Team Server 버전 3.0.1을 아직 설치하지 않았으며 기본 Derby 데이터베이스가 아닌 다른 데이터베이스를 사용 중인 경우, Jazz Team Server 데이터베이스를 작성해야 합니다.

    데이터베이스는 Jazz Team Server 및 데이터 웨어하우스에 필요합니다. Requirements Management 애플리케이션의 경우 데이터 저장을 위해 Jazz Team Server 데이터베이스를 사용하므로 데이터베이스를 작성하지 않아도 됩니다. 각 데이터베이스에 대한 세부사항은 데이터베이스 설정의 주제를 참조하십시오.

    참고: Oracle 또는 SQL Server 데이터베이스를 사용하는 경우 데이터베이스 드라이버를 올바른 위치에 복사하십시오. 세부사항은 Oracle 데이터베이스 설정 및 SQL Server 데이터베이스 설정을 참조하십시오.
  10. 다른 머신에 Requirements Management 애플리케이션을 설치하십시오. 지시사항은 IBM Installation Manager를 사용하여 설치의 내용을 참조하십시오.

    설치 중에 Requirements Composer 2.x 컨텍스트 루트 사용을 선택하십시오. 이 옵션을 선택하면 필수 옵션으로 RM 애플리케이션을 설치하여 RM 아티팩트에 대한 링크를 보존하는 데 필요한 RM의 /rdm 버전 2 컨텍스트 루트가 보존됩니다. 이 옵션을 선택하는 데 실패하면 업그레이드에 실패합니다. 자세한 정보는 배치 및 업그레이드 프로세스 이해의 내용을 참조하십시오.

  11. 설치 종료 시 시작할 프로그램에서 없음을 선택하고 완료를 클릭한 다음 종료를 클릭하십시오.
  12. WebSphere Application Server에 배치하는 경우, 버전 2 .war 파일(converter.war, jazz.war, rrc-help.war 및 rdm.war)을 중지한 후 설치 제거하십시오. 자세한 정보는 버전 3 업그레이드를 위해 WebSphere Application Server 설정의 내용을 참조하십시오.
  13. 오프라인 업그레이드 스크립트를 실행하십시오. Jazz Team Server 버전 3.0.1을 설치한 위치에서 새 명령 창을 열고 JTS301InstallDir\server로 이동한 다음 upgrade\rm_upgrade.bat 업그레이드 스크립트(Windows) 또는 upgrade/rm_upgrade.sh 업그레이드 스크립트(AIX 또는 Linux 시스템)를 실행하십시오. 스크립트는 실행될 때 컴퓨터 로케일의 언어 설정을 사용합니다.
    참고: 명령행에서 모든 인수를 지정하여 스크립트를 실행할 수 있습니다. 또는 업그레이드 스크립트를 여러 번 다시 실행하는 경우 스크립트 매개변수 파일을 편집하고 축약된 명령행을 실행할 수도 있습니다. 매개변수 파일에 대한 지시사항은 14단계를 참조하십시오.
    중요사항:
    • 스크립트 파일은 업그레이드 디렉토리 아래에 있지만, 서버 디렉토리에서 실행해야 합니다. 또한 경로에 공백이 포함된 경우 경로 이름을 큰따옴표로 묶어야 합니다.
    • Rational Requirements Composer 버전 2에서 Floating 라이센스를 사용한 경우 알려진 문제가 있으므로, IBM Rational Requirements Composer 버전 2 데이터베이스에서 데이터를 가져오기 전에 업그레이드 스크립트를 중지하고, Jazz Team Server를 시작한 다음 버전 3.0.1 Floating 라이센스를 설치해야 할 수 있습니다. 이를 수행하는 방법에 대한 자세한 정보는 https://jazz.net/library/article/659를 참조하십시오.

    Jazz Team Server 버전 3.0.1을 RM 애플리케이션과 함께 설치했으며 이 업그레이드가 업그레이드하려는 첫 번째 애플리케이션 또는 유일한 애플리케이션인 경우 명령 구문은 다음과 같습니다.

    Windows:

    upgrade\rm_upgrade.bat -oldApplicationHome RRC2InstallDir\server\conf -importFromFile c:\tmp\export.tar -createJTSTables 

    AIX 또는 Linux:

    ./upgrade/rm_upgrade.sh -oldApplicationHome RRC2InstallDir/server/conf -importFromFile /tmp/export.tar -createJTSTables 
    참고: -createJTSTables 매개변수는 Jazz Team Server 버전 3.0.1 및 CLM(Collaborative Lifecycle Management) 제품을 처음 설치하는 경우 설치에 적용됩니다. Jazz Team Server 버전 3.0.1이 존재하므로 RM 애플리케이션만 설치하는 경우 명령에 이 매개변수를 포함하지 않아도 됩니다. createTables 매개변수는 Jazz Team Server 데이터베이스를 작성하고 .tar 파일의 컨텐츠를 가져옵니다. 이미 기존 Jazz Team Server 데이터베이스가 있는 경우 기존 데이터베이스를 겹처쓰게 되므로 명령행에 createTables 매개변수를 포함하지 마십시오.

    분산 배치에서처럼 Jazz Team Server 버전 3.0.1을 RM 애플리케이션과 별도로 설치한 경우, RM 애플리케이션의 위치를 지정하고 Jazz Team Server QM 3.0.1 설치 디렉토리에서 스크립트를 실행해야 합니다. 이 경우, -newApplicationHome 인수를 포함하십시오.

    Windows:

    JTS301InstallDir\server upgrade\rm_upgrade.bat -oldApplicationHome RRCS2InstallDir\server\conf -importFromFile c:\tmp\export.tar -newApplicationHome RRC301InstallDir\server\conf -jtsURL https://fully qualified domain name:port/jts

    AIX 또는 Linux:

    JTS301InstallDir/server ./upgrade/rm_upgrade.sh -oldApplicationHome RRCS2InstallDir/server/conf -importFromFile /tmp/export.tar -newApplicationHome RRC301InstallDir/server/conf -jtsURL https://fully qualified domain name:port/jts
    참고:
    • 분산 배치이며 Jazz Team Server 버전 3.0.1을 구성하지 않은 경우 위의 명령행 예제에 -createJTSTables 매개변수를 추가할 수 있습니다.
    • -jtsURL 매개변수는 Jazz Team Server의 공용 URI입니다. 기본적으로 Jazz Team Server 공용 URI는 애플리케이션 공용 URI에서 파생됩니다. 이 매개변수는 Jazz Team Server가 RM 애플리케이션이 아닌 다른 서버 인스턴스에서 실행 중인 분산 배치에 지정해야 합니다.

    명령행 옵션에 대한 자세한 정보를 보려면 다음 명령 중 하나를 입력하십시오.

    Windows: upgrade\rm_upgrade.bat -help

    AIX 또는 Linux: ./upgrade/rm_upgrade.sh -help

    마이그레이션할 정보의 양 때문에 오프라인 마이그레이션의 경우 완료하는 데 시간이 걸릴 수 있습니다.
    주의: 오프라인 마이그레이션 중에는 병합된 파일의 컨텐츠를 표시하는 프롬프트, 특히 teamserver.properties 파일에 지정된 데이터베이스 연결을 검토하고 필요한 경우 병합된 파일을 편집해야 합니다.

    이 스크립트는 다음 태스크를 완료합니다.

    1. 다음과 같이 버전 3.0.1 구성 파일을 업데이트하십시오.
      • -migration_rm_updateConfigurationFiles 명령을 실행하고 구성 및 Tomcat 파일을 업데이트합니다. [E]를 입력하여 명령을 실행하거나, [S]를 입력하여 단계를 건너뛰거나, [Enter]를 눌러 스크립트 실행을 취소하십시오.
        중요사항: 데이터 웨어하우스 데이터베이스에 연결하는 데 필요한 특성이 현재 Derby로 설정되어 있더라도 이 특성을 수정하지 마십시오. 이 특성은 서버 설정 마법사에서만 수정하십시오.
        참고: 아직 Jazz Team Server 버전 3.0.1을 설치하지 않은 경우, 현재 9단계에서 이전에 작성한 새 Jazz Team Server 데이터베이스에 대한 데이터베이스 위치 특성을 입력해야 합니다.
      • 구성 파일이 병합된 후, 계속하려면 [C]를 입력하십시오. 메모장 창 또는 vi 편집기(AIX 또는 Linux시스템의 경우)가 열리고, 여기에서 Jazz Team Server teamserver.properties 파일을 확인할 수 있습니다. com.ibm.team.repository.server.webapp.url 특성에 표시된 공용 URI 루트가 올바른지 확인하십시오. 또한 데이터베이스 특성이 올바른지도 확인하십시오. 완료되면, 변경사항이 있는 경우 저장하고 스크립트 실행을 계속하려면 편집기를 닫으십시오.
      • 버전 2 Tomcat 사용자 .xml 파일을 복사합니다.
      • 버전 3.0.1과 교차 저장소 통합에 대해 설정된 서버 목록을 포함하는 버전 2 friendsconfig.rdf 파일을 병합합니다.
      • 버전 2 server.xml 및 web.xml(LDAP 설정) 파일의 컨텐츠를 버전 3.0.1과 병합합니다.
    2. repotools-jts -import Windows 명령 또는 ./repotools-jts.sh -import AIX 또는 Linux 시스템 명령을 사용하여 내보낸 RM 버전 2 데이터를 .tar 파일에서 Jazz Team Server 버전 3.0.1 데이터베이스로 가져오십시오.
      참고:
      • Requirements Management 애플리케이션 버전 3.0.1용 대형 저장소를 가져오면 OutOfMemoryException 오류가 발생할 수 있습니다. 프로젝트 및 아티팩트 수가 많은 경우 repotools-jts.bat 또는 repotools-jts.sh 스크립트에서 -Xmx 매개변수를 기본값인 1500M에서 더 높은 값으로 늘려야 합니다. 최상의 결과의 결과를 위해서는 시스템 메모리가 충분한 경우 4096M를 사용하십시오.
      • 구성 파일에서 수행된 Rational Requirements Composer의 자세한 변경 목록을 보려면 Rational Requirements Composer 변경을 참조하십시오.
  14. 선택사항: 이전 단계의 대안으로 스크립트 매개변수 파일을 열고 기본값을 수정한 다음 명령행의 축약 양식을 실행할 수도 있습니다. 이러한 값에 대한 자세한 정보는 rm_upgrade를 참조하십시오.

    매개변수 파일의 영어 버전과 번역된 버전은 JazzInstallDir\server\upgrade\params\rm_params.bat 디렉토리(Windows) 또는 ./params/rm_params.sh 디렉토리(AIX 또는 Linux 시스템)에 있습니다.

    1. 자국어로 된 매개변수 파일의 정확한 이름을 확인하려면 JazzInstallDir\server\upgrade 디렉토리에서 locale.bat -rm -showParamFileName 명령(Windows) 및 ./locale.sh -rm -showParamFileName 명령(AIX 또는 Linux 시스템)을 실행하십시오.
    2. 편집을 위해 rm_params 파일 또는 번역된 버전을 열고 각 매개변수의 값을 지정하십시오. 반드시 설정해야 하는 매개변수 중 하나는 OLD_APPLICATION_HOME 디렉토리의 경로입니다. 경로에 공백이 없는지 확인하십시오. 그러나 파일 이름 또는 파일 경로 매개변수에 공백이 포함된 경우 매개변수를 큰따옴표로 묶어야 합니다. 예를 들어 OLD_APPLICATION_HOME="C:\Program Files\IBM\RRCS2002\server\conf"를 설정하십시오. 각 매개변수에 대한 정보는 JazzInstallDir\server\upgrade\doc\rm_help.txt를 참조하십시오.
  15. 저장소 데이터 및 구성 파일이 업데이트되었는지 확인하십시오. 세부사항은 업그레이드 중 구성 파일 확인 및 -migration_rm_updateConfigurationFiles를 참조하십시오.
  16. 오프라인 마이그레이션을 완료한 후 버전 2 데이터베이스를 백업한 위치가 아닌 다른 위치에 Jazz Team Server 버전 3.0.1 데이터베이스 및 전체 서버 디렉토리를 백업하십시오. 백업은 온라인 마이그레이션을 계속하기 전에 수행하십시오. 버전 2 데이터베이스 백업을 겹쳐쓰지 마십시오.
  17. 이전 릴리스에서 사용하기 위해 보안 인증서를 작성한 경우 인증서를 복사하거나 인증서를 새로 작성하십시오. 세부사항은 보안 인증서 구성의 내용을 참조하십시오.
  18. Tomcat 애플리케이션 서버를 Windows 서비스로 실행하는 경우 서비스를 제거한 후 다시 설치해야 합니다. 명령 구문은 Apache Tomcat에서 Windows 서비스로 실행(32비트)의 내용을 참조하십시오.
  19. IBM WebSphere Application Server에 배치하는 경우 3.0 WAR 파일을 배치하고 보안 역할을 사용자 또는 그룹에 맵핑하십시오. 자세한 정보는 버전 3 업그레이드를 위해 WebSphere Application Server 설정의 내용을 참조하십시오.
  20. 백업을 완료한 후 온라인 마이그레이션 단계를 계속하십시오. 온라인 마이그레이션 업그레이드 단계의 내용을 참조하십시오.

피드백