安装 Data Replication

重要信息： IBM Cloud Pak® for Data 4.7 版本将于 2025 年 7 月 31 日结束支持 (EOS)。 欲了解更多信息，请参阅 IBM Cloud Pak for Data 版本 4.X 的停止服务公告。

在 IBM Cloud Pak for Data 4.7 版本支持结束之前，升级到 IBM Software Hub 5.1 版本。 更多信息，请参阅 IBM Software Hub 版本 5.1 文档中的升级 IBM Software Hub。

实例管理员可以在 IBM Cloud Pak for Data V 4.7上安装 Data Replication 。

谁需要完成此任务?

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

实例的 操作程序项目

此 Cloud Pak for Data 实例的操作程序安装在操作程序项目中。

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

实例的 操作数项目

此 Cloud Pak for Data 实例的 Cloud Pak for Data control plane 和服务安装在操作数项目中。

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

何时需要完成此任务?

查看以下选项以确定是否需要完成此任务:

  • 如果要同时安装 Cloud Pak for Data control plane 和一个或多个服务，请改为遵循 安装 Cloud Pak for Data 中的过程。
  • 如果在安装 Cloud Pak for Data control plane时未安装 Data Replication ，请完成此任务以将 Data Replication 添加到环境中。

    根据需要重复 如果您负责 Cloud Pak for Data的多个实例，那么可以重复此任务以在集群上安装更多 Data Replication 实例。

完成此任务所需的信息

在安装 Data Replication之前，请查看以下信息:

版本需求

必须在同一发行版中安装与 Cloud Pak for Data 实例相关联的所有组件。 例如，如果 Cloud Pak for Data control plane 安装在 V 4.7.4上，那么必须安装 V 4.7.4上的 Data Replication 。

环境变量

此任务中的命令使用环境变量，以便您可以完全按照编写的方式运行命令。

  • 如果没有用于定义环境变量的脚本，请参阅 设置安装环境变量。
  • 要使用脚本中的环境变量，必须先确定环境变量的来源，然后再运行此任务中的命令。 例如，运行以下命令：
    source ./cpd_vars.sh
安全上下文约束

Data Replication 使用缺省 Red Hat® OpenShift® Container Platform 安全上下文约束:

  • 在 V 4.10上，缺省 SCC 为 restricted。
  • 在 V 4.12上，缺省 SCC 为 restricted-v2
Common core services

Data Replication 需要 Cloud Pak for Data common 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® Storage Fusion Data Foundation 安装服务时，请指定文件存储器和块存储器。
  • 文件存储器: ocs-storagecluster-cephfs *
  • 块存储器: ocs-storagecluster-ceph-rbd
IBM Storage Fusion Global Data Platform 安装服务时，请为文件存储器和块存储器指定相同的存储类。
  • 文件存储器: ibm-spectrum-scale-sc *
  • 块存储器: ibm-spectrum-scale-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

准备工作

此任务假定满足以下先决条件:

先决条件 在何处查找更多信息
集群满足安装 Data Replication的最低要求。 如果此任务未完成，请参阅 系统需求。
将从中运行安装的工作站设置为客户机工作站，并包含以下命令行界面:
  • Cloud Pak for Data CLI: cpd-cli
  • OpenShift CLI: oc
 如果此任务未完成，请参阅 设置客户机工作站。
已安装 Cloud Pak for Data control plane 。 如果此任务未完成，请参阅 安装 Cloud Pak for Data。
对于使用专用容器注册表的环境 (例如气郄环境) ，会将 Data Replication 软件映像镜像到专用容器注册表。 如果此任务未完成，请参阅 镜像映像到专用容器注册表。
对于使用专用容器注册表的环境 (例如气郄环境) ， cpd-cli 配置为从专用容器注册表中拉取 olm-utils-v2 映像。 如果此任务未完成，请参阅 从专用容器注册表中拉取 olm-utils-v2 映像。

过程

完成以下任务以安装 Data Replication:

  1. 指定安装选项
  2. 安装服务
  3. 验证安装
  4. 下一步操作

指定安装选项

如果计划安装 Data Replication，那么必须在 work 目录中名为 install-options.yml 的文件中指定以下安装选项。

此参数是必需参数。

将 <license> 替换为适合于您的环境的值。

################################################################################
# Data Replication parameters
################################################################################
replication_license_type: <license>
参数 描述
replication_license_type 指定您购买的许可证。
有效值：
IDRC
如果您购买了 IBM Data Replication Cartridge for IBM Cloud Pak for Data (L-MVQH-PRYPMJ )，请指定此选项。
IIDRC
如果购买了 IBM InfoSphere Data Replication 墨盒，请指定此选项，用于 IBM Cloud Pak for Data ( L-ABEV-TSNPF4 ).
IDRM
如果购买了 IBM Data Replication 现代化 (L-LCRM-JMHEEA )，请指定此选项。
IIDRM
如果购买了 IBM InfoSphere Data Replication 现代化 (L-QYFR-MBJXAV )，请指定此选项。
如果要在使用 cpd-cli 命令安装 Data Replication 之前查看许可证的链接，请运行以下命令:
cpd-cli manage get-license \
--release=${VERSION} \
--components=replication \
--license-type=<license>
将 <license> 替换为要获取相关信息的复制许可证类型。

