Tomcat에서 이전 버전에서 업그레이드

Apache Tomcat에서 이전 버전의 IBM® Rational® Asset Manager에서 업그레이드하려면 다음 지침을 사용하십시오.

시작하기 전에

중요사항: 또한 IBM Rational Team Concert. 이는 Tomcat 서버용 추가 데이터베이스와 보안 인증서를 필요로 합니다.

라이센스 서버를 업그레이드하고 업데이트된 라이센스 키를 요청해야 합니다. Rational License Server 필수 버전에 대한 자세한 정보는 Rational License Key Server 설치를 참조하십시오.

또한 애플리케이션 서버를 여러 번 중지했다가 다시 시작해야 합니다.

웹 애플리케이션 및 포함된 IBM Rational Team Concert의 애플리케이션 파일을 개별 Tomcat 서버에 설치하여 Rational Asset Manager의 성능과 안정성을 향상시킬 수 있습니다. 이 문서 전반에서 Rational Asset Manager용 Tomcat 서버 설치 디렉토리는 tomcat_install_directory입니다. Rational Team Concert용 Tomcat 서버 설치 디렉토리는 tomcat_for_rtc_install_directory입니다. 동일한 Tomcat 서버에 모든 웹 애플리케이션을 설치하는 경우에는 디렉토리가 동일합니다.

이 태스크 정보

다음 아웃라인은 최신 버전의 Rational Asset Manager로 업그레이드하기 위해 수행해야 하는 작업을 표시합니다.
  1. 업그레이드를 준비하고 중요한 파일과 데이터베이스를 백업하십시오(1 단계).
  2. 최신 버전의 Rational Asset Manager 애플리케이션 파일을 검색하십시오(4단계).
  3. V7.1.1.1 이하에서 업그레이드하는 경우, 추가 데이터베이스를 작성하십시오(5단계).
  4. Tomcat 서버를 종료하십시오(6단계).
  5. 라이센스 서버를 Rational Common Licensing 8.1.2로 업그레이드하십시오(7단계).
  6. Rational Asset Manager 및 Rational Common Licensing 8.1.2용 새 공유 라이브러리 파일을 복사하고 Tomcat 서버 시작 파일을 그에 따라 수정하십시오(8 - 10단계).
  7. 싱글 사인온을 위해 Tomcat 서버를 구성하십시오(11단계).
  8. 포함된 Rational Team Concert의 현재 애플리케이션 파일을 검색하십시오(12 - 13단계).
  9. V7.1.1.1 이하에서 업그레이드하고 Rational Team Concert가 필요한 경우, 애플리케이션 서버에 Rational Team Concert를 설치하십시오(16 - 23단계).
  10. V7.1.1.1 이하에서 업그레이드하는 경우, Rational Team Concert를 구성하십시오(24 - 30단계).
  11. V7.2 이상에서 업그레이드하는 경우, 포함된 Rational Team Concert를 업그레이드하십시오(32단계).
  12. Rational Asset Manager의 기존 애플리케이션 파일을 제거하고 새 버전의 애플리케이션을 설치하십시오(33 - 38단계).
  13. Rational Asset Manager에 로그인하고 저장소를 마이그레이션하십시오(39단계).
  14. V7.1.1.1 이하에서 업그레이드하는 경우, Rational Team Concert에 연결하도록 Rational Asset Manager를 구성하십시오(40단계).
  15. Eclipse 클라이언트를 업그레이드하십시오(41단계).

프로시저

  1. 업그레이드를 시작하기 전에 Rational Asset Manager 저장소 백업 작성의 지시사항에 따라 저장소, 데이터베이스, 자산 파일 및 애플리케이션 서버 설정의 전체 백업을 작성하십시오.
  2. 테마 또는 이메일 메시지를 수정한 경우, Rational Asset Manager 서버를 업데이트하기 전에 관리 > 도구 페이지에서 현재 테마 및 메일 메시지 파일을 다운로드하고 서버를 업데이트한 후에 테마와 메시지를 다시 적용하십시오. 자세한 정보는 테마 마이그레이션을 참조하십시오.
  3. 저장소 서버가 모두 동일한 현재 날짜, 시간 및 시간대로 설정되어 있는지 확인하십시오.
  4. Tomcat 및 해당 운영 체제에 적합한 아카이브에서 애플리케이션 파일을 검색하십시오. 애플리케이션 파일은 archive_extract_location/apps/tomcat/ 폴더에 있습니다.
  5. V7.1.1.1 이하에서 업그레이드하는 경우: 자산 라이프사이클 데이터베이스를 작성하십시오.
  6. Tomcat 서버를 중지하십시오. 저장소 및 서버의 기타 애플리케이션이 이제 오프라인 상태가 됩니다.
  7. Windows의
경우: Linux의 경우: AIX의 경우: Rational Licensing Server를 Rational Common Licensing V8.1.2 이상으로 마이그레이션하십시오. 자세한 정보는 Rational Licensing Server v7.1.x 이하에서 Rational Common Licensing으로 마이그레이션을 참조하십시오.

    Rational License Key Server는 Rational Asset Manager 설치 매체에 포함되어 있습니다. Passport Advantage 계정을 통해 또는 Rational Download Center를 통해서도 최신 버전의 Rational License Server를 검색할 수 있습니다.

    이 프로세스를 수행하려면 Rational Licensing Server를 사용하는 애플리케이션을 모두 종료하고 기존 Rational Licensing Server를 설치 제거하며, 라이센스 파일을 업데이트하고 Rational Common Licensing Server를 설치해야 합니다. Windows의 경우, Windows용 라이센스 서버 구성을 참조하십시오. AIX® 또는 Linux의 경우 UNIX용 라이센스 서버 구성을 참조하십시오.

    zSeries®용 Linux의 경우, UNIX 및 Linux용 Rational License Server 7.0.0.1을 계속 사용하십시오.
  8. 공유 라이브러리 파일을 Tomcat 서버용 \shared\lib 폴더에 추출하십시오.
    1. archive_extract_location\apps\tomcat\sharedLib.zip 파일을 찾아 압축을 푸십시오.
    2. 압축이 풀린 sharedLib.zip 파일의 전체 컨텐츠를 tomcat_install_directory\lib 디렉토리로 복사하십시오.
  9. Windows의
