使用 IBM WebSphere 时适用于 Java 的数据源配置

使用 IBM WebSphere 管理控制台创建数据源、JDBC 提供程序以及自定义属性。

数据源是一个指定的数据库连接。您必须在 Web 应用程序服务器中指定数据源，才能将要素服务发布到 ArcGIS Spatial Data Server for Java Platform。数据源对象配置有一个基于 Java 命名和目录接口 (JNDI) API 的命名服务。

随 WebSphere 安装的 JDBC 驱动程序可能不是 ArcGIS Spatial Data Server 所支持的 JDBC 驱动程序版本。PostgreSQL JDBC 驱动程序不会随 WebSphere 一起安装。这种情况下，您必须将正确的 JDBC 驱动程序手动放置到 WebSphere Application Server 根目录下并创建一个新的 JDBC 提供程序。您可在配置数据源时创建 JDBC 提供程序，也可在设置数据源之前进行创建。本主题将介绍在配置数据源的同时如何创建 JDBC 提供程序。

添加 JDBC 驱动程序

将数据库的 JDBC 驱动程序放到 WAS_INSTALL_ROOT 的 lib 目录下。

配置数据源

DB2

使用 WebSphere 管理控制台创建 DB2 数据源、创建 JDBC 提供程序并设置数据源的自定义属性。

创建数据源和 JDBC 提供程序

以下步骤将介绍如何在 WebSphere 管理控制台中创建 DB2 数据源和 JDBC 提供程序。

步骤:

1. 以管理用户的身份登录到 IBM WebSphere 管理控制台。
2. 展开资源下的 JDBC，然后单击数据源。
3. 单击新建创建一个新的数据源。

   将打开创建数据源 页面。

4. 输入数据源和 JNDI 的名称。
   注:

   数据源名称和 JNDI 名称值必须相同。但是，JNDI 名称必须以 jdbc/ 开头。例如，您可以输入 atoll_spdb_sdsu 作为数据源名称，输入 jdbc/atoll_spdb_sdsu 作为 JNDI 名称。

5. 在设置安全性别名 页面中，您可以设置安全性别名，也可以接受默认设置，然后单击下一步。
6. 单击下一步。
7. 单击创建新 JDBC 提供程序。
8. 单击下一步。
9. 从数据库类型下拉列表中选择 DB2。
10. 在提供程序类型中选择使用 IBM JCC 驱动程序的 DB2。
11. 在实现类型中选择连接池数据源。
12. 为 DB2 JDBC 提供程序提供名称和描述，然后单击下一步。
13. 输入 DB2 jar 文件的路径和名称，以设置 $DB2_JCC_DRIVER_PATH WebSphere 变量。
14. 如果设置了 $DB2_JCC_DRIVER_NATIVEPATH WebSphere 变量，则可以将原生库路径留空。
15. 单击下一步。
16. 从驱动程序类型的值下拉列表中选择 DB2 JDBC 驱动程序的版本。
17. 在数据库名称文本框中输入数据源将使用的数据库名称。
18. 在服务器名称文本框中输入安装 DB2 的服务器的名称。
19. 在端口号文本框中输入数据库通信所需的端口号。
20. 选中在容器管理持久性 (CMP) 中使用此数据源。
21. 单击下一步。
22. 在设置安全性别名 页面中，您可以设置安全性别名，也可以接受默认设置，然后单击下一步。
23. 查看数据源的摘要信息，然后单击完成。

数据源将显示在 WebSphere 管理控制台的数据源列表中。

设置自定义属性

数据源的大部分属性在创建时已经设置。但是，您必须在 WebSphere 管理控制台的自定义属性 页面中设置数据源的用户名和密码属性。

在 WebSphere 管理控制台的数据源列表中打开刚刚创建的数据源，然后打开自定义属性 页面以定义数据源的属性。

步骤:

1. 单击数据源将其打开。
2. 在其他属性下，单击自定义属性。

   将打开自定义属性 页面。

您必须添加连接用户和用户密码的值，还要添加用来重定向上下文根的值。可在配置选项卡中添加这些值（每次添加一个）。
3. 单击首选项下的新建。

   将打开配置选项卡。

4. 在名称文本框中输入 user，然后在值文本框中输入要用于数据库连接的数据库用户的名称。
5. 单击配置选项卡中的确定，创建属性。
6. 按照相同的步骤创建用户密码的自定义属性。在名称文本框中输入 password，然后在值文本框中输入数据库用户的密码。
7. 按照相同的步骤创建自定义属性以重定向上下文根 URI。在名称文本框中输入 com.ibm.ws.webcontainer.redirectcontextroot，然后在值文本框中输入 true。

Oracle

使用 WebSphere 管理控制台创建 Oracle 数据源、创建 JDBC 提供程序并设置数据源的自定义属性。

创建数据源和 JDBC 提供程序

以下步骤将介绍如何在 WebSphere 管理控制台中创建 Oracle 数据源和 JDBC 提供程序。

步骤:

1. 以管理用户的身份登录到 IBM WebSphere 管理控制台。
2. 展开资源下的 JDBC，然后单击数据源。
3. 单击新建创建一个新的数据源。

   将打开创建数据源 页面。

4. 输入数据源和 JNDI 的名称。
   注:

   数据源名称和 JNDI 名称值必须相同。但是，JNDI 名称必须以 jdbc/ 开头。例如，您可以输入 porcupine_osid_pubu 作为数据源名称，输入 jdbc/porcupine_osid_pubu 作为 JNDI 名称。

