安装 Cloud Pak for Data

IBM® Cloud Pak for Data ，您将更新 IBM Cloud Pak® for Data 平台运营商和 IBM Cloud Pak 基础服务运营商，以便查看您将安装 IBM Cloud Pak for Data。然后，创建一个自定义资源， Cloud Pak for Data 该项目中。

此任务所需的许可权

您必须是：

集群管理员
以下项目的管理员：

IBM Cloud Pak 基础服务项目

由 ${PROJECT_CPFS_OPS} 环境变量标识。
通常是 ibm-common-services 项目。

IBM Cloud Pak for Data 平台运营商项目

由 ${PROJECT_CPD_OPS} 环境变量标识。
该项目可以是一个单独的项目，例如 cpd-operators ，也可以是 IBM Cloud Pak 基础服务项目。

计划安装 Cloud Pak for Data 的项目

由 ${PROJECT_CPD_INSTANCE} 环境变量标识。

当您需要完成此任务时

每次要在集群上安装 Cloud Pak for Data 实例时，都必须完成此任务。

完成此任务所需的信息

Cloud Pak for Data control plane 仅需要 restricted 安全上下文约束 (SCC)。
Cloud Pak for Data control plane 使用以下存储类。如果您在集群上不使用这些存储类，请确保使用具有等效定义的存储类：
- OpenShift® Container Storage: ocs-storagecluster-cephfs
- IBM Spectrum® Scale 容器本机: ibm-spectrum-scale-sc
- NFS: managed-nfs-storage
- Portworx: portworx-shared-gp3
- IBM Cloud File Storage ： ibmc-file-gold-gid 或 ibm-file-custom-gold-gid

重要信息: 本任务中的步骤假定您正在安装最新软件映像。

准备工作

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

请确保先运行环境变量脚本，然后再运行此任务中的命令。

确保集群管理员已完成环境所需的安装前任务。具体而言，验证集群管理员是否已完成以下任务：

如果您使用专门的安装方法，请确保已安装 IBM Cloud Pak 基础服务。详情请参阅安装 IBM Cloud Pak 基础服务。
您计划安装 Cloud Pak for Data 的项目已存在。有关详细信息，请参阅在 Red Hat OpenShift Container Platform。
对于使用专用容器注册表的环境 (例如气郄环境) ，会将 Cloud Pak for Data 软件映像镜像到专用容器注册表。有关详细信息，请参阅将映像镜像到专用容器注册表。
集群已配置为提取软件映像。有关详细信息，请参阅配置集群以拉取 Cloud Pak for Data 映像。
存在 Cloud Pak for Data 平台操作程序目录源。有关详细信息，请参阅创建目录源。
存在 Cloud Pak for Data 平台操作程序预订和 IBM NamespaceScope Operator 预订。有关详细信息，请参阅创建操作员预订。

如果未完成这些步骤，那么 Cloud Pak for Data 安装将失败。

过程

要安装 Cloud Pak for Data:

以具有足够许可权的用户身份登录到 Red Hat OpenShift Container Platform 以完成该任务:
```
oc login ${OCP_URL}
```
使 IBM Cloud Pak for Data 平台运营商和 IBM Cloud Pak 基础服务运营商能够查看您将安装的项目 IBM Cloud Pak for Data ：
快速安装

创建一个操作请求，授予 IBM Cloud Pak for Data 平台运营商和 IBM Cloud Pak 基础服务运营商权限，以便管理您计划安装的项目 Cloud Pak for Data。
```
cat <<EOF |oc apply -f -
apiVersion: operator.ibm.com/v1alpha1
kind: OperandRequest
metadata:
  name: empty-request
  namespace: ${PROJECT_CPD_INSTANCE}
spec:
  requests: []
EOF
```
专门安装