경우: Linux의 경우: AIX의 경우: Rational Licensing Key Server V8.1.2의 라이브러리 파일을 tomcat_install_directory\lib 폴더로 압축을 푸십시오.
    중요사항: zSeries용 Linux에서 설치 중이면 이 단계를 완료하지 마십시오.
    1. archive_extract_location\sharedLibs\rlsclients_rlsibmratl_812.zip 파일을 찾아 압축을 푸십시오.
    2. 추출된 .zip 파일에서 해당 운영 체제 및 아키텍처용 rlsibmratl812.zip 파일을 찾으십시오. 예를 들어, 32비트 Windows의 파일은 win32 디렉토리에 있습니다.
    3. 해당 rlsibmratl812.zip 파일의 컨텐츠를 추출하십시오.
    4. 추출된 rlsibmratl812.zip 파일의 전체 컨텐츠를 tomcat_install_directory\shared\lib 디렉토리에 복사하십시오. Tomcat 6 또는 7의 경우에는 압축이 풀린 rlsibmratl812.zip 파일의 전체 컨텐츠를 tomcat_install_directory\lib 디렉토리로 복사하십시오.
  10. Windows의
경우: Linux의 경우: AIX의 경우: Rational Asset Manager용 Tomcat 서버의 시작 스크립트를 수정하십시오.
    1. Tomcat 시작 파일을 찾아 문서 편집기에서 여십시오. Windows에서 이 파일은 tomcat_install_directory\bin\startup.bat입니다. Linux, AIX 또는 zSeries용 Linux에서 이 파일은 tomcat_install_directory/bin/startup.sh입니다.
    2. JAVA_OPTS=가 포함된 행을 검색하십시오.
      • JAVA_OPTS 환경 변수가 이미 설정된 경우, 다음 옵션과 값을 추가하십시오.
        • Windows의
경우:
          -Djava.library.path="tomcat_install_directory\shared\lib"
        • Linux의 경우: AIX의 경우:
          -Djava.library.path=tomcat_install_directory/shared/lib
      • JAVA_OPTS 환경 변수가 설정되지 않은 경우, 다음 텍스트를 입력하십시오.
        • Windows의
