安装和配置 SDO 存储库

服务数据对象 (SDO) 是一个开放式标准,它使应用程序能够以统一方式(例如数据图)来处理来自不同数据源的数据。 支持服务集成总线的 Web Service 使用 SDO 存储库来存储和处理 WSDL 定义。使用此任务来创建并配置您的首选数据库以便存储 SDO 数据,并在计划用于支持总线的 Web Service 的每个服务器上安装并配置 SDO 存储库。

开始之前

规划支持总线的 Web Service 安装中所述,确定要在其上安装并配置 SDO 存储库的服务器或集群,然后按配置总线的成员中所述将每个服务器或集群作为总线成员添加。

SDO 存储库可使用大部分数据库产品。有关选择和配置首选数据库的具体信息,请咨询数据库管理员或查看数据库产品文档,也可阅读本主题中有关数据库用法的注释。

关于此任务

要安装并配置 SDO 存储库,请完成下列步骤:
  • 安装首选数据库产品。
  • 为数据库创建 JDBC 提供程序和数据源。
  • 运行 installSdoRepository.jacl 脚本一次或多次,以在每个服务器上安装 SDO 应用程序并设置 SDO 存储库要使用的数据库类型。
有关如何执行此操作的更多信息,请先阅读有关数据库用法及 installSdoRepository.jacl 脚本的下列注释,然后执行对应其中一个配置的步骤:
有关数据库用法的注释:
  • [AIX Solaris HP-UX Linux Windows][IBM i]对于单服务器配置,可使用首选数据库或 WebSphere® Application Server 附带的嵌入式 Apache Derby 数据库。[z/OS]在 z/OS® 环境中,无法使用嵌入式 Derby 数据库,原因是此数据库一次只能供一个进程访问,即使 z/OS 上的单个服务器可在多个进程中运行。
  • 对于 Network Deployment 配置,可使用首选数据库或提供的 Derby 数据库及关联网络服务器应用程序。但是,您应该知道 Derby Network Server 的限制。例如,它不支持事务。
  • SDO 存储库将规定它使用的模式和表名,因此,不同的存储库必须使用不同的数据库来确保它们不会访问相同的数据。对每个单元使用一个 SDO 存储库,因此,如果您具有多个单元,那么应使用多个数据库,每个单元对应一个数据库。
  • [z/OS]z/OS 上的 DB2® 没有多个数据库这一概念。在 z/OS 系统上,每个 SDO 存储库必须使用不同的 DB2 实例,以确保不同的存储库不会访问相同的数据。
  • 使用相应 app_server_root/util/SdoRepository/database_type 目录中的 Table.ddl 文件为首选数据库供应商创建数据库。Table.ddl 文件描述 SDO 存储库所需要的数据库表。
  • installSdoRepository.jacl 脚本中的 -editBackendId 标志确定存储库要使用的数据库类型。后端标识确定了应用程序在与数据库通信时要遵循的特定于数据库的规则。 请参阅有关 installSdoRepository.jacl 脚本的关联注释。
  • 某些数据库要求用户标识已被授予访问 SDO 存储库数据库的许可权。在为 Oracle、Sybase 和 SQL Server 数据库创建表之前,为用户名 SDOREP 创建用户标识。考虑到这些数据库处理用户名和表名的方式,用户名必须为 SDOREP 以使 SDO 存储库能够使用标准名称 SDOREP.BYTESTORE 来访问它的表。务必为 SDOREP 用户授予读写数据库的许可权。
  • 如果使用 Informix® 数据库,那么不要禁用记录。
  • SDO 存储库不需要 XA 支持。在大多数情况下,既可以使用 XA 数据源也可以使用非 XA 数据源。但是,如果数据库是 Oracle 8 或 9,必须对 SDO 存储库数据源使用 Oracle JDBC 驱动程序(非 XA)。
  • 您还可以选择执行其他步骤,例如,创建主键的索引以提高数据库性能。不要更改模式名、表名和列名。
  • 如果将此 SDO 存储库配置为与同时包含 WebSphere Application Server V6.0V6.1 及更高版本应用程序服务器的单元配合使用,那么必须使用与这些版本兼容的数据库。
