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`, and 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 for access.

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

Trial and entitlement image access

Edit online

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 you are installing as an evaluation, the required images are pulled from the public registry (icr.io/appcafe), so you can ignore the following instructions on how to get access to the entitled registry.
If installing Transformation Advisor as an entitled product, you need an entitled registry key.

Entitlement to Transformation Advisor is included with the purchase of certain IBM products. To find your entitlement key, 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 is displayed there.

For more information on creating the ibm-entitlement-key secret, see entitlement key.

Migrating to IBM Cloud Container Registry

Edit online

As of Transformation Advisor 2.4.3, some of the Transformation Advisor images (the operator, bundle, and catalog) have been 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

Edit online

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

Edit online

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 Transformation Advisor in a disconnected/air-gapped environment.