mq-container/docs/building.md

Building a container image

Prerequisites

You need to have the following tools installed:

• Docker 20.10 or later, or Podman 4.4 or later.
• GNU make

Building Images

To build an IBM MQ image, navigate to the appropriate section:

• Building a production image
• Building a developer image

Building a production image

MQ Continuous Delivery (CD)

The procedure below is for building the 9.4.1 release, on amd64, ppc64le and s390x architectures.

1. Create a downloads directory in the root of this repository
2. Identify the correct eImage part number for your architecture from https://www.ibm.com/support/pages/downloading-ibm-mq-94 and download
3. Ensure the tar.gz file is in the downloads directory
4. Run make build-advancedserver

If you have an MQ archive file with a different file name, you can specify a particular file (which must be in the downloads directory). You should also specify the MQ version, so that the resulting image is tagged correctly, for example:

MQ_ARCHIVE=mq-1.2.3.4.tar.gz MQ_VERSION=1.2.3.4 make build-advancedserver

MQ LTS

The procedure below is for building the 9.4.0 release, on amd64, ppc64le and s390x architectures.

1. Create a downloads directory in the root of this repository
2. Identify the correct eImage part number for your architecture from https://www.ibm.com/support/pages/downloading-ibm-mq-94 and download
3. Ensure the tar.gz file is in the downloads directory
4. Run make build-advancedserver

If you have an MQ archive file with a different file name, you can specify a particular file (which must be in the downloads directory). You should also specify the MQ version, so that the resulting image is tagged correctly, for example:

MQ_ARCHIVE=mq-1.2.3.4.tar.gz MQ_VERSION=1.2.3.4 make build-advancedserver

Building a developer image

Run make build-devserver, which will download the latest version of MQ Advanced for Developers. This is available on the amd64 and arm64 (Apple Silicon) architectures.

You can use the environment variable MQ_ARCHIVE_DEV to specify an alternative local file to install from (which must be in the downloads directory).

Installed components

This image includes the core MQ server, Java, language packs, GSKit, and web server. This is configured in the mq-redux build stage in Dockerfile-server.