有关 installSdoRepository.jacl 脚本的注释:
  • 使用 wsadmin 脚本编制客户机运行该脚本。
  • [IBM i]在 Qshell 中运行此脚本。
  • app_server_root/bin 目录中提供了此脚本,其中 app_server_rootWebSphere Application Server 的安装根目录。如果您选择从另一个目录中运行 wsadmin 脚本编制客户机,那么请在命令选项中指定脚本的完整路径。例如,要使用缺省概要文件以外的概要文件,请切换至 app_server_root/profiles/profile_name/bin 目录,然后指定以下脚本路径:[IBM i]
    wsadmin -f app_server_root/bin/installSdoRepository.jacl
    [AIX Solaris HP-UX Linux Windows][z/OS]
    wsadmin.ext -f app_server_root/bin/installSdoRepository.jacl
    [AIX Solaris HP-UX Linux Windows][z/OS]其中 .ext 是 Windows 系统的文件扩展名 .bat,对于 UNIX、Linux 或 z/OS 系统,则为 .sh
  • installSdoRepository.jacl 脚本中的 -editBackendId 标志确定存储库要使用的数据库类型。后端标识确定了应用程序在与数据库通信时要遵循的特定于数据库的规则。要查看可用后端标识值的完整列表,请使用 -listBackendIds 标志:
    wsadmin -f installSdoRepository.jacl -listBackendIds
    在一个或多个 WebSphere Application Server V7.0 或更高版本 应用程序服务器上安装 SDO 存储库后,可使用列表中的所有后端标识值。在 V6.0 服务器上安装 SDO 存储库后,不能使用带有 (*) 标记的值。在 V6.0V6.1 服务器上安装 SDO 存储库后,不能使用带有 (**) 标记的值。
  • 如果该数据源已存在,或者 SDO 存储库应用程序的安装先前已中断或只完成了一部分,那么 installSdoRepository.jacl 脚本将无法完成,并且不会保存配置更改。在这些情况下,请运行 SDO 存储库卸载脚本,解决问题,然后重新运行 installSdoRepository.jacl 脚本。
[IBM i][AIX Solaris HP-UX Linux Windows]

为单个服务器配置 SDO 存储库并使用嵌入式 Derby 数据库

[z/OS]

开始之前

[z/OS]在 z/OS 环境中,无法使用嵌入式 Derby 数据库,原因是此数据库一次只能供一个进程访问,即使 z/OS 上的单个服务器可在多个进程中运行。

关于此任务

如果正在创建单服务器配置,并且要使用嵌入式 Derby,那么运行 installSdoRepository.jacl 脚本时必须指定 -createDb 开关。此操作将创建 Derby 数据库并安装 SDO 存储库。

要为单个服务器配置 SDO 存储库并使用嵌入式 Derby 数据库,请完成以下步骤:

过程

  1. 打开命令提示符,然后切换到 app_server_root/bin 目录。
  2. 输入以下命令: [IBM i]
    wsadmin -f installSdoRepository.jacl -createDb
    [AIX Solaris HP-UX Linux Windows][z/OS]
    wsadmin.ext -f installSdoRepository.jacl -createDb
    注: -createDb 标志指示命令创建缺省 Derby 数据库。即使省略此 标志,该命令也仍然会安装配置为使用 Derby 的 SDO 存储库,但该命令不会创建该数据库。

为单个服务器配置 SDO 存储库并使用嵌入式 Derby 以外的数据库

关于此任务

如果要创建使用嵌入式 Derby 以外的数据库的单服务器配置,那么请安装您首选的数据库产品,创建 JDBC 提供程序和数据源,然后运行两次 installSdoRepository.jacl 脚本:
  1. 第一次运行该脚本以在应用程序服务器上安装 SDO 应用程序。
  2. 再次运行该脚本以设置该 SDO 存储库要使用的数据库类型。

要为单个服务器配置 SDO 存储库并使用嵌入式 Derby 以外的数据库,请完成以下步骤:

过程

  1. 使用相应 app_server_root/util/SdoRepository/database_type 目录中的 Table.ddl 文件为首选数据库供应商创建数据库。

    有关在 DB2 中创建表的过程说明,请参阅根据导出的表数据定义语言重新创建数据库表。有关更多信息,请参阅 部署数据访问应用程序

  2. 创建 J2C 认证别名

    这将与您在下一步中创建的数据源配合使用。验证认证别名是否与数据库实例的登录详细信息相匹配,不匹配无法建立连接。

  3. 创建和配置 JDBC 提供程序和数据源
    设置下列数据源属性:
    • 设置认证属性以使用您在上一步中创建的认证别名。
    • 选择在容器管理的持久性 (CMP) 中使用此数据源复选框。
    • 名称属性设置为您自己选择的名称。例如,SDO Repository DataSource
    • JNDI 名称属性设置为以下值:jdbc/com.ibm.ws.sdo.config/SdoRepository
    • 设置作为用于所选数据库的必需设置的任何其他属性。
  4. 可选: 测试数据源连接:
    注: 此选项并非在所有配置中都可用。此选项的可用性取决于在其中定义了数据源的作用域以及在数据源配置和 JDBC 提供程序配置中使用的任何 WebSphere Application Server 变量的作用域。有关测试数据源连接的更多信息,请参阅测试连接服务
    1. 在管理控制台中,浏览至资源 -> JDBC -> 数据源
    2. 选择 SDO 存储库数据源。
    3. 单击测试连接
  5. 配置 SDO 存储库:
    1. 打开命令提示符,然后切换到 app_server_root/bin 目录。
    2. 在服务器上安装 SDO 存储库应用程序: [IBM i]
      wsadmin -f installSdoRepository.jacl
      [AIX Solaris HP-UX Linux Windows][z/OS]
      wsadmin.ext -f installSdoRepository.jacl
    3. 设置 SDO 存储库要使用的数据库类型:
      [IBM i]
      wsadmin -f installSdoRepository.jacl -editBackendId database_type
      [AIX Solaris HP-UX Linux Windows][z/OS]
      wsadmin.ext -f installSdoRepository.jacl -editBackendId database_type
      例如:[IBM i]
      wsadmin -f installSdoRepository.jacl -editBackendId DB2UDB_V82
      [AIX Solaris HP-UX Linux Windows][z/OS]
      wsadmin.ext -f installSdoRepository.jacl -editBackendId DB2UDB_V82

