安装 IBM Cloud Pak for Data

重要信息： 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 foundational services 之后，可以安装 IBM Cloud Pak for Data control plane 和服务。

安装阶段
你不在这里 设置客户工作站
你不在这里 设置集群
你不在这里 收集所需信息
你不在这里 准备从专用容器注册表运行安装程序
你不在这里 准备群集 Cloud Pak for Data
你不在这里 准备安装 Cloud Pak for Data
您在此图标。 安装 Cloud Pak for Data
谁需要完成此任务?

实例管理员 实例管理员可以完成此任务。

何时需要完成此任务?

根据需要重复 如果计划安装 Cloud Pak for Data的多个实例，那么必须对计划安装的每个实例重复此任务。

准备工作

最佳实践: 如果您设置了环境变量，那么可以在此任务中以完全相同的方式运行命令。 有关指示信息，请参阅 设置安装环境变量。

在运行此任务中的命令之前，请确保确定环境变量的来源。

关于本任务

您可以选择是否要执行以下操作:
  • 在实例中安装服务之前安装 Cloud Pak for Data control plane
  • 同时安装 Cloud Pak for Data control plane 和服务。
请记住: 实例中的所有软件都必须安装在同一版本上。

如果计划将 Cloud Pak for Data 与 IBM Cloud Pak foundational services Identity Management Service，请决定默认管理员账户的名称对您来说是否重要。

与 Identity Management Service集成时，缺省管理员帐户称为 cpadmin。
  • 如果同时安装 Cloud Pak for Data control plane 和服务，那么必须将缺省管理员用户帐户的名称更新为 admin ，以使服务能够访问和管理在安装期间创建的对象。
  • 如果在安装服务之前安装 Cloud Pak for Data control plane 并与 Identity Management Service 集成，那么可以使用缺省 cpadmin 帐户。

过程

  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. 查看 Cloud Pak for Data的许可条款。
    Cloud Pak for Data 许可证以联机方式提供。 运行相应的命令以获取许可证的 URL :
    Enterprise Edition 
    cpd-cli manage get-license \
--release=${VERSION} \
--license-type=EE
    Standard Edition 
    cpd-cli manage get-license \
--release=${VERSION} \
--license-type=SE
  3. 在实例的 操作程序项目 中安装操作程序。
    提示: 在对集群运行此命令之前，可以通过运行带有 --preview=true 选项的命令来预览此命令将代表您发出的 oc 命令。

    oc 命令将保存到 work 目录中的 preview.sh 文件。

    IBM Cloud Pak for Data 平台运营商和服务运营商 
    cpd-cli manage apply-olm \
--release=${VERSION} \
--cpd_operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--components=${COMPONENTS}
    IBM Cloud Pak for Data 仅限平台运营商 
    cpd-cli manage apply-olm \
