安装命令行 IBM Cloud Pak for Data 界面

重要提示:4.8IBM 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 工具完成其他任务(例如备份和还原安装程序或管理用户),您同样可以执行此操作。

开始之前

确保工作站符合《 设置客户端工作站以安装 Cloud Pak for Data 》中的要求。

关于本任务

您必须在能够连接到您集群的客户端 cpd-cli 工作站上安装该软件。

过程

要安装 cpd-cli

  1. 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
  2. 将包的内容解压到您想要运行该程序的目录 cpd-cli中。
  3. 在 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
    对于每个组件:
    1. 右键单击该组件,然后选择 “打开 ”。

      您将看到以下格式的消息:

      macOS 无法验证组件名称的开发者。 确定要打开该文件吗?
    2. 点击打开
  4. 最佳实践 :使 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
  5. 最佳实践 :确定是否需要为以下环境变量进行设置: 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
    根据您的环境确定正确的参数:
    • 如果客户端工作站上的证书位于目录 /etc/pki/ca-trust 中,则参数为:

      " -v /etc/pki/ca-trust:/etc/pki/ca-trust"

    • 如果客户端工作站上的证书位于不同目录,请将 <ca-loc> 替换为客户端工作站上的相应位置:

      " -v <ca-loc>:/etc/pki/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>"
    重要提示: 若设置了上述任一环境变量,请务必将其添加至安装环境变量脚本中。
  6. 运行以下命令以确保 已 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 命令行界面的安装