Image Registry Access

The images that are required for Transformation Advisor are hosted in the following locations.

Registry	Description
`icr.io`	OLM Images (operator, bundle, and catalog) are located in `icr.io/cpopen`. No authentication is required for access. Trial product images are stored in `icr.io/appcafe`. No authentication is required for access.
`cp.icr.io`	Entitled product images are located in `cp.icr.io/cp/icpa`. An entitlement key is required to access.

Your cluster needs access to these registries. If you operate block or allow lists for registries in your cluster, then you need to update the image.config.openshift.io/cluster resource to allow access to icr.io and cp.icr.io.

Trial versus Entitlement Image Access

Transformation Advisor can be installed with a time limited evaluation license (fully featured), or as an entitled product. For more information, see Licenses under which you have entitlement to use Transformation Advisor.

If installing as an evaluation, you can ignore the following instructions that describe how to get access to the entitled registry. In this case, the required images will be pulled from a public registry (icr.io/appcafe) and no access details are required.
If installing Transformation as an entitled product, you will need to have an entitled registry key.

Entitlement to Transformation Advisor is obtained by purchasing one of a number of other IBM products. To find your entitlement key you must first ensure that you have entitlement to any one of the IBM products listed here. Then log in to MyIBM Container Software Library with the IBMid and password that are associated with the entitled software. Your Entitlement Key will be displayed there.

See #entitlement-key for more on creating the ibm-entitlement-key secret.

Migration to IBM Cloud Container Registry

As of Transformation Advisor 2.4.3, some of the Transformation Advisor images (the operator, bundle, and catalog) were migrated from Docker Hub (docker.io/ibmcom) to the IBM Cloud Container Registry (icr.io/cpopen).

This change affects all of your IBM Operator Catalog provided software, not just Transformation Advisor. For more information, see Migrating from Docker to the IBM Container Registry.

For Transformation Advisor, the following are the changes that are required:

If you operate in an internet-connected Red Hat® OpenShift® Container Platform cluster:

Update the IBM Operator Catalog to point to icr.io/cpopen, instead of docker.io/ibmcom. For more information, see Migrating from Docker to the IBM Container Registry.
If you are upgrading Transformation Advisor from a version BEFORE 2.4.3, apply an ImageContentSourcePolicy. For more information, see Migrating from Docker to the IBM Container Registry.

If you operate in a disconnected (air-gapped) Red Hat® OpenShift® Container Platform cluster:

When mirroring the Transformation Advisor images, update the manifest of images to replace docker.io/ibmcom with icr.io/cpopen. For more information, see Installing IBM Cloud Transformation Advisor in a Disconnected/Air-gapped Environment.