경우:
          set JAVA_OPTS=-Djava.library.path="tomcat_install_directory\lib"
        • Linux의 경우: AIX의 경우:
          export JAVA_OPTS="-Djava.library.path=tomcat_install_directory/lib"
  11. 모든 애플리케이션에 대한 싱글 사인온을 위해 Tomcat 서버를 구성하십시오.
    1. 문서 편집기에서 tomcat_install_directory\conf\server.xml 파일을 여십시오.
    2. 다음 텍스트를 검색하십시오.
      <!--
      <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
      -->
    3. <Valve> 요소의 주석 처리를 해제하십시오.
      <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
    4. Tomcat을 서비스로서 실행하지 않는 경우에는 문서 편집기에서 startup.bat 파일(Microsoft Window의 경우) 또는 startup.sh 파일(Linux의 경우)을 여십시오. 파일에 다음 행을 추가하십시오. Microsoft Windows의 경우:
      SET JAVA_OPTS=" -Dorg.apache.catalina.authenticator.Constants.SSO_SESSION_COOKIE_NAME=JSSOSESSIONID"
      Linux의 경우:
      export JAVA_OPTS=" -Dorg.apache.catalina.authenticator.Constants.SSO_SESSION_COOKIE_NAME=JSSOSESSIONID"
    5. Tomcat을 서비스로서 실행 중이면 Tomcat을 서비스로서 설치하기 위해 사용하는 서비스 설치 명령에 --JvmOptions "-Xrs; -Dorg.apache.catalina.authenticator.Constants.SSO_SESSION_COOKIE_NAME=JSSOSESSIONID" 옵션을 추가하십시오.
  12. 설치 매체에서 archive_extract_location/apps/tomcat/RTC-server.zip 파일을 찾으십시오.
  13. 하드 디스크 드라이브의 위치(이 지시사항에서는 rtc_install_dir이라고 함)에 RTC-server.zip 압축을 푸십시오.
  14. 상황에 따라 Rational Team Concert를 설치하고 구성하거나 업데이트하십시오.
    • V7.1.1.1 이하에서 업그레이드하는 경우: 포함된 Rational Team Concert를 설치하고 구성하십시오. 15 단계로 진행하십시오.
    • V7.2 이상에서 업그레이드하는 경우: 포함된 Rational Team Concert를 업데이트하십시오. 32 단계로 진행하십시오.
  15. 상황에 따라 Rational Team Concert를 설치하고 구성하거나 구성하기만 하십시오.
    • Rational Team Concert를 설치하고 구성해야 하는 경우: 16단계로 진행하십시오.
    • 기존 Rational Team Concert 애플리케이션이 있고 Rational Asset Manager와 작동하도록 구성할 경우: 24단계로 진행하십시오.
  16. rtc_install_dir/jazz/server/ramjazz_war.ear 파일을 찾아 압축을 푸십시오. .ear 파일의 압축을 풀려면 7-Zip과 같은 무료 유틸리티를 사용할 수 있습니다. 추출된 ramjazz_war.ear 패키지에서 ramjazz.war 파일을 tomcat_for_rtc_install_directory/webapps/ 디렉토리에 복사하십시오.
  17. Rational Team Concert용 Tomcat 서버에서 보안 포트를 구성하십시오.
    1. SSL 연결을 위해 Rational Team Concert용 Tomcat 서버를 식별하는 보안 인증서를 작성하십시오. Java™ JDK keytool 명령을 사용하여 자체 서명된 인증서를 작성할 수 있습니다. 또는 신뢰할 수 있는 인증 기관이 서명한 인증서를 요청할 수 있습니다.
      keytool 명령을 사용하여 자체 서명된 인증서를 작성하는 방법에 대한 자세한 정보는 Oracle Java 문서를 참조하십시오. 다음 예제 keytool 명령을 사용하여 자체 서명된 인증서를 작성할 수 있습니다.
      keytool -genkey -alias tomcat -keystore tomcat_for_rtc_install_directory/.keystore

      해당 명령을 실행하면 키 저장소 파일의 비밀번호를 입력하도록 프롬프트가 표시됩니다. 기본 비밀번호는 changeit이지만 다른 비밀번호를 지정해야 합니다. 해당 비밀번호를 기억했다가 나중에 server.xml 파일에 입력해야 합니다.

      IBM JRE를 사용 중인 경우, 다수 버전에서 IBM_Java_JRE_install_location/jre/bin/ 디렉토리에 IBM 도구 ikeyman이 포함되어 있습니다. 이 도구를 사용하여 서버에서 보안 인증서를 작성하고 관리할 수 있습니다. iKeyman 도구 사용에 대한 자세한 정보는 iKeyman 사용자 안내서를 참조하십시오.

      여기서는 rtc_install_dir/jazz/server/ 폴더에 단순 인증서도 포함시킵니다. 인증서 파일은 ibm-team-ssl.keystore입니다.

    2. tomcat_for_rtc_install_directory\conf\server.xml 파일에서 scheme="https" 속성을 가진 <Connector> 태그를 찾으십시오. 기본 파일은 포트 8443에 대한 예제 <Connector> 태그(주석 처리됨)를 포함합니다.
    3. 다음 텍스트를 복사하여 붙여넣으십시오.
      <Connector port="8443"
           maxHttpHeaderSize="8192" 
           maxThreads="150"
           minSpareThreads="25" 
           maxSpareThreads="75"
           enableLookups="false"
           disableUploadTimeout="true"
           connectionTimeout="20000"
           acceptCount="100"
           scheme="https"
           secure="true" 
           clientAuth="false"
           keystoreFile="keystore_file"
           keystorePass="keystore_password"
           sslProtocol="keystore_protocol"
           algorithm="keystore_algorithm"
           URIEncoding="UTF-8"
      />
      여기서,
      • keystore_file은 키 저장소 파일의 파일 이름입니다. Tomcat 서버 루트 디렉토리(tomcat_for_rtc_install_directory)로부터의 상대 경로 또는 절대 경로입니다. 위에서 단순 명령을 사용한 경우, .keystore입니다. 포함된 인증서를 사용하는 경우, rtc_install_dir/jazz/server/ibm-team-ssl.keystore입니다.
      • keystore_password는 키 저장소 파일의 비밀번호입니다. 포함된 키 저장소 파일을 사용하는 경우, ibm-team입니다.
      • keystore_protocol은 키 저장소 프로토콜입니다. 대부분 TLS 또는 SSL_TLS입니다. 포함된 키 저장소 파일을 사용하는 경우, SSL_TLS입니다.
      • keystore_algorithm은 키 저장소의 X509 알고리즘입니다. 인증서 소스에 따라 대부분 SunX509 또는 IbmX509입니다. 포함된 키 저장소 파일을 사용하는 경우, IbmX509입니다.
    4. 비SSL 커넥터에 8443 이외의 포트(기본적으로 포트 8080)를 사용하도록 port 값을 변경할 수 있습니다. 포트 값을 변경하는 경우, SSL 커넥터의 포트 번호와 일치하도록 redirectPort 속성 값을 변경하십시오.

    Tomcat의 SSL 구성에 대한 자세한 정보는 Apache Tomcat 7 SSL 구성 방법Apache Tomcat 구성 참조서를 참조하십시오.

  18. Oracle의 경우: Microsoft SQL Server의 경우: 데이터베이스 제공자로부터 해당 .jar 파일을 복사하십시오.
    • Oracle의 경우: ojdbc6.jar 파일을 rtc_install_dir/jazz/server/oracle 폴더에 복사하십시오(oracle 폴더 작성이 필요할 수 있음).

      Oracle에서 이 파일을 다운로드할 수 있습니다.

    • Microsoft SQL Server의 경우: 다음 파일을 rtc_install_dir/jazz/server/sqlserver 폴더에 복사하십시오(sqlserver 폴더를 작성해야 할 수도 있음).
      • sqljdbc4.jar(Microsoft에서 이 파일을 다운로드할 수 있습니다.)
  19. Tomcat 시작 특성 설정을 구성하십시오.
    1. Tomcat 시작 파일을 찾아 문서 편집기에서 여십시오. Windows에서 이 파일은 tomcat_for_rtc_install_directory\bin\startup.bat입니다. Linux, AIX 또는 zSeries용 Linux에서 이 파일은 tomcat_for_rtc_install_directory/bin/startup.sh입니다.
    2. 시작 파일에서 다음 텍스트를 입력하십시오.
      • Windows의