为 Network Deployment 单元配置 SDO 存储库

关于此任务

如果您正在 Network Deployment 环境中工作,那么请安装首选数据库产品,接着创建 JDBC 提供程序和数据源,然后对每个单元运行 installSdoRepository.jacl 脚本数次:
  1. 运行一次该脚本以在 Deployment Manager 上安装 SDO 应用程序。
  2. 再次运行该脚本以设置该 SDO 存储库要使用的数据库类型。
  3. 运行数次该脚本以在您打算用于一个或多个支持总线的 Web Service 角色的每个服务器或集群上安装 SDO 应用程序实例。

要为 Network Deployment 单元配置 SDO 存储库,请完成以下步骤:

过程

  1. 使用相应 app_server_root/util/SdoRepository/database_type 目录中的 Table.ddl 文件为首选数据库供应商创建数据库。

    有关在 DB2 中创建表的过程说明,请参阅根据导出的表数据定义语言重新创建数据库表。有关更多信息,请参阅 部署数据访问应用程序

  2. 在所有受影响的节点(包括 Deployment Manager 节点)上创建下列节点级 WebSphere Application Server 变量。
    注: 根据配置的不同,可以在节点范围或单元范围中设置这些变量。但是,对于多平台节点来说,由于各节点的安装目录各不相同,所以通常不能在单元范围设置 WAS_INSTALL_ROOT
    1. 在管理控制台中,转到环境 -> WebSphere 变量,然后将作用域设置为节点级。
    2. 检查 WAS_INSTALL_ROOT 变量是否存在及 WebSphere Application Server 安装根目录的值。
    3. 创建新变量 your_database_JDBC_DRIVER_PATH, 将此变量的值设置为将在该单元的每个主机中存储数据库 JAR 文件(在后续步骤)的位置。
  3. 创建 J2C 认证别名

    这将与您在下一步中创建的数据源配合使用。验证认证别名是否与数据库实例的登录详细信息相匹配,不匹配无法建立连接。

  4. 创建和配置 JDBC 提供程序和数据源
    设置下列数据源属性:
    • 设置认证属性以使用您在上一步中创建的认证别名。
    • 选择在容器管理的持久性 (CMP) 中使用此数据源复选框。
    • 名称属性设置为您自己选择的名称。例如,SDO Repository DataSource
    • JNDI 名称属性设置为以下值:jdbc/com.ibm.ws.sdo.config/SdoRepository
    • 设置作为用于所选数据库的必需设置的任何其他属性。
  5. 在单元中的每台主机上部署数据库客户机 JAR 文件。

    JAR 文件必须部署为您在上一步中声明的 your_database_JDBC_DRIVER_PATH 变量给定的位置,否则远程节点将无法连接至 SDO 存储库。

  6. 配置 SDO 存储库:
    1. 打开命令提示符,然后切换到 app_server_root/bin 目录。
    2. 在此单元的 Deployment Manager 上安装 SDO 存储库应用程序: [IBM i]
      wsadmin -f installSdoRepository.jacl deployment_manager_node_name deployment_manager_server_name
      [AIX Solaris HP-UX Linux Windows][z/OS]
      wsadmin.ext -f installSdoRepository.jacl deployment_manager_node_name deployment_manager_server_name
      例如:[IBM i]
      wsadmin -f installSdoRepository.jacl dmgrNode dmgr
      [AIX Solaris HP-UX Linux Windows][z/OS]
      wsadmin.sh -f installSdoRepository.jacl dmgrNode dmgr
    3. 设置 SDO 存储库要使用的数据库类型:
      [IBM i]
      wsadmin -f installSdoRepository.jacl -editBackendId database_type
      [AIX Solaris HP-UX Linux Windows][z/OS]
      wsadmin.ext -f installSdoRepository.jacl -editBackendId database_type
      例如:[IBM i]
      wsadmin -f installSdoRepository.jacl -editBackendId DB2UDB_V82
      [AIX Solaris HP-UX Linux Windows][z/OS]
      wsadmin.ext -f installSdoRepository.jacl -editBackendId DB2UDB_V82
    4. 在您计划用于一个或多个支持总线的 Web Service 角色的每个服务器或每个集群上安装 SDO 存储库实例:
      • 对于每台不属于集群的服务器,重复以下命令: [IBM i]
        wsadmin -f installSdoRepository.jacl node_name server_name
        [AIX Solaris HP-UX Linux Windows][z/OS]
        wsadmin.ext -f installSdoRepository.jacl node_name server_name
      • 对于每个集群,重复以下命令:[IBM i]
        wsadmin -f installSdoRepository.jacl -cluster cluster_name
        [AIX Solaris HP-UX Linux Windows][z/OS]
        wsadmin.ext -f installSdoRepository.jacl -cluster cluster_name

指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tjw_install_sdo
文件名:tjw_install_sdo.html