本主题概述了如何配置 Parasoft JDBC 驱动程序。

章节目录：

配置过程

推荐的配置流程为：

1. 将 Parasoft JDBC 驱动程序 jar 文件放在应用程序服务器上（下面几节将精确地指出它应该放在每种类型的服务器上的什么位置）。驱动程序 ParasoftJDBCDriver.jar 随 Parasoft Virtualize 一起提供，位于 <INSTALL-DIR>/proxies。
2. 配置驱动程序，使其注册到适当的 Virtualize 服务器。配置 Parasoft JDBC 驱动程序的方法取决于应用程序的部署方式。有关如何执行适合特定环境的配置的详细信息，请参阅：
   • WebSphere 应用程序服务器上的配置
   • webMethods 集成服务器上的配置
   • TIBCO ActiveMatrix BusinessWorks 上的配置
   • Oracle/BEA WebLogic 9.2 应用服务器上的配置
   • Oracle WebLogic 10.3 (11g) 应用服务器上的配置
   • Apache Tomcat 应用服务器上的配置
   • JBoss 应用服务器上的配置
   • 用于独立或其他应用程序服务器平台的 JDBC 配置
   • ParaBank 的 JDBC 配置
3. 启动被测应用程序（AUT）。在初始化驱动程序时，它将自动连接到虚拟化，并为该组 ID 创建新的部署配置，或者从具有相同组 ID 的现有部署配置中获取设置。控制台视图将报告一条消息，该驱动程序已注册：
   
4. 验证此 Parasoft JDBC 驱动程序的 JDBC 控制器是否出现在 Virtualize 服务器视图中。
   

从那时起，您将能够通过 Virtualize 服务器视图或环境管理器控制 JDBC 驱动程序模式和日志记录。默认情况下，驱动程序以 passthrough 模式启动，日志级别为 1。

所有环境所需的驱动程序/系统属性

对于所有应用服务器和设置，您必须为 Parasoft JDBC 驱动程序配置以下两个驱动程序属性： 

• virtualizeServerUrl: 指定 Parasoft Virtualize 服务器的主机名。格式应为 http://<VIRTUALIZE SERVER HOST NAME/IP ADDRESS>:9080。默认端口号为 9080。只在 Virtualize 服务器使用不同端口号配置时才使用 9080 之外的端口号。
• virtualizeGroupId: 用于在 Virtualize 中创建 JDBC 控制器的组名。多个驱动程序可以共享同一个组 ID。共享一个组 ID 的所有驱动程序都将根据相关控制器的配置更改进行更新。例如，如果您有一个节点集群，并希望能够同步启动或停止录制，可将它们配置为共享一个组 ID。如果想要单独控制，则可为每个组分配一个不同的组 ID。
  • 如果使用现有的组 id，当前的 Parasoft JDBC 驱动程序将被分配给该组的 JDBC 控制器。
  • 如果使用新的组 ID，将为该 ID 创建一个新的 JDBC 控制器。

下列 Java 系统属性是 AUT 所需的启动参数：

• parasoft.virtualize.group.id: 等效于 virtualizeGroupId 驱动程序属性；默认是 hostname。
• parasoft.virtualize.server.url: 等效于 virtualizeServerUrl 驱动程序属性。

可以将这些属性设置为驱动程序 URL 的一部分。例如，下面设置组 ID 和服务器 URL：

jdbc:parasoft:proxydriver:virtualizeGroupId=derbyTest&virtualizeServerPath=MyPath:@org.apache. derby.jdbc.EmbeddedDriver:@jdbc:derby:memory:myDB;create=true

此外，通常也可以通过管理员 GUI 或使用 -D<PROP NAME>=<PROP VALUE> 语法作为 Java 的命令行参数进行指定。

若要查看 AUT 需要使用的确切系统属性，请参阅 Parasoft 环境管理器的端点报告。例如： 
 

指定 Parasoft JDBC 驱动程序调用哪个虚拟资产

默认情况下，Parasoft JDBC 驱动程序会调用部署在 /virtualDb 的虚拟资产（在虚拟化或 Hybrid 模式下，或在 Failover 模式下发生故障时）。若要让它调用部署在不同端点的虚拟资产，请使用可选的驱动程序/系统属性：

• Driver property for all application servers and setups: virtualizeServerPath
• Java System property: parasoft.virtualize.server.path

此属性应设置为虚拟资产部署配置路径。例如，如果您的虚拟资产部署在 /myVirtualDb，您可以通过以下任一方式进行配置：

parasoft.virtualize.server.path=myVirtualDb

或

virtualizeServerPath=myVirtualDb

控制轮询间隔

默认（poall）提供者使用简单的 HTTP 连接来检查 Virtualize 服务器视图中是否设置了任何 Parasoft JDBC 驱动程序更新（例如，JDBC 驱动程序模式更改）。

默认的轮询间隔为 5000 ms。如果要更改轮询频率，请使用系统属性 parasoft.virtualize.poll。

为使用 Virtualize 9.4 或更早版本的用户进行迁移

如果您使用过 Virtualize 9.4 或更早版本的 Parasoft JDBC 驱动程序，请按照以下步骤开始使用最新的功能：

1. 将现有 Parasoft JDBC 驱动程序 jar 文件（ParasoftJDBCProxy-All.jar）更新为新的 ParasoftJDBCDriver.jar，其定位于 [virtualize installation directory]/proxies）。
2. 通过以下方式更新驱动程序属性：a) 删除所有 virtualize* 属性，除了 virtualizeServerUrl，然后 b) 添加 virtualizeGroupId。这将指定用于在 Virtualize 中创建 JDBC 控制器的组名。多个驱动程序可以共享相同的组 id，并且所有的驱动程序都可以通过任何配置更改进行更新。如果使用现有的组 id，当前的驱动程序将被分配给该组以及其相关联的 JDBC 控制器。如果您使用一个新的组 id，就会为这个新的组 id 创建一个新的配置和 JDBC 控制器。
   
   在 Virtualize 9.4 或更早版本中：
   
   
   
   在 Virtualize 9.5 或更高版本中：
   
   
   
   

3. 通过以下方式更新 AUT 启动参数：a) 删除所有 parasoft.virtualize* 属性，除了 parasoft.virtualize.server.url 以及（如果使用了）parasoft.virtualize.driver.proxy.direct 和 parasoft.virtualize.driver.register.jdbcproxydriver.in.drivermanager 然后 b) 添加 parasoft.virtualize.group.id。

   在 Virtualize 9.4 或更早版本中：

   set JAVA_OPTIONS=%JAVA_OPTIONS% -Dparasoft.virtualize.mode=record -Dparasoft.virtualize.log.destination=file -Dparasoft.virtualize.log.level=1 -Dparasoft.virtualize.log.file.location=[desired path]/jdbcproxy.log -Dparasoft.virtualize.server.url=http://VirtualizeServerHostName:9080 -Dparasoft.virtualize.driver.proxy.direct=false -Dparasoft.virtualize.driver.register.jdbcproxydriver.in.drivermanager=true

   
   在 Virtualize 9.5 或更高版本中：

   set JAVA_OPTIONS=%JAVA_OPTIONS% -Dparasoft.virtualize.group.id=ParaBank -Dparasoft.virtualize.server.url=http://VirtualizeServerHostName:9080 -Dparasoft.virtualize.driver.proxy.direct=false -Dparasoft.virtualize.driver.regis-ter.jdbcproxydriver.in.drivermanager=true