Preparing a host

If you are in an air-gapped environment, you must be able to connect a host to the internet and the mirror registry for connected mirroring. You can also mirror images to a file system, which can be brought to a restricted environment for disconnected mirroring. For more information on the latest supported operating systems, see Installation documentation for ibm-pak plugin.

Note: To mirror IBM Process Mining images, you need to use Docker and Podman for container management and Red Hat OpenShift CLI (oc) for Red Hat OpenShift Container Platform administration.

To prepare a host, do the following steps:

  1. Install Docker or Podman;

    a. Use the following commands to install Docker (for example, on Red Hat® Enterprise Linux®):

    dnf check-update
dnf install docker

    b. Use the following command to install Podman:

    dnf check-update
dnf module install -y container-tools:rhel8

    You can verify the installation with the following command:

    podman --help

  2. Install the oc Red Hat® OpenShift® Container Platform CLI tool.

  3. Download and install the version 1.23.1 of IBM Catalog Management Plug-in for IBM Cloud Paks from the IBM/ibm-pak.

    1. Use the following command to extract the binary file:

      tar -xf oc-ibm_pak-linux-amd64.tar.gz

    2. Run the following command to move the file to the /usr/local/bin directory:

      mv oc-ibm_pak-linux-amd64 /usr/local/bin/oc-ibm_pak

    3. Download the plug-in based on the host operating system. Use the following command to confirm that oc ibm-pak -h is installed:

      oc ibm-pak --help

  4. Install oc-mirror CLI Plug-in with the following commands: Openshift.

    1. Go to the Downloads page of Red Hat Hybrid Cloud Console.
    2. In the OpenShift disconnected installation toolssection, select the OS type and Architecture type of the OpenShift Client (oc) mirror plugin from the drop-down menus.
    3. Download and extract the archive by running the following command:
      tar zxvf oc-mirror.tar.gz
/bin/mv oc-mirror /usr/local/bin/oc-mirror
chmod 755 /usr/local/bin/oc-mirror
    4. Verify the installation with the following commands:
      oc mirror help --v1
oc mirror help --v2

  • If you are installing as a non-root user, you must use sudo. For more information, refer to the Podman or Docker documentation for installing as a non-root user.

  • For more information on plug-in commands, see command-help.