5. 单击下一步。
6. 单击创建新 JDBC 提供程序。
7. 单击下一步。
8. 在数据库类型下拉列表中选择 Oracle。
9. 从提供程序类型下拉列表中选择 Oracle JDBC 驱动程序。
10. 从实现类型下拉列表中选择连接池数据源。
11. 为 JDBC 提供程序提供名称和描述，然后单击下一步。
12. 输入 Oracle JDBC 驱动程序的路径和名称，以设置 WebSphere $ORACLE_JDBC_DRIVER_PATH 变量。
13. 单击下一步。
URL 的值应预先填充。请确保与您的数据源相符。
14. 从数据存储帮助程序类名下拉列表中选择 Oracle11g 数据存储帮助程序。
15. 选中在容器管理持久性 (CMP) 中使用此数据源。
16. 单击下一步。
17. 在设置安全性别名 页面中，您可以设置安全性别名，也可以接受默认设置，然后单击下一步。
18. 查看数据源的摘要信息，然后单击完成。

数据源将显示在 WebSphere 管理控制台的数据源列表中。

设置自定义属性

数据源的大部分属性在创建时已经设置。但是，您必须在 WebSphere 管理控制台的自定义属性 页面中设置数据源的用户名和密码属性。

在 WebSphere 管理控制台的数据源列表中打开刚刚创建的数据源，然后打开自定义属性 页面以定义数据源的属性。

步骤:

1. 单击数据源将其打开。
2. 在其他属性下，单击自定义属性。

   将打开自定义属性 页面。

您必须添加连接用户和用户密码的值，还要添加用来重定向上下文根的值。可在配置选项卡中添加这些值（每次添加一个）。
3. 单击首选项下的新建。

   将打开配置选项卡。

4. 在名称文本框中输入 user，然后在值文本框中输入要用于数据库连接的数据库用户的名称。
5. 单击配置选项卡中的确定，创建属性。
6. 按照相同的步骤创建用户密码的自定义属性。在名称文本框中输入 password，然后在值文本框中输入数据库用户的密码。
7. 按照相同的步骤创建自定义属性以重定向上下文根 URI。在名称文本框中输入 com.ibm.ws.webcontainer.redirectcontextroot，然后在值文本框中输入 true。

PostgreSQL

PostgreSQL 不是 WebSphere 上经过认证的 JDBC 驱动程序。因此，当您将数据源配置为指向 PostgreSQL 数据库时，必须配置用户定义的 JDBC 提供程序。

设置 JDBC 驱动程序环境变量

首先，设置 JDBC 驱动程序变量。

步骤:

1. 以管理用户的身份登录到 IBM WebSphere 管理控制台。
2. 导航至环境 > Websphere 变量，然后找到 User-defined_JDBC_DRIVER_PATH 变量。
3. 将 User-defined_JDBC_DRIVER_PATH 变量设置为 WAS_INSTALL_ROOT/lib。

创建数据源和 JDBC 提供程序

接下来，创建新的数据源并定义 JDBC 提供程序。

步骤:

1. 展开资源下的 JDBC，然后单击数据源。
2. 单击新建创建一个新的数据源。

   将打开创建数据源 页面。

3. 输入数据源和 JNDI 的名称。
   注:

   数据源名称和 JNDI 名称值必须相同。但是，JNDI 名称必须以 jdbc/ 开头。例如，您可以输入 laverne_pgdb_lri2 作为数据源名称，输入 jdbc/laverne_pgdb_lri2 作为 JNDI 名称。

4. 单击下一步。
5. 单击创建新 JDBC 提供程序。
6. 单击下一步。
7. 从数据库类型下拉列表选择用户定义。
8. 在实现类名文本框中输入 org.postgresql.ds.PGConnectionPoolDataSource。
9. 为用户定义的 JDBC 提供程序提供名称和描述，然后单击下一步。
10. 提供 WebSphere 服务器上 PostgreSQL jar 文件的路径和名称，然后单击下一步。
11. 输入数据存储帮助程序类名。
12. 选中在容器管理持久性 (CMP) 中使用此数据源，然后单击下一步。
13. 在设置安全性别名 页面中，您可以设置安全性别名，也可以接受默认设置，然后单击下一步。
14. 查看数据源的摘要信息，然后单击完成。

数据源将显示在 WebSphere 管理控制台的数据源列表中。

设置自定义属性

您已为 PostgreSQL 数据源创建了一个用户定义的 JDBC 提供程序，所以必须手动设置某些属性。此操作可在 WebSphere 管理控制台的自定义属性 页面中完成。

在 WebSphere 管理控制台的数据源列表中打开刚刚创建的数据源，然后打开自定义属性 页面以定义数据源的属性。

步骤:

1. 单击数据源将其打开。
2. 在其他属性下，单击自定义属性。

   将打开自定义属性 页面。

您必须添加数据库名称、服务器名称、数据库端口号、连接用户和用户密码的值，还要添加用于重定向上下文根的值。可在配置选项卡中添加这些值（每次添加一个）。
3. 单击首选项下的新建。

   将打开配置选项卡。

4. 提供下列配置属性的值：

   名称	值
   数据库名称	<用于数据源的 PostgreSQL 数据库的名称>
   服务器名称	<安装 PostgreSQL 数据库集群的服务器的名称>
   端口号	<PostgreSQL 数据库集群进行通信所用的端口>
   用户	<用于连接的登录角色名称>
   密码	<登录角色的密码>
   com.ibm.ws.webcontainer.redirectcontextroot	true

5. 单击配置选项卡中的确定即可创建属性。