4.4 使用驱动程序参数

要更改驱动程序参数，可编辑《驱动程序参数》页。

  1. 在 iManager 中，单击 Identity Manager >《Identity Manager 概述》。

  2. 在所属驱动程序集中找到此驱动程序。

  3. 单击驱动程序图标，打开《驱动程序概述》页。

  4. 再次单击驱动程序图标，打开《修改对象》页。

  5. 单击《驱动程序配置》。

  6. 使用以下各表中提供的信息来升级驱动程序参数。

4.4.1 驱动程序选项

下表中的第三列包含可以粘贴到驱动程序参数 XML 编辑器中的 XML 文本。 XML 文本准确地表示了显示参数所需的内容。 还可以将《说明》标题下的信息放到 <description> </description> 参数中。

Table 4-1 驱动程序参数

参数

说明

用于定义驱动程序参数的 XML

Default Certifier ID file

用于注册 Notes 通讯录中用户对象的默认 Notes 证明者 ID 文件。 该文件的完整路径的表示形式取决于承载 Domino 的操作系统。

<definition display-name="Default Certifier ID File" name="cert-id-file" type="string"> <description> </description>

<value>c:\lotus654\domino\data\ids\people\ndriver.id</value> </definition>

Default Certifier ID password

用于注册 Notes 通讯录中用户对象的默认 Notes 证明者 ID 文件口令。

使用该参数的 type=“password-ref” 特性时，将根据驱动程序配置加密并安全地储存口令。 以这种方式安全地储存口令时，Metadirectory 引擎或使用指定密钥名称的驱动程序可以引用该口令。 （在本例中为 defaultCertPwd。）

<definition display-name="Default Certifier Password" is-sensitive="true" name="cert-id-password" type="password-ref"> <description> </description>

<value>defaultCertPwd</value> <pwd-value removePwd="false"> </pwd-value></definition>

Directory File or Input Database

要与 Identity Vault 同步的数据库的文件名。 在没有完整路径信息的情况下指定该项目。

<definition display-name="Directory File" name="directory-file" type="string"> <description> </description>

<value>names.nsf</value> </definition>

Notes Address Book

如果输入数据库（目录文件）是 Notes 通讯录，则指定为 True；否则指定为 False。

<definition display-name="Notes Address Book?" name="is-directory" type="boolean"> <description> </description>

<value>true</value> </definition>

Notes Domain Name

运行驱动程序的 Notes 域的名称。 它可能与 Notes 组织名不同，因此无法从服务器名派生。

<definition display-name="Notes Domain Name" name="notes-domain" type="string"> <description> </description>

<value>PROVO1</value> </definition>

Server ID File

与该驱动程序鉴定到的 Notes 服务器关联的 Notes 服务器 ID 文件（可选）。 该文件的完整路径的表示形式取决于承载 Domino 的操作系统。 该 ID 文件可以不是服务器 ID 文件。 它实际上可以是没有口令（且不必具有任何访问权限）的 ID 文件。

<definition display-name="Domino Server ID File" name="server-id-file" type="string"> <description> </description>

<value>c:\lotus654\domino\data\server.id</value> </definition>

Update File or ndsrep polling cache

数据库的文件名，用于超速缓存需要发布到 Identity Vault 的数据库更改。 默认为 ndsrep.nsf。 在没有完整路径信息的情况下指定该项目。

驱动程序的 Domino 加载项进程 ndsrep 可创建该数据库。 在该数据库中，已过滤更新将在超速缓存后供 Notes 驱动程序的发布者使用。

<definition display-name="Update File" name="update-file" type="string"> <description> </description>

<value>ndsrep.nsf</value> </definition>

Notes User ID file

与该驱动程序表示的 Notes 用户关联的 Notes 用户 ID 文件（必选）。 该文件的完整路径的表示形式取决于承载 Domino 的操作系统。 可在以下用户界面部分中输入与该用户 ID 文件关联的口令： 《驱动程序配置》>《鉴定》>《Specify the application password》（指定应用程序口令）。

<definition display-name="Notes Driver User ID File" name="user-id-file" type="string"> <description> </description>

<value>c:\lotus654\domino\data\ids\people\ndriver.id</value> </definition>

