데이터베이스 서버의 명령행 스위치

명령행 스위치를 사용하여 dbadmin 명령의 옵션을 설정하고 Rational® DOORS® 데이터베이스 서버를 관리할 수 있습니다.
참고: dbadmin 명령을 사용하려면 -data 스위치가 필요합니다. 이 스위치를 생략하거나 올바르지 않은 데이터 값을 사용하면 명령을 실행할 수 없으며 -F- DBADMIN: 서버가 지정되지 않음 메시지가 표시됩니다.

RationalDOORS 클라이언트의 명령행 스위치 목록은 Rational DOORS 클라이언트의 명령행 스위치를 참조하십시오.

표 1. RationalDOORS에서 dbadmin 명령의 명령행 스위치
스위치(약어) 매개변수 설명
-data (-d) port@DOORSserver 이 스위치는 Rational DOORS 데이터베이스 서버를 식별합니다. 여기서 port는 데이터베이스 서버에서 사용 중인 포트 번호이고 DOORSserver는 데이터베이스 서버가 설치된 컴퓨터의 이름입니다. 이 스위치는 항상 필수입니다.
-killprocess (-k) channel_identifier 이 스위치는 channel_identifier 매개변수로 지정된 사용자 연결을 끊습니다.

channel_identifier 매개변수는 -userlist 스위치로 표시됩니다.

-killserver (-K)   이 스위치는 서버를 중지합니다.
-locklist (-l)   이 스위치는 현재 잠긴 모든 파일과 각 파일의 채널 ID를 나열합니다.
-outfile (-o) filename 이 스위치는 출력을 파일로 보냅니다.

이 스위치를 -locklist-userlist 스위치와 함께 사용하십시오.

-password (-P) password 이 스위치는 서버의 현재 비밀번호입니다.
-newpassword (-p) newpassword 이 스위치는 서버의 새 비밀번호입니다.
-unlock (-U) channel_identifier 이 스위치는 channel_identifier 매개변수로 지정된 파일의 잠금을 해제합니다.

channel_identifier 매개변수는 -locklist 스위치로 표시됩니다.

-userlist (-u)   이 스위치는 모든 사용자 연결을 나열합니다.
-serverLogging log_level loglevellogfile 매개변수를 지정하여 서버를 시작한 경우 이 스위치를 사용하여 로깅 레벨을 변경할 수 있습니다.

새 로그 레벨을 적용하기 위해 서버를 다시 시작할 필요는 없습니다.

로그 레벨에 대한 설명은 로그 파일을 참조하십시오.
-logxconfig (-X) logging_file_name log4cxx 구성 파일의 전체 이름입니다(예: c:\Program Files\IBM\Rational\DOORS\9.6\logging-config.xml). Log4cxx는 애플리케이션 메시지를 로깅하기 위한 프레임워크입니다. 명령행 또는 레지스트리에서 이 매개변수를 사용하면 애플리케이션 메시지가 지정된 구성 파일에 출력됩니다. 다음과 같은 여섯 가지 레벨의 메시지가 로그됩니다.
  • 추적
  • 디버그
  • 정보(수신 확인, 확인, 조회 포함)
  • 경고
  • 오류
  • 치명
-tdsUserFilterLimit string 이 스위치는 Rational Directory Server 사용자 검색에 대한 한계를 설정합니다.
-tdsGroupFilterLimit string 이 스위치는 Rational Directory Server 그룹 검색에 대한 한계를 설정합니다.
-useCardAuthentication   이 스위치는 스마트카드 인증을 설정합니다.
-doNotUseCardAuthentication   이 스위치는 스마트카드 인증을 해제합니다.
-useOSUserAuthentication   이 스위치는 OS 사용자 인증을 설정합니다.
-doNotUseOSUserAuthentication   이 스위치는 OS 사용자 인증을 해제합니다.
-secure on, ON, off, OFF 이 스위치는 Rational DOORS 서버를 보안 모드로 시작하도록 구성할지를 지정합니다.
-keyDB filename 이 스위치는 Rational DOORS SSL 인증 및 유효성 검증에 사용되는 키가 포함된 키 데이터베이스 파일의 전체 경로(파일 이름 포함)입니다.

기본 경로는 DOORS\9.version\certdb\server_authentication.kdb입니다.

이 스위치는 -certdb 스위치보다 우선합니다. Rational Directory Server 키 데이터베이스 폴더의 위치를 지정하려면 -certdb 스위치를 사용하십시오. Rational DOORS SSL 키 데이터베이스 파일의 별도 위치를 지정하려면 -keyDB 스위치를 사용하십시오.

-certdb folder_name 이 스위치는 Rational Directory Server 및 Rational DOORS SSL의 키를 포함하는 키 데이터베이스 파일이 들어 있는 폴더를 식별합니다.

기본 경로는 DOORS\9.version\certdb\입니다.

Rational DOORS SSL의 키 데이터베이스 파일을 별도 폴더에 두려면 -keyDB 스위치를 사용하십시오. -keyDB 스위치는 -certdb 스위치보다 우선합니다.

