資料庫伺服器的指令行切換參數

您可以利用這些指令行切換參數,來設定 dbadmin 指令的選項,以及管理 IBM® Rational® DOORS® 資料庫伺服器。
註: 如果要使用 dbadmin 指令,需要提供 -data 切換參數。如果您省略該切換參數,或使用無效的資料值,指令就無法執行,且會顯示下列訊息:-F- DBADMIN: 未指定伺服器

如需 Rational DOORS 用戶端的指令行切換參數清單,請參閱 Rational DOORS 用戶端的指令行切換參數

表 1. Rational DOORS dbadmin 指令的指令行切換參數
切換參數(縮寫) 參數 說明
-data (-d) port@DOORSserver 這個切換參數識別資料庫伺服器,其中 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 是記載應用程式訊息的架構。當您在指令行或登錄中使用此參數時,會將應用程式訊息輸出至指定的配置檔。會記載下列六種訊息層次:
  • TRACE
  • DEBUG
  • INFO,包括 ACK、CONFIRM 和 QUERY
  • WARNING
  • ERROR
  • FATAL
-tdsUserFilterLimit string 這個切換參數會設定 Rational Directory Server 使用者搜尋限制。
-tdsGroupFilterLimit string 這個切換參數會設定 Rational Directory Server 群組搜尋限制。
-useCardAuthentication   這個切換參數會開啟智慧卡鑑別。
-doNotUseCardAuthentication   這個切換參數會關閉智慧卡鑑別。
-useOSUserAuthentication   這個切換參數會開啟作業系統使用者鑑別。
-doNotUseOSUserAuthentication   這個切換參數會關閉作業系統使用者鑑別。
-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 是執行 Web 伺服器之電腦的完整主機名稱;例如 dwaserver.ibm.com
-dwaPort port 這個切換參數識別執行 Rational DOORS Web Access 伺服器的埠號。

請參閱在這個表格之後有關預設值和 URI 的重要注意事項。

-dwaProtocol httphttps 這個切換參數指定 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   這個切換參數會關閉「資料變更通知」服務。
重要: 如果 -dwaPort 切換參數是空的,埠值會預設為選定通訊協定的標準埠:
表 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   這個切換參數會移除第一次安裝資料庫伺服器時所建立的預設服務。
-mremove -iservice_instance_number 這個切換參數會移除特定的資料庫伺服器服務實例,其中 portnumber 等於指派給該資料庫服務名稱的實例號碼。
-list   這個切換參數會以表格格式,輸出所有已配置的 Rational DOORS 資料庫伺服器服務及其狀態的清單。
-logfile log_file 這個切換參數會設定用於資料庫伺服器交易記載的檔案。如需記載層次說明,請參閱日誌檔
-loglevel log_level 這個切換參數設定資料庫伺服器交易記載所記錄的資訊詳細程度。如果要關閉記載功能,請使用值 0。如果要產生最詳細的資料,請使用值 6。
-start   這個切換參數會啟動預設的資料庫伺服器服務。
-stop   這個切換參數會停止預設的資料庫伺服器服務。

指令行指令範例

您可以在指令行和捷徑中使用指令行切換參數。

如果要關閉正在 36677@IBMEDSERV 執行的伺服器,請輸入下列指令:
dbadmin -data 36677@abc -killserver

捷徑指令範例

如果要啟動伺服器,請使用下列捷徑。請修訂指令,以反映您的 Rational DOORS 安裝路徑。
"C:\Program Files (x86)\IBM\Rational\DOORS\9.version\bin\doorsd.exe" -start

意見