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.

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 17.0.0 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 version stable-4.17 of oc-mirror Plug-in from Openshift.

    1. Download the latest stable version of mirror.tar.gz.

    2. Extract the binary file with 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

    3. Verify the installation with the following command:

      oc mirror help

  • 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.

  • The plug-in is also provided in a container image cp.icr.io/cpopen/cpfs/ibm-pak:TAG where TAG should be replaced with the corresponding plug-in version.

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

Next steps