Tomcat에 포함된 Rational Team Concert 서버 애플리케이션 배치

IBM® Rational® Asset Manager에는 자산 개발을 관리하는 데 사용할 수 있는 라이프사이클 기능을 제어하는 IBM Rational Team Concert가 필요합니다. Rational Team Concert가 아직 없으면, Tomcat 서버에 배치할 수 있는 해당 제품의 제한된 버전이 포함됩니다.

시작하기 전에

Rational Team Concert 서버 애플리케이션을 이미 배치하여 구성한 경우, 새 애플리케이션을 설치하는 대신 기존 애플리케이션을 사용할 수 있습니다. Rational Asset Manager와 작동하도록 Rational Team Concert를 구성하려면 Rational Asset Manager와 작동하도록 Rational Team Concert 서버 구성을 참조하십시오.

설치되어 실행 중인 Tomcat 서버에 대한 관리 및 파일 액세스 권한이 있어야 합니다.

이 태스크를 수행하기 전에 다음 태스크를 완료하십시오.
  1. 애플리케이션 파일 검색
  2. 라이프사이클 데이터베이스 작성

Tomcat 서버에 대한 보안 인증서가 있어야 합니다. 포함된 버전의 Rational Team Concert에는 보안 연결이 필요합니다.

이 태스크 정보

웹 애플리케이션 및 포함된 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 서버에 모든 웹 애플리케이션을 설치하는 경우에는 디렉토리가 동일합니다.

프로시저

  1. 저장소 서버가 모두 동일한 현재 날짜, 시간 및 시간대로 설정되어 있는지 확인하십시오.
  2. Tomcat 및 해당 운영 체제에 적합한 아카이브에서 애플리케이션 파일을 검색하십시오. 애플리케이션 파일은 archive_extract_location/apps/tomcat/ 폴더에 있습니다.
  3. Windows의 경우: Linux의 경우: AIX의 경우: Rational Licensing Key Server V8.1.2의 라이브러리 파일을 tomcat_for_rtc_install_directory\shared\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_for_rtc_install_directory\shared\lib 디렉토리에 복사하십시오.
    Rational Asset ManagerRational Team Concert를 동일한 애플리케이션 서버에 설치하는 경우에는 이 단계를 이미 완료했습니다.
  4. 설치 매체에서 archive_extract_location/apps/tomcat/RTC-server.zip 파일을 찾으십시오.
  5. 하드 디스크 드라이브의 위치(이 지시사항에서는 rtc_install_dir이라고 함)에 RTC-server.zip 압축을 푸십시오.
  6. rtc_install_dir/jazz/server/ramjazz_war.ear 파일을 찾아 압축을 푸십시오. .ear 파일의 압축을 풀려면 7-Zip과 같은 무료 유틸리티를 사용할 수 있습니다. 추출된 ramjazz_war.ear 패키지에서 ramjazz.war 파일을 tomcat_for_rtc_install_directory/webapps/ 디렉토리에 복사하십시오.
  7. 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 구성 참조서를 참조하십시오.

  8. 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에서 이 파일을 다운로드할 수 있습니다.)
  9. 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 옵션이 여전히 포함됩니다.
  10. 해당 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로 바꾸십시오.
  11. 문서 편집기에서 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
  12. 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
  13. 사용자 보안을 위해 Tomcat 서버를 구성하십시오. LDAP 보안을 사용하려면, 먼저 파일 기반 보안을 사용하여 애플리케이션을 구성하고 애플리케이션을 구성한 후 LDAP 인증으로 전환하십시오. 자세한 정보는 Tomcat에 대한 LDAP 인증 구성을 참조하십시오.
    1. 문서 편집기에서 tomcat_for_rtc_install_directory\conf\tomcat-users.xml 파일을 여십시오. 다시, 동일한 Tomcat 서버에 애플리케이션을 설치하는 경우 이 파일은 Rational Asset Manager 애플리케이션의 사용자 보안 설정을 수정한 것과 동일한 파일입니다.
    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 서버에 애플리케이션을 설치하는 경우, Rational Asset Manager 애플리케이션의 사용자 보안 설정을 수정할 때 작성한 사용자에게 JazzAdmins 역할을 추가하십시오.

  14. 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
  15. Rational Asset Manager와 작동하도록 Rational Team Concert를 구성하십시오. 관리 권한을 구성하고 Rational Team Concert에 프로젝트 영역을 작성해야 합니다.

피드백