Janitor Cleanup Interval

守卫清理查找并释放可能已被未完成的 query-ex 序列孤立的资源。 该间隔确定执行此守卫服务的频率。

<definition display-name="Janitor Cleanup Interval (in minutes)" name="janitor-cleanup-interval" type="integer"> <description> </description>

<value>30</value> </definition>

Allow Document Locking

允许 Notes 驱动程序 Shim 锁定将被修改的 Notes 数据库文档。 该参数仅在使用 Notes 6.5 或更高版本且 Notes 数据库启用了《允许锁定文档》复选框时才有效。

<definition display-name="Allow Document Locking" name="allow-document-locking" type="boolean"> <description> </description>

<value>true</value> </definition>

4.4.2 订购者选项

下表中的第三列包含可以粘贴到驱动程序参数 XML 编辑器中的 XML 文本。 XML 文本准确地表示了显示参数所需的内容。 还可以将《说明》标题下的信息放到 <description> </description> 参数中。

Table 4-2 订购者通道参数

参数

说明

用于定义驱动程序参数的 XML

Allow Domino AdminP Support

指定可以使用 AdminP 功能。 只支持 Lotus Notes 6.0.3 或更改版本用户使用 AdminP 功能。

如果具有 Lotus Notes 6.0.3 或更高版本且希望使用 AdminP 功能，则必须添加该参数并将其设置为 True。

如果驱动程序参数中不包含该参数，则默认设置为 False。

可以使用Section 4.5, Custom Driver Parameters中介绍的 Allow AdminP Support 特性来逐个命令地覆盖此参数。

<definition display-name="Allow Domino AdminP Support" name="allow-adminp-support" type="boolean"> <description> </description>

<value>true</value> </definition>

Certify/Register Users

该参数指示在创建 Notes 用户帐户时驱动程序的默认行为。 Yes 表明默认情况下，驱动程序将通过以下方式尝试注册 Notes 通讯录中的用户：在收到添加事件时证明用户并为每个用户创建 ID 文件。

可以使用 XML 特性标记 <certify-user> 覆盖此默认设置。

<definition display-name="Certify (register) Notes Users" name="cert-users" type="boolean"> <description> </description>

<value>true</value> </definition>

Create Mail DB

该参数指示在创建电子邮件帐户时驱动程序的默认行为。 True 表明默认情况下，驱动程序将在添加新用户时尝试创建 Notes 邮件数据库。

可以使用 XML 特性标记 <create-mail> 覆盖此默认设置。

<definition display-name="Create User E-Mail Box" name="create-mail" tmpId="238" type="boolean"> <description> </description>

<value>true</value> </definition>

Default HTTP Password

为新创建的 Notes 用户设置的默认 Notes 万维网 (HTTP) 口令。

可以使用 XML 特性标记 <user-pwd> 覆盖此默认设置。

<definition display-name="Default HTTP Password" name="default-http-password" type="string"> <description> </description>

<value>notesweb</value> </definition>

Default Notes Password

新创建的 Notes 用户的默认 Notes 用户 ID 口令。

可以使用 XML 特性标记 <user-pwd> 覆盖此默认设置。

<definition display-name="Default Notes Password" name="default-password" type="string"> <description> </description>

<value>notes</value> </definition>

Expiration Term

新创建的 Notes 用户 ID 文件的默认失效期限（以年为单位指定）。

可以使用 XML 特性标记 <expire-term> 覆盖此默认设置。

<definition display-name="Default User ID File/Registration Expiration Term (in years)" name="expiration-term" type="integer"> <description> </description>

<value>2</value> </definition>

Failed Command Reply Status

如果驱动程序参数中不包含该参数，则默认设置为《重试》。

可能的值包括《成功》、《警告》、《错误》、《重试》或《致命》。

可在对严重情况进行查错时使用该参数。

<definition display-name="Retry Status Return Code" name="retry-status-return" type="enum"> <description> </description>

<value>retry</value> </definition>

ID File Storage Location

该参数指定在注册用户对象并创建 ID 文件时使用的默认 Notes 用户 ID 文件（证明者）储存位置。 新的 ID 文件处于该位置。 该文件夹完整路径的表示形式取决于承载 Domino 的操作系统。

