Charm for IBM MQ

Overview

IBM MQ

IBM MQ provides for 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 (1414). 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

Usage

Download (see below) your licensed IBM MQ 8.0.0.2 software and copy it to the
files/archives directory of MQ charm.

For e.g:

• Go to the files/archives directory.

• Copy the WS_MQ_8.0.0.2_FOR_LIN_ON_LE_POWER.tar.gz file to this directory for
  POWER LE base machines. For x86_64, use WS_MQ_V8.0.0.2_LINUX_ON_X86_64_I.tar.gz.

• The file name you have could be different from the example above (but with the
  .gz extension). Ensure a backup copy of the file.

To install the downloaded binaries you must agree to the IBM license. The license
file(s) can be found under the files/archives/licenses directory on extraction
of IBM MQ software using the following command:

tar xvfz *.gz  --strip-components=1

The license can also be viewed by running the following command after extracting
IBM MQ to the files/archives directory:

./mqlicense.sh -text_only

Run the following to deploy this charm:

juju deploy ibm-mq

At this point the charm will wait until the user accepts the license. If you
agree to the license, run the following command:

juju set ibm-mq accept-ibm-mq-license=True

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 Charm updates the following system configuration:

• In /etc/sysctl.conf:

  fs.file-max = 524288
  kernel.shmmax = 268435456
  

• In /etc/security/limits.conf:

  mqm              hard    nofile          10240
  mqm              soft    nofile          10240
  

• Adds user ubuntu to group mqm.

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

Configuration

accept-ibm-mq-license
Before you can use or install IBM MQ,
you must accept the terms of International License
Agreement for Non-Warranted Programs and additional license information.
Please read the license agreement carefully.

The license file(s) can be found under the files/archives directory after
downloading and extracting IBM MQ there. The license can also be viewed by
running the following command after extracting IBM MQ to the files/archives
directory:
./mqlicense.sh -text_only

Set the value of accept-ibm-mq-license to True if you agree to IBM MQ license.

The IBM MQ software cannot be installed until the terms and
conditions are accepted. The charm will not function correctly until the
this configuration option is set to True.

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 this document.

IBM MQ Information

(1) General Information

Details about MQ available here.

Details about MQ Version 8.0 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.

A 90 days trial version is available here.

(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.

Contact Information

For issues with this charm, please contact jujusupp@us.ibm.com