重要提示:4.8
IBM Cloud Pak for Data 版本将于2025年7月31日达到支持终止(EOS)。 有关更多信息,请参阅 4.X 版本
IBM Cloud Pak for Data 的服务终止公告。
升级至 IBM Software Hub 版本 5.1 ,在 4.8 版本达到支持 IBM Cloud Pak for Data 终止前完成升级。 有关更多信息,请参阅从 IBM Cloud Pak for Data 版本 4.8 升级到 IBM 的说明: Software Hub 版本 5.1。
要在集群 Red Hat® OpenShift® Container Platform 上安装 IBM Cloud Pak for Data 软件,您必须在执行安装命令的工作站上安装命令行 Cloud Pak for Data 界面(cpd-cli)。
- 安装阶段
设置客户端工作站
设置集群
收集所需信息
准备在受限网络中运行安装程序
准备从私有容器注册表运行安装程序
为集群做准备 Cloud Pak for Data
准备安装一个实例 Cloud Pak for Data
安装一个实例 Cloud Pak for Data
- 谁需要完成这项任务?
| 用户 |
为什么你需要 cpd-cli |
| 集群管理员 |
- 配置镜像拉取密钥
- 更改节点设置
- 设置项目,其中 Cloud Pak for Data 将被安装
|
| 实例管理员 |
安装 Cloud Pak for Data 软件 |
| 注册管理员 |
镜像推送到私有容器注册表。 |
- 你需要在什么时候完成这项任务?
根据需要重复此操作。您必须在计划运行安装命令的任何工作站上完成此任务。
若需使用该 cpd-cli 工具完成其他任务(例如备份和还原安装程序或管理用户),您同样可以执行此操作。
关于本任务
您必须在能够连接到您集群的客户端 cpd-cli 工作站上安装该软件。
过程
要安装 cpd-cli:
- 从
cpd-cli 存储 IBM/cpd-cli 库下载版本 13.1.9 的。 GitHub
请根据您购买的许可证 Cloud Pak for Data 类型以及客户端工作站的操作系统,确保下载正确的软件包:
| 工作站操作系统 |
Enterprise Edition |
Standard Edition |
| Linux® |
您下载的软件包取决于您的硬件配置:
- x86_64
cpd-cli-linux-EE-13.1.9.tgz
- ppc64le
cpd-cli-ppc64le-EE-13.1.9.tgz
- s390x
cpd-cli-s390x-EE-13.1.9.tgz
|
您下载的软件包取决于您的硬件配置:
- x86_64
cpd-cli-linux-SE-13.1.9.tgz
- ppc64le
cpd-cli-ppc64le-SE-13.1.9.tgz
- s390x
cpd-cli-s390x-SE-13.1.9.tgz
|
| Mac OS |
cpd-cli-darwin-EE-13.1.9.tgz |
cpd-cli-darwin-SE-13.1.9.tgz |
| Windows |
您必须下载该 Linux 软件包并在以下 Windows Subsystem for Linux环境中运行: cpd-cli-linux-EE-13.1.9.tgz |
您必须下载该 Linux 软件包并在以下 Windows Subsystem for Linux环境中运行: cpd-cli-linux-SE-13.1.9.tgz |
- 将包的内容解压到您想要运行该程序的目录
cpd-cli中。
- 在 Mac OS 上,您必须信任
cpd-cli以下组件:
- cpd-cli
- plugins/lib/darwin/config
- plugins/lib/darwin/cpdbr
- plugins/lib/darwin/cpdbr-oadp
- plugins/lib/darwin/cpdctl
- plugins/lib/darwin/cpdtool
- plugins/lib/darwin/health
- plugins/lib/darwin/manage
- plugins/lib/darwin/platform-diag
- plugins/lib/darwin/platform-mgmt
对于每个组件:
- 右键单击该组件,然后选择 “打开 ”。
您将看到以下格式的消息:
macOS 无法验证组件名称的开发者。 确定要打开该文件吗?
- 点击打开。
- 最佳实践 :使
cpd-cli 可执行文件可在任意目录下运行。
默认情况下,您必须切换到包含 cpd-cli 的目录,或指定 的完整路径才能运行 cpd-cli 命令。
不过,你可以将 cpd-cli 可执行文件设置为从任意目录运行,这样只需输入命令 cpd-cli
command-name 即可执行操作。
| 工作站操作系统 |
详细信息 |
| Linux |
在您的 文件 ~/.bashrc 中添加以下内容:export PATH=<fully-qualified-path-to-the-cpd-cli>:$PATH
|
| Mac OS |
在您的 ~/.bash_profile 或 ~/.zshrc 文件中添加以下内容:export PATH=<fully-qualified-path-to-the-cpd-cli>:$PATH
|
| Windows |
从 文件 Windows Subsystem for Linux中,将以下内容添加到你的 文件 ~/.bashrc 中:export PATH=<fully-qualified-path-to-the-cpd-cli>:$PATH
|
- 最佳实践 :确定是否需要为以下环境变量进行设置:
cpd-cli
CPD_CLI_MANAGE_WORKSPACE
默认情况下,首次运行命令
cpd-cli
manage 时,系统
cpd-cli 会自动创建目录
cpd-cli-workspace/olm-utils-workspace/work 。
目录的位置取决于以下几个因素:
- 如果你从任意目录创建了
cpd-cli 可执行文件,该目录将在你运行命令 cpd-cli 的目录中创建。
- 若未从任何目录创建
cpd-cli 可执行文件,则该目录将在安装程序 cpd-cli 所在的目录中创建。
您可以设置环境变量 CPD_CLI_MANAGE_WORKSPACE 来覆盖默认位置。
环境变量 CPD_CLI_MANAGE_WORKSPACE 在从任意目录创建 cpd-cli 可执行文件时尤为有用。 设置环境变量后,可确保所有文件都位于同一个目录中。
- 缺省值
- 无缺省值。 该目录是根据前文所述因素创建的。
- 有效值
- 您希望
cpd-cli 创建 目录 work 的完整路径。 例如,若指定 /root/cpd-cli/,则该 cpd-cli
manage 插件将文件存储在 目录 /root/cpd-cli/work 中。
要设置环境变量
CPD_CLI_MANAGE_WORKSPACE ,请运行:
export CPD_CLI_MANAGE_WORKSPACE=<fully-qualified-directory>
OLM_UTILS_LAUNCH_ARGS
您可以使用 OLM_UTILS_LAUNCH_ARGS 环境变量在容器 cpd-cli 中挂载证书,该证书是容器 cpd-cli 必须使用的。
- 加载CA证书
若需访问使用自签名证书的外部 HTTPS 端点,可挂载CA证书。
提示: 通常CA证书位于工作站的目录
/etc/pki/ca-trust 中。 若需了解如何向工作站添加证书的更多信息,请运行:
man update-ca-trust
- 挂载 Kubernetes 证书
- 若需使用证书连接至 API Kubernetes 服务器,可挂载 Kubernetes 证书。
该论点取决于证书在客户端工作站上的位置。 请将 <k8-loc> 替换为客户端工作站上的相应位置:
" -v <k8-loc>:/etc/k8scert --env
K8S_AUTH_SSL_CA_CERT=/etc/k8scert"
- 缺省值
- 无缺省值。
- 有效值
- 有效值取决于您需要传递
OLM_UTILS_LAUNCH_ARGS 给环境变量的参数。
- 要传递CA证书,请指定:
" -v
<ca-loc>:/etc/pki/ca-trust"
- 要传递 Kubernetes 证书,请指定:
" -v <k8-loc>:/etc/k8scert --env
K8S_AUTH_SSL_CA_CERT=/etc/k8scert"
- 要同时通过CA证书和 Kubernetes 证书,请指定:
" -v <ca-loc>:/etc/pki/ca-trust -v
<k8-loc>:/etc/k8scert --env
K8S_AUTH_SSL_CA_CERT=/etc/k8scert"
要设置环境变量
OLM_UTILS_LAUNCH_ARGS ,请运行:
export OLM_UTILS_LAUNCH_ARGS=" <arguments>"
- 运行以下命令以确保 已
cpd-cli 安装并运行,且 插件 cpd-cli
manage 拥有 图像 olm-utils 的最新版本。
cpd-cli manage restart-container
结果
该 cpd-cli-workspace 目录包含以下子目录:
| 目录 |
该目录中存储了什么? |
olm-utils-workspace/work |
- 该
components.csv 文件是在您运行命令 list-components 时生成的。
- 由命令
mirror-images 生成的日志文件。
|
olm-utils-workspace/work/offline |
本目录的内容按版本进行组织。 例如,若您下载了版本的软件包 CASE ,这些 4.8.9 软件包将存储在目录 4.8.9 中。此外,诸如命令 list-images 之类的输出结果会被存储在特定版本的目录中。
|
下一步操作
现在您已安装了 cpd-cli,即可继续完成 OpenShift 命令行界面的安装。