> # Jolt接続プール

> 列の表示 関連タスク

> Joltは、任意のJava EE Webサーバー上の汎用JavaクライアントおよびアプリケーションからOracle Tuxedoサービスへのリクエストを管理するJavaベースのクライアントAPIです。Jolt接続プールを使用すると、WebLogic Server上のアプリケーションからOracle Tuxedoドメインに接続できるようになります。

> このページでは、現在のWebLogic Serverドメイン内に構成されているJolt接続プールの概要を示します。

> Jolt APIはWebLogic Server APIに組み込まれており、WebLogic Server上で稼動するサーブレットまたはその他のアプリケーションからアクセスできます。各WebLogic Serverインスタンスは、起動時にJolt接続プールを作成し、必要に応じてサーブレットまたはアプリケーションに接続を割り当てます。接続プールは、Tuxedoサーバー上で稼動するJoltサービス・リスナー(JSL)を介してOracle Tuxedoに接続します。

> #### 列の表示

> 「この表のカスタマイズ」を展開して「列の表示」リストを変更すると、このページに表示されるデータ・ポイントを減らしたり増やしたりできます。それぞれのデータ・ポイントは各自の表列に表示されます。

> 次の表に、このページの列に表示できるすべてのデータ・ポイントを記載します。

> 名前 | 説明
> --- | ---
> 名前 | このJolt接続プールの名前。 MBean属性: `JoltConnectionPoolMBean.Name` 変更は、モジュールの再デプロイ後またはサーバーの再起動後に有効になります。
> ターゲット | このJolt接続プールの現在のターゲットのリスト。
> プライマリ・アドレス | TuxedoシステムのプライマリJoltサーバー・リスナー(JSL)のアドレス・リスト。 各アドレスのフォーマットは`//hostname:port`です。複数のアドレスはカンマで区切る必要があります。 MBean属性: `JoltConnectionPoolMBean.PrimaryAddresses` 変更は、モジュールの再デプロイ後またはサーバーの再起動後に有効になります。
> フェイルオーバー・アドレス | 接続プールがプライマリ・アドレスへの接続を確立できない場合、または失敗した場合に使用されるJoltサーバー・リスナー(Jolt Server Listener: JSL)アドレスのリスト。 各アドレスのフォーマットは`//hostname:port`です。複数のアドレスはカンマで区切る必要があります。 これらのJSLは、プライマリJSLと同じホスト上に存在している必要があります。 MBean属性: `JoltConnectionPoolMBean.FailoverAddresses` 変更は、モジュールの再デプロイ後またはサーバーの再起動後に有効になります。
> 最小プール・サイズ | WebLogic Serverが起動したときに、このJolt接続プールに追加する接続の最小数。 MBean属性: `JoltConnectionPoolMBean.MinimumPoolSize` 最小値: `0` 最大値: `2147483647` 変更は、モジュールの再デプロイ後またはサーバーの再起動後に有効になります。
> 最大プール・サイズ | このJolt接続プールから開始できる接続の最大数。 MBean属性: `JoltConnectionPoolMBean.MaximumPoolSize` 最小値: `1` 最大値: `2147483647` 変更は、モジュールの再デプロイ後またはサーバーの再起動後に有効になります。
> ユーザー・ロール | このJolt接続プールのTuxedoユーザー・ロール。(これは、Tuxedoドメインのセキュリティ・レベルが`USER_AUTH`、`ACL`、または`MANDATORY_ACL`の場合にのみ必須です)。 MBean属性: `JoltConnectionPoolMBean.UserRole` 変更は、モジュールの再デプロイ後またはサーバーの再起動後に有効になります。
> セキュリティ・コンテキストの有効化 | このJolt接続プールが、WebLogic Serverユーザーからの接続プールのセキュリティ・コンテキスト(ユーザー名、パスワードおよびその他の情報)をTuxedoドメインに渡すかどうかを指定します。 セキュリティ・コンテキストを渡すように接続プールを有効化する場合、`-a`オプションを指定してJoltサービス・ハンドラ(Jolt Service Handler: JSH)を起動する必要があります。JSHは、呼出し元のIDが付いたメッセージを取得すると、`impersonate_user()`を呼び出してそのユーザーのappkeyを取得します。JSHはappkeyをキャッシュし、呼出し元が次に要求したときに、appkeyをキャッシュから取り出してリクエストがサービスに転送されるようにします。キャッシュはJSHごとに維持されます。つまり、同じJSHに接続されたすべてのセッション・プールに対して1つのキャッシュが維持されます。 Tuxedoが安全な接続を要求する場合、セキュリティ・コンテキストを有効化する必要があります。 MBean属性: `JoltConnectionPoolMBean.SecurityContextEnabled` セキュアな値: `true` 変更は、モジュールの再デプロイ後またはサーバーの再起動後に有効になります。
> RecvTimeout | このJolt接続プールのTuxedoユーザー・ロール。(これは、Tuxedoドメインのセキュリティ・レベルが`USER_AUTH`、`ACL`、または`MANDATORY_ACL`の場合にのみ必須です)。 MBean属性: `JoltConnectionPoolMBean.UserRole` 変更は、モジュールの再デプロイ後またはサーバーの再起動後に有効になります。
> ユーザー名 | アプリケーションが、このJolt接続プールに接続するために指定するユーザー名。セキュリティ・コンテキストが有効化されている場合、認可されたTuxedoユーザーの名前にする必要があります。(Tuxedoの認証レベルが`USER_AUTH`の場合に、Tuxedoユーザー名を指定する必要があります。) MBean属性: `JoltConnectionPoolMBean.UserName` 変更は、モジュールの再デプロイ後またはサーバーの再起動後に有効になります。

> 関連タスク

> - Joltを使用したTuxedoへの接続
> - Jolt接続プールの監視
> - Jolt接続のリセット
> - Jolt接続プールの削除