pureQuery Runtime 構成および検査のスクリプトでの WebSphere Application Server アプリケーションの構成

pureQuery® インストール・ディレクトリーには、pureQuery が使用可能なアプリケーションを実行できるようにするために、 WebSphere® Application Server を構成するスクリプトが含まれています。 ディレクトリーには WebSphere Application Server が正しく構成されたことを検査する WebSphere サーブレット・アプリケーションも含まれています。

始める前に

スクリプトを実行するユーザーには以下の特権が必要です。

このタスクについて

スクリプトは pureQuery Runtime インストール・ディレクトリーの PureQuery_Websphere_Config_Scripts ディレクトリーにあります。

スクリプトに必須および任意のパラメーターを表示するため、パラメーターを指定せずにスクリプトを実行できます。

手順

pureQuery Runtime が動作するように WebSphere Application Server を構成するスクリプトを実行し、構成を検査するには、スクリプトを以下の順序で実行します。

  1. JDBC プロバイダー・クラスパスを pureQuery Runtime 情報で更新するため、InstallPQJars スクリプトを実行します
  2. pureQuery Runtime プロパティーを指定するカスタム・データ・ソース・プロパティーを作成するため、SetupDSProp スクリプトを実行します
  3. pureQuery Runtime 構成を検査するため、InstallPQValidator スクリプトを実行します

pureQuery Runtime JAR ファイルを JDBC プロバイダー・クラスパスに追加するため、InstallPQJars スクリプトを実行します。

InstallPQJars スクリプトを実行する際、更新のための WebSphere JDBC プロバイダーのスコープおよび、pureQuery Runtime JAR ファイルへのパスを指定します。スクリプトが表示する JDBC プロバイダーのリストから選択します。 スクリプトは、指定した JDBC プロバイダーのクラスパスを更新します。 スクリプトはプロバイダーのクラスパスを構成した後、WebSphere JDBC プロバイダー、 pureQuery Runtime、および Java 環境についての情報を表示します。

手順

pureQuery Runtime JAR ファイルを、JDBC プロバイダー・クラスパスに追加するためのスクリプトを実行するには以下のようにします。

  1. コマンド・ウィンドウを開き InstallPQJars スクリプトを実行します。 例えば、次のコマンドは WebSphere ノードに devNode01 を、およびpureQuery Runtime JAR ファイルへのパスに C:/PureQueryRuntime を指定します。:
     InstallPQJars -node devNode01 -pqPath C:/PureQueryRuntime

    このコマンドの例では、ノード・レベルで WebSphere JDBC プロバイダーが定義されること、および WebSphere Application Server インストールは単一のスタンドアロン・インストールであることを前提とします。

  2. JDBC プロバイダー・クラスパスを構成するには、スクリプトの指示にしたがってください。

    スクリプトが pureQuery Runtime JAR ファイルをクラスパス内に検出した場合、クラスパスを更新するか、現行のクラスパスを維持するかを選択できます。

    スクリプトが完了すると、WebSphere、pureQuery、および Java の構成情報が表示されます。

次のタスク

管理コンソールから、更新された JDBC プロバイダー・クラスパスを pureQuery Runtime 情報とともに表示できます。

次に、pureQuery Runtime プロパティーを使用して JDBC プロバイダー・データ・ソースを構成するため、SetupDSProp スクリプトを実行します。

データ・ソースに pureQuery Runtime プロパティーを追加するための SetupDSProp スクリプトの実行

SetupDSProp スクリプトを実行する際、pureQuery Runtime プロパティー値およびWebSphere サーバーを指定します。 SetupDSProp スクリプトによって、指定されたデータ・ソース用のカスタム・プロパティー pdqProperties が作成されます。 プロパティーの値は、指定された pureQuery Runtime プロパティー値のリストです。

手順

データ・ソースを構成するためにスクリプトを実行するには、次のようにします。

  1. コマンド・ウィンドウを開き、SetupDSProp スクリプトを実行します。 例えば、次のコマンドは WebSphere サーバー server1 を指定し、pureQuery Runtime プロパティー captureMode の値を ON、およびプロパティー pureQueryXml の値を C:\temp\capture.pdqxml に指定します。
    SetupDSProp -server server1 -props "captureMode(ON), pureQueryXml(C:\temp\capture.pdqxml)"
    注: スクリプトは、指定した pureQuery Runtime プロパティー値を検査しません。 スクリプトは、プロパティー値としてストリングを使用し、カスタム・プロパティー pdqProperties を作成します。
  2. データ・ソースを構成するには、スクリプトの指示にしたがってください。

    構成用にデータ・ソースを選択した後、スクリプトはカスタム・プロパティーを作成します。 その後、スクリプトはデータ・ソースおよびカスタム・プロパティーに関する情報を表示します。

タスクの結果

管理コンソールから、pdqProperties カスタム・プロパティーが設定されたことを確認できます。プロパティーは、データ・ソースのカスタム・プロパティーとしてリストされます。

次のタスク

次に InstallPQValidator スクリプトを実行し、pureQuery Runtime 構成が InstallPQValidator スクリプトの実行によって正しく構成されたことを検証します。

pureQuery Runtime 構成を検証する、InstallPQValidator スクリプトの実行

InstallPQValidator スクリプトは、WebSphere サーブレットRunPQDataVersionEAR.ear をインストールして開始します。サーブレットは、データ・ソースに対する pureQuery 構成と、pureQuery Runtime の前提条件を検証します。 サーブレットは、コンテキスト、アプリケーション・クラス・ローダー、グローバル pureQuery プロパティー、および pureQuery Runtime バージョン情報を表示します。

手順

pureQuery Runtime インストールを検証するために、スクリプトを実行するには次のようにします。

  1. コマンド・ウィンドウを開き、InstallPQValidator スクリプトを実行します。 例えば、次のコマンドは WebSphere サーバーを server1、ノードを devNode01 と指定します。
    InstallPQValidator -server server1 -node devNode01
    スクリプトはサーブレットをインストールして開始します。

    サーブレットは、管理コンソールにアプリケーションとしてリストされます。

  2. ブラウザーからサーブレットを実行します。 サーブレットを開始するには、ブラウザーを開いて URL を入力します。
    例えば、次の URL は WebSphere が実行されていること、コンピューター上にサーブレットが存在すること、および WebSphere Application Server ポートが 9081 であることを前提としています。
    http://localhost:9081/RunPQValidate/
    サーブレット・ページが開きます。
  3. サーブレット・ページの DB2® データ・ソースに JNDI 名を入力し、「送信」をクリックします。

    サーブレットはデータ・ソースとの接続を作成し、その後ブラウザー・ウィンドウに構成情報を表示します。

次のタスク

pureQuery Runtime 用の WebSphere Application Server データ・ソースが構成されました。 pureQuery により、データ・ソースを使って DB2 データベースへのアクセスすることが可能になりました。

フィードバック