Table of Contents

1. Overview
2. License
3. Description - What the module does and why it is useful
4. Setup

• Requirements
• Installing the mq_install module

5. Usage - Configuration options and additional functionality
6. Reference - An under-the-hood peek at what the module is doing and how
7. Limitations - OS compatibility, etc.

Overview

This module allows you to install IBM MQ messaging software. It is part of our family of Puppet modules to install and manage IBM messaging middleware. Besides the mq_install module, this family also contains:

• mq_config to configure and manage the MQ software
• iib_config to manage and configure IBM Integration Bus software
• iib_install to install IBM Integration Bus software

License

This is a commercially licensed module. But you can use the module on VirtualBox based development systems for FREE. You can request a FREE trial license here

Check the License for details.

Description

Our mq_install module allows you to install your IBM MQ software on your systems. It automatically configures your OS, creates required users and groups, unpacks the files and registers the license.

Here is an example on how to use this:

include mq_install::installmq

Check here to see the full documentation for this module.

Setup

Requirements

The mq_install module requires:

• Puppet module enterprisemodules-easy_type installed.
• Puppet version 4.9 or higher. Can be Puppet Enterprise or Puppet Open Source
• IBM MQ 8 or 9 installation.
• A valid License from IBM to use this software.
• A valid entitlement to use this module by Enterprise Modules.
• Runs on most Linux systems, Solaris, AIX and Windows.

Installing the mq_install module

To install these modules, you can use a Puppetfile

mod 'enterprisemodules/mq_install'               ,'1.5.0'

Then use the librarian-puppet or r10K to install the software.

You can also install the software using the puppet module command:

puppet module install enterprisemodules-mq_install

Usage

Building a total MQ setup requires quite some work. To help you, we have built some examples:

• MQ only example
• MQ and IIB example

These repos contain examples of how you can install and configure a basic MQ setup.

Reference

Here you can find some more information regarding this puppet module:

• The MQ install documentation
• The product announcement

Here is a list of related blog posts:

• Introducing the IBM MQ Puppet module

Some example code:

• Simple MQ demo
• MQ and IIB demo

Limitations

This module runs most Linux versions, Solaris, AIX and Windows systems. It requires a puppet version higher than 4. Contact us of you need to run this module on other flavors of UNIX. We can work together with you to make it work.

Version updates

1.8.0

• [release] Support puppet 7
• [core] Using Sentive data type for password values

1.7.0

• [autostart] Add support for your own template for the systemd unit

1.6.3

• [autostart] Fix autostart systemd for multiple queue managers

1.6.2

• [autostart] Fix for RHEL 8

1.6.1

• [fixpack] Fix when running on systemd systems

1.6.0

• [core] Add Solaris support

1.5.0

• [core] Add AIX support
• [core] Rename facts to be more os generic

1.4.0

• [core] Add support for Windows

1.3.0

• [fixpack] Add documentation and share some properties between software and fixpack
• [fixpack] Take care of circular dependecy
• [software] Fix the unittests
• [fixpack] Initial implementation
• [software] Refacter to allow addition and removal of rpms after basic install
• [quality] Make acceptance test run on Puppet 6

1.2.0

• [software] Add support for MQ 9.1 components
• [core] Add Puppet 6 unit tests
• [autostart] Fix acceptance test

1.1.1

• [autostart] Add support for standby queue managers
• [acceptance] Fix tests. Not using stdlib 5.0 yet
• [autostart] Make it more rubust
• [core] Update versions of dependency modules

1.1.0

• [autostart] Add support for multi instance queue managers
• [docs] renerate docs with typ info and defaults
• [docs] Add type and defaults
• [core] Fix metadata.json
• [mq_version] Fix faster message

1.0.14

• [mq_version] Handle nil error when invalid version number is received.

1.0.13

• [tasks] Add restart task
• [tasks] Add status task
• [tasks] Add start task
• [tasks] Add stop task
• [release] Better description in the metadata
• [release] Fix link to license in readme

1.0.12

• [release] Added license notice

1.0.11

• [release] Add license text and readme
• [release] Always include puppetlabs_spec_helper gem
• [software] Define tmp_dir in puppet

1.0.10

• [core] Remove support for puppet versions before 4.9
• [autostart] Initial implementation for RedHat 6 and 7
• [os] Make settings easier manageble. And include them in specs
• [quality] Add acceptance tests
• [os] Make all os settings hiera modifyable

1.0.9

• [os] Leave other limits in place

1.0.8

• [os] contain the limits to make sure it is done before the rest

1.0.7

• [os] Add support for NOT managing the home of mqm user

1.0.6

• [os] Add required sysctl parameter

1.0.5

• [software] Fix ordering issue
• [functions] Remove return_type for function.
• [software] Fix selection of optional components
• [software] Cleanup extracted temporary packages

1.0.4

• [os] remove user mquser

1.0.3

• [core] Removed binding and added type

1.0.2

• [core] Fixed bindings

1.0.1

• [core] Added bindings

1.0.0

• [docs] Added documentation

0.0.3

• [os] Make nofile limits bigger

0.0.2

• [software] Make options selectable
• [os] Remove sysctl settings
• [os] Add mqm user

0.0.1

• [installmq] Initial version