경우: rtc_install_dir의 각 공백 문자를 %20으로 바꾸십시오.
        set ORACLE_JDBC=oracle_jar_dir
        set SQLSERVER_JDBC=sqlServer_jar_dir
        set JAZZ_INSTALL_DIR=rtc_install_dir
        set JAVA_OPTS=-Djava.awt.headless=true -Djava.library.path="tomcat_for_rtc_install_directory\shared\lib" -DSQLSERVER_JDBC="%SQLSERVER_JDBC%" -DORACLE_JDBC="%ORACLE_JDBC%" -DDB2I_JDBC="%DB2I_JDBC%" -DDB2Z_JDBC="%DB2Z_JDBC%" -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -DJAZZ_HOME=file:///%JAZZ_INSTALL_DIR%\jazz\server\conf -Dcom.ibm.team.repository.tempDir=%TEMP% -Xmx700M
      • Linux의 경우: AIX의 경우: Linux for zSeries의 경우:
        ORACLE_JDBC=oracle_jar_dir
        SQLSERVER_JDBC=sqlServer_jar_dir
        JAZZ_INSTALL_DIR=rtc_install_dir
        export JAVA_OPTS="-Djava.awt.headless=true -Djava.library.path=tomcat_for_rtc_install_directory/shared/lib -DSQLSERVER_JDBC=$SQLSERVER_JDBC -DORACLE_JDBC=$ORACLE_JDBC -DDB2I_JDBC=$DB2I_JDBC -DDB2Z_JDBC=$DB2Z_JDBC -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -DJAZZ_HOME=file://"$JAZZ_INSTALL_DIR"/jazz/server/conf -Dcom.ibm.team.repository.tempDir=$TEMP_DIR -Xmx700M"
      여기서,
      • rtc_install_dirRTC-server.zip 파일의 압축을 푼 디렉토리입니다. Windows에서는 rtc_install_dir의 각 공백 문자를 %20으로 바꾸십시오.
      • Oracle의 경우: oracle_jar_dirojdbc6.jar 파일의 디렉토리입니다(rtc_install_dir/jazz/server/oracle).
      • Microsoft SQL Server의 경우: sqlServer_jar_dirsqljdbc4.jar 파일의 디렉토리입니다(rtc_install_dir/jazz/server/sqlserver).
      • tomcat_for_rtc_install_directory는 Tomcat 서버 설치 디렉토리입니다.
      • Windows의
경우: Linux의 경우: AIX의 경우: Rational Asset ManagerRational Team Concert를 동일한 애플리케이션 서버에 설치하는 경우 이 JAVA_OPTS 시스템 변수를 사용하여 Rational Asset Manager용 Tomcat 서버의 시작 스크립트를 구성할 때 작성한 경로를 바꾸십시오. 이 선언에는 -Djava.library.path 옵션이 여전히 포함됩니다.
  20. 해당 Jazz™ 서버 특성 파일을 찾아 이름을 바꾸십시오.
    1. rtc_install_dir/jazz/server/conf/ramjazz/ 디렉토리에서 teamserver.properties 파일을 찾아 teamserver.derby.properties로 이름을 바꾸십시오.
    2. 데이터베이스 서버의 해당 파일을 찾으십시오.
      • DB2의 경우: Windows의