--release=${VERSION} \
--cpd_operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--components=cpd_platform
    等待 cpd-cli 返回以下消息，然后继续执行下一步:
    [成功] ... apply-olm 命令成功运行。

    如果 apply-olm 命令失败，请参阅安装或升级期间应用-olm 命令的故障排除。

  4. 在实例的 操作数项目 中安装操作数:
    提示: 在对集群运行此命令之前，可以通过运行带有 --preview=true 选项的命令来预览此命令将代表您发出的 oc 命令。

    oc 命令将保存到 work 目录中的 preview.sh 文件。

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

    Red Hat OpenShift Data Foundation 存储器

    为指定的组件创建定制资源。

    Cloud Pak for Data control plane 和服务 (无安装选项)

    缺省情况下， apply-cr 最多同时安装到 4 组件。 您可以通过指定 --parallel_num 选项来调整此设置。

    cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=${COMPONENTS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true
    Cloud Pak for Data control plane 和服务 (带有安装选项)

    如果创建了 install-options.yml 文件，请运行以下命令。

    缺省情况下， apply-cr 最多同时安装到 4 组件。 您可以通过指定 --parallel_num 选项来调整此设置。

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

    为指定的组件创建定制资源。

    Cloud Pak for Data control plane 和服务 (无安装选项)

    缺省情况下， apply-cr 最多同时安装到 4 组件。 您可以通过指定 --parallel_num 选项来调整此设置。

    cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=${COMPONENTS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true
    Cloud Pak for Data control plane 和服务 (带有安装选项)

    如果创建了 install-options.yml 文件，请运行以下命令。

    缺省情况下， apply-cr 最多同时安装到 4 组件。 您可以通过指定 --parallel_num 选项来调整此设置。

    cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=${COMPONENTS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true \
--param-file=/tmp/work/install-options.yml
    Cloud Pak for Data control plane仅
    cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=cpd_platform \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true
    IBM Storage Fusion 全球数据平台存储

    为指定的组件创建定制资源。

    使用 IBM Storage Fusion 存储器时， ${STG_CLASS_BLOCK} 和 ${STG_CLASS_FILE} 都指向同一存储类，通常是 ibm-spectrum-scale-sc。

    Cloud Pak for Data control plane 和服务 (无安装选项)

    缺省情况下， apply-cr 最多同时安装到 4 组件。 您可以通过指定 --parallel_num 选项来调整此设置。

    cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=${COMPONENTS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true
    Cloud Pak for Data control plane 和服务 (带有安装选项)

    如果创建了 install-options.yml 文件，请运行以下命令。

    缺省情况下， apply-cr 最多同时安装到 4 组件。 您可以通过指定 --parallel_num 选项来调整此设置。

    cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=${COMPONENTS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true \
--param-file=/tmp/work/install-options.yml
    Cloud Pak for Data control plane仅
    cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=cpd_platform \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true
    IBM Storage Scale Container 本机存储器

    为指定的组件创建定制资源。

    使用 IBM Storage Scale Container Native 存储器时， ${STG_CLASS_BLOCK} 和 ${STG_CLASS_FILE} 都指向同一存储类，通常是 ibm-spectrum-scale-sc。

    Cloud Pak for Data control plane 和服务 (无安装选项)

    缺省情况下， apply-cr 最多同时安装到 4 组件。 您可以通过指定 --parallel_num 选项来调整此设置。

    cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=${COMPONENTS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true
    Cloud Pak for Data control plane 和服务 (带有安装选项)

    如果创建了 install-options.yml 文件，请运行以下命令。

    缺省情况下， apply-cr 最多同时安装到 4 组件。 您可以通过指定 --parallel_num 选项来调整此设置。

    cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=${COMPONENTS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true \
--param-file=/tmp/work/install-options.yml
    Cloud Pak for Data control plane仅
    cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=cpd_platform \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true
    Portworx 存储器

    为指定的组件创建定制资源。

    Cloud Pak for Data control plane 和服务 (无安装选项)

    缺省情况下， apply-cr 最多同时安装到 4 组件。 您可以通过指定 --parallel_num 选项来调整此设置。

    cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=${COMPONENTS} \
--storage_vendor=portworx \
--license_acceptance=true
    Cloud Pak for Data control plane 和服务 (带有安装选项)

    如果创建了 install-options.yml 文件，请运行以下命令。

    缺省情况下， apply-cr 最多同时安装到 4 组件。 您可以通过指定 --parallel_num 选项来调整此设置。

    cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=${COMPONENTS} \
--storage_vendor=portworx \
--license_acceptance=true \
--param-file=/tmp/work/install-options.yml
    Cloud Pak for Data control plane仅
    cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=cpd_platform \
--storage_vendor=portworx \
--license_acceptance=true
    NFS 存储器

    使用 IBM Storage Scale Container Native 存储器时， ${STG_CLASS_BLOCK} 和 ${STG_CLASS_FILE} 都指向同一存储类，通常是 managed-nfs-storage。

    为指定的组件创建定制资源。

    Cloud Pak for Data control plane 和服务

    缺省情况下， apply-cr 最多同时安装到 4 组件。 您可以通过指定 --parallel_num 选项来调整此设置。

    cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=${COMPONENTS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true
    Cloud Pak for Data control plane 和服务 (带有安装选项)

    如果创建了 install-options.yml 文件，请运行以下命令。

    缺省情况下， apply-cr 最多同时安装到 4 组件。 您可以通过指定 --parallel_num 选项来调整此设置。

    cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=${COMPONENTS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true \
--param-file=/tmp/work/install-options.yml
    Cloud Pak for Data control plane仅
    cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=cpd_platform \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true
    仅 AWS EFS 存储器

    为指定的组件创建定制资源。

    仅使用 EFS 存储器时， ${STG_CLASS_BLOCK} 和 ${STG_CLASS_FILE} 都指向同一存储类 (通常为 efs-nfs-client)。

    Cloud Pak for Data control plane 和服务

    缺省情况下， apply-cr 最多同时安装到 4 组件。 您可以通过指定 --parallel_num 选项来调整此设置。

    cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=${COMPONENTS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true
    Cloud Pak for Data control plane 和服务 (带有安装选项)

    如果创建了 install-options.yml 文件，请运行以下命令。

    缺省情况下， apply-cr 最多同时安装到 4 组件。 您可以通过指定 --parallel_num 选项来调整此设置。

    cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=${COMPONENTS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true \
--param-file=/tmp/work/install-options.yml
    Cloud Pak for Data control plane仅
    cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=cpd_platform \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true
    AWS EFS 和 EBS 存储器

    为指定的组件创建定制资源。

    Cloud Pak for Data control plane 和服务

    缺省情况下， apply-cr 最多同时安装到 4 组件。 您可以通过指定 --parallel_num 选项来调整此设置。

    cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=${COMPONENTS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true
    Cloud Pak for Data control plane 和服务 (带有安装选项)

    如果创建了 install-options.yml 文件，请运行以下命令。

    缺省情况下， apply-cr 最多同时安装到 4 组件。 您可以通过指定 --parallel_num 选项来调整此设置。

    cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=${COMPONENTS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true \
--param-file=/tmp/work/install-options.yml
    Cloud Pak for Data control plane仅
    cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=cpd_platform \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true
    NetApp Trident

    为指定的组件创建定制资源。

    使用 NetApp Trident 存储器时， ${STG_CLASS_BLOCK} 和 ${STG_CLASS_FILE} 都指向同一存储类，通常是 ontap-nas。

    Cloud Pak for Data control plane 和服务

    缺省情况下， apply-cr 最多同时安装到 4 组件。 您可以通过指定 --parallel_num 选项来调整此设置。

    cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=${COMPONENTS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true
    Cloud Pak for Data control plane 和服务 (带有安装选项)

    如果创建了 install-options.yml 文件，请运行以下命令。

    缺省情况下， apply-cr 最多同时安装到 4 组件。 您可以通过指定 --parallel_num 选项来调整此设置。

    cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=${COMPONENTS} \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true \
--param-file=/tmp/work/install-options.yml
    Cloud Pak for Data control plane仅
    cpd-cli manage apply-cr \
--release=${VERSION} \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=cpd_platform \
--block_storage_class=${STG_CLASS_BLOCK} \
--file_storage_class=${STG_CLASS_FILE} \
--license_acceptance=true
    等待 cpd-cli 返回以下消息，然后继续执行下一步:
    [成功] ... apply-cr 命令成功运行。
  5. 确认操作数的状态为 Completed:
    cpd-cli manage get-cr-status \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS}
  6. 获取 Web 客户机的 URL 和缺省凭证:
    cpd-cli manage get-cpd-instance-details \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--get_admin_initial_credentials=true

下一步操作

如果要将项目绑定到 Cloud Pak for Data 的此实例，请完成将项目绑定到 IBM Cloud Pak for Data control plane。

确保完成安装后设置（第 1 天操作）。

如果在安装控制平面时未安装任何服务，请确保安装要使用的服务。 请参阅 服务中有关单独安装每个服务的指示信息。