使用 pureQuery Runtime 配置和验证脚本配置 WebSphere Application Server 应用程序

pureQuery® 安装目录包含配置 WebSphere® Application Server 以运行支持 pureQuery 的应用程序的脚本。该目录还包含一个 WebSphere servlet 应用程序,可验证 WebSphere Application Server 是否已正确配置。

开始之前

运行脚本的用户必须具有下列特权:

关于此任务

脚本位于 pureQuery Runtime 安装目录的 PureQuery_Websphere_Config_Scripts 目录中。

您不必指定参数来显示脚本的必要和选用参数即可运行脚本。

过程

要运行脚本来配置 WebSphere Application Server 以与 pureQuery Runtime 一起使用,并验证该配置,请按此顺序来运行脚本:

  1. 运行 InstallPQJars 脚本以使用 pureQuery Runtime 信息更新 JDBC 提供程序类路径
  2. 运行 SetupDSProp 脚本以创建指定 pureQuery Runtime 属性的定制数据源属性
  3. 运行 InstallPQValidator 脚本以验证 pureQuery Runtime 配置

运行 InstallPQJars 脚本将 pureQuery Runtime JAR 文件添加到 JDBC 提供程序类路径

运行 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 配置信息。

下一步做什么

从管理控制台,您可以查看更新的带有 pureQuery Runtime 信息的 JDBC 提供程序类路径。

然后,运行脚本 SetupDSProp 来使用 pureQuery Runtime 属性配置 JDBC 提供程序数据源。

运行 SetupDSProp 脚本将 pureQuery Runtime 属性添加到数据源

运行 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 脚本会安装并启动 WebSphere servlet RunPQDataVersionEAR.ear。servlet 会验证数据源的 pureQuery 配置及 pureQuery Runtime 先决条件。servlet 会显示上下文、应用程序类装入器、全局 pureQuery 属性及 pureQuery Runtime 版本信息。

过程

要运行脚本来验证 pureQuery Runtime 安装:

  1. 打开命令窗口并运行 InstallPQValidator 脚本。 例如,此命令指定 WebSphere 服务器 server1,节点 devNode01。
    InstallPQValidator -server server1 -node devNode01
    脚本会安装并启动 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 数据库。

反馈