可以使用 XML 特性标记 <user-id-path> 覆盖此默认设置。

<definition display-name="User ID File Storage Location" name="cert-path" type="string"> <description> </description>

<value>c:\lotus654\domino\data\ids\people</value> </definition>

Internet Mail Domain Name

在 2.0 版中已废弃。

<definition display-name="Internet Mail Domain" name="account.email.InternetDomainName" type="string"> <description> </description>

<value><variable-ref var-name="base.Notes.INetMailDomain"/></value> </definition>

Add User E-Mail ACL Level

新创建用户对象的新创建邮件文件的默认 ACL 设置。 有效值包括 NOACCESS、DEPOSITOR、READER、AUTHOR、EDITOR、DESIGNER 和 MANAGER。 如果未指定任何 ACL 设置，则默认设置为 MANAGER。

可以使用 XML 特性标记 <mailfile-acl-level> 覆盖此默认设置。

<definition display-name="Add User E-Mail: E-Mail Database ACL Setting" name="account.email.aclsetting" type="enum"> <description> </description>

<value>default</value> </definition>

User Mail File Storage Location

相对于 Domino 数据储存位置的邮件储存路径，其中储存由驱动程序创建的邮件文件。 例如，如果参数设置为《邮件》，则由 Domino 服务器（在 Linux 上运行）上驱动程序创建的新邮件文件储存在 /local/notesdata/mail 文件夹中。

<definition display-name="User Mail File Storage Location" name="mailfile-path" type="string"> <description> </description>

<value>mail</value> </definition>

Notes Password Strength

新创建的 Notes 用户 ID 文件的默认最小口令长度（0-16 个字符）。

可以使用 XML 特性标记 <minimum-pwd-len> 覆盖此默认设置。

<definition display-name="Notes Password Strength (0 - 16)" name="minimum-pwd-len" type="integer"> <description> </description>

<value>2</value> </definition>

Is Domino Server North American?

北美服务器用户 ID 文件（证明者）属性。仅当 Domino 服务器在北美运行时，才将此参数设置为 True。 根据 Domino 注册要求，创建用户 ID 文件时需要使用该特性。

<definition display-name="Is Domino Server North American?" name="north-american-flag" type="boolean"> <description> </description>

<value>true</value> </definition>

Domino Mail Server Name

承载邮件文件的 Domino 服务器的 DN。

将 XML <mailserver> 元素用作添加事件元素的子元素，可以覆盖此默认设置。

<definition display-name="Domino Mail Server Name" name="mail-server" type="string"> <description> </description>

<value>CN=blackcap/O=novell</value> </definition>

Notes Document Save Failure Return Code

如果驱动程序参数中不包含该参数，则默认值为《警告》。

可能的值包括《成功》、《警告》、《错误》、《重试》或《致命》。

可在查错时使用该参数且其可被 <retry-status-return> 重写

<definition display-name="Notes Document Save Failure Return Code" name="notes-save-fail-action" type="enum"> <description> </description>

<value>warning</value> </definition>

Allow Notes Web (HTTP) Password Set

将该参数设置为 True，可允许 Notes 驱动程序设置或更改用户对象上的万维网 (HTTP) 口令特性。 将该参数设置为 False，将禁止 Notes 驱动程序设置或更改用户对象上的万维网 (HTTP) 口令特性。默认设置为 True。

<definition display-name="Allow Notes Web (HTTP) Password Set" name="allow-http-password-set" type="boolean"> <description> </description>

<value>true</value> </definition>

Registration/ Certification Log File

用来记录 Notes 通讯录中用户对象注册情况的 Notes 证书日志文件。 在没有完整路径信息的情况下指定该项目。

<definition display-name="Registration/Certification Log File" name="cert-log" type="string"> <description> </description>

<value>certlog.nsf</value> </definition>

Store User ID in Address Book

此标志指示驱动程序在以下情况中的默认行为：注册时将用户 ID 文件附加到 Notes 通讯录中其各自的用户对象中。

将此标志设置为 True，可在 Notes 通讯录中创建注册用户对象时附加用户 ID 文件。

将该标志设置为 False，可在 Notes 通讯录中创建注册用户对象时不附加用户 ID 文件。

