Upgrading From Evaluation License

IBM® Application Modernization Accelerator can be installed on Red Hat OpenShift Container Platform and used for free for 90 days. After 90 days you will need entitlement to continue using the product. The following instructions should be followed when the 90 Day Free Evaluation period is over and you have purchased entitlements to a product containing Application Modernization Accelerator.

An entitlement key for the software is associated with your MyIBM account. Get the entitlement key that is assigned to your ID.

• Log in to MyIBM Container Software Library with the IBMid and password that are associated with the entitled software.
• In the Entitlement keys section, select Copy key to copy the entitlement key to the clipboard.

Here is a sample command to create the image pull secret. Substitute in your own values for the entitled registry user and key.

oc -n <NAME_SPACE> create secret docker-registry <SECRET_NAME> --docker-server=cp.icr.io --docker-username=<ENTITLED_REGISTRY_USER> --docker-password=<ENTITLED_REGISTRY_KEY>

Navigate to the Application Modernization Accelerator instance in OpenShift Container Platform:

• Click on Installed Operators and set the project to the project where Application Modernization Accelerator is installed
• Click through on the Application Modernization Accelerator operator and then on the Application Modernization Accelerator tab
• Click on the listed instance, and then click on the YAML tab
• Add the image pull secret for each Application Modernization Accelerator image as follows:

...
couchdb:
  imagePullSecret: <SECRET_NAME>
  ...
neo4j:
  imagePullSecret: <SECRET_NAME>
  ...
transadv:
  imagePullSecret: <SECRET_NAME>
  ...
transadvui:
  imagePullSecret: <SECRET_NAME>
  ...
...

• Click the Save button
• Allow several minutes for the Application Modernization Accelerator containers to restart. After restarting, the containers will pull the images from the entitled registry. You can confirm by looking at the events for the containers to see an event which shows the entitled registry is used:

Successfully pulled image "cp.icr.io/cp/icpa/transformation-advisor-ui@sha256:<actual image digest here>" in 1.007108858s

You may also configure the entitled registry credentials in the global pull secret on the cluster. In this case, you still need to add the imagePullSecret properties to the Application Modernization Accelerator instance as described in step 3. However, instead of specifying a real secret, you can specify an arbitrary string as the secret name. For example:

...
couchdb:
  imagePullSecret: dummytapullsecret
  ...
neo4j:
  imagePullSecret: dummytapullsecret
  ...
transadv:
  imagePullSecret: dummytapullsecret
  ...
transadvui:
  imagePullSecret: dummytapullsecret
  ...
...