创建 LDAP 数据视图

创建 LDAP 数据视图将包括以下步骤：

1. 创建 LDAP 数据源。

2. 创建 LDAP 数据源池。

3. 将 LDAP 数据源连接到数据源池。

4. 创建 LDAP 数据视图。

创建和配置 LDAP 数据源

本部分介绍如何使用 dpconf 命令创建和配置 LDAP 数据源。有关这些主题的参考信息，请参见《Sun Java System Directory Server Enterprise Edition 6.3 Reference》中的“LDAP Data Sources”。

有关如何创建和配置 LDAP 数据源的信息，请参见以下过程。

创建 LDAP 数据源

可使用 DSCC 执行此任务。有关信息，请参见目录服务控制中心界面和 DSCC 联机帮助。

1. 创建数据源。

   $ dpconf create-ldap-data-source -h host -p port source-name host:port

   在此命令中，source-name 是为新数据源指定的名称。host 和 port 指的是正在运行 LDAP 服务器的主机和端口。请注意，在默认情况下数据源不使用 SSL。

   如果主机由 IP V6 地址指定，则创建数据源时需要使用 IP V6 引用。例如，如果目录代理服务器要绑定到端口 2389 上 IP V6 地址为 fe80::209:3dff:fe00:8c93 的主机，请使用以下命令创建数据源：

   $ dpconf create-ldap-data-source -h host1 -p 1389 ipv6-host \ [fe80::209:3dff:fe00:8c93]:2389

   如果使用控制台创建数据源，则必须指定实际的 IP V6 地址（不包含方括号）。

   有关如何修改 LDAP 数据源属性的信息，请参见配置 LDAP 数据源。

2. （可选的）查看数据源列表。

   $ dpconf list-ldap-data-sources -h host -p port

配置 LDAP 数据源

以下过程介绍如何显示 LDAP 数据源的属性以及如何设置需要更改的属性。该过程提供了用于更改任何 LDAP 数据源属性的命令，并且还描述了如何获取属性的详细信息，以便帮助您设置该属性。

可使用 DSCC 执行此任务。有关信息，请参见目录服务控制中心界面和 DSCC 联机帮助。

1. 通过使用以下命令语法查看数据源的属性：

   $ dpconf get-ldap-data-source-prop -h host -p port \ [-M unit] [-Z unit] source-name [property...]

   在此命令中，-M 和 -Z 指的是显示数据的单位。M 选项指定时间单位。-M 的值可以为 M、w、d、h、m、s 或 ms，分别表示月、周、天、小时、分钟、秒或毫秒。-Z 选项指定数据大小单位。-Z 的值可以为 T、G、M、k 或 b，分别表示千吉字节、千兆字节、兆字节、千字节或字节。

   如果不指定属性，将显示所有属性。LDAP 数据源的默认属性如下所示：

   bind-dn : - bind-pwd : - client-cred-mode : use-client-identity connect-timeout : 10s description : - is-enabled : false is-read-only : true ldap-address : host ldap-port : port ldaps-port : ldaps monitoring-bind-timeout : 5s monitoring-entry-dn : "" monitoring-entry-timeout : 5s monitoring-inactivity-timeout : 2m monitoring-interval : 30s monitoring-mode : proactive monitoring-search-filter : (|(objectClass=*)(objectClass=ldapSubEntry)) num-bind-incr : 10 num-bind-init : 10 num-bind-limit : 1024 num-read-incr : 10 num-read-init : 10 num-read-limit : 1024 num-write-incr : 10 num-write-init : 10 num-write-limit : 1024 proxied-auth-check-timeout : 1.8s proxied-auth-use-v1 : false ssl-policy : never use-tcp-no-delay : true

2. 启用数据源。

   $ dpconf set-ldap-data-source-prop -h host -p port source-name is-enabled:true

3. 如果要更改默认设置，请配置步骤 1 中列出的所有属性。

   $ dpconf set-ldap-data-source-prop -h host -p port source-name property:value

   例如，如果要修改数据源上的条目，请将此数据源配置为允许写入操作。

   $ dpconf set-ldap-data-source-prop -h host -p port source-name is-read-only:false

   要查找有关子命令中所使用的属性的信息，请运行以下命令：

   $ dpconf help-properties ldap-data-source property

   例如，要查找有关 is-read-only 属性的信息，请运行以下命令：

   dpconf help-properties ldap-data-source is-read-only

   要列出数据源的主要属性，请在 list-ldap-data-sources 子命令中使用详细选项 -v。

   $ dpconf list-ldap-data-sources -v Name is-enabled ldap-address ldap-port ldaps-port description ----------- ---------- ------------ --------- ---------- ----------- datasource0 true myHost myPort ldaps - datasource1 true myHost myPort ldaps -

