Installing the IBM® Cloud Private CLI

If you install the IBM Cloud Private command line interface (CLI), you can create and manage new clusters.

After you install IBM Cloud Private, you can install the CLI on Windows, Linux, or macOS.

  1. Synchronize the clocks in between the client computer and the nodes in the IBM Cloud Private cluster. To synchronize your clocks, you can use network time protocol (NTP). For more information about setting up NTP, see the user documentation for your operating system.
  2. Install the IBM Cloud CLI. See Manual CLI installation in the IBM Cloud documentation.
  3. Confirm that the IBM Cloud CLI installed:

    bx --help

    The IBM Cloud CLI usage is displayed.

  4. From the IBM Cloud Private management console, click Menu > Command Line Tools > Cloud Private CLI.
  5. To download the CLI installer file, click the download link for your operating system.
  6. Install the CLI. Run the following command:

    bx plugin install /<path_to_installer>/<cli_file_name>

    For example, to use a icp-darwin-amd64 file for macOS that is in the Downloads folder, run this command:

    bx plugin install ~/Downloads/icp-darwin-amd64
  7. Confirm that the IBM Cloud Private CLI installed:

    bx pr --help

    The IBM Cloud Private CLI usage is displayed.

  8. Install and setup the Kubernetes command-line tool, kubectl. See Install and Set Up kubectl Open in a new tab. Note: You need to install version 1.9.1.

  9. Log in to your cluster:

    bx pr login -a https://<master_ip_address>:8443 --skip-ssl-validation

    Where master_ip_address is the external IP address for your master or leading master node.

You can now use the IBM Cloud Private CLI to view information about your first cluster, install more content for your cluster, or configure more clusters. If you use the IBM Cloud Private CLI to configure a new cluster, you can use the CLI to add or remove worker nodes to it.