이 주제에서는
WebSphere® Application Server와 함께 작업하도록
Jazz™ Team Server를 설정하는 방법에 대해
설명합니다. 이 설정에서는
Jazz Team Server를
Websphere Application Server와 동일한 시스템에 설치하는 중이라고 가정합니다.
시작하기 전에
이 단계를 시작하기 전에 다음이 완료되어 있어야 합니다.
- WebSphere Application Server가
이미 설치되어 있습니다.
- 데이터베이스가 작성되고 teamserver.properties 파일이
데이터베이스 설정으로 업데이트되었습니다.
- 대소문자 구분 없는 로그인 사용(선택사항): 애플리케이션 서버 인증 방법에서
대소문자 구분 없는 로그인을 허용하는 경우에는
Jazz 애플리케이션에서도 해당 로그인을 허용하도록 할 수 있습니다. 대소문자 구분 없는 로그인을
허용하려면 관리 웹 UI의 고급 특성 페이지에서 "대소문자 구분 없는
사용자 ID 일치 사용" 특성을 사용하면 됩니다. 기본값은 변경되지 않습니다.
대소문자 구분 없는 로그인을 사용하려면 관리자가 이 특성을 명시적으로
대체해야 합니다.
- Java™ 2 보안 옵션을 꺼야 합니다.
WebSphere Application Server에서 이 옵션을 켜면
Jazz Team Server .war가 시작하지 않습니다.
- WAS 보안 설정 "비보호 URI에 액세스하는 경우 사용 가능한 인증 데이터 사용"이 선택되어 있는지 확인하십시오.
이를 위해서는 WAS Integrated Solutions Console을 사용하는 경우 다음과 같이 하십시오.
- 보안 -> 관리, 애플리케이션 및
인프라스트럭처 보안 -> 웹 보안 - 일반 설정으로 이동하십시오.
- "비보호 URI에 액세스하는 경우 사용 가능한 인증 데이터 사용" 선택란을 선택하십시오.
- Jazz Team Server에는 전체 Apache Tomcat 기반 서버를 실행하는 데
필요한 파일이 포함되어 있습니다. WebSphere 설치에서는
Jazz Team Server 파일 서브세트만 필요하며
이 파일 서브세트를 WebSphere 서버 시스템의 디렉토리에 넣어야 합니다. 향후 지시사항에서는 이 디렉토리를
Jazz Team Server 설치 디렉토리라고 하거나 축약하여
JazzInstallDir이라고 합니다. 이 디렉토리에서는 다음을 사용합니다.
- JazzInstallDir/server/tomcat/webapps/jazz.war 파일
- JazzInstallDir/server/update-site 디렉토리
- JazzInstallDir/server/conf 디렉토리
- JazzInstallDir/repositoryDB의 기본 저장소 데이터베이스
- JazzInstallDir/repotools의 저장소 도구
- JazzInstallDirserver/license-update-site 디렉토리
- JazzInstallDir/server/nl1-update-site 디렉토리
- JazzInstallDir/server/nl2-update-site 디렉토리
팁: IBM® Installation
Manager를 사용하는 경우에는 Jazz Team Server 파일을
웹 애플리케이션 디렉토리에 설치할 수 있습니다. 설치 프로세스 중에는
포함된 Apache Tomcat 애플리케이션 서버를 설치할 수 없습니다.
이 애플리케이션 서버를 설치하면 Installation Manager가 웹 애플리케이션 디렉토리를
찾아서 WebSphere에 필요한 파일만 설치하게 됩니다.
기본 디렉토리는 C:\Program Files\IBM\JazzTeamServer(Windows®의 경우) 또는
/opt/IBM/JazzTeamServer(Linux®의 경우)입니다.
이 프로시저에서 설치 디렉토리는 JazzInstallDir입니다. IBM Installation Manager를 사용하여
파일을 WebSphere Application Server
웹 애플리케이션 디렉토리에 설치하는 경우에는 위의 설명과 같이 파일을
수동으로 이동할 필요가 없습니다.
이 태스크 정보
주: 이 문서에서는 복잡한 주제일 수 있는
WebSphere 인증 또는 SSL 구성에 대해서는 설명하지
않습니다. WebSphere에 대한 다양한 인증 및 암호화 옵션에 대한
자세한 정보는 WebSphere Information Center에 있습니다. 자세한 정보를 보려면
WebSphere Information Center로 이동하여
애플리케이션 및 해당 환경 보안을 검색하십시오.
Jazz 웹 UI의 경우 권한을 부여하고 애플리케이션을 개인에 맞게 설정하려면
인증을 구성해야 합니다.
- teamserver.properties 파일의 데이터베이스 위치를 검토하고 업데이트하십시오.
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
주: 이는 샘플
DB2 구성입니다. 데이터베이스 벤더(Oracle/MS-SQL)에 따라
teamserver.properties를 업데이트해야 합니다.
- WebSphere Application
Server 레벨을 확인하거나 업데이트하십시오.
Jazz Team Server에는 IBM Java SDK
1.5 SR5 이상의 Cumulative Fix가 적용된 WebSphere Application Server 버전 6.1 또는 7.0.0.7 이상이 설치된
WebSphere Application
Server 버전 7.0이 필요합니다. IBM Java SDK 1.5 SR6 SDK 업데이트는 http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24017492에
있습니다. WebSphere 6.1
및 GA IBM
Java SDK를 사용하는 경우
Jazz는
몇 번의 오퍼레이션을 수행한 후 "프록시 오류"를 보고하기
시작합니다.
IBM Rational Team Concert™ 2.0이 올바르게 실행되는 데 필요한
IBM Java SDK
1.5 SR9 또는 IBM Java SDK
1.6 SR4의 수정사항에 해당하는 WebSphere Application
Server i-fix를 확보해야 합니다. 그렇지 않으면 서버의 일부 서비스가
올바르게 시작하지 않습니다. i-fix는 해당 WebSphere Application Server
APAR 아래에 있습니다. IBM Java SDK 1.5/WebSphere Application
Server 6.1의 경우 APAR는 PK85942이고 ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK85942/에서
파일을 다운로드할 수 있습니다. JRE i-fix를 설치하기 전에 WebSphere Application
Server 6.1 수정팩 19 이상을 설치하십시오. IBM Java SDK 1.6/WebSphere Application
Server 7.0의 경우 APAR는 PK 86771이고 ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK86771/에서
파일을 다운로드할 수 있습니다.
- JVM 인수 업데이트
Jazz Team Server의 경우 이 서버가 실행되는
Java Virtual Machine에 대한 일부 특정 설정이 요구됩니다.
일반 JVM 인수에 설정해야 하는 첫 번째 특성은 -Xmx 설정을 사용하는
기본 최대 메모리 할당입니다. 이 최대 메모리는
해당 서버 및 Jazz Team Server가 실행되는 서버의 메모리 용량에서 지원하는
팀의 크기에 따라 설정되어야 합니다. 일반적인 중간 크기 팀에서는 -Xmx1536M 값을 사용하여
Jazz Team Server 프로세스에 대해 1536MB의 힙 메모리를 제공합니다.
특히 Rational® Quality Manager의 경우 일반 JVM 인수에 설정해야 하는 두 번째 특성은
스레드 스택 크기입니다. Rational Quality Manager의 일반적인 스택 크기는
-Xss786K입니다.
Oracle 또는 SQL Server 데이터베이스에 연결하는 경우
"ORACLE_JDBC" 또는 "SQLSERVER_JDBC"라는 특성을 추가해야 합니다.
해당 jdbc 드라이버에 대한 절대 파일 경로(URL이 아님)로 특성을 설정하십시오.
다음 예제에서는 기본 최대 메모리 할당 및 스레드 스택 크기와 함께
Oracle 및 SQL Server 데이터베이스에 연결하기 위한 일반 JVM 인수를 보여 줍니다.
JazzInstallDir을
사용자 Jazz Team Server 설치 디렉토리로 대체하십시오.
-DORACLE_JDBC=JazzInstallDir\server\oracle -Xmx1536M -Xss768k
-DSQLSERVER_JDBC=JazzInstallDir\server\sqlserver -Xmx1536M -Xss768k
특정 서버 동작을 제어하도록 설정되어야 하는
기타 여러 가지 시스템 특성이 있습니다. 그러한 특성 중 몇 가지가 아래에 있습니다. 여기에는
WebSphere Administrative
Console의 JVM 특성을 설정하는 방법이 구체적으로 나와 있습니다. JazzInstallDir을
사용자 Jazz Team Server 설치 디렉토리로 대체하십시오.
- 를 클릭하십시오.
- server1을 클릭하십시오.
- 를 클릭하십시오.
- Java Virtual Machine을 클릭하십시오.
- 값 100을 초기 힙에 추가하십시오.
- 값 1000을 최대 힙 크기에 추가하십시오.
- 적용을 클릭하십시오.
- 로깅 및 추적을 클릭하십시오. 로그
세부사항 레벨 변경을 클릭하십시오. Jazz Team Server에서는
BIRT 보고 엔진을 사용합니다. BIRT 정보 항목이
WebSphere 로그 파일에 기록되지 않게 하려면 org.eclipse.birt.* 패키지의 로깅 레벨을
심각으로 설정하십시오. 적용을 클릭하십시오.
- 사용자 정의 특성을 클릭하십시오. 추가해야 하는 사용자 정의 특성 중 하나는 특정 구성 파일을 찾을 수 있는 위치를 지정하는 JAZZ_HOME
시스템 특성입니다. 이 특성은 단순 경로가 아닌 URL을 사용하므로
해당 값을 //-style URL 파일로 지정해야 합니다.
- 다음 특성을 추가하십시오. 새로 작성을 클릭하십시오.
이름 및 값을 입력한 후
확인을 클릭하십시오.
- 이름: java.awt.headless 값:
true
- 이름: org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin 값:
true
- 이름: JAZZ_HOME 값: 파일:///JazzInstallDir/server/conf
- 마스터 구성에 직접 저장을 클릭하십시오.
- Websphere를 다시 시작하여 Jazz Application을 설치하십시오.
다음 명령행 예제에서
WASInstallDir은
WebSphere Application Server가
사용자 서버에 설치된 위치를 나타냅니다.
- WebSphere Application
Server의 관리 콘솔을 여십시오.
- 를 클릭하십시오.
- 새 애플리케이션 경로에서
로컬 파일 시스템을 클릭하십시오.
- 전체 경로에서 다음을 입력하십시오.
JazzInstallDir/server/jazz.war
- 컨텍스트 루트를 /jazz로 설정하십시오.
- 다음을 클릭하고
나머지 새 애플리케이션 설치 단계를 계속 진행하십시오.
- 완료를 클릭하십시오.
- 마스터 구성에 직접 저장을 클릭하십시오.
- 을 클릭하십시오.
- jazz_war 옆의 상자를 선택한 후 시작을 클릭하십시오.
애플리케이션이 성공적으로 시작되었음을 표시하는
초록색 화살표가 표시되어야 합니다.
다음에 수행할 작업
Rational Team Concert 사용자인 경우
설정 마법사 실행 주제로 진행하십시오.
Rational Quality Manager의 경우에는
"Jazz Team Server 설정 마법사 실행" 주제로 진행하십시오.
이 주제에 대한 자세한 정보를 보려면
다음 링크를 방문하십시오.
http://jazz.net/library/techtip/95
https://jazz.net/wiki/bin/view/Main/WASSetupFAQ