配置 JDBC 驅動程式

IBM® Business Automation Workflow 包括 DB2 資料庫的 Java 資料庫連線功能 (JDBC) 驅動程式。 包含的 DB2 JDBC 驅動程式版本由 Business Automation Workflow特定版本所支援的對應資料庫產品層次決定。 每當發佈資料庫產品的另一個層次時,您都應該更新 JDBC 驅動程式,以避免從驅動程式產生的失敗產生非預期的錯誤。 如果您使用 Oracle 或 SQL Server 資料庫,則必須配置您自己的 JDBC 驅動程式。

對於產品資料來源, Business Automation Workflow 需要資料庫供應商針對特定資料庫版本提供的第 4 類 JDBC 驅動程式。 即使您使用 DB2,也可以使用 JDBC 驅動程式的自訂路徑。

程序

若要配置或更新 JDBC 驅動程式,請完成下列步驟:

  1. 判定資料庫產品特定層次可用的 JDBC 驅動程式版本。
    您可以檢查 DB2 JDBC 驅動程式版本及下載,以判定特定層次的 DB2 可用的 JDBC 驅動程式版本。 另請參閱 分散式平台上 IBM Business Automation Workflow 的進階資料庫支援
  2. 如果您已安裝 JDBC 驅動程式, 透過執行下列指令 (其中 database_product 是 DB2的其中一個) ,判定 Business Automation Workflow 中 JDBC 驅動程式的現行版本。 Oracle或 SQL Server):
    install_root/my_jdbc_directory/database_product
    例如 (DB2):適用於 Linux 作業系統適用於 UNIX 作業系統
    cd /opt/IBM/BPM/jdbcdrivers/DB2
    /opt/IBM/BPM/java/bin/java -cp db2jcc4.jar com.ibm.db2.jcc.DB2Jcc -version
    適用於 Windows 作業系統
    cd C:\IBM\BPM\jdbcdrivers\DB2
    C:\IBM\BPM\java\bin\java -cp db2jcc4.jar com.ibm.db2.jcc.DB2Jcc -version

    例如 (Oracle):

    適用於 Linux 作業系統適用於 UNIX 作業系統
    cd /opt/IBM/BPM/myOraclejdbc/
    /opt/IBM/BPM/java/bin/java -jar ojdbc10.jar
  3. 完成下列子步驟來停止環境:
    1. 停止叢集。
    2. 停止環境中的所有節點代理程式。
    3. 停止部署管理程式。
  4. Business Automation Workflow 部署管理程式及每個受管理節點機器上的 Business Automation Workflow 安裝根目錄中, 建立 JDBC 驅動程式的自訂目錄,並將必要的 JDBC 驅動程式複製到其中。
    例如,您可以為 DB2 JDBC 驅動程式建立下列自訂目錄:
    install_root/mydb2jdbc

    下表顯示資料庫產品及對應的 JDBC 驅動程式:

    資料庫產品 JDBC 驅動程式
    DB2
    • db2jcc4.jar
    • db2jcc_license_cisuz.jar
    • db2jcc_license_cu.jar
    DB2 for z/OS
    • db2jcc4.jar
    • db2jcc_license_cisuz.jar
    • db2jcc_license_cu.jar
    Oracle
    • ojdbc8.jarojdbc10.jar
    SQL Server Business Automation Workflow 22.0.2 以及更新版本支援下列 JDBC 驅動程式:
    • mssql-jdbc-11.2.0.jre8.jar
    • mssql-jdbc-10.2.0.jre8.jar
    • mssql-jdbc-9.4.1.jre8.jar
    • mssql-jdbc-9.2.1.jre8.jar
    • mssql-jdbc-8.4.1.jre8.jar
    • mssql-jdbc-8.2.2.jre8.jar
    • mssql-jdbc-7.0.0.jre8.jar
    • sqljdbc42.jar
    • mssql-jdbc-6.4.0.jre8.jar
    • mssql-jdbc-6.2.2.jre8.jar
    PostgreSQL
    • postgresql-42.2.22.jar
    • postgresql-42.2.23.jar
    • postgresql-42.2.24.jar
    • postgresql-42.2.25.jar
    • postgresql-42.3.0.jar
    • postgresql-42.3.1.jar
    • postgresql-42.3.2.jar
    • postgresql-42.3.3.jar
    • postgresql-42.3.4.jar
    • postgresql-42.3.5.jar
    • postgresql-42.3.6.jar
    • postgresql-42.3.7.jar
    • postgresql-42.3.3.jar
  5. 如果您使用 Microsoft SQL Server,請完成下列子步驟來容納 JDBC 分散式交易元件及 Windows 鑑別:
    1. sqljdbc_xa.dll 檔案從您下載的 Microsoft JDBC 驅動程式套件複製到 SQL Server 電腦的 Binn 目錄。 若為預設 SQL Server 安裝, Binn 目錄的位置是 C:/Program Files/Microsoft SQL Server/MSSQL10_50.MSSQLSERVER/MSSQL/Binn。 使用 x64 資料夾中的 sqljdbc_xa.dll 檔案。
    2. 在 SQL Server上執行 xa_install.sql 資料庫 Script。 例如,從命令提示字元執行 sqlcmd -i xa_install.sql。 此 Script 會安裝 sqljdbc_xa.dll所呼叫的延伸儲存程序。 這些延伸儲存程序實作 Microsoft SQL Server JDBC 驅動程式的分散式交易及 XA 支援。 您需要以 SQL Server 實例的管理者身分執行此 Script。 您可以忽略無法捨棄不存在之程序的相關錯誤。
    3. 如果您已配置 Windows 鑑別,請將 sqljdbc_auth.dll 檔案從您下載的 Microsoft JDBC 驅動程式套件複製到 SQL Server 電腦的 Binn 目錄。 若為預設 SQL Server 安裝, Binn 目錄的位置是 C:/Program Files/Microsoft SQL Server/MSSQL10_50.MSSQLSERVER/MSSQL/Binn。 使用 x64 資料夾中的 sqljdbc_auth.dll 檔案。
  6. 變更 JDBC 驅動程式變數,以指向自訂 JDBC 驅動程式目錄。 在網路部署環境中,執行這個指令來更新部署管理程式,並針對每一個受管理節點重新執行它。 在獨立式環境中,更新伺服器上的路徑。
    BPMConfig -update -profile profile_name -node node_name -jdbcDriverPath jdbc_driver_path
    其中:
    • profile_name 是部署管理程式設定檔的名稱
    • node_name 是您要為其設定 JDBC 驅動程式路徑之部署管理程式節點或受管理節點的名稱
    • jdbc_driver_path 是包含 JDBC 驅動程式的目錄
    例如,下列指令會更新部署管理程式和兩個受管理節點的 JDBC 驅動程式路徑。
    BPMConfig -update -profile Dmgr01 -node Dmgr01 -jdbcDriverPath ${WAS_INSTALL_ROOT}\myOraclejdbc\
    BPMConfig -update -profile Dmgr01 -node Node01 -jdbcDriverPath ${WAS_INSTALL_ROOT}\myOraclejdbc\
    BPMConfig -update -profile Dmgr01 -node Node02 -jdbcDriverPath /opt/myOraclejdbc/
  7. 完成下列子步驟來重新啟動環境:
    1. 啟動部署管理程式。
    2. 啟動節點代理程式。
    3. 啟動叢集。
  8. 驗證已套用更新的 JDBC 版本。 例如,若要驗證已更新 DB2的 JDBC 版本,請尋找字串DSRA8203ISystemOut.log 檔案中,如下列輸出所示:
    [3/17/14 11:57:26:122 BRT] 00000000 InternalGener I   DSRA8203I: Database product name : DB2/AIX64
    [3/17/14 11:57:26:123 BRT] 00000000 InternalGener I   DSRA8204I: Database product version : SQL09075
    [3/17/14 11:57:26:124 BRT] 00000000 InternalGener I   DSRA8205I: JDBC driver name  : IBM Data Server Driver for JDBC and SQLJ
    [3/17/14 11:57:26:124 BRT] 00000000 InternalGener I   DSRA8206I: JDBC driver version  : 4.13.80
    [3/17/14 11:57:26:124 BRT] 00000000 InternalGener I   DSRA8218I: JDBC driver specification level  : 4.0