애플리케이션을 등록하기 위한 저장소 도구 명령

' RegisterApp ' 명령을 사용하여 Jazz® 팀 서버에 애플리케이션을 등록합니다.

용도

registerApp 명령은 구성된 Jazz Team Server에 여러 애플리케이션을 등록하고 구성하는 데 사용됩니다. 명령을 사용하기 전에 등록할 애플리케이션에 대한 설정을 포함하는 특성 파일을 작성하십시오.

중요: 명령을 실행할 때 서버가 실행 중이어야 합니다.

매개변수

속성	설명	필수	기본값
repositoryURL	서버의 연결 URL입니다.	아니오	https://localhost:9443/jts
authServerUserId	사용 중인 경우 Jazz Authorization Server 에 로그인하기 위한 관리자 ID입니다.	아니오	none
authServerPassword	사용 중인 경우 Jazz Authorization Server 에 로그인하기 위한 관리자 ID 비밀번호입니다.	아니오	none
adminUserId	JAZZ 저장소에 로그인하기 위한 관리자 ID입니다.	아니오	`ADMIN`
adminPassword	JAZZ 저장소에 로그인하기 위한 관리자 ID 비밀번호입니다.	아니오	`ADMIN`
credentialsFile	관리자 사용자의 로그인 신임 정보가 들어 있는 파일입니다.	아니오	credentials.properties
certificateFile	관리자 사용자의 로그인 인증서가 들어 있는 파일입니다.	아니오	none
smartCard	스마트카드를 사용하여 로그인하는 별명 또는 ?의 경우 사용 가능한 별명을 나열합니다.	아니오	none
logFile	로그 파일에 대한 경로.	아니오	repotools-jts_registerApp.log
parametersFile	등록 애플리케이션 매개변수 구성 파일의 위치입니다. 매개변수 파일에는 다양한 애플리케이션 등록 특성에 대한 값이 포함되어 있습니다.	예	none
kerberos	true로 설정하면 Kerberos/SPNEGO를 사용하여 Windows 사용자 신임 정보로 인증합니다. 또는 windows로 설정하여 Windows 통합 인증으로 인증하십시오.	아니오	없음

.properties 샘플 파일

다음 샘플은 재즈 팀 서버에 IBM® Engineering Lifecycle Management 애플리케이션을 등록하는 데 필요한 정보를 포함할 수 있는 ' .properties ' 파일용 샘플입니다. 이러한 app.properties 파일을 로컬 드라이브에 저장한 후 명령 인수에서 참조할 수 있습니다.

참고: 이 항목의 샘플 ' .properties ' 파일은 JDBC 연결이 있는 Db2® 데이터베이스를 사용합니다. Db2 이외의 데이터베이스를 사용하는 경우 db.vendor 및 db.jdbc.location 를 적절하게 변경하십시오. app을 사용 중인 애플리케이션으로 바꾸십시오.

추가 데이터베이스 정보:

Derby

app\:configure.database.page\:db.vendor=DERBY
app\:configure.database.page\:db.jdbc.location=conf/app/derby/repositoryDB
app\:data.warehouse.page\:db.jdbc.location=//localhost\:1527/conf/jts/derby/warehouseDB

Oracle

app\:configure.database.page\:db.vendor=ORACLE
app\:configure.database.page\:db.jdbc.location=thin\:appDBuser/{password}@//oracleserver.example.com\:1521/ORCL

Db2 z

app\:configure.database.page\:db.vendor=DB2Z
app\:configure.database.page\:db.jdbc.location=//ipAddress:ipPort/location:user\=ccmDBuser;password\={password};
app\:configure.database.page\:db.schemaPrefix=DB2z schema prefix - must be unique for each database in the same DB2z subsystem
app\:configure.database.page\:db.db2.dsn.dbname=JAZZDB
app\:data.warehouse.page\:db.db2.dsn.dbname=RIDW
app\:data.warehouse.page\:db.schemaPrefix=xx
app\:data.warehouse.page\:report.user=RTPUSER

Db2 i

app\:configure.database.page\:db.vendor=DB2i
app\:configure.database.page\:db.jdbc.location=//hostname;hold statements\=true;metadatasource\=1;user\=ccmDBuser;password\={password};
app\:data.warehouse.page\:report.user=RTPUSER

J2EE

app\:configure.database.page\:db.type=J2EE
app\:configure.database.page\:db.j2ee.dataSource=

{password}에는 비밀번호를 입력하지 마십시오. configure.database.page\:db.jdbc.password 행을 사용하여 비밀번호를 입력하십시오.

또한 JDBC 연결의 경우 수명 주기 쿼리 엔진 및 링크 인덱스 공급자를 제외한 모든 애플리케이션은 ' db.jdbc.location ' 및 ' db.jdbc.password '를 사용합니다. 이 두 애플리케이션에는 db.location 및 db.password를 사용해야 합니다.

데이터베이스 연결 매개변수에 대한 자세한 정보는 다음을 참조하십시오.

