Our mq_config module allows you to configure and manage almost everything you’d want to manage on of an IBM MQ installation.

You don’t want to read about it, but really want to try it? You can! You can explore our Puppet modules for IBM MQ by checking out our playgrounds. Here we guide you around in some of the functionality of our MQ modules.

The module allows you to manage:

• mq_channel
• mq_manager
• mq_queue
• mq_topic

Here is example puppet code to manage a MQ Queue Manager:

mq_manager { 'QM1':
  ensure   => 'present',
  acctcono => 'ENABLED',
  acctint  => '1801',
  acctmqi  => 'OFF',
  acctq    => 'OFF',
  activrec => 'MSG',
  actvcono => 'DISABLED',
  actvtrc  => 'OFF',
  authorev => 'DISABLED',
  ccsid    => '1208',
  certlabl => 'ibmwebspheremqqm1',
  certvpol => 'ANY',
  chad     => 'DISABLED',
  chadev   => 'DISABLED',
  chlauth  => 'ENABLED',
  chlev    => 'DISABLED',
  clwllen  => '100',
  clwlmruc => '999999999',
  clwluseq => 'LOCAL',
  cmdev    => 'DISABLED',
  configev => 'DISABLED',
  connauth => 'SYSTEM.DEFAULT.AUTHINFO.IDPWOS',
  defclxq  => 'SCTQ',
  inhibtev => 'DISABLED',
  ipaddrv  => 'IPV4',
  localev  => 'DISABLED',
  loggerev => 'DISABLED',
  markint  => '5000',
  maxhands => '256',
  maxmsgl  => '4194304',
  maxpropl => 'NOLIMIT',
  maxumsgs => '10000',
  monacls  => 'QMGR',
  monchl   => 'OFF',
  monq     => 'OFF',
  perfmev  => 'DISABLED',
  psclus   => 'ENABLED',
  psmode   => 'ENABLED',
  psnpmsg  => 'DISCARD',
  psnpres  => 'NORMAL',
  psrtycnt => '5',
  pssyncpt => 'IFPER',
  remoteev => 'DISABLED',
  revdns   => 'ENABLED',
  routerec => 'MSG',
  schinit  => 'QMGR',
  scmdserv => 'QMGR',
  sslev    => 'DISABLED',
  sslfips  => 'NO',
  sslkeyr  => '/var/mqm/qmgrs/QM1/ssl/key',
  sslrkeyc => '0',
  statacls => 'QMGR',
  statchl  => 'OFF',
  statint  => '1800',
  statmqi  => 'OFF',
  statq    => 'OFF',
  status   => 'running',
  strstpev => 'ENABLED',
  suiteb   => 'NONE',
  treelife => '1800',
  trigint  => '999999999',
}

Check here to see the full documentation for this module.

To install the MQ software on your system, check out mq_install

Our modules are based on an annual subscription(an entitlement). When you purchase an entitlement:

• you are allowed to use the module on the named nodes you purchased the subscription for;
• you get full support on usage and any issues you have;
• we will guide you towards a working setup;
• Are allowed to use the latest and greatest version without any extra charge.

We will make sure the modules keep working with the latest versions of Puppet en the supporting products like Oracle IBM MQ or WebLogic.

We currently have the following licensing methods for you:

1) Free when used on VirtualBox
2) Per node per year subscription
3) Custom licensing

1. Free when used on VirtualBox

This module is Free when used on a VirtualBox testing machine. The software checks if you are using VirtualBox and allows usage. No need to get any licenses from us to get going. Just download the module from our own forge and get going. To download the module use:

puppet module install
    --module_repository=http://forge.enterprisemodules.com
    enterprisemodules-modulename

2. Per node per year subscription

Our basic licensing model requires a subscription per node. The subscription is valid for a year. To make this work, we need you to send us the node name of the system you want to use the module on. (Not the puppetmaster, but the system where the agent is running.). Based on this information we will send you a file containing the entitlement for your node(s). You can purchase the entitlement in the shop or you can contact us. After you have ordered this module, you will receive an entitlement file. This file contains the information needed to run the software on your Puppet machine (agents).

3. Custom licensing

Our license manager is very flexible. If you have special requirements, please contact us so we can discuss other options.

When you have questions about licensing, please contact us or check our licensing FAQ

The mq_install module requires:

• Puppet version 4.0 or higher. Can be Puppet Enterprise or Puppet Open Source
• IBM MQ 9 or 10 installation. All fix packs are supported
• A valid License from IBM to use this software.
• A valid entitlement for usage.
• Runs on most Linux systems, Windows, AIX and Solaris.

To get a valid license for IBM Integration Bus, please contact your IBM representative.

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

• The MQ config documentation
• The product announcement

Here is a related blog posts:

• Introducing the IBM MQ Puppet module
• Gain control of your MQ versions and fixpacks

Some example code:

• Simple MQ demo

Also check out the MQ playgrounds here, where you can experiment with these modules without downloading or installing any software.