4.10. Distributed Numeric Assignment プラグインの属性
Distributed Numeric Assignment プラグインは、数値の範囲を管理し、その範囲内の一意の番号をエントリーに割り当てます。番号の割り当てを範囲に分割することで、Distributed Numeric Assignment プラグインは、競合なしに複数のサーバーが数値を割り当てることができます。プラグインは、サーバーに割り当てられた範囲も管理します。そのため、1 つのインスタンスがその範囲で迅速に実行される場合は、他のサーバーから追加の範囲を要求できます。
分散数値割り当ては、単一の属性型または複数の属性タイプを使用するように設定でき、サブツリー内の特定の接尾辞および特定のエントリーにのみ適用されます。
分散数値割り当ては属性ごとに処理され、サブツリー内の特定の接尾辞と特定のエントリーにのみ適用されます。
4.10.1. dnaPluginConfig (オブジェクトクラス)
このオブジェクトクラスは、エントリーに割り当てる DNA プラグインおよび数値範囲を設定するエントリーに使用されます。
このオブジェクトクラスは Directory Server に定義されています。
上級クラス
top
OID
2.16.840.1.113730.3.2.324
使用できる属性
- dnaType
- dnaPrefix
- dnaNextValue
- dnaMaxValue: 1000
- dnaInterval
- dnaMagicRegen
- dnaFilter
- dnaScope
- dnaSharedCfgDN
- dnaThreshold
- dnaNextRange
- dnaRangeRequestTimeout
- cn
4.10.2. dnaFilter
この属性は、分散数値割り当て範囲を適用するエントリーを検索および識別するために使用する LDAP フィルターを設定します。
dnaFilter 属性は、属性の分散数値割り当てを設定するために必要です。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=DNA_config_entry,cn=Distributed Numeric Assignment Plugin,cn=plugins,cn=config |
| Valid Range | 有効な LDAP フィルター |
| デフォルト値 | なし |
| 構文 | DirectoryString |
| 例 | dnaFilter: (objectclass=person) |
4.10.3. dnaInterval
この属性は、範囲内の数値をインクリメントするために使用する間隔を設定します。基本的に、これは事前定義されたレートで数値をスキップします。間隔が 3 で、範囲内の最初の数字が 1 の場合、範囲内で使用される次の数字は 4、7、10 と、新しい数字を割り当てるたびに 3 ずつ増加していきます。
レプリケーション環境では、dnaInterval により、複数のサーバーが同じ範囲を共有できます。ただし、同じ範囲を共有する異なるサーバーを設定する場合は、それに応じて dnaInterval パラメーターと dnaNextVal パラメーターを設定し、異なるサーバーが同じ値を生成しないようにします。レプリケーショントポロジーに新しいサーバーを追加する場合も、これを考慮する必要があります。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=DNA_config_entry,cn=Distributed Numeric Assignment Plugin,cn=plugins,cn=config |
| Valid Range | 任意の整数 |
| デフォルト値 | 1 |
| 構文 | 整数 |
| 例 | dnaInterval: 1 |
4.10.4. dnaMagicRegen
この属性は、エントリーに新しい値を割り当てるようにプラグインに指示するユーザー定義の値を設定します。マジック値は、既存のエントリーに新しい一意の番号を割り当てるため、または新しいエントリーを追加するときの標準設定として使用できます。
マジックエントリーは、誤ってトリガーされないように、サーバーに対して定義された範囲外にある必要があります。DirectoryString または他の文字タイプで使用する場合、この属性は数値である必要はないことに注意してください。ただし、ほとんどの場合、DNA プラグインは整数値のみを許可する属性で使用されます。この場合は、dnamagicregen 値も整数である必要があります。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=DNA_config_entry,cn=Distributed Numeric Assignment Plugin,cn=plugins,cn=config |
| Valid Range | 任意の文字列 |
| デフォルト値 | なし |
| 構文 | DirectoryString |
| 例 | dnaMagicRegen: -1 |
4.10.5. dnaMaxValue: 1000
この属性は、範囲に割り当てることができる最大値を設定します。デフォルトは -1 で、最大 64 ビット整数を設定するのと同じです。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=DNA_config_entry,cn=Distributed Numeric Assignment Plugin,cn=plugins,cn=config |
| Valid Range | 32 ビットシステムでは 1 から最大 32 ビット整数、64 ビットシステムでは最大 64 ビット整数。-1 は無制限。 |
| デフォルト値 | -1 |
| 構文 | 整数 |
| 例 | dnaMaxValue: 1000 |
4.10.6. dnaNextRange
この属性は、現在の範囲が使い切られるときに使用する次の範囲を定義します。この値は、範囲がサーバー間で転送される際に自動的に設定されますが、範囲要求を使用しない場合は、手動で範囲をサーバーに追加するように設定することもできます。
dnaNextRange 属性は、個別の特定範囲を他のサーバーに割り当てる必要がある場合にのみ明示的に設定する必要があります。dnaNextRange 属性に設定した範囲は、重複を避けるために、他のサーバーで利用可能な範囲から一意でなければなりません。他のサーバーからの要求がなく、 dnaNextRange が明示的に設定されているサーバーがその設定された dnaMaxValue に達した場合、次の値のセット (dnaNextRange の一部) がこのデッキから割り当てられます。
dnaNextRange の割り当ては、DNA 設定で設定された dnaThreshold 属性によっても制限されます。dnaNextRange 用に別のサーバーに割り当てられる範囲は、範囲が dnaNextRange のデッキで利用可能であっても、サーバーのしきい値に違反できません。
dnaNextRange 属性が明示的に設定されていない場合に内部で処理される場合。自動的に処理される場合、dnaMaxValue 属性は次の範囲の上限として機能します。
この属性は、範囲を lower_range-upper_range の形式で設定します。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=DNA_config_entry,cn=Distributed Numeric Assignment Plugin,cn=plugins,cn=config |
| Valid Range | 32 ビットシステムでは 1 から最大 32 ビット整数、64 ビットシステムでは下限と上限の h 範囲に最大 64 ビット整数 |
| デフォルト値 | なし |
| 構文 | DirectoryString |
| 例 | dnaNextRange: 100-500 |
4.10.7. dnaNextValue
この属性は、次に割り当て可能な番号を提供します。設定エントリーで最初に設定された後、この属性は分散数値割り当てプラグインによって管理されます。
dnaNextValue 属性は、属性の分散数値割り当てを設定するために必要です。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=DNA_config_entry,cn=Distributed Numeric Assignment Plugin,cn=plugins,cn=config |
| Valid Range | 32 ビットシステムでは 1 から最大 32 ビット整数、64 ビットシステムでは最大 64 ビット整数 |
| デフォルト値 | -1 |
| 構文 | 整数 |
| 例 | dnaNextValue: 1 |
4.10.8. dnaPrefix
この属性は、属性に生成された番号の値の前に付けることができる接頭辞を定義します。たとえば、user1000 などのユーザー ID を生成するには、dnaPrefix 設定は user になります。
dnaPrefix は、あらゆる種類の文字列を保持できます。ただし、dnaType の一部の可能な値 (uidNumber や gidNumber など) には整数値のみが必要です。接頭辞文字列を使用するには、文字列を許可する dnaType のカスタム属性の使用を検討してください。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=DNA_config_entry,cn=Distributed Numeric Assignment Plugin,cn=plugins,cn=config |
| Valid Range | 任意の文字列 |
| デフォルト値 | None |
| 例 | dnaPrefix: id |
4.10.9. dnaRangeRequestTimeout
Distributed Numeric Assignment プラグインを使用すると考えられる状況の 1 つは、1 台のサーバーが割り当てる番号が不足し始めていることです。dnaThreshold 属性は、範囲内で使用可能な番号のしきい値を設定します。これにより、サーバーは、番号の割り当てを実行できなくなる前に、他のサーバーに追加の範囲を要求できます。
dnaRangeRequestTimeout 属性は、範囲要求のタイムアウト期間を秒単位で設定します。これにより、サーバーは 1 つのサーバーからの新しい範囲の待機を停止せず、新しいサーバーからの範囲を要求できます。
範囲要求を実行するには、dnaSharedCfgDN 属性を設定する必要があります。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=DNA_config_entry,cn=Distributed Numeric Assignment Plugin,cn=plugins,cn=config |
| Valid Range | 32 ビットシステムでは 1 から最大 32 ビット整数、64 ビットシステムでは最大 64 ビット整数 |
| デフォルト値 | 10 |
| 構文 | 整数 |
| 例 | dnaRangeRequestTimeout: 15 |
4.10.10. dnaScope
この属性は、分散数値割り当てを適用するエントリーを検索するためのベース DN を設定します。これは ldapsearch のベース DN と似ています。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=DNA_config_entry,cn=Distributed Numeric Assignment Plugin,cn=plugins,cn=config |
| Valid Range | Directory Server エントリー |
| デフォルト値 | なし |
| 構文 | DirectoryString |
| 例 | dnaScope: ou=people,dc=example,dc=com |
4.10.12. dnaThreshold
Distributed Numeric Assignment プラグインを使用すると考えられる状況の 1 つは、1 台のサーバーが割り当てる番号が不足し始め、問題が発生する可能性があることです。分散数値割り当てプラグインを使用すると、サーバーは他のサーバーで使用可能な範囲から新しい範囲を要求できます。
サーバーは割り当てられた範囲の終了に到達すると認識できるため、dnaThreshold 属性は範囲内で利用可能な残りの数字のしきい値を設定します。サーバーがしきい値に達すると、新しい範囲の要求を送信します。
範囲要求を実行するには、dnaSharedCfgDN 属性を設定する必要があります。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=DNA_config_entry,cn=Distributed Numeric Assignment Plugin,cn=plugins,cn=config |
| Valid Range | 32 ビットシステムでは 1 から最大 32 ビット整数、64 ビットシステムでは最大 64 ビット整数 |
| デフォルト値 | 100 |
| 構文 | 整数 |
| 例 | dnaThreshold: 100 |
4.10.13. dnaType
この属性は、一意の数字が生成される属性を設定します。この場合、マジック番号を持つエントリーに属性が追加されるたびに、割り当てられた値が自動的に指定されます。
この属性は、属性に分散した数値割り当てを設定するには必要になります。
dnaPrefix 属性が設定されている場合、接頭辞の値は dnaType によって生成される値の前に付けられます。dnaPrefix 値には任意の文字列を指定できますが、dnaType (uidNumber や gidNumber など) の妥当な値には整数値のみが必要になります。接頭辞文字列を使用するには、文字列を許可する dnaType のカスタム属性の使用を検討してください。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=DNA_config_entry,cn=Distributed Numeric Assignment Plugin,cn=plugins,cn=config |
| Valid Range | Directory Server の属性 |
| デフォルト値 | None |
| 例 | dnaType: uidNumber |
4.10.15. dnaHostname
この属性は、複数サ upplier レプリケーションの特定ホストの DNA 範囲設定の一部として、共有範囲内のサーバーのホスト名を特定します。利用可能な範囲はホストによって追跡され、範囲情報はすべてのサプライヤー間で複製されるため、サプライヤーが利用可能な数が少ない場合に、ホスト情報を使用して別のサプライヤーに連絡し、新しい範囲を要求できます。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=DNA_config_entry,cn=Distributed Numeric Assignment Plugin,cn=plugins,cn=config |
| 構文 | DirectoryString |
| Valid Range | 有効なホスト名 |
| デフォルト値 | None |
| 例 | dnahostname: ldap1.example.com |
4.10.16. dnaPortNum
この属性は、dnaHostname で特定されたホストへの接続に使用する標準のポート番号を指定します。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=DNA_config_entry,cn=Distributed Numeric Assignment Plugin,cn=plugins,cn=config |
| 構文 | 整数 |
| Valid Range | 0 から 65535 |
| デフォルト値 | 389 |
| 例 | dnaPortNum: 389 |
4.10.17. dnaRemainingValues
この属性には、残りの値と、エントリーに割り当てるサーバーで使用できる値の数が含まれます。
| パラメーター | 説明 |
|---|---|
| エントリー DN | dnaHostname=host_name+dnaPortNum=port_number,ou=ranges,dc=example,dc=com |
| 構文 | 整数 |
| Valid Range | 任意の整数 |
| デフォルト値 | None |
| 例 | dnaRemainingValues: 1000 |
4.10.18. dnaRemoteBindCred
Replication Manager のパスワードを指定します。認証が必要な dnaRemoteBindMethod 属性にバインドメソッドを設定する場合は、 cn=config エントリーの下のプラグイン設定エントリーのレプリケーションデプロイメント内のすべてのサーバーに dnaRemoteBindDN および dnaRemoteBindCred パラメーターを追加で設定します。
パラメーターをプレーンテキストで設定します。値は、保存される前に自動的に AES 暗号化されます。
変更を反映するには、サーバーを再起動する必要があります。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=DNA_config_entry,cn=Distributed Numeric Assignment Plugin,cn=plugins,cn=config |
| 構文 | DirectoryString {AES} encrypted_password |
| 有効な値 | 有効な AES 暗号化パスワード。 |
| デフォルト値 | |
| 例 | dnaRemoteBindCred: {AES-TUhNR0NTcUdTSWIzRFFFRkRUQm1NRVVHQ1NxR1NJYjNEUUVGRERBNEJDUmxObUk0WXpjM1l5MHdaVE5rTXpZNA0KTnkxaE9XSmhORGRoT0MwMk1ESmpNV014TUFBQ0FRSUNBU0F3Q2dZSUtvWklodmNOQWdjd0hRWUpZSVpJQVdVRA0KQkFFcUJCQk5KbUFDUWFOMHlITWdsUVp3QjBJOQ==}bBR3On6cBmw0DdhcRx826g== |
4.10.19. dnaRemoteBindDN
Replication Manager DN を指定します。認証が必要な dnaRemoteBindMethod 属性にバインドメソッドを設定する場合は、 cn=config エントリーの下のプラグイン設定のレプリケーションデプロイメント内のすべてのサーバーに dnaRemoteBindDN および dnaRemoteBindCred パラメーターを追加で設定します。
変更を反映するには、サーバーを再起動する必要があります。
| パラメーター | 説明 |
|---|---|
| エントリー DN | cn=DNA_config_entry,cn=Distributed Numeric Assignment Plugin,cn=plugins,cn=config |
| 構文 | DirectoryString |
| 有効な値 | 有効な Replication Manager DN。 |
| デフォルト値 | |
| 例 | dnaRemoteBindDN: cn=replication manager,cn=config |
4.10.20. dnaRemoteBindMethod
リモートバインドメソッドを指定します。認証が必要な この属性にバインドメソッドを設定する場合は、cn=config エントリーの下のプラグイン設定エントリーのレプリケーションデプロイメント内のすべてのサーバーに dnaRemoteBindDN および dnaRemoteBindCred パラメーターを追加で設定します。
変更を反映するには、サーバーを再起動する必要があります。
| パラメーター | 説明 |
|---|---|
| エントリー DN | dnaHostname=host_name+dnaPortNum=port_number,ou=ranges,dc=example,dc=com |
| 構文 | DirectoryString |
| 有効な値 |
|
| デフォルト値 | |
| 例 | dnaRemoteBindMethod: SIMPLE |
4.10.21. dnaRemoteConnProtocol
リモート接続プロトコルを指定します。
変更を反映するには、サーバーを再起動する必要があります。
| パラメーター | 説明 |
|---|---|
| エントリー DN | dnaHostname=host_name+dnaPortNum=port_number,ou=ranges,dc=example,dc=com |
| 構文 | DirectoryString |
| 有効な値 |
|
| デフォルト値 | |
| 例 | dnaRemoteConnProtocol: LDAP |
4.10.22. dnaSecurePortNum
この属性は、dnaHostname で特定されたホストへの接続に使用するセキュアな (TLS) ポート番号を指定します。
| パラメーター | 説明 |
|---|---|
| エントリー DN | dnaHostname=host_name+dnaPortNum=port_number,ou=ranges,dc=example,dc=com |
| 構文 | 整数 |
| Valid Range | 0 から 65535 |
| デフォルト値 | 636 |
| 例 | dnaSecurePortNum: 636 |