Change and Configuration Management 애플리케이션 (ccm.properties)

register.applications.page\:jts.register.ccm=true
register.applications.page\:ccm.application.title=/ccm
register.applications.page\:ccm.discovery.url=https\://hostname.example.com\:9443/ccm/scr
ccm\:configure.database.page\:db.type=JDBC
ccm\:configure.database.page\:db.vendor=DB2
ccm\:configure.database.page\:db.jdbc.location=//localhost\:50000/CCM\:user\=db2admin;password\={password};
ccm\:configure.database.page\:db.jdbc.password=
ccm\:data.warehouse.page\:db.jdbc.location=//localhost\:50000/JTS\:user\=db2admin;password\={password};
ccm\:data.warehouse.page\:db.jdbc.password=
ccm\:data.warehouse.page\:db.type=JDBC
ccm\:data.warehouse.page\:db.vendor=DB2
ccm\:data.warehouse.page\:db.base.folder=Enter an existing base folder for data warehouse
ccm\:data.warehouse.page\:report.user=RTPUSER

Engineering Test Management 애플리케이션qm.properties

register.applications.page\:jts.register.qm=true
register.applications.page\:qm.discovery.url=https\://hostname.example.com\:9443/qm/scr
register.applications.page\:qm.application.title=/qm
qm\:configure.database.page\:db.vendor=DB2
qm\:configure.database.page\:db.jdbc.location=//localhost\:50000/QM\:user\=db2admin;password\={password};
qm\:configure.database.page\:db.jdbc.password=
qm\:configure.database.page\:db.type=JDBC
qm\:data.warehouse.page\:db.jdbc.location=//localhost\:50000/JTS\:user\=db2admin;password\={password};
qm\:data.warehouse.page\:db.jdbc.password=
qm\:data.warehouse.page\:db.vendor=DB2
qm\:data.warehouse.page\:db.type=JDBC
qm\:data.warehouse.page\:db.base.folder=Enter an existing base folder for data warehouse
qm\:data.warehouse.page\:report.user=RTPUSER

Requirements Management 애플리케이션 (rm.properties)

register.applications.page\:jts.register.rm=true
register.applications.page\:rm.application.title=/rm
register.applications.page\:rm.discovery.url=https\://hostname.example.com\:9443/rm/scr
rm\:configure.database.page\:db.type=JDBC
rm\:configure.database.page\:db.vendor=DB2
rm\:configure.database.page\:db.jdbc.location=//localhost\:50000/RM\:user\=db2admin;password\={password};
rm\:configure.database.page\:db.jdbc.password=
rm\:data.warehouse.page\:db.jdbc.location=//localhost\:50000/JTS\:user\=db2admin;password\={password};
rm\:data.warehouse.page\:db.jdbc.password=
rm\:data.warehouse.page\:db.vendor=DB2
rm\:data.warehouse.page\:db.type=JDBC
rm\:data.warehouse.page\:db.base.folder=Enter an existing base folder for data warehouse
rm\:data.warehouse.page\:report.user=RTPUSER

Global Configuration Management 애플리케이션 (gc.properties)

register.applications.page\:jts.register.gc=true
register.applications.page\:gc.application.title=/gc
register.applications.page\:gc.discovery.url=https\://hostname.example.com\:9443/gc/scr
gc\:configure.database.page\:db.vendor=DB2
gc\:configure.database.page\:db.type=JDBC
gc\:configure.database.page\:db.jdbc.location=//localhost\:50000/GC\:user\=db2admin;password\={password};
gc\:configure.database.page\:db.jdbc.password=

보고서 빌더 애플리케이션 (rs.properties)

register.applications.page\:jts.register.rs=true
register.applications.page\:rs.application.title=/rs
register.applications.page\:rs.discovery.url=https\://hostname.example.com\:9443/rs/scr
rs\:com.ibm.team.jrs.setupStep\:db.jdbc.password=

링크 인덱스 공급자 애플리케이션ldx.properties

register.applications.page\:jts.register.ldx=true
register.applications.page\:ldx.application.title=/ldx
register.applications.page\:ldx.discovery.url=https\://hostname.example.com\:9443/ldx/scr
ldx\:configure.database.page\:db.vendor=DB2
ldx\:configure.database.page\:db.location=//localhost\:50000/LDX\:user\=db2admin;password\={password};
ldx\:configure.database.page\:db.password=
ldx\:configure.pgs.page\:dw.db.vendor=DB2
ldx\:configure.pgs.page\:dw.db.type=JDBC
ldx\:configure.pgs.page\:dw.db.location=//localhost\:50000/LDX\:user\=db2admin;password\={password};
ldx:\:configure.pgs.page\:dw.db.password=

데이터 수집 구성 요소 애플리케이션dcc.properties