4. 重新启动目录代理服务器实例以使更改生效（如有必要）。

   有关重新启动目录代理服务器的信息，请参见重新启动目录代理服务器。有关需要重新启动服务器的配置更改的列表，请参见需要重新启动服务器的配置更改。

创建和配置 LDAP 数据源池

本部分介绍如何使用 dpconf 命令创建和配置 LDAP 数据源池。有关这些主题的参考信息，请参见《Sun Java System Directory Server Enterprise Edition 6.3 Reference》中的“LDAP Data Sources”。

有关如何创建和配置数据源池的信息，请参见以下过程：

创建 LDAP 数据源池

可使用 DSCC 执行此任务。有关信息，请参见目录服务控制中心界面和 DSCC 联机帮助。

1. 创建一个或多个数据源池。

   $ dpconf create-ldap-data-source-pool -h host -p port pool-name

   可以在第一个 pool-name 之后指定其他数据源池。有关如何修改数据源池属性的信息，请参见配置 LDAP 数据源池。

2. （可选的）查看数据源池列表。

   $ dpconf list-ldap-data-source-pools -h host -p port

配置 LDAP 数据源池

可使用 DSCC 执行此任务。有关信息，请参见目录服务控制中心界面和 DSCC 联机帮助。

1. 通过使用以下命令语法查看数据源池的属性：

   $ dpconf get-ldap-data-source-pool-prop -h host -p port \ [-M unit] [-Z unit] pool-name [property...]

   在此命令中，-M 和 -Z 指的是显示数据的单位。M 选项指定时间单位。-M 的值可以为 M、w、d、h、m、s 或 ms，分别表示月、周、天、小时、分钟、秒或毫秒。-Z 选项指定数据大小单位。-Z 的值可以为 T、G、M、k 或 b，分别表示千吉字节、千兆字节、兆字节、千字节或字节。

   如果不指定属性，将显示所有属性。LDAP 数据源池的默认属性如下所示：

   client-affinity-policy : write-affinity-after-write client-affinity-timeout : 20s description : - enable-client-affinity : false load-balancing-algorithm : proportional

2. 配置步骤 1 中列出的属性。

   $ dpconf set-ldap-data-source-pool-prop -h host -p port pool-name \ property:value

   有关如何为负载平衡和客户端相似性配置数据源池属性的信息，请参见第 21 章，目录代理服务器负载平衡和客户端相似性。

将 LDAP 数据源连接到数据源池

连接到数据源池的数据源称为连接数据源。连接数据源的属性确定数据源池的负载平衡配置。配置连接数据源的权重时，应考虑数据源池中所有连接数据源的权重。请确保这些权重能够根据需要协同工作。有关如何为负载平衡配置权重的信息，请参见配置负载平衡的权重。

将 LDAP 数据源连接到数据源池

可使用 DSCC 执行此任务。有关信息，请参见目录服务控制中心界面和 DSCC 联机帮助。

1. 将一个或多个数据源连接到数据源池。

   $ dpconf attach-ldap-data-source -h host -p port pool-name \ source-name [source-name ...]

2. （可选的）查看给定数据源池中连接数据源的列表。

   $ dpconf list-attached-ldap-data-sources -h host -p port -E pool-name

   在此命令中，-E 是可选选项，用于修改显示输出，以便每行显示一个属性值。

3. （可选的）查看给定数据源池中连接数据源的主要属性。

   $ dpconf list-attached-ldap-data-sources -h host -p port -v pool-name

   在此命令中，-v 指定详细输出。例如，查看示例数据源池的属性。

   $ dpconf list-attached-ldap-data-sources -h host1 -p 1389 -v My-pool SRC_NAME add-weight bind-weight compare-weight ----------- ---------- ----------- -------------- datasource0 disabled disabled disabled datasource1 disabled disabled disabled delete-weight modify-dn-weight modify-weight search-weight ------------- ---------------- ------------- ------------- disabled disabled disabled disabled disabled disabled disabled disabled