安装服务

要安装 Data Replication:

  1. 运行 cpd-cli manage login-to-ocp 命令，以具有足够许可权的用户身份登录到集群以完成此任务。 例如：
    cpd-cli manage login-to-ocp \
--username=${OCP_USERNAME} \
--password=${OCP_PASSWORD} \
--server=${OCP_URL}
    提示: login-to-ocp 命令采用与 oc login 命令相同的输入。 运行 oc login --help 以获取详细信息。
  2. 运行以下命令以在实例的 操作程序项目 中为 Data Replication 创建必需的 OLM 对象:
    cpd-cli manage apply-olm \
--release=${VERSION} \
--cpd_operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--components=replication
    等待 cpd-cli 返回以下消息，然后继续执行下一步:
    [SUCCESS]... The apply-olm command ran successfully

    如果 apply-olm 失败，请参阅 在安装或升级期间对 apply-olm 命令进行故障诊断。

  3. 为 Data Replication创建定制资源。

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

    Red Hat OpenShift Data Foundation 存储器

    运行以下命令以创建定制资源。

    cpd-cli manage apply-cr \
--components=replication \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--param-file=/tmp/work/install-options.yml \
--license_acceptance=true
    IBM Storage Fusion 数据 基础存储

    运行以下命令以创建定制资源。

    cpd-cli manage apply-cr \
--components=replication \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--param-file=/tmp/work/install-options.yml \
--license_acceptance=true
    IBM Storage Fusion 全球数据平台存储
    请记住: 使用 IBM Storage Fusion Global Data Platform 存储器时， ${STG_CLASS_BLOCK} 和 ${STG_CLASS_FILE} 都指向同一存储类，通常是 ibm-spectrum-scale-sc。

    运行以下命令以创建定制资源。

    cpd-cli manage apply-cr \
--components=replication \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--param-file=/tmp/work/install-options.yml \
--license_acceptance=true
    IBM Storage Scale Container 本机存储器
    请记住: 使用 IBM Storage Scale Container Native 存储器时， ${STG_CLASS_BLOCK} 和 ${STG_CLASS_FILE} 都指向同一存储类，通常是 ibm-spectrum-scale-sc。

    运行以下命令以创建定制资源。

    cpd-cli manage apply-cr \
--components=replication \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--param-file=/tmp/work/install-options.yml \
--license_acceptance=true
    Portworx 存储器

    运行以下命令以创建定制资源。

    cpd-cli manage apply-cr \
--components=replication \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--storage_vendor=portworx \
--param-file=/tmp/work/install-options.yml \
--license_acceptance=true
    NFS 存储器
    请记住: 使用 NFS 存储器时， ${STG_CLASS_BLOCK} 和 ${STG_CLASS_FILE} 都指向同一存储类，通常是 managed-nfs-storage。

    运行以下命令以创建定制资源。

    cpd-cli manage apply-cr \
--components=replication \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--param-file=/tmp/work/install-options.yml \
--license_acceptance=true
    仅具有 EFS 存储器的 AWS
    请记住: 使用 EFS 存储器时， ${STG_CLASS_BLOCK} 和 ${STG_CLASS_FILE} 都指向同一存储类，通常是 efs-nfs-client。

    运行以下命令以创建定制资源。

    cpd-cli manage apply-cr \
--components=replication \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--param-file=/tmp/work/install-options.yml \
--license_acceptance=true
    带有 EFS 和 EBS 存储器的 AWS

    运行以下命令以创建定制资源。

    cpd-cli manage apply-cr \
--components=replication \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--param-file=/tmp/work/install-options.yml \
--license_acceptance=true
    NetApp Trident
    请记住: 使用 NetApp Trident 存储器时， ${STG_CLASS_BLOCK} 和 ${STG_CLASS_FILE} 都指向同一存储类，通常是 ontap-nas。

    运行以下命令以创建定制资源。

    cpd-cli manage apply-cr \
--components=replication \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--param-file=/tmp/work/install-options.yml \
--license_acceptance=true

验证安装

当 apply-cr 命令返回以下内容时，将安装 Data Replication :
[SUCCESS]... The apply-cr command ran successfully

如果要确认定制资源状态为 Completed，那么可以运行 cpd-cli manage get-cr-status 命令:

下一步操作

安装 Data Replication后，将为 admin 用户提供一个复制实例。 如果您具有 admin 用户的凭证，那么可以登录并开始使用提供的实例来复制数据。

完成安装后 Data Replication 中的任务。

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

当 Data Replication 完成并配置后，您还可以开始管理服务。