Red Hat Summit6.4. データベースプラグインの属性
また、データベースプラグインは、情報ツリーにまとめられます。データベースインスタンスで使用されるすべてのプラグインテクノロジーは、cn=ldbm database プラグインノードに保存されます。このセクションでは、cn=ldbm database,cn=plugins,cn=config 情報ツリーの各ノードの追加の属性情報を太字で示します。
6.4.1. cn=config,cn=ldbm database,cn=plugins,cn=config 下のデータベース属性
このセクションでは、すべてのインスタンスに共通するグローバル設定属性を cn=config,cn=ldbm database,cn=plugins,cn=config ツリーノードに格納します。
6.4.1.1. nsslapd-backend-implement
nsslapd-backend-implement パラメーターは、Directory Server が使用するデータベースバックエンドを定義します。
Directory Server は次のデータベースタイプをサポートしています。
- Berkeley Database (BDB)
- Lightning Memory-Mapped Database Manager (LMDB)
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=config,cn=ldbm database,cn=plugins,cn=config |
| 有効な値 | bdb または mdb |
| Default Value | bdb |
| 構文 | ディレクトリー文字列 |
| 例 | nsslapd-backend-implement: mdb |
6.4.1.2. nsslapd-backend-opt-level
このパラメーターは、実験的なコードをトリガーして書き込みパフォーマンスを向上できます。
値:
-
0: パラメーターを無効にします。 -
1: トランザクション中にレプリケーション更新ベクターがデータベースに書き込まれません -
2: バックエンドロックの取得順序を変更し、トランザクションを開始します。 -
4: トランザクションからコードを移動します。
すべてのパラメーターを組み合わせることができます。たとえば、7 の場合は、すべての最適な機能を有効にします。
このパラメーターは実験的なものです。Red Hat サポートから特に指示されない限り、値を変更 しないでください。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=config,cn=ldbm database,cn=plugins,cn=config |
| 有効な値 | 0 | 1 | 2 | 4 |
| デフォルト値 | 0 |
| 構文 | 整数 |
| 例 | nsslapd-backend-opt-level: 0 |
6.4.1.3. nsslapd-db-deadlock-policy
nsslapd-db-deadlock-policy パラメーターは、libdb library-internal deadlock ポリシーを設定します。
このパラメーターは、Red Hat サポートから指示された場合にのみ変更します。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=config,cn=ldbm database,cn=plugins,cn=config |
| 有効な値 | 0-9 |
| デフォルト値 | 0 |
| 構文 | DirectoryString |
| 例 | nsslapd-db-deadlock-policy: 9 |
6.4.1.4. nsslapd-db-private-import-mem
nsslapd-db-private-import-mem パラメーターは、Directory Server がデータベースインポート用のリージョンとミューテックスの割り当てにプライベートメモリーを使用するかどうかを管理します。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=config,cn=ldbm database,cn=plugins,cn=config |
| 有効な値 | on | off |
| デフォルト値 | on |
| 構文 | DirectoryString |
| 例 | nsslapd-db-private-import-mem: on |
6.4.1.5. nsslapd-db-transaction-wait
nsslapd-db-transaction-wait パラメーターを有効にすると、Directory Server はトランザクションを開始せずに、ロックリソースが利用可能になるまで待機します。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=config,cn=ldbm database,cn=plugins,cn=config |
| 有効な値 | on | off |
| デフォルト値 | off |
| 構文 | DirectoryString |
| 例 | nsslapd-db-transaction-wait |
6.4.1.6. nsslapd-directory
この属性は、データベースインスタンスへの絶対パスを指定します。データベースインスタンスを手動で作成する場合は、この属性を含める必要があります。データベースインスタンスを作成したら、このパスを変更しないでください。変更すると、サーバーがデータにアクセスできなくなるリスクがあります。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=config,cn=ldbm database,cn=plugins,cn=config |
| 有効な値 | データベースインスタンスへの有効な絶対パス |
| デフォルト値 | |
| 構文 | DirectoryString |
| 例 | nsslapd-directory: /var/lib/dirsrv/slapd-instance/db |
6.4.1.7. nsslapd-exclude-from-export
この属性には、データベースのエクスポート時にエントリーから除外する属性の名前のスペース区切りのリストが含まれています。これは主に、サーバーインスタンス固有の設定および運用属性に使用されます。
サーバーのパフォーマンスに影響する可能性があるため、この属性のデフォルト値を削除しないでください。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=config,cn=ldbm database,cn=plugins,cn=config |
| 有効な値 | 有効な属性 |
| デフォルト値 | entrydn entryid dncomp parentid numSubordinates entryusn |
| 構文 | DirectoryString |
| 例 | nsslapd-exclude-from-export: entrydn entryid dncomp parentid numSubordinates entryusn |
6.4.1.8. nsslapd-idlistscanlimit
nsslapd-idlistscanlimit 属性は非推奨になりました。検索パフォーマンスに対するこの属性の影響が、有益というよりも有害であるためです。以下の説明は、履歴としてのみ提供されています。
デフォルトでは、このパフォーマンス関連の属性は、検索操作中に特定されるエントリー ID の数を指定します。数値ではない場合、または 32 ビットの符号付き整数には大きすぎる値を設定しようとすると、LDAP_UNWILLING_TO_PERFORM エラーメッセージが返され、問題を説明する追加のエラー情報が示されます。検索パフォーマンスを向上させるには、デフォルト値を保持することを推奨します。
このパラメーターはサーバーの実行中に変更でき、新しい値は後続の検索に影響します。
対応するユーザーレベルの属性は nsIDListScanLimit です。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=config,cn=ldbm database,cn=plugins,cn=config |
| Valid Range | 100 から最大 32 ビットの整数値 (2147483647) のエントリー ID |
| デフォルト値 | 2147483646 |
| 構文 | 整数 |
| 例 | nsslapd-idlistscanlimit: 50000 |
6.4.1.9. nsslapd-idl-switch
nsslapd-idl-switch パラメーターは、Directory Server が使用する IDL 形式を設定します。Red Hat では、以前の IDL 形式に対応しなくなった点に注意してください。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=config,cn=ldbm database,cn=plugins,cn=config |
| 有効な値 | new | old |
| デフォルト値 | new |
| 構文 | ディレクトリー文字列 |
| 例 | nsslapd-idl-switch: new |
6.4.1.10. nsslapd-lookthroughlimit
このパフォーマンス関連の属性は、検索要求に応答して候補エントリーを調べるときに Directory Server がチェックするエントリーの最大数を指定します。ただし、Directory Manager DN は、デフォルトでは無制限で、ここで指定したその他の設定を上書きします。この制限では、バインドベースのリソース制限が機能する点に注意する必要があります。つまり、ユーザーバインドするエントリーに操作属性 nsLookThroughLimit の値が存在する場合は、デフォルトの制限が上書きされます。数値ではない場合、または 32 ビットの符号付き整数には大きすぎる値を設定しようとすると、LDAP_UNWILLING_TO_PERFORM エラーメッセージが返され、問題を説明する追加のエラー情報が示されます。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=config,cn=ldbm database,cn=plugins,cn=config |
| Valid Range | エントリーの -1 から最大 32 ビット整数までです (-1 は無制限)。 |
| デフォルト値 | 5000 |
| 構文 | 整数 |
| 例 | nsslapd-lookthroughlimit: 5000 |
6.4.1.11. nsslapd-mode
この属性は、新しく作成されたインデックスファイルに使用されるパーミッションを指定します。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=config,cn=ldbm database,cn=plugins,cn=config |
| 有効な値 |
4 桁の 8 進数。ただし、モード |
| デフォルト値 | 600 |
| 構文 | 整数 |
| 例 | nsslapd-mode: 0600 |
6.4.1.12. nsslapd-pagedidlistscanlimit
このパフォーマンス関連の属性は、簡単なページ結果制御を使用して検索操作で特定されるエントリー ID の数を指定します。
この属性は nsslapd-idlistscanlimit 属性と同じように機能しますが、単純なページ結果制御による検索にのみ適用される点が異なります。
この属性が存在しないか、ゼロに設定されている場合は、nsslapd-idlistscanlimit を使用してページングされた検索およびページ以外の検索を行います。
対応するユーザーレベルの属性は nsPagedIDListScanLimit です。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=config,cn=ldbm database,cn=plugins,cn=config |
| Valid Range | エントリーの -1 から最大 32 ビット整数までです (-1 は無制限)。 |
| デフォルト値 | 0 |
| 構文 | 整数 |
| 例 | nsslapd-pagedidlistscanlimit: 5000 |
6.4.1.13. nsslapd-pagedlookthroughlimit
このパフォーマンス関連の属性は、単純なページ結果制御を使用する検索の候補エントリーを調べる時に Directory Server がチェックするエントリーの最大数を指定します。
この属性は nsslapd-lookthroughlimit 属性と同じように機能しますが、単純なページ結果制御の検索にのみ適用される点が異なります。
この属性が存在しないか、ゼロに設定されている場合は、nsslapd-lookthroughlimit を使用して、ページングされた検索と、ページングされていない検索の両方を行います。
対応するユーザーレベルの属性は nsPagedLookThroughLimit です。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=config,cn=ldbm database,cn=plugins,cn=config |
| Valid Range | エントリーの -1 から最大 32 ビット整数までです (-1 は無制限)。 |
| デフォルト値 | 0 |
| 構文 | 整数 |
| 例 | nsslapd-pagedlookthroughlimit: 25000 |
6.4.1.14. nsslapd-rangelookthroughlimit
このパフォーマンス関連の属性は、範囲検索リクエストへの応答として候補のエントリーを調べるときに Directory Server がチェックするエントリーの最大数を指定します。
範囲検索は演算子を使用して括弧を設定して検索し、ディレクトリー内のエントリーのサブセット全体を返します。たとえば、これにより 1 月 1 日の午前 0 時以降に変更されたすべてのエントリーを検索します。
(modifyTimestamp>=20200101010101Z)範囲検索の性質は、ディレクトリー内のすべてのエントリーを評価して、その範囲内にあるかどうかを確認する必要があることです。基本的に、範囲検索は常に ID 検索です。
ほとんどのユーザーの場合は、ルックスルーの制限が開始され、範囲の検索が全 ID 検索に変換するのを防ぎます。これにより、全体的なパフォーマンスが向上し、さまざまな検索結果を加速します。ただし、Directory Manager などの一部のクライアントまたは管理ユーザーには、ルックスルー制限が設定されていない場合があります。この場合は、範囲検索が完了するまで数分かかるか、無限に続行することがあります。
nsslapd-rangelookthroughlimit 属性は、Directory Manager を含むすべてのユーザーに適用される個別の範囲のルックスルー制限を設定します。
これにより、クライアントや管理者ユーザーは、パフォーマンスが低下する可能性のある範囲検索に合理的な制限を設けながらも、高いルックスルー制限を設定することができます。
その他のリソース制限とは異なり、Directory Manager、通常ユーザー、およびその他の LDAP クライアントなどのユーザーによる検索に適用されます。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=config,cn=ldbm database,cn=plugins,cn=config |
| Valid Range | エントリーの -1 から最大 32 ビット整数までです (-1 は無制限)。 |
| デフォルト値 | 5000 |
| 構文 | 整数 |
| 例 | nsslapd-rangelookthroughlimit: 5000 |
6.4.1.15. nsslapd-search-bypass-filter-test
nsslapd-search-bypass-filter-test パラメーターを有効にすると、Directory Server は、検索時に候補リストをビルドするタイミングでフィルターチェックを回避します。パラメーターを verify に設定すると、Directory Server は検索候補エントリーに対してフィルターを評価します。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=config,cn=ldbm database,cn=plugins,cn=config |
| 有効な値 | on | off | verify |
| デフォルト値 | on |
| 構文 | ディレクトリー文字列 |
| 例 | nsslapd-search-bypass-filter-test: on |
6.4.1.16. nsslapd-search-use-vlv-index
nsslapd-search-use-vlv-index は、仮想リストビュー (VLV) 検索を有効または無効にします。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=config,cn=ldbm database,cn=plugins,cn=config |
| 有効な値 | on | off |
| デフォルト値 | on |
| 構文 | ディレクトリー文字列 |
| 例 | nsslapd-search-use-vlv-index: on |
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}