register.applications.page\:jts.register.dcc=true
register.applications.page\:dcc.application.title=/dcc
register.applications.page\:dcc.discovery.url=https\://hostname.example.com\:9443/dcc/scr
dcc\:configure.database.page\:db.type=JDBC
dcc\:configure.database.page\:db.vendor=DB2
dcc\:configure.database.page\:db.jdbc.location=//localhost\:50000/DCC\:user\=db2admin;password\={password};
dcc\:configure.database.page\:db.jdbc.password=
dcc\:data.warehouse.page\:db.jdbc.location=//localhost\:50000/JTS\:user\=db2admin;password\={password};
dcc\:data.warehouse.page\:db.jdbc.password=
dcc\:data.warehouse.page\:db.vendor=DB2
dcc\:data.warehouse.page\:db.type=JDBC
dcc\:data.warehouse.page\:db.base.folder=Enter an existing base folder for data warehouse
dcc\:data.warehouse.page\:report.user=RTPUSER

수명 주기 쿼리 엔진 애플리케이션lqe.properties

register.applications.page\:jts.register.lqe=true
register.applications.page\:lqe.application.title=/lqe
register.applications.page\:lqe.discovery.url=https\://hostname.example.com\:9443/lqe/scr
lqe\:configure.trs.page\:trs.add=AddTRS
lqe\:configure.database.page\:db.vendor=DB2
lqe\:configure.database.page\:db.location=//localhost\:50000/LQE\:user\=db2admin;password\={password};
lqe\:configure.database.page\:db.password=
lqe\:configure.pgs.page\:dw.db.vendor=DB2
lqe\:configure.pgs.page\:dw.db.type=JDBC
lqe\:configure.pgs.page\:dw.db.location=//localhost\:50000/LQE\:user\=db2admin;password\={password};
lqe:\:configure.pgs.page\:dw.db.password=

IBM Engineering Lifecycle Optimization Engineering Insights 애플리케이션 (relm.properties)

register.applications.page\:jts.register.relm=true
register.applications.page\:relm.application.title=/relm
register.applications.page\:relm.discovery.url=https\://hostname.example.com\:9443/relm/scr
relm\:configure.database.page\:db.jdbc.location=//localhost\:50000/RELM\:user\=db2admin;password\={password};
relm\:configure.database.page\:db.jdbc.password=
relm\:configure.database.page\:db.vendor=DB2
relm\:configure.database.page\:db.type=JDBC

예제

Windows 운영 체제의 경우 명령 프롬프트를 열고 해당 명령을 입력하십시오.

cd C:\Program Files\IBM\JazzTeamServer\server\
repotools-jts.bat -registerApp repositoryURL=https://hostname.example.com:9443/jts adminUserId=admin adminPassword=admin parametersFile=C:\ccm.properties kerberos=true

Unix 운영 체제의 경우 명령행을 열고 다음 명령을 입력하십시오:

cd /opt/IBM/JazzTeamServer/server/
./repotools-jts.sh -registerApp repositoryURL=https://hostname.example.com:9443/jts adminUserId=admin adminPassword=admin parametersFile=/opt/ccm.properties

애플리케이션 등록 실패 문제점 해결

몇 가지 구성 오류 때문에 프로세스 도중 애플리케이션 등록이 실패하고 작업을 계속 진행할 수 없는 경우, 애플리케이션 등록을 취소해야 합니다. 실패한 애플리케이션 등록을 복구하려면 다음 단계를 완료하십시오.

경고: 애플리케이션을 등록 취소하면 Jazz Team Server 의 애플리케이션에서 이전에 저장한 데이터가 영구적으로 유실됩니다. 이 작업은 새 애플리케이션을 대상으로 실패한 설정을 재시도하는 경우에만 수행해야 합니다. 이전에 제거된 저장소에 데이터가 있는 애플리케이션을 등록 취소하는 것은 지원되지 않습니다.

Jazz Team Server 의 서버 관리에서 ‘서버 > 등록된 애플리케이션’을 클릭합니다.
조치 열 아래에서 X 아이콘을 클릭하여 애플리케이션을 제거하십시오. 확인 을 클릭하여 확인하십시오.
통신 아래에서 컨슈머(인바운드)를 클릭하고 애플리케이션에 대한 컨슈머 키가 없음을 확인하십시오.
IBM WebSphere® Application Server 실행 중인 경우 서버를 중지합니다.
JazzInstallDir/server/conf/app/derby로 이동하고 repositoryDB 폴더를 삭제하십시오.
derby 폴더에서 repositoryDB.zip의 압축을 푸십시오. 디렉토리 구조가 derby/repositoryDB인지 확인하십시오.
JazzInstallDir/server/conf/app에서 teamserver.properties 파일을 삭제하십시오.
원본 teamserver-xxxxxxxxxxxxxbackup.properties를 찾아 teamserver.properties로 이름을 바꾸십시오. 백업 파일이 여러 개 있습니다. 파일 크기가 가장 크고 오래된 파일이 원본 파일입니다.
서버를 시작하고 등록을 다시 실행하십시오.