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

要安装 cpd-cli:

1. 从 GitHub 上的 IBM/cpd-cli 资源库下载 cpd-cli 的 13.0.4 版本。

   确保根据您购买的 Cloud Pak for Data 许可证和客户机工作站上的操作系统下载正确的软件包:

   工作站操作系统	Enterprise Edition	Standard Edition
   Linux®	cpd-cli-linux-EE-13.0.4.tgz	cpd-cli-linux-SE-13.0.4.tgz
   Mac OS	cpd-cli-darwin-EE-13.0.4.tgz	cpd-cli-darwin-SE-13.0.4.tgz
   Windows	您必须下载 Linux 软件包并在 Windows Subsystem for Linux中运行该软件包: cpd-cli-linux-EE-13.0.4.tgz	您必须下载 Linux 软件包并在 Windows Subsystem for Linux中运行该软件包: cpd-cli-linux-SE-13.0.4.tgz

   限制: 如果计划使用客户机来运行安装或升级，请勿下载 Power® (ppc64le) 或 IBM Z® (s390x) 软件包。 无法在这些操作系统上运行 cpd-cli manage 命令。
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/manage
   • plugins/lib/darwin/migrate
   • plugins/lib/darwin/platform-diag
   • plugins/lib/darwin/platform-mgmt

   对于每个组件:

   1. 右键单击组件，然后选择 打开。

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

      macOS 无法验证 component-name的开发者。 确定要打开该文件吗？

   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 可执行文件，那么 CPD_CLI_MANAGE_WORKSPACE 环境变量特别有用。 设置环境变量时，它将确保文件位于一个目录中。

   缺省值

   无缺省值。 该目录是根据前面文本中描述的因素创建的。

   有效值

   您希望 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

   如果您的环境包含 cpd-cli 必须使用的证书，那么可以使用 OLM_UTILS_LAUNCH_ARGS 环境变量在 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 证书

   如果需要使用证书来连接到 Kubernetes API 服务器，请安装 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