配置或修改資料庫。雖然您可以使用 installutil 來搭配各種次指令,但此參考頁面中說明的語法是供配置 LDAP 使用者鑑別的特定次指令所使用。installutil 指令行公用程式只能在 Windows 上使用。
用法概要
- installutil subcommand dbset_name cq_login cq_password [ –site site ]
[ –domain domain ] [ specific_subcommand_argument...]
說明
配合下列次指令來使用 installutil 指令:
- getauthenticationalgorithm。顯示 setauthenticationalgorithm 次指令指定的演算法。
- getcqldapmap。顯示 setcqldapmap 次指令指定的字串。
- getldapinit。顯示 setldapinit 次指令對指定之資料庫集所指定的 ldapsearch 字串。
- getldapsearch。顯示 setldapsearch 次指令對指定之資料庫集所指定的字串。
- setauthenticationalgorithm。控制 Rational® ClearQuest® 對指定的資料庫集是同時支援 ClearQuest 及 LDAP 鑑別,或僅支援 ClearQuest 鑑別。
- setcqldapmap。識別 ClearQuest 用來將 ClearQuest 資料庫集中的使用者帳戶對映至 LDAP 目錄中的使用者帳戶之 ClearQuest 使用者設定檔欄位及 LDAP 使用者屬性。這個指令會對每一個網域及/或網站(如果適用)執行一次。
- setldapinit。設定 ClearQuest 資料庫集連接至用於鑑別的 LDAP 目錄所需要的參數字串。它會對每一個網域及/或網站(如果適用)執行一次。
- setldapsearch。指定要使用的 LDAP 搜尋準則來尋找要對其鑑別的 LDAP 使用者帳戶。它會對每一個網域及/或網站(如果適用)執行一次。
- validateldap。確認 LDAP 配置正確運作中。
小心: 如果您啟用 LDAP 鑑別,則必須保留一個 ClearQuest 已鑑別的管理者帳戶。您必須從使用 ClearQuest 鑑別的管理者帳戶執行 installutil 次指令。因為如果 LDAP 配置設定不一致、不正確或處於未運作狀態,則 ClearQuest 無法鑑別管理者的認證。從使用 ClearQuest 鑑別的管理者帳戶執行這些次指令,可確保萬一 LDAP 目錄無法使用時,您可以存取 ClearQuest 管理功能。
ClearQuest 會阻止具有管理者專用權的使用者,設定其本身的使用者帳戶使用 LDAP 鑑別,但不會阻止具有管理者專用權的使用者設定另一個管理者的帳戶使用 LDAP 鑑別。
至少,當您執行 installutil 次指令來配置 ClearQuest 的 LDAP 鑑別時,必須指定 ClearQuest 資料庫集名稱、管理者使用者名稱及相關聯的管理者密碼。
選項及引數
- dbset_name
- ClearQuest 資料庫集或連線的名稱,其包含要對 LDAP 鑑別啟用的資料庫。
- cq_login
- ClearQuest 管理使用者的登入名稱。此使用者必須具備「超級使用者」專用權,而且被標示為 ClearQuest 鑑別。
- cq_password
- ClearQuest 管理使用者的密碼。若要指定空值密碼,請輸入一組空的雙引號 ""。
- -site site
- 在 Rational ClearQuest MultiSite 環境中,特定的 MultiSite 網站名稱。如果您使用這個選項,該指令僅套用到指定的網站。如果您省略這個選項,該指令將套用到所有網站。
- -domain domain
- Rational ClearQuest 支援可使用多個 LDAP 配置來鑑別的環境。如果您使用這個選項,installutil 次指令僅套用到指定的 LDAP 網域。如果您省略這個選項,這個次指令將套用到所有網域。
- specific_subcommand_argument
- installutil 次指令特定的一個以上引數。若為 installutil setldapinit 及 installutil setldapsearch 次指令,您必須以雙引號括住引數。請使用單引號括住內含空格的巢狀參數清單和字串。