安装 Data Replication

实例管理员可以在 5.3 版本 IBM® Software Hub 上安装 Data Replication。

谁需要完成这项任务？

实例管理员要安装 Data Replication ，您必须是实例管理员。 实例管理员有权限在以下项目中安装软件：

实例的操作员项目

此实例的 Data Replication 操作符已安装在 operators 项目中。

在安装命令中，环境变量 ${PROJECT_CPD_INST_OPERATORS} 指代操作员的项目。

实例的操作数项目

用于 和 Data Replicationcontrol plane 的自定义资源已安装在 operands 项目中。

在安装命令中，环境变量 ${PROJECT_CPD_INST_OPERANDS} 指代操作数项目。

你需要在什么时候完成这项任务？

请查看以下选项，以确定您是否需要完成此任务：

  • 若需同时安装多个服务，请改为遵循 《批量安装解决方案和服务》 中的流程。
  • 若您未在批量安装过程中安装 Data Replication ，请完成此任务以将 Data Replication 添加至您的环境。

    根据需要重复此操作如果您负责管理多个实例 IBM Software Hub，可以重复此任务在集群中安装更多实例的 Data Replication。

完成此任务所需的信息

在安装 Data Replication 之前，请仔细阅读以下信息：

版本需求

与某个实例 IBM Software Hub 相关的所有组件都必须安装在同一版本中。 例如，如果 IBM Software Hubcontrol plane 安装在版本 5.3.1 ，则必须将 Data Replication 安装在版本 5.3.1。

环境变量

本任务中的命令使用环境变量，因此您可以完全按照所写的命令运行。

  • 若您尚未拥有定义环境变量的脚本，请参阅 《设置安装环境变量》。
  • 要使用脚本中的环境变量，必须在本任务中运行命令之前加载这些环境变量。 例如，运行以下命令：
    source ./cpd_vars.sh
安全上下文约束

Data Replication 使用默认 Red Hat® OpenShift® Container Platform 的安全上下文约束。 restricted-v2

Common core services

Data Replication 需要。 IBM Software Hubcommon core services

如果实例的操作数项目中未安装 common core services 这些组件，则在安装 Data Replication 时会自动安装 common core services 这些组件。 该 common core services 安装程序延长了安装完成所需的时间。

存储要求
在安装 Data Replication 时，必须指定存储类。 建议使用以下存储类。 然而，若您在集群中未使用这些存储类，请确保指定具有等效定义的存储类。

* 表示该存储类仅在 common core services 需要安装时使用。

存储器 注意 存储类
OpenShift Data Foundation 安装服务时，请指定文件存储和块存储。
  • 文件存储： ocs-storagecluster-cephfs *
  • 块存储： ocs-storagecluster-ceph-rbd
IBM Fusion Data Foundation 安装服务时，请指定文件存储和块存储。
  • 文件存储： ocs-storagecluster-cephfs *
  • 块存储： ocs-storagecluster-ceph-rbd
IBM Fusion Global Data Platform 安装服务时，请为文件存储和块存储指定相同的存储类。
  • 文件存储：

    以下任一存储类：

    • ibm-spectrum-scale-sc *
    • ibm-storage-fusion-cp-sc
  • 块存储：

    以下任一存储类：

    • ibm-spectrum-scale-sc
    • ibm-storage-fusion-cp-sc
IBM Storage Scale Container Native 安装服务时，请为文件存储和块存储指定相同的存储类。
  • 文件存储： ibm-spectrum-scale-sc *
  • 块存储： ibm-spectrum-scale-sc
Portworx 安装服务时，该 --storage_vendor=portworx 选项可确保服务使用正确的存储类。
  • 文件存储： portworx-rwx-gp3-sc *

    （等同于 portworx-shared-gp3 旧版安装中的）

  • 块存储：
    • portworx-couchdb-sc *
    • portworx-elastic-sc *
    • portworx-gp3-sc
NFS 安装服务时，请为文件存储和块存储指定相同的存储类。
  • 文件存储： managed-nfs-storage *
  • 块存储： managed-nfs-storage
Amazon Elastic 存储 安装服务时，请指定文件存储和块存储。