4. （可选的）通过使用以下命令语法查看连接数据源的属性：

   $ dpconf get-attached-ldap-data-source-prop -h host -p port [-M unit] [-Z unit] \ pool-name source-name [property...]

   在此命令中，-M 和 -Z 指的是显示数据的单位。M 选项指定时间单位。-M 的值可以为 M、w、d、h、m、s 或 ms，分别表示月、周、天、小时、分钟、秒或毫秒。-Z 选项指定数据大小单位。-Z 的值可以为 T、G、M、k 或 b，分别表示千吉字节、千兆字节、兆字节、千字节或字节。

   如果不指定属性，将显示所有属性。

   连接数据源的属性可定义负载平衡中每种操作类型的权重。连接数据源的默认权重如下所示：

   add-weight : disabled bind-weight : disabled compare-weight : disabled delete-weight : disabled modify-dn-weight : disabled modify-weight : disabled search-weight : disabled

   必须设置连接数据源的属性，才能确保目录代理服务器按预计工作。在以下示例中，所有属性都被设置为具有相同的值。可以根据要求更改这些属性的值。有关如何为负载平衡配置连接数据源权重的信息，请参见配置负载平衡的权重。

   $ dpconf set-attached-ldap-data-source-prop -h host -p port \ pool-name source-name add-weight:1 $ dpconf set-attached-ldap-data-source-prop -h host -p port \ pool-name source-name bind-weight:1 $ dpconf set-attached-ldap-data-source-prop -h host -p port \ pool-name source-name compare-weight:1 $ dpconf set-attached-ldap-data-source-prop -h host -p port \ pool-name source-name delete-weight:1 $ dpconf set-attached-ldap-data-source-prop -h host -p port \ pool-name source-name modify-dn-weight:1 $ dpconf set-attached-ldap-data-source-prop -h host -p port \ pool-name source-name modify-weight:1 $ dpconf set-attached-ldap-data-source-prop -h host -p port \ pool-name source-name search-weight:1

使用 LDAP 数据视图

有关如何创建和配置 LDAP 数据视图的信息，请参见以下过程：

创建 LDAP 数据视图

可使用 DSCC 执行此任务。有关信息，请参见目录服务控制中心界面和 DSCC 联机帮助。

1. 创建 LDAP 数据视图。

   $ dpconf create-ldap-data-view -h host -p port view-name pool-name suffix-DN

   有关如何修改 LDAP 数据视图属性的信息，请参见配置 LDAP 数据视图。

2. 查看 LDAP 数据视图的列表。

   $ dpconf list-ldap-data-views -h host -p port

配置 LDAP 数据视图

可使用 DSCC 执行此任务。有关信息，请参见目录服务控制中心界面和 DSCC 联机帮助。

1. 查看 LDAP 数据视图的属性。

   $ dpconf get-ldap-data-view-prop -h host -p port view-name

   如果在创建数据视图时未配置任何属性，则数据视图具有以下配置：

   alternate-search-base-dn : "" attr-name-mappings : none base-dn : suffix-DN contains-shared-entries : false custom-distribution-algorithm-class : none description : - distribution-algorithm : none dn-join-rule : none dn-mapping-attrs : none dn-mapping-source-base-dn : none excluded-subtrees : - filter-join-rule : none is-enabled : true is-read-only : false is-routable : true ldap-data-source-pool : pool-name lexicographic-attrs : all lexicographic-lower-bound : none lexicographic-upper-bound : none non-viewable-attr : none non-writable-attr : none numeric-attrs : all numeric-default-data-view : false numeric-lower-bound : none numeric-upper-bound : none pattern-matching-base-object-search-filter : all pattern-matching-dn-regular-expression : all pattern-matching-one-level-search-filter : all pattern-matching-subtree-search-filter : all process-bind : - replication-role : master viewable-attr : all except non-viewable-attr writable-attr : all except non-writable-attr

   ---

   注 –

   除代理管理员外，所有用户都会看到后端服务器中的 cn=config 和 cn=monitor 后缀。默认情况下，后端服务器中的数据对于代理管理员不可用。对于代理管理员可用的 cn=config 和 cn=monitor 子树就是代理服务器自身的这些子树。

   创建目录代理服务器实例时，将使用空数据视图策略创建代理管理员的连接处理程序。如果代理管理员需要访问后端数据，则必须向代理管理员连接处理程序的数据视图策略中添加数据视图。默认情况下，在此类数据视图上将排除 cn=config 和 cn=monitor 子树。

   ---

2. 更改步骤 1 中列出的一个或多个属性。

   $ dpconf set-ldap-data-view-prop -h host -p port view-name \ property:value [property:value ... ]

   例如，要访问数据源上的 dc=example,dc=com 子树，请在数据视图中指定 dn-mapping-source-base-dn。

   $ dpconf set-ldap-data-view-prop -h host1 -p 1389 myDataView \ dn-mapping-source-base-dn:dc=example,dc=com

   要在多值属性中添加值，请使用以下命令：

   $ dpconf set-ldap-data-view-prop -h host -p port view-name property+:value

   要从多值属性中删除值，请使用以下命令：

   $ dpconf set-ldap-data-view-prop -h host -p port view-name property-:value

3. 重新启动目录代理服务器实例以使更改生效（如有必要）。

   有关重新启动目录代理服务器的信息，请参见重新启动目录代理服务器。