可以使用 XML 特性标记 <store-useridfile-in-ab> 覆盖此默认设置。

<definition display-name="Store User ID File in Address Book" name="store-id-ab-flag" type="boolean"> <description> </description>

<value>true</value> </definition>

E-Mail File Template

要在驱动程序创建用户电子邮件帐户及创建新邮件数据库时使用的 .ntf 数据库模板。 Domino 数据文件夹中的 Domino 服务器必须可以访问此模板。

<definition display-name="Mail File Template" name="mailfile-template" type="string"> <description> </description>

<value>mail654.ntf</value> </definition>

Add Registered Users To Address Book

该参数指示在将注册用户对象放到 Notes 通讯录中时驱动程序的默认行为。 将该标志设置为 True，可将注册用户放到通讯录中。 将该标志设置为 False，可注册用户（即为用户创建证明者 ID 文件），但不会将该用户对象放到 Notes 通讯录中。

可以使用 XML 特性标记 <update-addressbook> 覆盖此默认设置。

<definition display-name="Add Registered Users to Address Book" name="update-ab-flag" type="boolean"> <description> </description>

<value>true</value> </definition>

Document Lock Failure Action

指定 Notes 驱动程序在无法获取文档锁定的情况下将向 Metadirectory 引擎返回的操作（文档返回代码）。 可供选择的值包括《重试》（默认）、《警告》、《错误》、《致命》和《成功》。

该参数由 <retry-status-return> 重写

<definition display-name="Document Lock Failure Action" name="notes-doc-lock-fail-action" type="enum">

<value>retry</value> </definition>

Number of File Creation Collision Retry Attempts

指定一个正整数值，表示要在尝试解决文件名冲突时追加到文件名后的最大数。 如果 NotesDriverShim 因文件名冲突而无法创建邮件文件或邮件文件复本，则 NotesDriverShim 会将整数文本值追加到尝试创建的文件名末尾并再次尝试创建该文件。 因此，如果邮件文件 JohnDoe.nsf 已存在，那么 NotesDriverShim 会尝试创建 JohnDoe1.nsf。 如果该值为 0（零），则不会调用这一在文件名冲突后创建文件的功能。

<definition display-name="Number of File Creation Collision Retry Attempts" name="db-creation-max-collisions" type="integer">

<value>5</value> </definition>

4.4.3 发布者选项

下表中的第三列包含应粘贴到驱动程序参数 XML 编辑器中的 XML 文本。 XML 文本准确地表示了显示参数所需的内容。 还可以将《说明》标题下的信息放到 <description> </description> 参数中。

Table 4-3 发布者通道参数

参数

说明

用于定义驱动程序参数的 XML

Check Attributes

ndsrep 检查和发布特性参数。 仅在修改了 Notes 对象后，应通过发布者通道将发布者过滤器中修改的特性发送到 Identity Vault 时，才将该参数设置为 True。 仅在修改了 Notes 对象后，应通过发布者通道将发布者过滤器中指定的同步特性发送到 Identity Vault 时，才将该参数设置为 False。

默认值为 True。

<definition display-name="Check Attributes?" name="check-attrs-flag" type="boolean"> <description> </description>

<value>true</value> </definition>

DN Format

ndsrep 使用的判别名格式。 有效值包括 NOTES_TYPED、NOTES、SLASH_TYPED、SLASH、LDAP、LDAP_TYPED、DOT 和 DOT_TYPED。 默认值为 NOTES_TYPED。

<definition display-name="DN FORMAT" name="dn-format" type="enum"> <description> </description>

<value>NOTES_TYPED</value> </definition>

Enable Loop Back Detection

回送检测参数。 设置为 True 可启用回送检测。 设置为 False 可禁用回送检测。

<definition display-name="Enable Loop Back Detection" name="loop-detect-flag" type="boolean"> <description> </description>

<value>true</value> </definition>

NDSREP Configuration Database

由驱动程序创建并维护的 ndsrep 配置数据库文件名。 该参数控制驱动程序 Shim 使用哪个 .nsf 数据库来写入其发布选项。

该文件名的完整路径的表示形式取决于承载 Domino 的操作系统。 使用该参数时，需要使用 -f 文件名参数来装载 ndsrep。