文件存储由 Amazon Elastic File System. 提供。 块存储由 Amazon Elastic Block Store. 提供。
  • 文件存储： efs-nfs-client
  • 块存储：

    以下任一存储类：

    • gp2-csi *
    • gp3-csi *
NetApp Trident 安装服务时，请为文件存储和块存储指定相同的存储类。
  • 文件存储： ontap-nas *
  • 块存储： ontap-nas
Nutanix 不支持。 不适用。

开始之前

此任务要求满足以下先决条件：

系统需求
此任务假定集群满足 Data Replication 的最低要求。
在何处查找更多信息
如果此任务尚未完成，请参阅系统要求。
工作站
此任务假定您将用于运行安装的工作站已配置为客户端工作站，并具备以下命令行界面：
  • IBM Software Hub 命令行界面： cpd-cli
  • OpenShift 命令行界面： oc
  • Helm 命令行界面： helm
在何处查找更多信息
如果此任务尚未完成，请参阅设置客户端工作站。
控制平面
此任务假设 已安装 IBM Software Hubcontrol plane 。
在何处查找更多信息
如果此任务尚未完成，请参阅 《安装 IBM 实例》 Software Hub。
专用容器注册表
如果您的环境使用私有容器注册表（例如，您的集群处于空气隔离状态），则此任务假定以下任务已完成：
  1. Data Replication 软件镜像已同步至私有容器注册表。
    在何处查找更多信息
    如果此任务尚未完成，请参阅《 将镜像镜像到私有容器注册表》。
  2. 该 cpd-cli 配置用于从私有容器注册表中拉取镜像 olm-utils-v4 。
    在何处查找更多信息
    如果此任务尚未完成，请参阅从私有容器注册表拉取 olm-utils-v4 镜像。
负载均衡器
负载均衡器超时设置已针对 Data Replication 进行调整。
在何处查找更多信息
如果此任务尚未完成，请参阅 《更改负载均衡器设置》。
簇作用域资源
此任务假定集群作用域资源（如自定义资源定义、集群角色和集群角色绑定）已存在。
在何处查找更多信息
如果此任务尚未完成，请参阅 《为 IBMSoftware Hub 平台和服务创建集群作用域资源》。
映像提取私钥
此任务假设包含实例镜像拉取凭据的密钥已存在。
在何处查找更多信息
如果此任务尚未完成，请参阅 《为 IBM 实例创建镜像拉取密钥 》 Software Hub。

过程

请完成以下任务以安装 Data Replication ：

  1. 指定安装选项
  2. 安装服务
  3. 验证安装
  4. 下一步该做什么

指定安装选项

若计划安装 Data Replication，必须在 目录 cpd-cli workinstall-options.yml 下的 文件中指定以下安装选项（例如： cpd-cli-workspace/olm-utils-workspace/work）。

此参数是必需参数。

请根据您 IBM Software Hub 安装的版本遵循相应的指导：

版本 5.3.1

5.3.1 此格式仅适用于 5.3.1IBM Software Hub 版本。

保留条目开头的 --- 语法，以确保该条目被视为独立文档。

---
# ............................................................................
# Data Replication parameters
# ............................................................................
non_olm:
  replication:
    licenseType: {{license_type}}
版本 5.3.0

在 install-options.yml 文件的 条目 replication: 下，将该参数添加到 部分 override_components_meta: 。

请根据您的环境替换 <license> 为相应的值。

# ............................................................................
# Data Replication parameters
# ............................................................................
  replication:
    replication_license_type: <license>
参数 描述
replication_license_type 请指定您购买的许可证。
有效值：
IDRC
若您购买的是适用于 的 IBM Data ReplicationIBM Software Hub 墨盒，请选择此选项。
IIDRC
若您购买的是适用于 IBM 的墨盒 IBM Software Hub，请勾 Data Replication 选此选项。 InfoSphere®
IDRM
若您已购买 IBM Data Replication 现代化升级，请勾选此选项。
IIDRM
若您购买了 IBMInfoSphereData Replication 现代化升级版，请选择此选项。
IDRZOS
若您已购买 IBM Data Replication for Db2® z/OS® Cartridge，请勾选此选项。
IIDRWXTO
若您已购买 IBM InfoSphere Data Replication for watsonx.data™ Cartridge，请勾选此选项。
若要在 cpd-cli 使用命令安装 Data Replication 之前查看许可证链接，请执行以下命令：
cpd-cli manage get-license \
--release=${VERSION} \
--components=replication \
--license-type=<license>
请 <license> 将 替换为您想要了解的复制许可类型。