更新 Cloud Pak for Data 操作程序项目中的 NamespaceScope 对象，以查看计划安装 Cloud Pak for Data的项目。
1. 检查 {PROJECT_CPD_OPS} 项目中是否已存在名为 cpd-operators 的 NamespaceScope 对象:
```
oc get NamespaceScope -n ${PROJECT_CPD_OPS}
```
2. 完成适合您环境的相应步骤:
  该命令会返回：No resources found in the ... namespace
  运行以下命令以创建 NamespaceScope 对象:
  cat <<EOF |oc apply -f - apiVersion: operator.ibm.com/v1 kind: NamespaceScope metadata: name: cpd-operators namespace: ${PROJECT_CPD_OPS} spec: namespaceMembers: - ${PROJECT_CPD_OPS} - ${PROJECT_CPD_INSTANCE} EOF
  此命令返回有关 NamespaceScope 对象的信息
  运行以下命令以更新 {PROJECT_CPD_OPS} 项目中的 NamespaceScope 对象:
  oc patch NamespaceScope cpd-operators \ -n ${PROJECT_CPD_OPS} \ --type json \ --patch "[{ \"op\": \"add\", \"path\": \"/spec/namespaceMembers/0\", \"value\": \"${PROJECT_CPD_INSTANCE}\" }]"
  
  要确认是否添加了该项目，请运行以下命令以查看 NamespaceScope YAML 的内容:
  oc get NamespaceScope cpd-operators -n ${PROJECT_CPD_OPS} -o yaml
  namespaceMembers 列表应包含:
  
  安装了 Cloud Pak for Data 操作程序的项目 (由 ${PROJECT_CPD_OPS}指定)。
  
  您计划在其中安装 Cloud Pak for Data (由 ${PROJECT_CPD_INSTANCE}指定) 的项目。

创建定制资源以安装 Cloud Pak for Data。请遵循适合您所在环境的指导信息：

重要信息: 通过使用 spec.license.accept: true创建 Ibmcpd 定制资源，您将接受 Cloud Pak for Data的许可条款。您可以在 Cloud Pak for Data 许可证信息中找到指向相关许可证的链接。

集群在 Red Hat OpenShift Container Storage 上使用建议的存储类名

设置共享持久存储器中描述了建议的存储类名。

创建具有以下格式的定制资源：

cat <<EOF |oc apply -f -
apiVersion: cpd.ibm.com/v1
kind: Ibmcpd
metadata:
  name: ibmcpd-cr                        # This is the recommended name, but you can change it
  namespace: ${PROJECT_CPD_INSTANCE}
spec:
  license:
    accept: true
    license: ${LICENSE_CPD}
  storageVendor: ocs
  csNamespace: ${PROJECT_CPFS_OPS}
EOF

集群在 Portworx 上使用建议的存储类名

设置共享持久存储器中描述了建议的存储类名。

创建具有以下格式的定制资源：

cat <<EOF |oc apply -f -
apiVersion: cpd.ibm.com/v1
kind: Ibmcpd
metadata:
  name: ibmcpd-cr                        # This is the recommended name, but you can change it
  namespace: ${PROJECT_CPD_INSTANCE}
spec:
  license:
    accept: true
    license: ${LICENSE_CPD}
  storageVendor: portworx
  csNamespace: ${PROJECT_CPFS_OPS}
EOF

集群使用 IBM Spectrum Scale 容器本机存储器

设置共享持久存储器中描述了建议的存储类名。

创建具有以下格式的定制资源：

cat <<EOF |oc apply -f -
apiVersion: cpd.ibm.com/v1
kind: Ibmcpd
metadata:
  name: ibmcpd-cr                        # This is the recommended name, but you can change it
  namespace: ${PROJECT_CPD_INSTANCE}
spec:
  license:
    accept: true
    license: ${LICENSE_CPD}
  storageClass: ibm-spectrum-scale-sc
  csNamespace: ${PROJECT_CPFS_OPS}
EOF

集群使用 NFS 存储器

设置共享持久存储器中描述了建议的存储类名。

cat <<EOF |oc apply -f -
apiVersion: cpd.ibm.com/v1
kind: Ibmcpd
metadata:
  name: ibmcpd-cr                        # This is the recommended name, but you can change it
  namespace: ${PROJECT_CPD_INSTANCE}
spec:
  license:
    accept: true
    license: ${LICENSE_CPD}
  storageClass: managed-nfs-storage
  csNamespace: ${PROJECT_CPFS_OPS}
EOF

集群使用定制存储类

如果集群使用的存储类名不是设置共享持久存储器中描述的存储类名，那么必须告知 Cloud Pak for Data 要使用的存储类名。

重要信息: 不能以写入方式运行此命令。必须编辑此命令以指定有效的存储类。

cat <<EOF |oc apply -f -
apiVersion: cpd.ibm.com/v1
kind: Ibmcpd
metadata:
  name: ibmcpd-cr                        # This is the recommended name, but you can change it
  namespace: ${PROJECT_CPD_INSTANCE}
spec:
  license:
    accept: true
    license: ${LICENSE_CPD}
  storageClass: RWX-storage-class        # Replace with the name of a RWX storage class
  zenCoreMetadbStorageClass: RWO-storage-class        # Replace with the name of a RWO storage class that points to block storage
  csNamespace: ${PROJECT_CPFS_OPS}
