创建 Db2 Data Gate 实例

1. 在 Web 浏览器中打开 IBM Cloud Pak for Data 登录页面，并使用您的用户标识和密码登录。
2. 单击 打开主菜单。
3. 选择服务 > 服务目录。
4. 在左侧的导航器中，单击 类别 下拉列表。
5. 选择 数据源。
6. 在右侧，选择标注为 Db2 Data Gate的磁贴。 您可能必须向下滚动才能找到该磁贴。
   这样会打开 Db2 Data Gate 登录页面。 您将看到 Db2 Data Gate 仪表板的截屏。
7. 如果这是您正在创建的第一个实例，请单击右上角的 供应实例 按钮。 如果已有其他实例，那么不会显示此按钮。 取而代之的是 菜单图标。 单击该图标以显示选项，然后选择新建实例。
   标题为“创建 Data Gate 实例”的页面将打开。

目标数据库：

8. 在 目标数据库 部分中，选择实例的工作负载类型:

   事务性

   简单，但是大量的数据检索（例如，点查询）。

   分析

   涉及到的访问许多不同表的查询。

   仅当存在适当的目标数据库时，单选按钮才会处于活动状态。 如果情况如此，那么目标数据库下拉菜单会提供可供选择的选项。 根据选定的单选按钮，在目标数据库下拉列表中，适当的数据库实例会预先选定。

   选择目标数据库时，系统将 "尝试" 使用 Cloud Pak for Data 凭证 (平台凭证) 来访问所选数据库。 如果当前用户在该数据库上具有管理员角色，那么将授予访问权。 如果要使用的标识缺少此角色，那么现有 Cloud Pak for Data 管理员可以通过执行以下步骤来添加此角色:

   1. 单击 打开 Cloud Pak for Data 主菜单。
   2. 选择数据 > 数据库。 您会看到表示现有数据库实例的磁贴。
   3. 在要访问的数据库磁贴上，单击 并选择管理访问。 您将看到对该数据库具有访问权的用户的列表。
   4. 在该列表中，请将鼠标指针移到您要为其授予管理员访问权的用户的条目上。
   5. 在该列表的服务角色列中，找到该用户的当前角色。 单击该角色旁边的 图标，打开相关菜单。
   6. 从下拉菜单中，选择管理员。

   如果选定工作负载类型没有适当的数据库，那么一个或两个单选按钮会显示为灰色。 在这种情况下，您会看到一个或两个链接，它们可用来创建缺失的数据库实例：

   创建事务性数据库

   此链接可将您转至用于创建 Db2 数据库的 Cloud Pak for Data 页面。 这是适用于事务性工作负载的数据库类型。 在该页面上，请单击供应实例，并按指示信息进行操作。

   创建分析数据库

   此链接可将您转至用于创建 Db2 Warehouse 数据库的 Cloud Pak for Data 页面。 这是适用于分析工作负载的数据库类型。 在该页面上，请单击供应实例，并按指示信息进行操作。

   重要： 请遵循 Cloud Pak for Data 上的 Db2 Data Gate 安装 Db2 实例中的要求和建议。
9. 如果希望两个实例在单个节点上共存，请选择 在目标数据库的节点上部署此 Db2 Data Gate 实例 。 缺省情况下， Db2 Data Gate 实例部署在另一个节点上。 如果两个实例都位于同一节点上，那么性能可能更好。
10. 如果在步骤 8中选择了 分析 ，那么您将看到另一个复选框 将此 Db2 Data Gate 实例用于查询加速。
    选中时，针对 Db2 for z/OS 源表的查询将路由到要创建的 Db2 Data Gate 实例，并在目标数据库中的原始表的副本上执行。 查询结果将返回到 Db2 for z/OS。 通过这种方式，您可以将某些查询工作负载转移到不同的环境中，并保存有价值的 z/OS 处理资源。

    要点: 如果选择此选项，那么 Db2 for z/OS表的原始编码将保留在目标数据库中。 即，如果 Db2 for z/OS 源表是 EBCDIC 表，那么将在目标数据库中创建 EBCDIC 表而不是 UNICODE 表。

计算资源：

11. 在 计算资源下，指定要分配给实例的处理核心数 (CPU) 和内存量。
    您可在 CPU 滑块条右侧的输入字段中输入整数，或者调整滑块，直到该字段中显示正确的数字为止。
12. 以相同的方式，指定要分配给实例的内存量。 请使用内存旁边的输入字段或滑块。

名称空间：

13. 在 名称空间下，选择现有名称空间。
    名称空间是物理集群中运行实例所在的虚拟集群。 它用来在多个用户之间组织和划分资源。

存储器：

14. 在 存储器下，选择下列其中一个选项:
    • 创建新存储器
    • 使用现有存储器
15. 请从下方的下拉列表中选择文件系统类型。
    您所选择的文件系统必须与最终访问实例数据的客户机应用程序兼容。
