IBM MQ Advanced for Developers container image

Available images

IBM MQ images are stored in the IBM Container Registry:

• IBM MQ Advanced for Developers 9.4.0.0: icr.io/ibm-messaging/mq:9.4.0.0-r1

Quick reference

• License:
  • Licensing reference for mq.ibm.com/v1beta1 and Apache License 2.0. Note that the IBM MQ Advanced for Developers license does not permit further distribution, and the terms restrict usage to a developer machine.
• Where to file issues:
  • GitHub
• Available for the following CPU architectures:
  • amd64
  • s390x
  • ppc64le

Usage

Run IBM MQ Advanced for Developers in a container.

See the usage documentation for details on how to run a container.

To be able to use the image, you must accept the terms of the IBM MQ license by setting the LICENSE environment variable.

Environment variables supported

LANG

Set the language you want the license to be printed in.

LICENSE

Set accept to agree to the IBM MQ Advanced for Developers license conditions.

Set view to view the license conditions.

MQ_ADMIN_PASSWORD

Specify the password of the admin user.

Must be at least 8 characters long.

There is no default password for the admin user.

From IBM MQ 9.4.0, this variable is no longer provided. The example YAML in this topic shows how you can create this variable yourself and secure it with a secret.

MQ_APP_PASSWORD

Specify the password of the app user.

If set, this causes the DEV.APP.SVRCONN channel to become secured and only allow connections that supply a valid user ID and password.

Must be at least 8 characters long.

There is no default password for the app user.

From IBM MQ 9.4.0, this variable is no longer provided. The example YAML in this topic shows how you can create this variable yourself and secure it with a secret.

MQ_DEV

Set false to stop the default objects being created.

MQ_ENABLE_METRICS

Set true to generate Prometheus metrics for your queue manager.

MQ_LOGGING_CONSOLE_SOURCE

Specify a comma-separated list of sources for logs that are mirrored to the container's stdout location.

Valid values are qmgr, web and mqsc.

Default value is qmgr,web.

Optional value is mqsc. This option can be used to reflect the contents of autocfgmqsc.LOG in the container log.

MQ_LOGGING_CONSOLE_FORMAT

Change the format of the logs that are printed to the container's stdout location.

Set basic to use a simple human-readable format. This is the default value.

Set json to use JSON format (one JSON object on each line).

MQ_LOGGING_CONSOLE_EXCLUDE_ID

Specify a comma-separated list of message IDs for log messages that are excluded.

The log messages still appear in the log file on disk, but are not printed to the container's stdout location.

Default value is AMQ5041I,AMQ5052I,AMQ5051I,AMQ5037I,AMQ5975I.

MQ_QMGR_NAME

Set the name you want your queue manager to be created with.

Example queue manager YAML that describes how to specify passwords for admin and app users

For users of the admin and app user IDs, you must provide passwords when deploying a queue manager using the Development license. Here is an example queue manager YAML that shows you how to do this with the IBM MQ Operator.

oc create secret generic my-mq-dev-passwords --from-literal=dev-admin-password=passw0rd --from-literal=dev-app-password=passw0rd

apiVersion: mq.ibm.com/v1beta1
kind: QueueManager
metadata:
  name: qm-dev
spec:
  license:
    accept: false
    license: L-CLXQ-ADXTK3
    use: Development
  web:
    enabled: true
  template:
    pod:
      containers:
        - env:
            - name: MQ_DEV
              value: "true"
            - name: MQ_CONNAUTH_USE_HTP
              value: "true"
            - name: MQ_ADMIN_PASSWORD
              valueFrom:
                secretKeyRef:
                  name: my-mq-dev-passwords
                  key: dev-admin-password
            - name: MQ_APP_PASSWORD
              valueFrom:
                secretKeyRef:
                  name: my-mq-dev-passwords
                  key: dev-app-password
          name: qmgr
  queueManager:
    storage:
      queueManager:
        type: persistent-claim
    name: QUICKSTART
  version: 9.4.0.0-r1