EOF

重要说明：

配置元数据存储器

如果集群未使用建议的存储类，那么必须通过为 zenCoreMetadbStorageClass 设置指定存储类来配置 Cloud Pak for Data 的元数据存储。存储类别必须为 ReadWriteOnce （RWO），并指向块存储，例如：

ocs-storagecluster-ceph-rbd on Red Hat OpenShift Container Storage
portworx-metastoredb-sc on Portworx

验证安装

当您创建 Ibmcpd 自定义资源时， IBM Cloud Pak for Data 平台操作员会处理自定义资源的内容并启动组成 Cloud Pak for Data ，包括 Cloud Pak for Data control plane。

Cloud Pak for Data control plane 由 ZenSerivce lite-cr 定制资源定义。

要检查安装状态：

切换到安装了 Cloud Pak for Data的项目。例如：
```
oc project ${PROJECT_CPD_INSTANCE}
```

获取安装状态:

运行以下命令以确定是否已创建 ibmcpd-cr :
```
oc get Ibmcpd ibmcpd-cr -o jsonpath="{.status.controlPlaneStatus}{'\n'}"
```
输出下一步操作

InProgress 等待几分钟。然后，再次运行该命令。

Completed 转至步骤 2b。

Failed 转至步骤 2b。

输出	下一步操作
`InProgress`	等待几分钟。然后，再次运行该命令。
`Completed`	转至步骤 2b。
`Failed`	转至步骤 2b。

运行以下命令以确定控制平面是否就绪:

oc get ZenService lite-cr -o jsonpath="{.status.zenStatus}{'\n'}"

输出	下一步操作
`InProgress`	等待几分钟。然后，再次运行该命令。此命令最多需要 90 分钟才能返回`Completed`. 如果命令仍未返回`Completed`90 分钟后，请联系 IBM 软件支持人员。
`Completed`	当命令返回时， Cloud Pak for Data control plane 已就绪`Completed`. 转至步骤 3。
`Failed`	请与 IBM 软件支持人员联系。

获取 Cloud Pak for Data Web 客户机的 URL :

oc get ZenService lite-cr -o jsonpath="{.status.url}{'\n'}"

URL 具备以下格式：

https://cpd-namespace.apps.OCP-default-domain

获取 admin 用户的初始密码：
```
oc extract secret/admin-user-details --keys=initial_admin_password --to=-
```
重要信息: 保存此命令的输出，以便您可以登录到 Web 客户机。强烈建议您在首次登录 Web 客户端时更改初始密码。

为 Cloud Pak for Data control plane

受控升级 (建议)

强烈建议您锁定特定版本的安装，以防止 Cloud Pak for Data control plane的意外升级。

要使用受控升级计划:

更新 ZenService 定制资源。
有关 Zen 操作程序支持的操作数版本的列表，请参阅 Cloud Pak for Data 操作程序和操作数版本。

例如，要将安装锁定在 4.4.4，请运行以下命令:
```
oc patch ZenService lite-cr \
--namespace ${PROJECT_CPD_INSTANCE} \
--type=merge \
--patch '{"spec": {"version":"4.4.4"}}'
```

自动升级

默认情况下， Cloud Pak for Data control plane 将在集群上安装更新版本的 IBM Cloud Pak 基础服务时自动升级。

限制: 在可预测性和稳定性非常重要的生产环境中，不建议允许自动更新。建议仅将此选项用于短期安装，例如概念验证部署。

如果要继续使用自动升级计划，那么不需要执行其他操作。

注: 对于此发行版的 Cloud Pak for Data，控制平面的缺省版本为 4.4.4。如果您安装 IBM Cloud Pak 基础服务的最低要求版本（版本 3.18.0 ），控制平面将保持在 4.4.4。如果您安装了 IBM Cloud Pak 基础服务的更新版本，则集群上可能会出现控制平面的更新版本。

下一步操作

确保针对您的环境完成相应的安装后任务。

例如：

将自签名 TLS 证书替换为您自己的 TLS 证书。有关详细信息，请参阅将定制 TLS 证书用于与平台的 HTTPS 连接。
重要信息: 如果未将自签名证书替换为您自己的证书，那么浏览器不会对用户界面进行高速缓存，这会对性能产生负面影响。
如果使用手动安装计划创建了操作程序，请查看为 Operand Deployment Lifecycle Manager自动安装的操作程序指定安装计划。
如果要更改到平台的路径，请遵循更改到平台的路径中的指导。