安装 Data Replication

实例管理员可在5.1 版 "IBM® Software Hub上安装Data Replication。

谁需要完成此任务?

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

实例的操作程序项目

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

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

实例的操作数项目

control plane 和 Data Replication 的定制资源安装在操作数项目中。

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

何时需要完成此任务?

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

如果要同时安装多个服务，请改为执行运行解决方案和服务的批处理安装中的过程。
如果未在批处理安装过程中安装 Data Replication ，请完成此任务以将 Data Replication 添加到环境中。
根据需要重复如果您负责 IBM Software Hub的多个实例，那么可以重复此任务以在集群上安装更多 Data Replication 实例。

完成此任务所需的信息

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

版本需求: 必须在同一发行版中安装与 IBM Software Hub 实例相关联的所有组件。例如，如果 IBM Software Hub control plane 安装在版本 5.1.3 ，则必须安装 Data Replication 版本 5.1.3.

环境变量

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

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

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

Common core services

Data Replication 需要 IBM Software Hub 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 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 CLI： `cpd-cli` OpenShift CLI： `oc`	如果此任务未完成，请参阅设置客户机工作站。
IBM Software Hub"control plane已安装。	如果此任务未完成，请参阅安装 IBM Software Hub 实例。
对于使用专用容器注册表的环境 (例如气郄环境) ，会将 Data Replication 软件映像镜像到专用容器注册表。	如果此任务未完成，请参阅镜像映像到专用容器注册表。
对于使用专用容器注册表的环境 (例如气郄环境) ， `cpd-cli` 配置为从专用容器注册表中拉取 `olm-utils-v3` 映像。	如果此任务未完成，请参阅从专用容器注册表中拉取 olm-utils-v3 映像。
负载平衡器超时设置调整为 Data Replication.	如果此任务未完成，请参阅更改负载平衡器设置。

过程

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

指定安装选项
安装服务
验证安装
下一步操作

指定安装选项

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

此参数是必需参数。

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

################################################################################
# Data Replication parameters
################################################################################
replication_license_type: <license>

参数描述

参数	描述
`replication_license_type`	指定您购买的许可证。有效值： `IDRC` 如果购买了 IBM Data Replication Cartridge for IBM Software Hub，请指定此选项。 `IIDRC` 如果购买了 IBM InfoSphere Data Replication Cartridge for IBM Software Hub，请指定此选项。 `IDRM` 如果您购买了 IBM Data Replication Modernization ，请指定此选项。 `IIDRM` 如果您购买了 IBM InfoSphere Data Replication Modernization ，请指定此选项。 `IDRZOS` 如果购买了 "IBM Data Replication for Db2® z/OS® Cartridge，请指定此选项。 `IIDRWXTO` 如果购买了 "IBM InfoSphere® Data Replication for watsonx.data™ Cartridge，请指定此选项。

replication_license_type

指定您购买的许可证。

有效值：

IDRC: 如果购买了 IBM Data Replication Cartridge for IBM Software Hub，请指定此选项。
IIDRC: 如果购买了 IBM InfoSphere Data Replication Cartridge for IBM Software Hub，请指定此选项。
IDRM: 如果您购买了 IBM Data Replication Modernization ，请指定此选项。
IIDRM: 如果您购买了 IBM InfoSphere Data Replication Modernization ，请指定此选项。
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:

将 cpd-cli 登录到 Red Hat OpenShift Container Platform 集群:
```
${CPDM_OC_LOGIN}
```
请记住: CPDM_OC_LOGIN 是 cpd-cli manage login-to-ocp 命令的别名。
运行以下命令以在实例的操作程序项目中为 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 命令进行故障诊断。

为 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

IBMFusion 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

IBMFusion 全球数据平台存储

请记住: 使用 IBM Fusion Global Data Platform 存储器时， ${STG_CLASS_BLOCK} 和 ${STG_CLASS_FILE} 都指向相同的存储类，通常是 ibm-spectrum-scale-sc 或 ibm-storage-fusion-cp-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 完成并配置后，您还可以开始管理服务。