使用 pureQuery Runtime 配置及驗證 Script 配置 WebSphere Application Server 應用程式

pureQuery® 安裝目錄包含可將 WebSphere® Application Server 配置為執行 pureQuery 啟用的應用程式的 Script。 此目錄也包含驗證是否已正確地配置 WebSphere Application Server 的 WebSphere Servlet 應用程式。

開始之前

正在執行 Script 的使用者必須具有下列專用權:

關於這項作業

Script 位於 pureQuery Runtime 安裝目錄的 PureQuery_Websphere_Config_Scripts 目錄。

您可以執行 Script 而不指定參數, 以顯示 Script 的必要及選用參數。

程序

若要執行 Script,將 WebSphere Application Server 配置為使用 pureQuery Runtime,並驗證配置,請依此順序執行 Script:

  1. 執行 InstallPQJars Script,以 pureQuery Runtime 資訊更新 JDBC 提供者類別路徑
  2. 執行 SetupDSProp Script,建立自訂資料來源內容,以指定 pureQuery Runtime 內容
  3. 執行 InstallPQValidator Script,以驗證 pureQuery Runtime 配置

執行 InstallPQJars Script,以新增 pureQuery Runtime JAR 檔至 JDBC 提供者類別路徑

當執行 InstallPQJars Script 時,您可以指定要更新的 WebSphere JDBC 提供者範圍, 以及 pureQuery Runtime JAR 檔的路徑。您可以從 Script 顯示的提供者清單中選取 JDBC 提供者。 Script 會更新您指定之 JDBC 提供者的類別路徑。 在 Script 配置提供者類別路徑之後,它會顯示 WebSphere JDBC 提供者、 pureQuery Runtime 及 Java 環境的相關資訊。

程序

若要執行 Script,以新增 pureQuery Runtime JAR 檔至 JDBC 提供者類別路徑,請執行下列動作:

  1. 開啟指令視窗,然後執行 InstallPQJars Script。 例如,此指令指定 WebSphere 節點為 devNode01,且 pureQuery Runtime JAR 檔的路徑為 C:/PureQueryRuntime。:
     InstallPQJars -node devNode01 -pqPath C:/PureQueryRuntime

    範例指令假設 WebSphere JDBC 提供者定義在節點層次中,並假設 WebSphere Application Server 安裝為簡單的獨立式安裝。

  2. 遵循 Script 指示,來配置 JDBC 提供者類別路徑。

    如果 Script 在類別路徑中偵測到 pureQuery Runtime JAR 檔,則您可以選擇更新類別路徑, 或保留現行類別路徑。

    當 Script 完成時,它會顯示 WebSphere、pureQuery 及 Java 配置資訊。

下一步

從管理主控台中,您可以檢視已利用 pureQuery Runtime 資訊更新的 JDBC 提供者類別路徑。

接下來,執行 Script SetupDSProp,配置 JDBC 提供者資料來源與 pureQuery Runtime 內容搭配。

執行 SetupDSProp Script,以新增 pureQuery Runtime 內容至資料來源

當執行 SetupDSProp Script 時,您可以指定 pureQuery Runtime 內容值及 WebSphere 伺服器。 SetupDSProp Script 會為指定的資料來源建立自訂內容 pdqProperties。內容值為所指定 pureQuery Runtime 內容值的清單。

程序

若要執行 Script 以配置資料來源,請執行下列動作:

  1. 開啟指令視窗,然後執行 SetupDSProp Script。 例如,此指令指定 WebSphere 伺服器 server1,並將 pureQuery Runtime 內容 captureMode 的值指定為 ON, 以及將內容 pureQueryXml 的值指定為 C:\temp\capture.pdqxml
    SetupDSProp -server server1 -props "captureMode(ON), pureQueryXml(C:\temp\capture.pdqxml)"
    註: Script 不會驗證您指定的 pureQuery Runtime 內容值。它會以字串作為內容值,來建立自訂內容 pdqProperties。
  2. 遵循 Script 指示,來配置資料來源。

    在選取要配置的資料來源之後,Script 會建立自訂內容。然後,Script 會顯示資料來源及自訂內容的相關資訊。

結果

從管理主控台中,您可以驗證是否已設定 pdqProperties 自訂內容。內容會列示為資料來源的自訂內容。

下一步

接下來,執行 Script InstallPQValidator,藉由執行 InstallPQValidator Script,以驗證 pureQuery Runtime 配置是否正確。

執行 InstallPQValidator Script,以驗證 pureQuery Runtime 配置

InstallPQValidator Script 會安裝並啟動 WebSphere Servlet RunPQDataVersionEAR.ear。 Servlet 會驗證資料來源的 pureQuery 配置及 pureQuery Runtime 必要條件。Servlet 會顯示環境定義、 應用程式類別載入器、廣域 pureQuery 內容,以及 pureQuery Runtime 版本資訊。

程序

若要執行 Script 以驗證 pureQuery Runtime 安裝,請執行下列動作:

  1. 開啟指令視窗,然後執行 InstallPQValidator Script。 例如,此指令指定 WebSphere 伺服器 server1、節點 devNode01。
    InstallPQValidator -server server1 -node devNode01
    Script 會安裝並啟動 Servlet。

    Servlet 會在管理主控台中列示為應用程式。

  2. 從瀏覽器中執行 Servlet。 啟動瀏覽器並輸入 URL,來執行 Servlet。
    例如,此 URL 假設 WebSphere 執行中、Servlet 位於您的電腦上, 以及 WebSphere Application Server 埠為 9081:
    http://localhost:9081/RunPQValidate/
    Servlet 頁面即會開啟。
  3. 在 Servlet 頁面上,輸入 DB2® 資料來源的 JNDI 名稱,然後按一下提交

    Servlet 會與資料來源建立連線,然後在瀏覽器視窗中顯示配置資訊。

下一步

WebSphere Application Server 資料來源是針對 pureQuery Runtime 配置的。pureQuery 啟用的應用程式可以使用資料來源, 來存取 DB2 資料庫。

讀者意見