How To
Summary
IBM has moved DataPower docker images away from Docker Hub starting with v10.0.3.0 / v10.0.1.4 / v2018.4.1.17*.
All versions* released after these versions will be stored on IBM Container Registry:
https://www.ibm.com/cloud/container-registry
As such, the process to use DataPower docker images has changed slightly.
*Note: 2018.4.1.17+ licensed images are located in Passport Advantage, and are not available on IBM Container Registry.
Steps
Developers-Limited:
If you are using a 'developers-limited' license, you do not need to authenticate to the IBM Container Registry. However, this image is to be used in nonproduction, development environments only; and is limited in some features.
To get the 'developers-limited' version, you can retrieve from the following repo:
icr.io/cpopen/datapower/datapower-limited:<Version>
For example:
docker run -it \
-e DATAPOWER_ACCEPT_LICENSE=true \
....
--name $NAME \
icr.io/cpopen/datapower/datapower-limited:10.0.1.5
**Note, the above is not a full container deployment syntax, and should not be directly used.
Production/Other:
If you are using a license other than 'developers-limited', such as:
- developers
- nonproduction
- production
You need to first authenticate with MyIBM to obtain an Entitlement key.
After obtaining the Entitlement Key, you can login to IBM Container Registry to obtain Entitled images.
developers:
|
nonproduction:
|
production:
|
To login, use the following command replacing only the entitlement key portion (not the username):
docker login cp.icr.io --username cp --password <your entitlement key>
After doing so, you can pull from any of the entitled registries like so:
docker run -it \
-e DATAPOWER_ACCEPT_LICENSE=true \
....
--name $NAME \
cp.icr.io/cp/datapower/datapower-prod:10.0.4.0
**Note, the above is not a full container deployment syntax, and should not be directly used.
2018.4.1.17+
2018.4.1.x licensed images are acquired via Passport Advantage, or via converting a developer edition to a supported edition, which is documented here:
Document Location
Worldwide
[{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SS9H2Y","label":"IBM DataPower Gateway"},"ARM Category":[{"code":"a8m50000000CdqsAAC","label":"DataPower-\u003EMGMT (MM)-\u003EInstallation\/ Re-Inital"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]
Was this topic helpful?
Document Information
Modified date:
05 December 2022
UID
ibm16541296