경우: Windows의 DB2의 경우: teamserver.db2.win32.properties
      • DB2의 경우: Linux의 경우: AIX의 경우: Linux for zSeries의 경우: DB2 on Linux, AIX 또는 Linux for zSeries의 경우: teamserver.db2.linux.properties
      • Oracle의 경우: teamserver.oracle.properties
      • SQL Server의 경우: teamserver.sqlserver.properties
    3. 파일 이름을 teamserver.properties로 바꾸십시오.
  21. 문서 편집기에서 teamserver.properties 파일을 열고 다음과 같이 수정하십시오(사용자의 데이터베이스 제공자에 해당하는).
    • DB2의 경우:
      1. 다음 행을 찾으십시오.
        com.ibm.team.repository.db.vendor = DB2
        com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:user=db2admin;password={password};
        com.ibm.team.repository.db.jdbc.password=db2admin
      2. DB2 서버 위치 및 라이프사이클 데이터베이스 이름에 대한 com.ibm.team.repository.db.jdbc.location 값을 편집하십시오.
        1. localhost:50000을 DB2 데이터베이스의 위치 및 포트로 바꾸십시오.
          팁: DB2 명령 창에서 db2 get dbm cfg를 입력하고 DB2 포트 이름 또는 번호를 표시하는 SVCENAME이 포함된 행을 찾으십시오. 이 명령이 번호를 표시하는 경우, 이전 예제의 50000 위치에서 이를 포트 번호로 사용하십시오. 이 명령이 숫자가 아닌 이름을 리턴하는 경우, 이 이름에 지정된 포트 번호를 판별하고 해당 포트 번호를 사용하십시오. Linux에서는 /etc/services 파일이 포트 이름과 번호 간의 맵핑을 포함합니다. Windows에서는 C:\windows\system32\drivers\etc\services 파일이 맵핑을 포함합니다. 자세한 정보는 데이터베이스 관리자에게 문의하거나 데이터베이스 문서를 참조하십시오.
        2. JAZZ를 라이프사이클 데이터베이스 이름으로 바꾸십시오.
        3. db2admin을 DB2 데이터베이스의 사용자 이름으로 바꾸십시오.
          참고: DB2 사용자에게는 테이블, 테이블스페이스 작성 권한과 데이터베이스 구성 수정 권한이 있어야 합니다. DB2 사용자는 운영 체제에서 작성합니다.
      3. com.ibm.team.repository.db.jdbc.password 특성에서 사용자 비밀번호를 지정하십시오.
        참고: com.ibm.team.repository.db.jdbc.location 특성의 password={password} 텍스트를 변경하지 마십시오.
      4. teamserver.properties 파일에서 다음 특성을 추가하십시오.
        여기서,
        • unsecure_port는 Tomcat 서버의 비보안 포트(기본적으로 8080)입니다.
        • secure_port는 Tomcat 서버의 보안 포트 번호(기본적으로 8443)입니다.
        • team_temp_dir은 임시 파일을 저장할 디렉토리의 절대 경로입니다.
        com.ibm.team.scm.tmpdir=team_temp_dir
        com.ibm.team.repository.server.repourl.port.http=unsecure_port
        com.ibm.team.repository.user.registry.type=UNSUPPORTED
        com.ibm.team.repository.ws.allow.admin.access=false
        com.ibm.team.repository.server.repourl.port.https=secure_port
    • Oracle의 경우:
      1. 다음 행을 찾으십시오.
        com.ibm.team.repository.db.vendor = ORACLE
        com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/ORCL
        com.ibm.team.repository.db.jdbc.password=jazzDBpswd
      2. Oracle 서버 위치 및 라이프사이클 데이터베이스 이름에 대한 com.ibm.team.repository.db.jdbc.location 값을 편집하십시오.
        1. jazzDBUser를 Oracle 데이터베이스의 사용자 이름(예: RAMSCHEMA)으로 바꾸십시오.
        2. @localhost:1521을 Oracle 데이터베이스의 위치 및 포트로 바꾸십시오. 이 위치가 localhost가 아니면, 위치 앞에 두 개의 슬래시(//)를 두어야 합니다(예: @//oracleserver.example.com:1521).
        3. ORCL을 라이프사이클 데이터베이스 이름(예: rtcdb)으로 바꾸십시오.
      3. com.ibm.team.repository.db.jdbc.password 특성에서 JazzDBpswd를 앞서 지정한 Oracle 사용자의 비밀번호로 바꾸십시오.
        참고: com.ibm.team.repository.db.jdbc.location 특성의 {password} 텍스트를 변경하지 마십시오.
      4. teamserver.properties 파일에서 다음 특성을 추가하십시오.
        여기서,
        • unsecure_port는 Tomcat 서버의 비보안 포트(기본적으로 8080)입니다.
        • secure_port는 Tomcat 서버의 보안 포트 번호(기본적으로 8443)입니다.
        • team_temp_dir은 임시 파일을 저장할 디렉토리의 절대 경로입니다.
        com.ibm.team.scm.tmpdir=team_temp_dir
        com.ibm.team.repository.server.repourl.port.http=unsecure_port
        com.ibm.team.repository.user.registry.type=UNSUPPORTED
        com.ibm.team.repository.ws.allow.admin.access=false
        com.ibm.team.repository.server.repourl.port.https=secure_port
      5. Oracle 11을 사용 중인 경우, teamserver.properties 파일에서 다음 특성을 추가하십시오.
        com.ibm.team.repository.db.override.versioncheck=true
    • Microsoft SQL Server의 경우:
      1. 다음 행을 찾으십시오.
        com.ibm.team.repository.db.vendor = SQLSERVER
        com.ibm.team.repository.db.jdbc.location=//localhost:1433;databaseName=jazz;user=jazzDBuser;password={password}
        com.ibm.team.repository.db.jdbc.password=jazzDBpswd
      2. SQL Server 위치 및 라이프사이클 데이터베이스 이름에 대한 com.ibm.team.repository.db.jdbc.location 값을 편집하십시오.
        1. @localhost:1433을 SQL Server 데이터베이스의 위치 및 포트로 바꾸십시오.
        2. jazz를 라이프사이클 데이터베이스 이름(예: RTCDB)으로 바꾸십시오.
        3. jazzDBUser를 SQL Server 데이터베이스의 사용자 이름으로 바꾸십시오.
      3. com.ibm.team.repository.db.jdbc.password 특성에서 JazzDBpswd를 앞서 지정한 SQL Server 사용자의 비밀번호로 바꾸십시오.
        참고: com.ibm.team.repository.db.jdbc.location 특성의 {password} 텍스트를 변경하지 마십시오.
      4. teamserver.properties 파일에서 다음 특성을 추가하십시오.
        여기서,
        • unsecure_port는 Tomcat 서버의 비보안 포트(기본적으로 8080)입니다.
        • secure_port는 Tomcat 서버의 보안 포트 번호(기본적으로 8443)입니다.
        • team_temp_dir은 임시 파일을 저장할 디렉토리의 절대 경로입니다.
        com.ibm.team.scm.tmpdir=team_temp_dir
        com.ibm.team.repository.server.repourl.port.http=unsecure_port
        com.ibm.team.repository.user.registry.type=UNSUPPORTED
        com.ibm.team.repository.ws.allow.admin.access=false
        com.ibm.team.repository.server.repourl.port.https=secure_port
  22. Rational Team Concert 테이블을 작성하십시오.
    1. 명령행 창을 열고 rtc_install_dir/jazz/server/ 디렉토리로 이동하십시오.
    2. 다음 명령을 입력하십시오.
      • Windows의
경우:
        repotools.bat -createTables teamserver.properties=conf\jazz\teamserver.properties
      • Linux의 경우: AIX의 경우: Linux for zSeries의 경우:
        ./repotools.sh -createTables teamserver.properties=conf/jazz/teamserver.properties
  23. 포함된 Rational Team Concert에 대한 사용자 권한 부여를 구성하십시오.
    • 파일 기반 보안의 경우:
      1. 문서 편집기에서 tomcat_for_rtc_install_directory\conf\tomcat-users.xml 파일을 여십시오.
      2. <tomcat-users> 태그 사이에 다음 텍스트를 붙여넣으십시오.
        <role rolename="JazzUsers"/>
        <role rolename="JazzAdmins"/>
        <role rolename="JazzDWAdmins"/>
        <role rolename="JazzGuests"/>
      3. admin이라는 사용자를 추가하고 해당 사용자에게 admin, manager 및 JazzAdmins 역할을 지정하십시오. 이 사용자를 추가하려면 다음 텍스트를 복사하여 <tomcat-users> 태그 사이에 붙여넣으십시오.
        <user username="admin" password="" roles="admin,manager,JazzAdmins" />

        동일한 Tomcat 서버에 애플리케이션을 설치하는 경우, 기존 admin 사용자에게 JazzAdmins 역할을 추가하십시오.

    • LDAP 인증의 경우: LDAP 인증을 위해 Tomcat 서버를 구성한 후 앞서 언급한 네 개 역할과 동일한 이름으로 네 개의 LDAP 그룹을 구성하십시오. 또는 기술 팁 TN0030: Tomcat에서 사용자 관리에 설명된 대로 기존 LDAP 그룹을 Jazz 서버 역할과 연관시킬 수 있습니다. LDAP을 사용하도록 Tomcat에서 Rational Team Concert 구성 주제 섹션의 2 - 3단계를 따르십시오.
  24. Rational Team Concert용 Tomcat 서버를 시작하십시오. Tomcat을 시작하려면 다음 파일을 실행하십시오.
    • Windows의
경우: tomcat_for_rtc_install_directory\bin\startup.bat
    • Linux의 경우: AIX의 경우: Linux for zSeries의 경우: tomcat_for_rtc_install_directory/bin/startup.sh
  25. 웹 브라우저에서 Rational Team Concert의 관리 웹 인터페이스(https://machine_name:secure_port/jazz/admin/)를 실행하십시오. https에 유의하십시오. 보안 연결이어야 합니다.
  26. Rational Team Concert 관리자의 사용자 ID와 비밀번호를 사용하여 로그인하십시오. 전에 아무도 Rational Team Concert에 로그인한 적이 없으면, 애플리케이션 서버 관리자의 사용자 ID와 비밀번호를 사용하십시오.
  27. Rational Team Concert를 새로 설치하여 작업하는 경우, Rational Team Concert의 관리 사용자를 구성하십시오.
    1. "서버 상태 정보 페치"에 대한 오류가 표시되면, 시스템을 종료하고 데이터베이스 서버와 애플리케이션 서버를 둘 다 다시 시작한 후 다시 로그인하십시오.
    2. Rational Team Concert 관리 웹 인터페이스에서 사용자 관리를 클릭하십시오. 구성되지 않는 외부 레지스트리에 대한 오류는 무시하십시오.
    3. 사용자 작성을 클릭하십시오.
    4. 다음 세부사항을 입력하십시오.
      1. 사용자 이름: 애플리케이션 서버 관리자의 사용자 ID
      2. 사용자 ID: 애플리케이션 서버 관리자의 사용자 ID
      3. 이메일 주소: 애플리케이션 서버 관리자의 올바른 이메일 주소
    5. 클라이언트 액세스 라이센스 섹션에서 Rational Team Concert - Developer를 선택하여 해당 사용자에게 개발자 라이센스를 지정하십시오.
    6. 저장을 클릭하십시오.
    7. 로그아웃한 후 애플리케이션 서버 관리자로 관리 웹 인터페이스에 다시 로그인하십시오.
  28. Rational Team Concert로 라이프사이클 프로세스 템플리트를 가져오십시오.
    1. Rational Team Concert 관리 웹 인터페이스에서 프로세스 템플리트 관리를 클릭하십시오. 프로세스 템플리트 관리 링크가 표시되지 않으면 로그아웃한 후 관리 웹 인터페이스에 다시 로그인하십시오.
    2. 템플리트 가져오기를 클릭하고 archive_extract_location/DatabaseScripts/ 폴더에서 com.ibm.ram.lifecycle.zip 파일을 찾아보십시오. 그런 다음, 확인을 클릭하십시오. RAM 라이프사이클 템플리트가 표시됩니다.
  29. Rational Team Concert에 프로젝트 영역을 작성하십시오.
    1. Rational Team Concert 관리 웹 인터페이스에서 프로젝트 영역 관리를 클릭하십시오. 프로젝트 영역 관리 링크가 표시되지 않으면 로그아웃한 후 관리 웹 인터페이스에 다시 로그인하십시오.
    2. 프로젝트 영역 작성을 클릭하십시오.
    3. 프로젝트 영역에 대한 다음 세부사항을 입력하십시오.
      • 프로젝트 이름: RAM Lifecycle
      • 요약: Rational Asset Manager Lifecycle control project area
      • 설명: This area is used to manage the lifecycles for Rational Asset Manager
    4. 저장을 클릭하십시오.
  30. 프로젝트 영역에 해당 멤버십과 프로세스 역할을 지정하십시오.
    1. 프로젝트 영역 관리 페이지에서 RAM 라이프사이클 프로젝트 영역을 클릭하십시오.
    2. 관리 섹션에서 추가를 클릭하십시오. 작성한 관리자를 검색하여 선택하십시오. 기존 Rational Team Concert 애플리케이션으로 작업하는 경우, 이 프로젝트 영역의 관리자가 될 다른 사용자도 선택할 수 있습니다.
    3. 구성원 섹션에서 추가를 클릭한 후 프로젝트 영역의 관리자로 선택한 동일한 사용자를 검색하여 선택하십시오.
    4. 관리자를 추가한 후 관리자 이름 옆의 프로세스 역할 아이콘을 클릭하십시오.
    5. 프로세스 역할 편집 창의 사용 가능한 역할 목록에서 관리를 선택하고 추가를 클릭하십시오.
    6. 완료를 클릭하십시오.
    7. 저장을 클릭하십시오.
  31. V7.1.1.1 이하에서 업그레이드하는 경우: 33단계로 진행하십시오.
  32. V7.2 이상에서 업그레이드하는 경우, 포함된 Rational Team Concert를 업그레이드하십시오.
    1. 설치 매체에서 하드 디스크 드라이브의 새 위치(이 지시사항에서는 new_rtc_install_dir임)에 RTC-Server.zip 파일의 압축을 푸십시오.
    2. 이전 rtc_install_dir/jazz/server/conf/jazz/ 폴더에서 teamserver.properties 파일을 새 new_rtc_install_dir/jazz/server/conf/jazz/ 폴더에 복사하십시오.

      Tomcat 시작 파일에서 기존 rtc_install_dir 위치를 찾을 수 있습니다. 시작 파일에서 JAZZ_INSTALL_DIR=이 포함된 행을 검색하십시오. JAZZ_INSTALL_DIR 변수 값은 현재 Rational Team Concert 파일의 위치입니다.

    3. Tomcat 시작 파일을 찾아 문서 편집기에서 여십시오. Windows에서 이 파일은 tomcat_for_rtc_install_directory\bin\startup.bat입니다. Linux, AIX 또는 zSeries용 Linux에서 이 파일은 tomcat_for_rtc_install_directory/bin/startup.sh입니다.
    4. 시작 파일에서 JAZZ_INSTALL_DIR=이 포함된 행을 검색하십시오. 다음에 따라 값을 편집하십시오(여기서 new_rtc_install_dir32.a단계에서 압축을 푼 디렉토리임).
      • Windows의
경우: (new_rtc_install_dir의 공백 문자를 %20으로 바꾸십시오.)
        set JAZZ_INSTALL_DIR=new_rtc_install_dir
      • Linux의 경우: AIX의 경우: Linux for zSeries의 경우: :
        JAZZ_INSTALL_DIR=new_rtc_install_dir
    5. Tomcat 서버를 시작하십시오.
    6. 웹 브라우저에서 https://host:secure_port/jazz/admin?internal URL을 입력하십시오. 여기서 host는 IP 주소 또는 서버 이름이고 secure_port는 Tomcat 서버의 보안 포트입니다.
    7. 애플리케이션 서버 관리자로 로그온하십시오.
    8. 사이드바의 내부 도구 아래에서 서버 재설정을 클릭하십시오.
    9. 서버 재설정 요청을 클릭하십시오.
    10. Tomcat 서버를 중지한 후 다시 시작하십시오. 포함된 Rational Team Concert 애플리케이션이 업데이트됩니다.
  33. Rational Asset Manager용 Tomcat 서버를 중지하십시오.
  34. Tomcat에 설치된 이전 Rational Asset Manager .war 웹 애플리케이션 파일을 제거하십시오.
    1. tomcat_install_directory/webapps/ 디렉토리로 이동하십시오.
    2. Rational Asset Manager 웹 애플리케이션의 폴더와 파일 이름을 적어두십시오. 이전 버전의 Rational Asset Manager에서는 해당 폴더(즉, 애플리케이션의 컨텍스트 경로)용으로 다음 이름이 제안되었습니다.
      • /com.ibm.ram.repository.web.tomcat_runtime
      • /com.ibm.ram.repository.web.ws.tomcat_runtime
      • /help/
      • /abdprocess/
    3. 다음 애플리케이션 파일을 삭제하십시오.
      • com.ibm.ram.repository.web.tomcat_runtime.war
      • com.ibm.ram.repository.web.ws.tomcat_runtime.war
      • ramhelp.war
      • rmcabdgovernprocess.war
      서버에 애플리케이션을 설치한 방법에 따라 파일 이름이 목록에 있는 이름과 다를 수 있습니다.
    4. 해당 애플리케이션의 연관된 폴더를 삭제하십시오.
  35. archive_extract_location/apps/tomcat/ 디렉토리에서 다음 파일을 tomcat_install_directory/webapps/ 디렉토리에 복사하십시오.
    • com.ibm.ram.repository.web.tomcat_runtime.war
    • com.ibm.ram.repository.web.ws.tomcat_runtime.war
    • ramhelp.war
    • rmcabdgovernprocess.war
  36. 애플리케이션의 컨텍스트 경로를 변경하려면 WAR 애플리케이션 파일의 이름을 바꾸십시오. 이전과 동일한 컨텍스트 경로를 사용하십시오. 새 설치의 경우 파일 이름과 컨텍스트 경로는 다음과 같습니다.
    표 1. Rational Asset Manager 웹 애플리케이션 파일의 컨텍스트 경로
    원래 파일 이름 새 파일 이름 결과 컨텍스트 경로 설명
    com.ibm.ram.repository.web.tomcat_runtime.war ram.war ram Tomcat용 Rational Asset Manager 기본 웹 애플리케이션
    com.ibm.ram.repository.web.ws.tomcat_runtime.war ram.ws.war ram.ws Tomcat용 Rational Asset Manager 웹 서비스 애플리케이션
    ramhelp.war ram.help.war ram.help Rational Asset Manager 도움말 및 사용자 지원 애플리케이션
    rmcabdgovernprocess.war ram.process.war ram.process 자산 기반 배치 및 관리 프로세스용 문서 애플리케이션
  37. Tomcat 서버의 캐시를 지우십시오. tomcat_install_directory/work/ 디렉토리를 삭제하십시오.
  38. Rational Asset Manager용 Tomcat 서버를 다시 시작하십시오.
  39. Rational Asset Manager 저장소를 최신 버전으로 마이그레이션하십시오.
    1. 웹 브라우저에서 Rational Asset Manager 웹 클라이언트를 여십시오. 업그레이드 후 웹 클라이언트를 처음 열 때 저장소를 마이그레이션해야 함을 표시하는 메시지가 표시됩니다.
    2. 필요하면 저장소 관리자 권한을 가진 사용자 ID로 로그인하십시오.
      참고: SQL Server의 경우, 기존 Rational Asset Manager 데이터베이스에 데이터 정렬이 _BIN2로 끝나는 시퀀스(예: Latin1_General_BIN2)로 설정되어 있지 않으면 수동 구성 필요 페이지가 메시지와 함께 나타납니다. 데이터베이스를 다시 작성하고 Rational Asset Manager와 올바로 작동하도록 데이터 정렬 옵션을 대소문자 구분으로 설정하거나 예기치 않은 대소문자 구분 충돌이 발생할 수 있음을 허용할 수 있습니다.
    3. 마이그레이션을 클릭하십시오. 대형 저장소에서는 마이그레이션에 몇 분이 소요될 수 있습니다. 마이그레이션이 완료될 때까지 저장소에 대한 일부 정보를 사용할 수 없습니다.
    4. 마이그레이션 프로세스가 완료되면 을 클릭하십시오.
  40. V7.1.1.1 이하에서 업그레이드하는 경우: Rational Asset Manager에서 Rational Team Concert에 연결하도록 설정을 구성하십시오.
    1. Rational Asset Manager 웹 클라이언트에서 관리를 클릭하십시오.
    2. 구성을 클릭하십시오.
    3. 내부 Rational Team Concert 경로 섹션에서 다음 정보를 입력하십시오.
      1. 경로: 구성한 Rational Team Concert 서버의 보안 URL입니다(예: https://localhost:9443/ramccm). https 연결 및 보안 포트 번호에 유의하십시오.
      2. 사용자: Rational Team Concert에서 "RAM 라이프사이클" 프로젝트 영역의 관리자인 사용자의 사용자 이름입니다.
      3. 비밀번호: "RAM 라이프사이클" 프로젝트 영역의 관리자인 사용자의 비밀번호입니다.
      4. 제한시간: Rational Asset ManagerRational Team Concert에 연결할 수 있는 시간(초)입니다. 기본값은 120입니다.
  41. 옵션: 설치 시 사용한 것과 동일한 방법을 사용하여 Rational Asset Manager Eclipse 애플리케이션을 업데이트하십시오. Eclipse 클라이언트에 대한 자세한 정보는 Rational Asset Manager Eclipse 클라이언트 설치를 참조하십시오.
    참고: 최신 버전의 Rational Asset Manager Eclipse 클라이언트를 설치하기 전에 Rational Asset Manager Eclipse 클라이언트 플러그인을 설치 제거하십시오.

    Eclipse Update Manager를 사용하여 Rational Asset Manager Eclipse 클라이언트 플러그인을 설치한 경우, 최신 버전의 Rational Asset Manager를 설치하기 전에 Eclipse 구성 관리자를 사용하여 Rational Asset Manager로 이름 지정된 기능을 제거하십시오. Eclipse 구성 관리자를 사용하려면, Eclipse에서 도움말 > 소프트웨어 업데이트 > 구성 관리를 클릭하십시오.

다음에 수행할 작업

Rational Asset Manager 버전 7.5.1 이상의 경우, 내부 Rational Team Concert 서버의 URL이 https://host:port/jazz에서 https://host:port/ramjazz로 변경되었습니다. Rational Asset Manager 7.5.1 이전 릴리스에서 업그레이드하는 경우, URL 참조를 개정하고 변경해야 하는 사항을 사용자에게 알리십시오.

다음 위치에서 URL을 업데이트하십시오.
  • 이전 URL을 사용하는 Rational Team Concert Eclipse IDE 저장소 연결. 저장소 연결을 업데이트하려면 다음을 수행하십시오.
    1. 팀 아티팩트 보기를 여십시오.
    2. 저장소 연결을 펼치십시오.
    3. Rational Asset Manager 연결을 마우스 오른쪽 단추로 클릭하고 특성을 선택하십시오.
    4. Jazz 저장소 구성을 선택하십시오.
    5. URI 위치에서 URL을 http://host_name/ramjazz로 변경하십시오.
    6. 확인을 클릭하십시오.
  • 이전 URL을 사용하는 Rational Team Concert 서버의 고급 특성. 고급 특성을 업데이트하려면 다음을 수행하십시오.
    1. 개정된 URL(http://host_name/ramjazz/admin)을 입력하여 웹 브라우저에서 Rational Asset Manager를 여십시오.
    2. 서버 관리자로 로그온하십시오.
    3. 서버 > 구성 > 고급 특성을 클릭하십시오.
    4. 이전 URL을 포함하는 특성을 업데이트하십시오(예: com.ibm.ram.repository.service.internal.RepositoryRemoteService).
  • 웹 브라우저의 책갈피에 저장된 Rational Asset Manager 링크.

피드백