이 주제에서는 WebSphere® Application Server와
함께 사용할 Jazz™ Team Server를
설정하는 방법을 설명합니다. 설정할 때 Jazz Team Server를
Websphere Application Server와 동일한 시스템에 설치한다고 가정합니다. 지침은
WebSphere Application Server 버전 6.1.0.23을
기준으로 합니다. 버전 7.0.0.7 이상에서는 약간의 변동이
있습니다. 이러한 변동 사항은 텍스트에 적절히 표시됩니다.
시작하기 전에
이 단계를 시작하기 전에 먼저 다음을
완료해야 합니다.
- WebSphere Application Server가
이미 설치되어 있습니다.
- 데이터베이스가 작성되고 teamserver.properties 파일이
데이터베이스 설정으로 업데이트되었습니다.
- 대소문자를 구분하지 않는 로그인 사용(선택사항): 애플리케이션 서버의
인증 방법이 대소문자를 구분하지 않는 로그인을 허용하면 Jazz
애플리케이션도 동일한 로그인을 수락하도록 설정할 수
있습니다. 대소문자를 구분하지 않는
로그인은 관리 웹 UI의 고급 특성 페이지에서 "대소문자 비구분 사용자
ID 일치 사용" 특성을 통해 설정합니다. 기본값이 변경되지 않습니다. 관리자가
대소문자를 구분하지 않는 로그인을 사용하도록 이 특성을 명시적으로 재정의해야 합니다.
- Java™ 2 보안 옵션은 설정 해제해야 합니다. WebSphere
Application Server에서 이 옵션이 켜져 있으면 Jazz Team Server .war이 시작되지
않습니다.
- WAS 보안 설정 "비보호 URI에 액세스할 때 인증 데이터
사용"을 선택했는지 확인하십시오. WAS 통합 솔루션 콘솔을
사용할 때는 다음에 따라 이 작업을 수행할 수 있습니다.
- 보안 -> 보안 관리, 애플리케이션 및
인프라 -> 웹 보안 - 일반 설정으로 이동하십시오. WAS 7.0.0.7에서는
보안 -> 글로벌 보안 -> 웹 및 SIP 보안 ->
일반 설정으로 이동하십시오.
- "비보호 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를 사용하여 Rational® Team Concert과 사용할 Jazz Team Server를 설치하면
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® 구성입니다. 데이터베이스 공급업체에 따라 teamserver.properties를
업데이트해야 합니다(Oracle/MS-SQL).
- WebSphere Application
Server 레벨을 확인하거나 업데이트하십시오.
Jazz Team Server에는
WebSphere Application Server
버전 6.1(IBM Java SDK
1.5 SR5 또는 이후 누적 수정사항 적용) 또는 WebSphere Application
Server 버전 7.0(최소 7.0.0.7 설치)이 필요합니다. 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는 실행되고 있는
JVM(Java Virtual
Machine)에서 몇 가지 특수한 설정이 필요합니다.
일반 JVM 인수에 설정해야 할 첫 번째 특성은 -Xmx 설정을 사용하는
기본 최대 메모리 할당입니다. 이 특성을 설정할 때는 서버에서 지원되는 팀의 크기와
Jazz Team Server가 실행되고 있는
서버의 메모리 용량에 기반해야 합니다. 중간 크기의 팀은 -Xmx1536M 값을 사용하는데, 그러면 Jazz Team Server
프로세스에 1536MB의 힙 메모리가 제공됩니다.
일반 JVM 인수, 특히 Rational Quality Manager에 대해
설정해야 할 두 번째 특성은 스레드 스택 크기입니다. 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
관리 콘솔에서 이러한 JVM 특성을 설정하는 구체적인 과정입니다. JazzInstallDir을
Jazz Team Server 설치 디렉토리로
대체하십시오.
- 를 클릭하십시오.
- server1을 클릭하십시오.
- 를 클릭하십시오.
- JVM(Java Virtual Machine)을 클릭하십시오.
- 초기 힙에 값 100을 추가하십시오.
- 최대 힙 크기에 값 1000을 추가하십시오.
- 적용을 클릭하십시오.
- 로깅 및 추적을 클릭하십시오. 로그 세부사항
레벨 변경을 클릭하십시오. Jazz Team Server는
BIRT 보고 엔진을 사용합니다. BIRT 정보 항목이 WebSphere
로그 파일에 기록되지 않게 하려면 org.eclipse.birt.* 패키지의 로깅 레벨을
심각으로 설정
하십시오. 적용을 클릭하십시오.
- 애플리케이션 서버 > {server_name} > 프로세스
정의 > JVM(Java Virtual Machine)
> 사용자 정의 특성을 클릭하십시오. 먼저 JAZZ_HOME이라는 사용자 정의 특성을 추가해야 합니다.
이 특성은 특정한 구성 파일의 위치를 지정하는 시스템
특성입니다. 이 특성은 단순 경로가 아닌 URL을 사용하므로
값을 file://-style URL로 지정해야 합니다.
- 다음 특성을 추가하십시오. 새로 작성을 클릭하십시오.
이름과 값을 입력하고
확인을 클릭하십시오.
- 이름: java.awt.headless 값: true
- 이름: org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin 값:
true
- 이름: JAZZ_HOME 값: file:///JazzInstallDir/server/conf
- 저장을 클릭하여 마스터 구성에
바로 저장하십시오.
중요사항: Solaris에서는
다음 Java 명령행 인수도 추가해야
합니다.
-XX:MaxPermSize=256m
자세한 정보는 Solaris 10 운영 체제 기반의
IBM WebSphere Application Server V6.1 레드북에서
2장 "WebSphere Application Server를 위한 Solaris 환경 구성"을 참조하십시오.
- Websphere를 다시 시작하여 Jazz 애플리케이션을 설치하십시오.
다음 명령행 예제에서
WASInstallDir은
서버에서 WebSphere Application Server를 설치한 위치를
나타냅니다.
- WebSphere Application Server의 관리 콘솔을 여십시오.
- 를 클릭하십시오. WebSphere Application Server
7.0.0.7 이상에서는 을 클릭하십시오.
- 새 애플리케이션 경로 아래에서
로컬 파일 시스템을 클릭하십시오.
- 전체 경로에 다음을 입력하십시오.
JazzInstallDir/server/tomcat/webapps/jazz.war
- 컨텍스트 루트를 /jazz로 설정하고
다음을 클릭하십시오.
주: WebSphere Application Server 7.0.0.7 이상을 설치하는 경우에는 이 단계가
끝 부분에 나타납니다.
- 다음을 클릭하고 나머지
새 애플리케이션 설치 단계를 계속 진행하십시오.
- 완료를 클릭하십시오.
- jazz_war 애플리케이션이 설치되었는지
저장을 클릭하여 마스터 구성을 바로 진행하십시오.
- 을 클릭하십시오.
- jazz_war 옆의 상자를 선택하고 시작을 클릭하십시오.
애플리케이션이 성공적으로 시작되었음을 나타내는 녹색
화살표가 나타나야 합니다.
주: 나머지 단계는 Rational Quality Manager
전용입니다.
- 새 애플리케이션 설치 페이지로 돌아가십시오.
- 로컬 파일 시스템에서 help.war 파일의 위치를 찾은 후
파일을 선택하십시오. 컨텍스트 루트를 /help로 입력한 후
다음을 클릭하십시오.
주: help.war 파일은 JazzInstallDir\server\tomcat\webapps\help.war에서 찾을 수 있습니다.
- 요약 화면이 표시될 때까지 다음을 계속 클릭한 후 완료를
클릭하여 새 애플리케이션을 설치하십시오.
- help_war 애플리케이션이 설치되었는지 확인한 후 저장을 클릭하여
마스터 구성 파일의 변경사항을 저장하십시오.
- 을 클릭하십시오.
- help_ war를 선택한 후 시작을 클릭하십시오.