ibm mq #28

Supports: trusty xenial

Add to new model

Description

IBM MQ provides for messaging services to transport multiple types of data.


Software & terms:

Charm for IBM MQ 9.0.1

Overview

IBM MQ

IBM MQ provides messaging services to transport multiple types of data.
MQ Runtime, Server and Sample components from IBM MQ product can be deployed using this charm.

This charm installs IBM MQ product and configures it's IP Address and default port number. MQ Administrators can setup queue managers and queues. This will allow IBM MQ client application to transmit/receive messages.

More information on IBM MQ available at the Product Page and IBM Knowledge Center

Prerequisites

This charm makes use of resources, a feature only available in Juju 2.0. During deploy, you will need to specify the installable package(s) required by this charm.
Download your licensed IBM MQ 9.0.1 Continuous Delivery Release version for Ubuntu. To acquire and download IBM MQ, follow instructions available at the Product Page.

Ubuntu for x86_64, the package and part number is:

IBM MQ V9.0.1 Continuous Delivery Release for Linux for System x86 (CNF04ML)

Ubuntu for Power LE, the package and part number is:

IBM MQ V9.0.1 Continuous Delivery Release for Linux for System p LE (CNF02ML)

Ubuntu for IBM z, the package and part number is:

IBM MQ V9.0.1 Continuous Delivery Release for Linux for System z (CNF03ML)

Usage

To use this charm, you must agree to the Terms of Use. You can view the full license for IBM MQ by visiting the Software license agreements search website.
Search for "IBM MQ V9.0.1" and choose the license that applies to the version you are using.

Deploy

Run the following commands to deploy this charm:

juju deploy ibm-mq --resource ibm_mq_installer=</path/to/installer.tar.gz>

Note: This charm requires acceptance of Terms of Use. When deploying from the Charm Store, these terms will be presented to you for your consideration. To accept the terms:

juju agree ibm-mq/1

Once you have agreed to the Terms, then only the IBM MQ charm will be deployed.

Manually update the following system configuration after installing MQ:

In order to create MQ objects like queue, it is required that some of the system configurations be updated. User has to manually update these values incase the limit is less for the required parameters. Details are provided at IBM Knowledge Center.

  • In /etc/sysctl.conf:
    fs.file-max = 524288
    kernel.shmmax = 268435456
    
The Charm updates the following system configuration:

In order to create MQ objects like queue, it is required that some of the system configurations be updated. Details provided at IBM Knowledge Center.
The below configurations will be updated by the charm only after installing MQ.
* Adds user ubuntu to group mqm.

  • In /etc/security/limits.conf if hard nofile and soft nofile limit for user mqm are less than 10240:

    mqm              hard    nofile          10240
    mqm              soft    nofile          10240
    
  • Updates /etc/pam.d/common-session file to take the above configurations to take effect

Verify these changes have been made successfully if MQ throws up any errors.

Verification

Once deployed, you can make use of IBM MQ by creating queues or adding relation with other services like WAS.
To verify IBM MQ is installed, list the contents of the installation directory:

juju run --application ibm-mq 'ls /opt/mqm'

Relation with other services:

ibm-mq can have relation with other services to get the service specific queue manager. For example if ibm-mq is related with ibm-was then, ibm-was specific queue manger will be created like 'ibm-wasQM'.

juju add-relation ibm-mq:messaging ibm-was-base:wasmessaging

or

juju add-relation ibm-mq ibm-was-base

IBM-MQ sets Queue Manager name, Queue Name, IP Address and Port for the connected services. It creates a Queue Manager for the consumer application and a local queue i.e QUEUE1 for above Queue Manager. But as a Queue Name it sets a filename where MQSC Commands can be edited for further operation.

On removal of relation with the service with which already relation was established, the service specific queue manger will be removed i.e in the above case 'ibm-wasQM' will be removed.

 juju remove-relation ibm-mq:messaging ibm-was-base:wasmessaging

or

 juju remove-relation ibm-mq ibm-was-base

Known Limitations:

Local providers does not allow updates to system configuration using sysctl command. These configurations will need be done manually for MQ to function. The required configurations are provided in the README under the Deploy section.

IBM MQ Information

(1) General Information Details about MQ available here.
Details about MQ Version 9.0.1 available at IBM Knowledge Center

(2) Download Information Information on procuring MQ product is available at the Product Page and at the Passport Advantage Site.
A development version for x86_64 is available here. After clicking on the above link and if you agree to the license, click on 'I agree' link to download the IBM MQ package.

(3) License Information License information for IBM MQ is available as part of the downloaded product package. The license can be viewed by running the following command after extracting IBM MQ.
./mqlicense.sh -text_only

License for the development version is available here.

(4) Contact Information For issues with this charm, please contact IBM Juju Support Team jujusupp@us.ibm.com

(5) Known Limitations This charm makes use of Juju features that are only available in version 2.0 or greater.