创建 LDAP 数据视图将包括以下步骤:
本部分介绍如何使用 dpconf 命令创建和配置 LDAP 数据源。有关这些主题的参考信息,请参见《Sun Java System Directory Server Enterprise Edition 6.3 Reference》中的“LDAP Data Sources”。
有关如何创建和配置 LDAP 数据源的信息,请参见以下过程。
可使用 DSCC 执行此任务。有关信息,请参见目录服务控制中心界面和 DSCC 联机帮助。
$ 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 数据源。
$ dpconf list-ldap-data-sources -h host -p port |
以下过程介绍如何显示 LDAP 数据源的属性以及如何设置需要更改的属性。该过程提供了用于更改任何 LDAP 数据源属性的命令,并且还描述了如何获取属性的详细信息,以便帮助您设置该属性。
可使用 DSCC 执行此任务。有关信息,请参见目录服务控制中心界面和 DSCC 联机帮助。
$ 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 |
启用数据源。
$ dpconf set-ldap-data-source-prop -h host -p port source-name is-enabled:true |
如果要更改默认设置,请配置步骤 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 - |
重新启动目录代理服务器实例以使更改生效(如有必要)。
有关重新启动目录代理服务器的信息,请参见重新启动目录代理服务器。有关需要重新启动服务器的配置更改的列表,请参见需要重新启动服务器的配置更改。
本部分介绍如何使用 dpconf 命令创建和配置 LDAP 数据源池。有关这些主题的参考信息,请参见《Sun Java System Directory Server Enterprise Edition 6.3 Reference》中的“LDAP Data Sources”。
有关如何创建和配置数据源池的信息,请参见以下过程:
可使用 DSCC 执行此任务。有关信息,请参见目录服务控制中心界面和 DSCC 联机帮助。
$ dpconf create-ldap-data-source-pool -h host -p port pool-name |
可以在第一个 pool-name 之后指定其他数据源池。有关如何修改数据源池属性的信息,请参见配置 LDAP 数据源池。
$ dpconf list-ldap-data-source-pools -h host -p port |
可使用 DSCC 执行此任务。有关信息,请参见目录服务控制中心界面和 DSCC 联机帮助。
$ 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 |
配置步骤 1 中列出的属性。
$ dpconf set-ldap-data-source-pool-prop -h host -p port pool-name \ property:value |
有关如何为负载平衡和客户端相似性配置数据源池属性的信息,请参见第 21 章,目录代理服务器负载平衡和客户端相似性。
连接到数据源池的数据源称为连接数据源。连接数据源的属性确定数据源池的负载平衡配置。配置连接数据源的权重时,应考虑数据源池中所有连接数据源的权重。请确保这些权重能够根据需要协同工作。有关如何为负载平衡配置权重的信息,请参见配置负载平衡的权重。
可使用 DSCC 执行此任务。有关信息,请参见目录服务控制中心界面和 DSCC 联机帮助。
将一个或多个数据源连接到数据源池。
$ dpconf attach-ldap-data-source -h host -p port pool-name \ source-name [source-name ...] |
(可选的)查看给定数据源池中连接数据源的列表。
$ dpconf list-attached-ldap-data-sources -h host -p port -E pool-name |
在此命令中,-E 是可选选项,用于修改显示输出,以便每行显示一个属性值。
(可选的)查看给定数据源池中连接数据源的主要属性。
$ 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 |
(可选的)通过使用以下命令语法查看连接数据源的属性:
$ 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 数据视图的信息,请参见以下过程:
可使用 DSCC 执行此任务。有关信息,请参见目录服务控制中心界面和 DSCC 联机帮助。
创建 LDAP 数据视图。
$ dpconf create-ldap-data-view -h host -p port view-name pool-name suffix-DN |
有关如何修改 LDAP 数据视图属性的信息,请参见配置 LDAP 数据视图。
查看 LDAP 数据视图的列表。
$ dpconf list-ldap-data-views -h host -p port |
可使用 DSCC 执行此任务。有关信息,请参见目录服务控制中心界面和 DSCC 联机帮助。
查看 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 子树。
更改步骤 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 |
重新启动目录代理服务器实例以使更改生效(如有必要)。
有关重新启动目录代理服务器的信息,请参见重新启动目录代理服务器。