安装服务

安装 Data Replication ：

  1. 登录 cpd-cli 到集群 Red Hat OpenShift Container Platform ：
    ${CPDM_OC_LOGIN}
    请记住： CPDM_OC_LOGIN 是一个别名，代表 命令 cpd-cli manage login-to-ocp 。
  2. 安装 Data Replication 的操作员和自定义资源。

    您运行的命令取决于集群中的存储。

    Red Hat OpenShift 数据基础存储 
    cpd-cli manage install-components \
--license_acceptance=true \
--components=replication \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET} \
--param-file=/tmp/work/install-options.yml
    IBM 融合数据基础存储 
    cpd-cli manage install-components \
--license_acceptance=true \
--components=replication \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET} \
--param-file=/tmp/work/install-options.yml
    IBM 融合全球数据平台存储
    请记住： 当使用 IBM Fusion Global Data Platform 存储时，和 ${STG_CLASS_BLOCK} 都 ${STG_CLASS_FILE} 指向相同的存储类，通常 ibm-spectrum-scale-sc 为或 ibm-storage-fusion-cp-sc。
    cpd-cli manage install-components \
--license_acceptance=true \
--components=replication \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET} \
--param-file=/tmp/work/install-options.yml
    IBM Storage 容器原生存储
    请记住： 当使用 IBM Storage Scale Container Native 存储时，和 ${STG_CLASS_BLOCK} 都 ${STG_CLASS_FILE} 指向相同的存储类，通常为 ibm-spectrum-scale-sc。
    cpd-cli manage install-components \
--license_acceptance=true \
--components=replication \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET} \
--param-file=/tmp/work/install-options.yml
    Portworx 存储器 
    cpd-cli manage install-components \
--license_acceptance=true \
--components=replication \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--storage_vendor=portworx \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET} \
--param-file=/tmp/work/install-options.yml
    NFS 存储器
    请记住： 当使用 NFS 存储时，和 ${STG_CLASS_BLOCK} 都 ${STG_CLASS_FILE} 指向相同的存储类，通常为 managed-nfs-storage。
    cpd-cli manage install-components \
--license_acceptance=true \
--components=replication \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET} \
--param-file=/tmp/work/install-options.yml
    AWS 仅限 EFS 存储
    请记住： 当您使用 ` EFS ` 存储时，`` ${STG_CLASS_BLOCK} 和 ${STG_CLASS_FILE} `` 都指向相同的存储类，通常为 efs-nfs-client``。
    cpd-cli manage install-components \
--license_acceptance=true \
--components=replication \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET} \
--param-file=/tmp/work/install-options.yml
    AWS 使用 EFS 和 EBS 存储 
    cpd-cli manage install-components \
--license_acceptance=true \
--components=replication \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET} \
--param-file=/tmp/work/install-options.yml
    NetApp Trident
    请记住： 当使用 NetApp Trident 存储时，和 ${STG_CLASS_BLOCK} 都 ${STG_CLASS_FILE} 指向相同的存储类，通常为 ontap-nas。
    cpd-cli manage install-components \
--license_acceptance=true \
--components=replication \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET} \
--param-file=/tmp/work/install-options.yml

验证安装

Data Replication 当 install-components 命令返回时安装：
[SUCCESS]... The install-components command ran successfully

若需确认自定义资源状态为 Completed，可执行 命令 cpd-cli manage get-cr-status ：

下一步操作

安装 Data Replication 后，用户 admin 将获得一个可用的复制实例。 若您持有该 admin 用户的凭据，即可登录并开始使用提供的实例进行数据复制。

此外，您还可以管理实例、为其他用户授予访问权限，以及创建服务实例。

在完成 Data Replication 的部署和配置后，您也可以开始管理该服务。