ndsrep 装载示例： 

load ndsrep NotesDriver2 -f /home/notes/mycfg.nsf

如果此参数不存在，则默认情况下配置数据库文件名设置为 dsrepcfg.nsf，且通常位于 Domino 数据文件夹中。

如果驱动程序名称包含空格，则必须用引号将名称引起来。

<definition display-name="NDSREP Configuration database" name="config-db-name" type="string"> <description> </description>

<value>mycfg.nsf</value> </definition>

NDSREP Configuration Instance

由驱动程序创建并维护的 ndsrep 配置数据库中的 ndsrep 配置实例名称。 该参数控制驱动程序 Shim 使用哪个数据库记事来读写它在 ndsrep 配置数据库中的发布选项。 使用此参数时，ndsrep 使用与该实例名称一同装载的该配置实例的设置作为参数。

如果此参数不存在，则默认情况下配置实例设置为驱动程序的名称（eDirectory 中的驱动程序 RDN）。

ndsrep 装载示例： 

load ndsrep NotesDriver2

如果驱动程序名称包含空格，则必须用引号将名称引起来。

<definition display-name="NDSREP Configuration Instance" name="instance-id" type="string"> <description> </description>

<value>NotesDriver2</value> </definition>

NDSREP Console Trace Level

可能的值包括 SILENT、NORMAL、VERBOSE 或 DEBUG。

如果此参数不存在，则默认设置为 NORMAL。

<definition display-name="NDSREP Domino Console Trace Level" name="ndsrep-console-trace-level" type="enum"> <description> </description>

<value>NORMAL</value> </definition>

NDSREP Schedule Units

ndsrep 巡回检测间隔单位。 有效值包括 SECONDS、MINUTES、HOURS、DAYS 和 YEARS。默认值为 SECONDS。

<definition display-name="NDSREP Polling Units" name="schedule-units" type="enum"> <description> </description>

<value>SECONDS</value> </definition>

NDSREP Schedule Value

ndsrep 巡回检测间隔单位值。 该值可与 <schedule-units> 配置参数结合使用。

<definition display-name="NDSREP Polling interval" name="schedule-value" type="integer"> <description> </description>

<value>30</value> </definition>

Polling Interval

Notes 驱动程序发布者巡回检测间隔，以 SECONDS、MINUTES、HOURS 和 DAYS 为单位指定。

<definition display-name="Polling Interval (in seconds)" name="polling-interval" type="integer"> <description> </description>

<value>30</value> </definition>

Publication Heartbeat Interval (in seconds)

以秒为单位指定的发布心跳间隔。 该参数代替 <pub-heartbeat-interval> 使用时，可提供合适的间隔大小。 如果在该指定间隔（持续时间）内没有任何文档发送到发布者通道，则驱动程序将发送心跳文档。 值为 0（零）表示没有要发送的心跳文档。

如果此参数不存在，则默认情况下发布心跳间隔为 0（零）。

<definition display-name="Heartbeat Interval (in seconds)" name="pub-heartbeat-interval-seconds" type="integer"> <description> </description>

<value>0</value> </definition>

Publication Heartbeat Interval

以分钟为单位指定的发布心跳间隔。 如果在该指定间隔（持续时间）内没有任何文档发送到发布者通道，则驱动程序将发送心跳文档。 值为 0（零）表示没有要发送的心跳文档。

如果此参数不存在，则默认情况下发布心跳间隔为 0（零）。

<definition display-name="Heartbeat Interval (in minutes)" name="pub-heartbeat-interval" type="integer"> <description> </description>

<value>0</value> </definition>

Write Time Stamps?

Ndsrep 是否在已同步的 Notes 参数中写入特定驱动程序时戳。 设置为 True，可以使 ndsrep 在所有已同步的 Notes 对象中写入特定驱动程序时戳。 此特定驱动程序时戳用于更准确地确定 Notes 对象特性的更新。 设置为 False，可以使 ndsrep 根据现有 Notes 对象时戳确定 Notes 对象特性的更新。

默认值为 True。

<definition display-name="Write Time Stamps?" name="write-timestamps-flag" type="boolean"> <description> </description>

<value>true</value> </definition>