mq-container/charts/ibm-mqadvanced-server-dev

IBM MQ

IBM® MQ is messaging middleware that simplifies and accelerates the integration of diverse applications and business data across multiple platforms. It uses message queues to facilitate the exchanges of information and offers a single messaging solution for cloud, mobile, Internet of Things (IoT) and on-premises environments.

Introduction

This chart deploys a single IBM MQ Advanced for Developers server (queue manager) into an IBM Cloud private or other Kubernetes environment.

Prerequisites

• Kubernetes 1.6 or greater, with beta APIs enabled
• If persistence is enabled (see configuration), then you either need to create a PersistentVolume, or specify a Storage Class if classes are defined in your cluster. ¸

Installing the Chart

To install the chart with the release name foo:

helm install --name foo stable/ibm-mqadvanced-server-dev --set license=accept

This command accepts the IBM MQ Advanced for Developers license and deploys an MQ Advanced for Developers server on the Kubernetes cluster. The configuration section lists the parameters that can be configured during installation.

Tip

: See all the resources deployed by the chart using kubectl get all -l release=foo

Uninstalling the Chart

To uninstall/delete the foo release:

helm delete foo

The command removes all the Kubernetes components associated with the chart, except any Persistent Volume Claims (PVCs). This is the default behavior of Kubernetes, and ensures that valuable data is not deleted. In order to delete the Queue Manager's data, you can delete the PVC using the following command:

kubectl delete pvc -l release=foo

Configuration

The following table lists the configurable parameters of the ibm-mqadvanced-server-dev chart and their default values.

Parameter	Description	Default
license	Set to accept to accept the terms of the IBM license	not accepted
image.repository	Image full name including repository	ibmcom/mq
image.tag	Image tag	9
image.pullPolicy	Image pull policy	IfNotPresent
image.pullSecret	Image pull secret, if you are using a private Docker registry	nil
persistence.enabled	Use persistent volumes for all defined volumes	true
persistence.useDynamicProvisioning	Use dynamic provisioning (storage classes) for all volumes	true
dataPVC.name	Suffix for the PVC name	"data"
dataPVC.storageClassName	Storage class of volume for main MQ data (under /var/mqm)	""
dataPVC.size	Size of volume for main MQ data (under /var/mqm)	2Gi
service.name	Name of the Kubernetes service to create	qmgr
service.type	Kubernetes service type exposing ports, e.g. NodePort	ClusterIP
resources.limits.cpu	Kubernetes CPU limit for the Queue Manager container	500m
resources.limits.memory	Kubernetes memory limit for the Queue Manager container	512Mi
resources.requests.cpu	Kubernetes CPU request for the Queue Manager container	500m
resources.requests.memory	Kubernetes memory request for the Queue Manager container	512Mi
queueManager.name	MQ Queue Manager name	Helm release name
queueManager.dev.adminPassword	Developer defaults - administrator password	Random generated string. See the notes that appear when you install for how to retrieve this.
queueManager.dev.appPassword	Developer defaults - app password	nil (no password required to connect an MQ client)
nameOverride	Set to partially override the resource names used in this chart	ibm-mq

Specify each parameter using the --set key=value[,key=value] argument to helm install.

Alternatively, a YAML file that specifies the values for the parameters can be provided while installing the chart.

Tip

: You can use the default values.yaml

Persistence

The chart mounts a Persistent Volume.

Troubleshooting

Cannot create a GlusterFS PersistentVolumeClaim

The generated PVC name can be too long when using GlusterFS. See here for more information. The PVC name is generated from three things:

1. The Helm release name, which is set by you at deployment time
2. A short PVC label, which defaults to "data" and can be changed using the dataPVC.name parameter.
3. The name of the chart you are using, which can be changed using the nameOverride parameter.

Copyright

© Copyright IBM Corporation 2017