Setting environment variables and downloading CASE files

To install IBM Process Mining, you must export the following parameters:

export CASE_NAME=ibm-process-mining
export CASE_VERSION=3.5.1
export NAMESPACE=<your_project_name>
export CASE_INVENTORY_SETUP=processMiningOperatorSetup

The value for NAMESPACE is arbitrary and depends on your preference. For example, you can define the NAMESPAACE as processmining.

If your host connects to the internet via a proxy, you must set environment variables on the machine that accesses the internet via the proxy server.

If you are mirroring by using connected mirroring, set the following environment variables on the machine that accesses the internet via the proxy server:

export https_proxy=http://proxy-server-hostname:port
export http_proxy=http://proxy-server-hostname:port
Tip: Save a copy of your environment variable values to a text editor. You can use that file as a reference to cut and paste from when you finish mirroring images to your registry.

Before mirroring your images, you can set the environment variables on your mirroring device, and connect to the internet so that you can download the corresponding CASE files.

To finish preparing your host, do the following steps:

  1. Create the following environment variables with the installer image name and version.

    export CASE_NAME=ibm-process-mining
export CASE_VERSION=3.5.1

    For more information on the CASE name and version, see IBM: Product CASE to Application Version.

  2. Connect your host to the intranet.

  3. Optional: Replace LOCALE with the preferred value - de_DE, en_US, es_ES, fr_FR, it_IT, ja_JP, ko_KR, pt_BR, zh_Hans, zh_Hant and run the following command to set the locale:

    oc ibm-pak config locale -l LOCALE

    Accordingly, the plug-in can detect the locale of your environment and provide textual helps and messages.

  4. Configure the plug-in to download CASEs as OCI artifacts from IBM Cloud Container Registry (ICCR).

    oc ibm-pak config repo 'IBM Cloud-Pak OCI registry' -r oci:cp.icr.io/cpopen --enable

  5. Optional: Use the following command to refrain from using the GitHub repository:

    oc ibm-pak config repo "IBM Cloud-Pak OCI registry" --enable

    After running this command, the default repository changes to oc ibm-pak config.

  6. Optional: Enable the color output:

    oc ibm-pak config color --enable true

  7. Use the following command to download the image inventory for IBM Process Mining to your host:

    oc ibm-pak get \
$CASE_NAME \
--version $CASE_VERSION

    If you do not specify the version, the script downloads the latest CASE.

By default, the root directory that is used by plug-in is ~/.ibm-pak. This means that the preceding command downloads the CASE in the directory ~/.ibm-pak/data/cases/$CASE_NAME/$CASE_VERSION. You can set the IBMPAK_HOME environment variable to configure this root directory. Assuming IBMPAK_HOME is set, the preceding command downloads the CASE under $IBMPAK_HOME/.ibm-pak/data/cases/$CASE_NAME/$CASE_VERSION.

You can locate the log files at $IBMPAK_HOME/.ibm-pak/logs/oc-ibm_pak.log.

Your host is now configured and you can mirror the images.

For more information, see Using cases in another environment.