이 주제에서는 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 통합 솔루션 콘솔을
사용할 때는 다음에 따라 이 작업을 수행할 수 있습니다.
- 보안 -> 보안 관리, 애플리케이션 및
인프라 -> 웹 보안 - 일반 설정으로 이동합니다.
- "비보호 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 구성입니다. 데이터베이스 공급업체에 따라 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.3 설치)이 필요합니다. 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)에서 몇 가지 특수한 설정이 필요합니다.
먼저, 일부 구성 파일의 위치를
알고 있어야 합니다. 시스템 특성 JAZZ_HOME을 설정하면
알 수 있습니다. 이 특성은 단순 경로가 아닌 URL을 사용하므로
값을 file://-style URL로 지정해야 합니다.
Jazz JVM에
필요한 두 번째 특성은 -Xmx 설정을 사용하여 최대 메모리 할당을 기본값 이상
제공합니다. 이 특성을 설정할 때는 서버에서 지원되는 팀의 크기와
Jazz Team Server가 실행되고 있는
서버의 메모리 용량에 기반해야 합니다. 중간 크기의 팀은 -Xmx1536M 값을 사용하는데, 그러면 Jazz Team Server
프로세스에 1536MB의 힙 메모리가 제공됩니다.
Oracle 또는 SQL Server
데이터베이스에 연결할 때는 "ORACLE_JDBC" 또는 "SQLSERVER_JDBC" 특성을
추가해야 합니다. 해당 특성을 적합한
jdbc 드라이버에 대한 절대 파일 경로로 설정하십시오(URL 아님).
다음은 서버의 일부 동작을 제어하기 위해 설정해야 하는
몇 가지 기타 시스템 특성입니다. WebSphere 관리 콘솔에서
이 JVM 특성을 설정하는 구체적인 과정이 나와 있으며, 수행할 때는 JazzInstallDir을
Jazz Team Server 설치
디렉토리로 대체하십시오.
- 를 클릭합니다.
- server1을 클릭합니다.
- 를 클릭합니다.
- JVM(Java Virtual Machine)을 클릭합니다.
- 초기 힙에 값 100을 추가합니다.
- 최대 힙 크기에 값 1000을 추가합니다.
- 적용을 클릭합니다.
- 로깅 및 추적을 클릭합니다. 로그 세부사항
레벨 변경을 클릭합니다. Jazz Team Server는
BIRT 보고 엔진을 사용합니다. BIRT 정보 항목이 WebSphere 로그 파일에 기록되지 않게 하려면
org.eclipse.birt.* 패키지의 로깅 레벨을 심각으로
설정하십시오. 적용을 클릭합니다.
- 사용자 정의 특성을 클릭합니다.
- 다음 특성을 추가합니다. 새로 작성을 클릭합니다.
이름과 값을 입력하고
확인을 클릭합니다.
- 이름: java.awt.headless 값: true
- 이름: org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin 값:
true
- 이름: JAZZ_HOME 값: file:///JazzInstallDir/server/conf
- 저장을 클릭하여 마스터 구성에
바로 저장합니다.
- Websphere를 다시 시작하여 Jazz 애플리케이션을 설치합니다.
다음 명령행 예제에서
WASInstallDir은
서버에서 WebSphere Application Server를 설치한 위치를
나타냅니다.
- WebSphere Application
Server의 관리 콘솔을 엽니다.
- 를 클릭합니다.
- 새 애플리케이션 경로 아래에서
로컬 파일 시스템을 클릭합니다.
- 전체 경로에 다음을 입력합니다.
JazzInstallDir/server/jazz.war
- 컨텍스트 루트를 /jazz로 설정합니다.
- 다음을 클릭하고 나머지
새 애플리케이션 설치 단계를 계속합니다.
- 완료를 클릭합니다.
- 저장을 클릭하여 마스터 구성에
바로 저장합니다.
- 을 클릭합니다.
- jazz_war 옆의 상자를 선택하고 시작을 클릭합니다.
애플리케이션이 성공적으로 시작되었음을 나타내는 녹색
화살표가 나타나야 합니다.