Installing the zoscb-encrypt CLI tool

You can install the zoscb-encrypt CLI tool by downloading and extracting the binary from the Docker image.

Before you begin

  • Ensure that Ansible is installed. For more information about installing Ansible, see Installing Ansible External link icon.
  • Ensure that the Red Hat® OpenShift® CLI is installed. For more information about installing the OpenShift CLI, see Getting started with the OpenShift CLI External link icon.
  • Use a supported operating system and architecture, such as macOS (Intel® and Apple silicon) or Linux® (amd64 and s390x).

Procedure

  1. Run the following command to download and extract the binary for your operating system and architecture to a temp directory on your local file system:

    mkdir -vp temp/
    OS=$(uname -s | tr '[:upper:]' '[:lower:]')
    ARCH=$(uname -m | sed -E "s/i686|x86_64/amd64/g")
    oc image extract icr.io/cpopen/ibm-zoscb-encryption-cli:latest --path /bin/${OS}-${ARCH}-zoscb-encrypt:temp/
    
  2. Run the following command to globally access the CLI in your terminal:

    OS=$(uname -s | tr '[:upper:]' '[:lower:]')
    ARCH=$(uname -m | sed -E "s/i686|x86_64/amd64/g")
    chmod +x temp/${OS}-${ARCH}-zoscb-encrypt
    sudo mv temp/${OS}-${ARCH}-zoscb-encrypt /usr/local/bin/zoscb-encrypt
    rm -rf temp
    
  3. (Optional) If you're using macOS and a window appears after running the zoscb-encrypt command, complete the following steps:

    "Developer cannot be verified" alert

    1. Click Cancel to close the window.

    2. Open System Settings.

    3. Click Privacy & Security.

    4. Scroll down to Security and click Allow Anyway to grant permission to the zoscb-encrypt application.

      Allow Always button

Procedure result

The zoscb-encrypt CLI tool is installed on your local machine.

Next step

You can use the tool to generate encrypted credential Secret and GitHub token Secret that can be used with z/OS® Cloud Broker. For more information, see Using the zoscb-encrypt CLI tool.