16. 在 大小 字段中，指定实例所使用的存储器的大小。
    必须指定整数。 它表示以 GB 计的存储器大小。

路径：

17. 在 主机 字段中，指定路由主机名的第一部分或前缀。
    生成的路径主机名会自动插入。 您可以更改前缀，即，第一个点之前的部分。 请勿更改主机名的域部分，即，第一个点或前缀后面的部分。 选择的名称用于创建唯一的 URL，以供客户机应用程序用来访问实例数据。
18. 在 端口 字段中，指定路由所使用的网络端口。
    端口 443 是您的第一个实例的缺省值。 每增加一个实例，该数字会递增 1。 即使您指定不同的端口号，也是如此。 假设您指定了端口号 44443。 系统会将 44444 作为下一个实例的端口。

    除非 Cloud Pak for Data 系统中有多个 Db2 Data Gate 实例连接到同一 Db2 for z/OS 子系统，否则请使用缺省设置。 在这种情况下，请为每个 Db2 Data Gate 实例指定不同的端口号。 在 IBM Z上，需要配置 PAGENT 规则以使用相同的 IP 地址和不同的端口号连接到多个 Db2 Data Gate 实例。

    每个 Db2 Data Gate 实例都会创建 OpenShift 路由，该路由是主机名和端口 ( OpenShift 路由端口始终为 443)。 如果对 Db2 Data Gate使用缺省端口 443 以外的端口，那么将需要配置端口转发规则以将访问从指定端口重定向到 OpenShift 路由端口 (443)。 以下过程显示在使用 HAProxy时如何添加端口转发设置。 如果使用的是除 HAProxy以外的负载均衡器，请参阅负载均衡器的文档以获取有关如何配置负载均衡器的信息。

    1. 在负载均衡器节点上，编辑 HAProxy 配置文件 /etc/haproxy/haproxy.cfg，添加以下规则 (在此示例中，指定的端口为 44443 ，并确保系统中的主/工作程序 IP 正确)。

       frontend ingress-https-44443
               bind *:44443
               default_backend ingress-https-44443
               mode tcp
               option tcplog
       
       backend ingress-https-44443
               balance source
               mode tcp
               server master0 10.17.109.126:443 check
               server master1 10.17.109.168:443 check
               server master2 10.17.113.178:443 check
               server worker0 10.17.114.145:443 check
               server worker1 10.17.118.127:443 check
               server worker2 10.17.126.107:443 check
       

    2. 运行以下命令以应用您对 HAProxy 配置所做的更改：

    systemctl restart haproxy

19. 单击页面右下方的 复审 。
20. 在 名称 字段中，输入实例的名称。
21. 复查设置。 准备就绪后，请单击右下方的确认。
    您会看到进度窗口。 该过程需要 10 分钟才能完成。 在此期间，请勿关闭浏览器页面。 该过程完成后，“配置”页面随即打开，您可以继续配置实例。

在标题 源数据库下的部分中，指定应该用作 Db2 Data Gate 实例的数据源的 Db2 子系统或数据共享组的详细信息。

22. 在 主机 字段中，输入可通过 TCP/IP 网络联系 Db2 子系统或数据共享组的 IP 地址或 TCP/IP 主机名。
23. 在 安全 DDF 端口 字段中，输入 Db2 for z/OS 数据服务器使用的已配置安全 DDF 端口号。
24. 在 位置 字段中，输入要由 Db2 Data Gate访问的 Db2 子系统或数据共享组的位置名。
    位置名是通信数据库的 SYSIBM.LOCATIONS 表中 Db2 for z/OS 数据服务器的名称。
25. 在 用户名 字段中，输入将访问数据源的用户的标识。
    这是在 z/OS 上创建 Db2 Data Gate 用户并授予权限时创建或指定的特权用户用户 ID 之一。
26. 在 密码 字段中，输入步骤 25中指定的用户的密码。

在下一部分中，输入与日志阅读器相关的信息。 日志阅读器通过网络访问已连接的源数据库 (Db2 子系统或数据共享组) 的日志。

