ibm mq #1
Description
IBM MQ provides for messaging services to transport multiple types of data.
- Tags:
- misc ›
- messaging ›
- ibm ›
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 forPOWER LE
base machines. Forx86_64
, useWS_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 groupmqm
.
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
Configuration
- accept-ibm-mq-license
- (boolean) The MQ software can only be used by accepting the terms and conditions for IBM MQ License. Setting this option to True indicates that you have read and accepted the IBM MQ terms and conditions found in the license file. The details about accessing the license(s) can be found in the README. ** Do not set to False if a relation exists with this charm **