-certName string 이 스위치는 보안 인증 도중 서버를 식별하는 인증서의 레이블을 식별합니다.

기본 레이블은 IBMSV1입니다.

-serverhostname string 이 스위치는 서버에서 인증서 유효성 검증 도중 스스로를 식별하는 데 사용하는 이름입니다.

기본 레이블은 IBMEDSERV입니다.

표 2. Rational DOORS Web Access에서 dbadmin의 명령행 스위치
스위치(약어) 매개변수 설명
-dwaHost DWAserver 이 스위치는 Rational DOORS Web Access 서버를 식별합니다. 여기서 DWAserver는 Rational DOORS Web Access 서버가 실행 중인 컴퓨터의 완전한 호스트 이름입니다(예: dwaserver.ibm.com).
-dwaPort port 이 스위치는 Rational DOORS Web Access 서버를 실행 중인 포트 번호를 식별합니다.

통신 보안을 사용하는 경우 기본 포트는 8443입니다. 그렇지 않은 경우, 기본 포트는 8080입니다.

-dwaProtocol http 또는 https 이 스위치는 Rational DOORS Web Access 서버가 사용 중인 프로토콜을 지정합니다.

통신 보안을 사용하는 경우 https를 입력하십시오. 그렇지 않은 경우, http를 입력하십시오. 둘 다 입력하지 마십시오.

-dcnEnable   이 스위치는 데이터 변경 알림을 필수로 설정하여 Rational DOORS Web Access 서버 및 브로커와의 통신을 가능하게 합니다.
-dcnBrokerUri tcp://broker:61616 이 스위치는 Rational DOORS Web Access 브로커를 식별합니다. 여기서 broker는 브로커를 호스팅하는 컴퓨터이고 61616은 브로커가 사용하는 기본 포트 번호입니다.
-dcnChannelName dcn 이 스위치는 데이터 변경 알림 채널을 설정합니다. 채널 이름은 항상 "dcn"입니다.
-dcnInfo   이 스위치는 데이터 변경 알림 서비스 상태를 확인합니다.
-dcnEnable   이 스위치는 데이터 변경 알림 서비스를 설정합니다.
-dcnDisable   이 스위치는 데이터 변경 알림 서비스를 해제합니다.
표 3. Rational DOORS에서 doorsd의 명령행 스위치
스위치(약어) 매개변수 설명
-minstall -port port_number -serverdata server_data_path 이 스위치는 Windows 운영 체제를 실행 중인 시스템에서 후속 Rational DOORS 데이터베이스 서버 서비스를 추가로 작성합니다. 여기서 portnumber는 데이터 연결 포트이고 server_data_path는 서버의 데이터 디렉토리 폴더입니다.

예:

"doorsd -minstall -port 36666 -serverdata C:\Program Files(x86)\IBM\Rational\DOORS\9.6\new_data._ 00001 등의 인스턴스 번호가 새 서비스에 지정됩니다.

-remove   이 스위치는 Rational DOORS 데이터베이스 서버가 처음 설치될 때 작성되는 기본 서비스를 제거합니다.
-mremove -i service_instance_number 이 스위치는 Rational DOORS 데이터베이스 서버 서비스의 특정 인스턴스를 제거합니다. 여기서 portnumber는 데이터베이스 서비스 이름에 지정된 인스턴스 번호입니다.
-list   이 스위치는 구성된 모든 Rational DOORS 데이터베이스 서버 서비스와 이 서비스의 상태 목록을 표 형식으로 출력합니다.
-logfile log_file 이 스위치는 Rational DOORS 데이터베이스 서버 트랜잭션 로깅에 사용되는 파일을 설정합니다. 로그 레벨에 대한 설명은 로그 파일을 참조하십시오.
-loglevel log_level 이 스위치는 Rational DOORS 데이터베이스 서버의 트랜잭션 로깅으로 기록되는 정보에 대해 세부사항 레벨을 설정합니다. 로깅을 해제하려면 값 0을 사용하십시오. 가장 상세한 세부사항을 작성하려면 값 6을 사용하십시오.
-start   이 스위치는 기본 Rational DOORS 데이터베이스 서버 서비스를 시작합니다.
-stop   이 스위치는 기본 Rational DOORS 데이터베이스 서버 서비스를 중지합니다.

명령행 명령 예

명령행 및 바로 가기에서 명령행 스위치를 사용할 수 있습니다.

36677@IBMEDSERV에서 실행 중인 서버를 종료하려면 다음 명령을 입력하십시오.
dbadmin -data 36677@abc -killserver

바로 가기 명령 예

서버를 시작하려면 다음 바로 가기를 사용하십시오. Rational DOORS 설치 경로를 반영하도록 명령을 수정하십시오.
"C:\Program Files\IBM\Rational\DOORS\9.version\bin\doorsd.exe" -start -debug
참고: 명령행에서 Rational DOORS 데이터베이스 서버를 시작할 때 -debug를 사용하십시오.

피드백