27. 在 日志阅读器下，选择是要对也用于访问数据源 (在步骤 25中指定的用户) 的日志阅读器使用相同的用户凭证，还是使用不同的用户凭证。 即，您可能想要为日志阅读器指定不同的用户标识和密码，不同的主机 IP 地址或不同的安全 DDF 端口 (比较步骤 22 和 23)。

    这在与 Db2 for z/OS 数据共享组连接时特别有用，因为它允许您为日志阅读器配置专用安全端口和位置别名。

    对日志阅读器使用源数据库连接信息

    用户标识、密码、主机 IP 地址和安全 DDF 端口与源数据库相同

    对日志阅读器使用不同的连接信息

    一个或多个访问信息与用于访问源数据库的信息不同: 用户标识和密码，主机 IP 地址或安全 DDF 端口。

    日志阅读者用户就是启动日志阅读者任务的用户。 您必须使用在网络设置期间授予其 MONITOR2 权限的用户标识（在示例中，用户标识为 USRT001）。 请参阅 向日志阅读器用户授予特权。 仅当该用户与步骤 25中的用户相同时，才选择 将源数据库连接信息用于日志阅读器 。

    如果选择 对日志阅读器使用不同的连接信息，那么您将看到一些额外的控件:

    1. 在 主机 字段中，输入配置为日志阅读器的单个 Db2 子系统或 Db2 数据共享组的主机名或 IP 地址。
    2. 在 安全 DDF 端口 字段中，输入配置的 DDF 端口号。 更多信息，请参阅为连接 Db2 Data Gate 定义安全网络端口、
    3. 在用户名字段中，键入日志阅读器用户的 ID，如在创建 Db2 Data Gate 用户并在 z/OS 上授予权限中配置的那样。
    4. 在 密码 字段中，输入该用户的密码。
28. 在 TLS 证书下，您将看到一个区域，您可以在该区域中从本地机器拖放证书文件。 另外，您还可以单击该区域中的链接。 它允许您选择要上载的文件。 您需要的证书是您在设置期间为出站网络流量创建和导出的证书。 请参阅生成和导出配对密钥和证书 Db2 Data Gate。
    注: 如果为网络设置运行了 AQTSSLDG 样本作业，请注意 AQTSSLDG 会创建两个证书。 第一个是针对 Db2 for z/OS 和 Db2 Data Gate之间的加密网络流量。 二是针对出站网络流量。 这里需要的是第二个。
29. 在 密钥库密码 字段中，输入证书的密码。
30. 在 数据门配对名称 字段中，输入唯一名称或标识。 此名称将用于标识 Db2 Data Gate 实例与 Db2 for z/OS 源的关联。
31. 单击继续。
    此时将打开一个信息窗口，其中显示配置进度。 完成此步骤后，您会看到选择表选项卡已选中，并显示在前面。

现在，您有权访问已连接的 Db2 子系统或数据共享组中的表。 下一步是选择 Db2 Data Gate的部分或全部这些表。 然后，所选表的副本将放置在 Db2 Data Gate 服务器上，并可用于连接应用程序。

32. 如果模式或表的列表很长，那么可以使用 搜索并选择要同步的表标题下的搜索字段。 该字段可用来搜索特定的模式名或表名。 搜索字段左侧的下拉列表可用来选择是要搜索模式还是表。 缺省情况下，已选中模式。 如有需要，您可更改此设置。 然后，在该字段中输入搜索字符串，以搜索以搜索字符串开头或包含该字符串的模式名或表名。 该搜索始终会在左侧列出模式名。 如果您已选择搜索表，您会看到包含所搜索表的模式。 选定模式或表的名称显示有黑色的勾选标记。
33. 选择模式。 在左侧，您会看到已连接的 Db2 子系统或数据共享组中的表模式列表。 请选中模式名前面的一个或多个复选框。 选中某个模式时，就会自动选中该模式中所有的表。 要选中所有的模式，您可选中列标题（模式）左侧的复选框。
    选定模式的表随即列示在页面右侧。
34. 现在，您已选择一个或多个模式，可以通过清除表名前面的复选框来减少可供 Db2 Data Gate 实例使用的表数。
    注: 如果在 Db2 Data Gate 连接到 Db2 子系统之后创建了 Db2 源表，那么您可能无法在列表中找到此表。 在这种情况下，请刷新浏览器中的 Web 页面。
35. 单击继续。
    完成选项卡随即选中并显示在前面。 您可以看到表选择摘要：

    主机

    Db2 for z/OS 数据源的主机名。

    端口

    用于连接到 Db2 for z/OS 数据源的安全 DDF 端口。

    位置

    Db2 for z/OS 数据源的位置名。

    模式总数

    您的选择中涉及的模式总数。

    表总数

    选定表的总数。

    估算的表总大小

    根据最新的 RUNSTAT 实用程序结果，估算的选定表总大小（以字节计）。 如果尚未针对该表空间运行 RUNSTAT 实用程序，那么此值将是无。

36. 在摘要下，您将看到标记为 启用同步和装入表的交换机。 该开关已启用。
    这项设置会针对所有选定的表触发装入进程。 只有已装入的表会包含数据；如果这些表都已卸载，那么该实例对于建立连接的应用程序来说没有价值。 此设置还可确保同步功能持续更新 Db2 Data Gate 实例中的所选表。 请保持该开关启用。 如果将其禁用，那么稍后需要在一个单独的步骤中完成这些任务（即，首先启用同步，然后装入表）。
37. 单击 完成 以完成 Db2 Data Gate 实例的配置过程。
    重要信息: 配置过程可能需要几分钟才能完成。 在此期间，请勿关闭“配置”页面。