動的 LDAP 接続プールを設定する

このページの内容

このセクションの項目

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

動的 LDAP 接続プールは、ディレクトリ単位の詳細なプール設定をサポートし、各接続プールの検証と保守を制御するパラメーターを追加します。これは、コネクタ ディレクトリと委任認証ディレクトリでのみ使用できます (以下のリストを参照)。また、StartTLS 接続もサポートします。

コネクタ ディレクトリには以下が含まれます。

  • Microsoft Active Directory (AD ディレクトリ) – このオプションは、最も一般的な LDAP ディレクトリの種類である AD を簡単に選択するために提供されています

  • LDAP ディレクトリ — 次の画面で他の LDAP ディレクトリの種類から選択できます

委任認証ディレクトリには以下が含まれます。

  • 内部 (LDAP 認証)

はじめる前に

JNDI プールと動的 LDAP プールを切り替える場合、または動的プールの設定を変更する場合、Confluence を再起動する必要はありません。

ただし、設定の変更は勤務時間外にのみ行うことをお勧めします。変更を行うと、ディレクトリで実行されているすべてのアクションが終了し、短時間の停止が発生する可能性があります。

詳細を読む...

Confluence では、接続設定 (URL、セキュア モード、認証情報) またはプール設定を変更すると、更新された設定で新しい接続プールが作成されます。プールはほぼ即座に作成されますが、場合によっては、ユーザーが実行したアクションで古いプールからの接続を借用する必要があり、この短い時間に失敗する可能性があります。この問題は必ず発生するとは限りません。古いプールから既に借用されている接続は引き続き機能し、失敗するのは新しい接続だけです。問題を防ぐため、周囲のユーザーが少なくなるのを待つ方が安全です。

接続プールを有効にする

ディレクトリの動的 LDAP 接続プールを有効にするには、次の手順を実行します。

  1. Go to Administration menu , then General Configuration..

  2. サイド メニューから [ユーザー ディレクトリ] を選択します。
  3. リストから、コネクタ ディレクトリまたは委任ディレクトリを選択し、[編集] を選択します。

  4. [LDAP 接続プール] セクションを展開します。

  5. [動的プール] オプションを選択します。

  6. パラメーターを設定します。詳細は次のテーブルをご確認ください。

  7. 設定をテストするには、[クイック テスト] を選択します。接続が確立できれば、成功のメッセージが表示されます。
  8. [保存してテスト] を選択して変更を保存します。

スクリーンショット:既存のディレクトリでの動的 LDAP プールの設定

プール パラメーター

動的接続プールごとに、次のパラメーターを設定できます。

PoolSize

動的プール パラメーター説明 既定値

最大総数

プールから同時に割り当てられる(すべてのタイプの)アクティブな接続の最大数。正でない値は、数値を無制限に設定します。

-1

タイプごとの最大総数

プールによって割り当てられる(チェックアウト済みまたはアイドル状態)、キーごとの接続スロットの制限。キー タイプごとに、読み取り専用接続または読み取り/書き込み接続のサブプールが決まります。制限に達すると、サブプールは枯渇します。正でない値は、数値を無制限に設定します。

-1

タイプごとの最大アイドル

各キー タイプ(読み取り専用と読み取り/書き込み)で、追加の接続を解放せずにプール内でアイドル状態を維持できるアクティブな接続の最大数。キー タイプごとに、読み取り専用接続と読み取り/書き込み接続のサブプールが決まります。正でない値は、数値を無制限に設定します。

-1

タイプごとの最小アイドル

追加の接続を作成せずにプール内でアイドル状態を維持できる、各キー タイプ(読み取り専用と読み取り/書き込み)のアクティブな接続の最小数。キー タイプごとに、読み取り専用接続と読み取り/書き込み接続のサブプールが決まります。正でない値は、数値を無制限に設定します。

0

枯渇時のプールの動作

次のパラメーターは、拡張可能な [詳細設定] セクションの「接続タイムアウト」パラメーターとは異なります。

ご利用のディレクトリ タイプでの「接続タイムアウト」の仕組み...

「接続タイムアウト」パラメーターは、ディレクトリ タイプによって動作が異なります。

  • 動的プール – ディレクトリに接続するための時間制限を指定します。
  • JNDI プール – ディレクトリに接続する時間制限と、プールが枯渇したあとに、接続が戻るまでプールが待機する最大時間を指定します。

動的プールでは、接続が戻るまでプールが待機する最大時間が、次に説明する「最大待機時間」で区切られ、制御されます。

動的プール パラメーター説明 既定値

枯渇時に待機する

これが有効である場合、利用できる接続がないときにプールは接続が返却されるのを待ちます。有効でない場合は、ログ ファイルにプールが枯渇したことを記録して、エラーを保存します。

最大待機」パラメーターが正の値で設定されている場合は、待機期間を超えても新しい接続スロットがないと NoSuchElementException がスローされます。

true

最大待機

「枯渇時に待機する」オプションが有効である場合に、プールが接続の返却を待つ最大待機時間を決定します。無期限に待機するには、正でない値を指定します。

これは、[枯渇時に待機する] オプションが有効になっている場合にのみ適用されます。 

-1

接続のテスト

動的プール パラメーター説明 既定値
接続の作成時にテストする接続を作成した際に、接続の有効性を検証します。接続の検証に失敗した場合は、その接続を借用できません。false
接続の借用時にテストするプールから接続を借用する際に接続の有効性を検証します。接続が検証に失敗した場合は、その接続がプールから削除されて、別の接続を借用しようとします。true
接続の返却時にテストするプールに接続を返却する際に接続の有効性を検証します。false
アイドル接続をテストするアイドル接続を検証します。接続が検証に失敗すると、プールから削除されます。false

アイドル接続の強制除去

動的プール パラメーター説明 既定値
強制除去の間隔(秒)強制除去の対象になった接続に対して、強制除去の間隔を指定します。値は正の数にする必要があります。300 秒
(5 分)
強制除去の対象になるまでの時間(秒)アイドル状態が続いている接続が強制除去の対象になるまでの時間を指定します。300 秒
(5 分)

動的 LDAP 接続プールを有効化したあとは、その監視方法をご確認ください。

最終更新日: 2024 年 10 月 3 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する

このセクションの項目

Powered by Confluence and Scroll Viewport.