目錄代理伺服器的指令行工具

用於目錄代理伺服器的指令行工具稱為 dpadm 與 dpconf。如需有關如何使用這些指令的相關資訊，請參閱 dpadm(1M) 與 dpconf(1M) 線上手冊。

本節說明 dpadm 與 dpconf 指令的位置。亦提供有關環境變數、指令間比較及於何處獲取使用這些指令之說明的資訊。

目錄代理伺服器指令的位置

依預設，目錄代理伺服器指令行工具位於下列目錄中：

install-path/dps6/bin

安裝路徑會隨作業系統而異。預設路徑與指令位置中列出了所有作業系統的安裝路徑。

設定 dpconf 的環境變數

dpconf 指令必須具有可使用環境變數預先設定的一些選項。如果使用指令時未指定選項，或未設定環境變數，則會使用預設設定。您可以配置下列選項的環境變數：

-D userDN

使用者連結 DN。環境變數：LDAP_ADMIN_USER。預設值：cn=Proxy Manager。

-w password-file

使用者連結 DN 的密碼檔案。環境變數： LDAP_ADMIN_PWF。預設值：密碼的提示。

-h host

主機名稱或 IP 位址。環境變數：DIR_PROXY_HOST。預設值：localhost。

-p LDAP-port

LDAP 連接埠號。環境變數：DIR_PROXY_PORT。預設值：如果伺服器實例以超級使用者身份執行，則為 389；如果伺服器實例以一般使用者身份執行，則為 1389。

如需更多詳細資訊，請參閱 dpconf(1M) 線上手冊。

dpadm 與 dpconf 的比較

下表顯示了 dpadm 與 dpconf 指令的比較。

使用 dpconf 設定多重值特性

某些目錄代理伺服器特性可具有多個值。指定這些值的語法如下：

$ dpconf set-container-prop -h host -p port container-name \
 property:value1 property:value2

例如，若要為名為 my-view 的 LDAP 資料檢視設定多個可寫入的屬性，請使用此指令：

$ dpconf set-ldap-data-view-prop -h host1 -p 1389 my-view \
 writable-attr:uid writable-attr:cn writable-attr:userPassword

如果增加或修改已包含值的多重值特性中任一值，則必須重設所有值。例如，在前一個範例中，如果要增加 sn 做為可寫入屬性，您必須在指令中包含所有其他可寫入屬性：

$ dpconf set-ldap-data-view-prop -h host1 -p 1389 my-view \
 writable-attr:uid writable-attr:cn writable-attr:userPassword writable-attr:sn

移除值時使用相同的規則。因此，若要從以上可寫入屬性的清單中移除 userPassword，請使用此指令：

$ dpconf set-ldap-data-view-prop -h host1 -p 1389 my-view \
 writable-attr:uid writable-attr:cn writable-attr:sn

取得有關使用 dpadm 與 dpconf 的說明

如需有關如何使用 dpadm 與 dpconf 指令的相關資訊，請參閱 dpadm(1M) 與 dpconf(1M) 線上手冊。

• 若要取得子指令的清單，請鍵入適當的指令：

  $ dpadm --help

  $ dpconf --help

• 若要取得有關如何使用子指令的資訊，請鍵入適當的指令：

  $ dpadm subcommand --help

  $ dpconf subcommand --help

• 若要取得有關 dpconf 指令中所使用之配置特性的資訊，請鍵入：

  $ dpconf help-properties

• 若要取得有關子指令配置特性的資訊，請使用此指令：

  $ dpconf help-properties subcommand-entity

  例如，若要尋找有關存取記錄特性的資訊，請鍵入：

  $ dpconf help-properties access-log

• 若要取得有關子指令中所使用之特性的資訊，請使用此指令：

  $ dpconf help-properties subcommand-entity property

  例如，若要尋找有關 set-access-log-prop 子指令之 log-search-filters 特性的資訊，請鍵入：

  $ dpconf help-properties access-log log-search-filters

• 若要列出一組實體的主要特性 (例如資料檢視或連線處理程式)，請搭配 list 子指令使用詳細選項 -v。

  例如，若要檢視所有連線處理程式的主要特性與相關特性，請使用此指令：

  $ dpconf -h host -p port list-connection-handlers -v Name is-enabled priority description -------------------------- ---------- -------- --------------------------- anonymous false 99 unauthenticated connections default connection handler true 100 default connection handler dscc administrators true 1 Administrators connection handler

  如需有關個別特性的更多資訊，請參閱該特性的線上手冊。