登入

成功通過資料存放區的認證之後，儲存後端資料存放區的使用者名稱和密碼。則此使用者名稱和密碼在將來可以用於呼叫 pgtool。

憑證儲存在管理員主目錄中名為 .apocpass 的檔案中。如果此檔案已存在且它不具有正確的許可權，則指令將發生錯誤並結束。

若已指定了使用者名稱，系統將提示管理員輸入密碼，否則系統將提示管理員輸入使用者名稱和密碼。使用對資料存放區的匿名存取，驗證該使用者名稱和密碼。若不支援匿名存取，系統將提示管理員輸入已授權的使用者名稱和密碼。如果已授權使用者名稱的驗證失敗，則指令將發生錯誤並結束。

一經認證，成對的使用者名稱/密碼項目即會儲存在使用主機/連接埠/基底 DN 和使用者名稱之組合所組成的金鑰之管理員的 .apocpass 檔案中。如此一來成對的使用者名稱/密碼便可儲存以供相同檔案的其他後端使用。

啟動資訊可使用指令指定，例如使用 --file 選項指出找到資訊的檔案，或使用 --url 選項直接指定此資訊。如需有關啟動程式的更多資訊，請參閱CLI 需要的啟動資訊。

如果沒有啟動資訊可用，或者無法建立憑證檔案，則指令會發生錯誤並結束。

若已成功建立了憑證檔案，則不必使用此後端儲存裝置為後續的 pgtool 指令指定使用者名稱和密碼。將會使用儲存在憑證檔案中的使用者名稱和密碼詳細資訊。

語法

login [--username=<username>] [--file=<bootstrap file>] [--url=<url>]

--username=<username>：後端儲存裝置所使用之格式的管理員使用者名稱，例如「jmonroe」。

--file=<bootstrap file>：啟動檔案之完全合格的路徑。預設檔案為 $HOME/pgtool.properties。此選項與 --url 選項不相容。

--url=<url>：識別資料存放區的 URL 。URL 的格式為 ldap://<hostname>:<port>/<base name>，其中 <hostname> 是伺服器名稱 (預設為 localhost)、<port> 是伺服器的連接埠號 (預設為 389)，而 <base name> 是基底項目的辨別名稱。

範例 3–7 登入

% pgtool login --username=jmonroe [Enter the correct password when prompted]

使用「jmonroe」和「密碼」之項目所建立的檔案 ~/.apocpass，檔案具有權限 600。要連接之後端的相關資訊，可於預設啟動檔案 ~/pgtool.properties 中找到。