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

預設的認證者 ID 檔案

用來在「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>

預設的認證者 ID 密碼

用來在「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>

目錄檔案或輸入資料庫

要與 Identity Vault 同步化的資料庫檔案名稱。 指定此項目時不必提供完整路徑資訊。

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

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

Notes 通訊錄

如果輸入資料庫 (目錄檔案) 是「Notes 通訊錄」,請指定 True;否則請指定 False。

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

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

Notes 領域名稱

執行驅動程式之 Notes 領域的名稱。 它可能與「Notes 組織」名稱不同,因此不能從伺服器名稱中衍生。

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

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

伺服器 ID 檔案

與此驅動程式驗證之「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>

更新檔案或 ndsrep 輪詢快取

用來快取需要發行至 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 使用者 ID 檔案

與此驅動程式代表之「Notes 使用者」相關聯的「Notes 使用者 ID」檔案 (此為必要項目)。 檔案的完整路徑應該以代管 Domino 之作業系統的相對路徑表示。 在下列使用者介面區段中輸入與此使用者 ID 檔案相關聯的密碼: 「驅動程式組態 > 驗證 > 指定應用程式密碼」。

<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>

守衛清理間隔

守衛清理會檢查和釋放可能已由未完成之 query-ex 序列進行錯誤鏡像複製的資源。 此間隔決定執行此守衛服務的頻率。

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

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

允許文件鎖定

如果正在修改 Notes 資料庫文件,則可讓「Notes 驅動程式 Shim」鎖定這些文件。 只有在使用 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

允許 Domino AdminP 支援

指定可以使用的 AdminP 功能。 僅針對 Lotus Notes 6.0.3 或更新版本的使用者支援 AdminP 功能。

如果您具有 Lotus Notes 6.0.3 或更新版本,且要使用 AdminP 功能,則必須新增此參數並將其設為 true。

如果驅動程式參數中不存在此參數,則預設設定是 false。

可使用Section 4.5, 自定驅動程式參數中描述的 Allow AdminP Support 屬性,以個別指令為基礎來置換此參數。

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

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

認證/註冊使用者

此參數指出關於 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>

建立郵件 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>

預設 HTTP 密碼

針對新建立之 Notes 使用者設定的預設 Notes Web (HTTP) 密碼。

使用 XML 屬性標籤 <user-pwd> 可置換此預設設定。

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

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

預設 Notes 密碼

新建立之 Notes 使用者的預設「Notes 使用者 ID」密碼。

使用 XML 屬性標籤 <user-pwd> 可置換此預設設定。

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

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

過期期限

新建立之「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>

失敗指令回覆狀態

如果驅動程式參數中不存在此參數,則預設設定是 Retry。

可能的值為 Success、Warning、Error、Retry 或 Fatal。

可以在疑難排解嚴重情況時使用此參數。

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

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

ID 檔案儲存位置

此參數指定在註冊使用者物件和建立 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>

網際網路郵件領域名稱

在 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>

新增使用者電子郵件 ACL 層級

新建立之使用者物件新建立的郵件檔案之預設 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>

使用者郵件檔案儲存位置

相對於儲存郵件檔案 (如果驅動程式已建立) 之 Domino 資料儲存位置的郵件儲存路徑。 例如,如果將參數設為 “mail,”,則會將驅動程式在 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 密碼強度

新建立之「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>

Domino 伺服器是北美伺服器嗎?

「北美伺服器使用者 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 郵件伺服器名稱

保留郵件檔案之「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 文件儲存失敗傳回碼

如果驅動程式參數中不存在此參數,則預設值是 warning。

可能的值為 success、warning、error、retry 或 fatal。

在疑難排解時可使用此參數,並可使用 <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>

允許 Notes Web (HTTP) 密碼設定

將參數設為 true 以允許 Notes 驅動程式設定或變更使用者物件的 Web (HTTP) 密碼屬性。 將參數設為 false 以不允許 Notes 驅動程式設定或變更使用者物件的 Web (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>

在 Notes 通訊錄中儲存使用者 ID

此旗標指出驅動程式的預設行為,它與在註冊時間,將使用者 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>

新增已註冊的使用者至通訊錄

此參數指出關於將已註冊的使用者物件置於「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>

文件鎖定失敗動作

指定當「Notes 驅動程式」無法取得文件鎖定時,「Notes 驅動程式」將傳回 Metadirectory 引擎的動作 (文件傳回碼)。 值選項為 retry (預設)、warning、error、fatal 和 success。

<retry-status-return> 會覆寫此參數

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

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

檔案建立衝突重試次數

指定當嘗試解決檔案名稱衝突時,指示附加到檔案名稱之最大數的正整數值。 如果 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

檢查屬性

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 格式

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>

啟用迴路偵測

迴路偵測參數。 設為 True 表示啟用迴路偵測。 設為 False 表示停用迴路偵測。

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

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

NDSREP 組態資料庫

驅動程式建立和維護的 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 組態例項

在 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 控制台追蹤層級

可能的值為 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 排程單位

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 排程值

ndsrep 輪詢間隔單位值。 此值會與 <schedule-units> 組態參數一起使用。

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

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

輪詢間隔

以 SECONDS、MINUTES、HOURS 和 DAYS 指定的「Notes 驅動程式 Shim」發行者輪詢間隔。

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

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

發行活動訊號間隔 (以秒為單位)

以秒為單位指定的「發行活動訊號間隔」。 可以使用此參數而不是 <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>

發行活動訊號間隔

指定以分鐘為單位的「發行活動訊號間隔」。 如果在此指定的間隔 (持續時間) 內「發行者」通道上未傳送任何文件,則驅動程式會傳送活動訊號文件。 值為 0 表示不會傳送任何活動訊號文件。

如果此參數不存在,則在預設狀態下,發行活動訊號間隔為 0。

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

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

寫入時戳?

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>