Obtaining the IBM App Connect Enterprise server image from the IBM Cloud Container Registry

You can obtain the IBM® App Connect server Docker image from the IBM Cloud Container Registry to extend it and add extra capability. These images are designed to be used only with the IBM App Connect Operator.

Note:

A different set of images are available if you want to configure IBM App Connect Enterprise to run in a Docker container on AIX®, Linux®, or Windows systems, or in IBM z/OS® Container Extensions (zCX). For more information, see Building a sample or supported IBM App Connect Enterprise image using Docker in the IBM App Connect Enterprise documentation.

Obtaining an IBM App Connect Enterprise server image

To obtain your required version of an IBM App Connect Enterprise server image, you require an IBM entitlement key for pulling the image from the IBM Cloud Container Registry. You need to obtain this key once only.

Procedure

Complete the following steps:

Obtain an IBM entitlement key from the following location: https://myibm.ibm.com/products-services/containerlibrary.
Log in to the IBM Cloud Container Registry by running this command, using cp as the username, cp.icr.io as the Docker server, and your entitlement key as the password:
```
docker login cp.icr.io -u cp -p myEntitlementKey
```
For more information about the Container Registry, see the IBM Cloud Container Registry documentation.

Use Docker to pull the required version, where imageLocation represents one of the listed image locations in the following table:

docker pull imageLocation

Version	Image location
12.0.12.0-r1-lts	`cp.icr.io/cp/appc/ace-server-prod@sha256:5e1237cf8b4a0c354a3172f033ff9b26788cfb528e7fa3f396d01ebf7b9bb20d`
12.0.11.3-r1-lts	`cp.icr.io/cp/appc/ace-server-prod@sha256:cd2e380a0b22e6a8cb0070e9a8dd344ef0a2c62094a4346a3610eee4a6b05a93`
12.0.11.2-r1-lts	`cp.icr.io/cp/appc/ace-server-prod@sha256:1225ae359a7fc100101f0ab30e5ddcf10a997d721097a1f90f55c71a78af298d`
12.0.11.1-r1-lts	`cp.icr.io/cp/appc/ace-server-prod@sha256:eb86717a6655671c77732e51da8c7982e683721dcd24c166a56da42395b1a41b`
12.0.10.0-r2-lts	`cp.icr.io/cp/appc/ace-server-prod@sha256:2a3e7d15eb56579a0b9c729fe59c5ccf81d57c0fae5f0758b9ded50c71fabc7d`
12.0.10.0-r1-lts	`cp.icr.io/cp/appc/ace-server-prod@sha256:1753d66293e51d8453acceb5194a8816fd9010caec7c770d07e6623b10fd3976`
12.0.9.0-r3-lts	`cp.icr.io/cp/appc/ace-server-prod@sha256:dfd94410ad0ad0de7a97c59a6385f3b0a17d6d0c4bce69f8ee80efda18c7073b`
12.0.9.0-r2-lts	`cp.icr.io/cp/appc/ace-server-prod@sha256:71887f1a47b72c038dd1d58926b103880c1e0a1218315a9aafd873f8ac9c9d4f`
12.0.9.0-r1-lts	`cp.icr.io/cp/appc/ace-server-prod@sha256:92002a49eff4a3ab026127528600df55384a59bbb648bfc43d09454acc342c3a`
12.0.8.0-r3-lts	`cp.icr.io/cp/appc/ace-server-prod@sha256:edeb3e4037083d47c54b63cd013eaba4af025ffa8f90d75397ca3ac622f9ac55`
12.0.8.0-r2-lts	`cp.icr.io/cp/appc/ace-server-prod@sha256:c22352ff8faf5caabed8c5ddf697156d6d9ada5d14beac67cba37b7410072c4f`
12.0.8.0-r1-lts	`cp.icr.io/cp/appc/ace-server-prod@sha256:551be301cd1407e531080762364c398af40edf41f4dd9b8be7c4593f8770c991`
12.0.7.0-r3-lts	`cp.icr.io/cp/appc/ace-server-prod@sha256:580dd8ebd4973afb4c48607cd68847ec9c951a0309146998ed93aee2425d1412`
12.0.7.0-r2-lts	`cp.icr.io/cp/appc/ace-server-prod@sha256:aff93d378b249d7808d79597c8bfd2fb44ff41586baa3d18fabba304cbdb1f3e`
12.0.7.0-r1-lts	`cp.icr.io/cp/appc/ace-server-prod@sha256:f4453b7e4f243570adcb4d36c04bc647e10c227cd1a9daac0c4801f26ed4a4bc`
12.0.6.0-r2-lts	`cp.icr.io/cp/appc/ace-server-prod@sha256:1f8e0d52d5ffb68232c9b6aa361bd1abe6617ef290469c3d99a0a67fc2cdc1bd`
12.0.6.0-r1-lts	`cp.icr.io/cp/appc/ace-server-prod@sha256:ee1ee4ac8da87686da1c47c1d347b1cac47aceea1d349244fdb3b8e7edaac5a6`
12.0.5.0-r1-lts	`cp.icr.io/cp/appc/ace-server-prod@sha256:48569e3e1e219682e0ff5e24a810bf89317bb4ae961a02691c4dc206d74fce75`

Re-tag the image appropriately and then push it to your preferred registry.

You can run the image by using an example command such as:

docker run --name aceserver -p 7600:7600 -p 7800:7800 -p 7843:7843 --env LICENSE=accept --env ACE_SERVER_NAME=ACESERVER cp.icr.io/cp/appc/ace-server-prod@sha256:48569e3e1e219682e0ff5e24a810bf89317bb4ae961a02691c4dc206d74fce75

For additional configuration options, see http://ibm.biz/ot4iaceserver.