Table of Contents

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

• Requirements
• Installing the iib_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 Integration Bus (IIB) software. It is part of our family of Puppet modules to install and manage IBM messaging middleware. Besides the iib_install module, this family also contains:

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

License

This is a commercially licensed module. But you can use the module on VirtualBox based development systems for FREE. When used on real systems a license is required.

You can license our modules in multiple ways. Our basic licensing model requires a subscription per node. But contact us for details.

Check the License for details.

Description

Our iib_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 iib_install::installmq

Check here to see the full documentation for this module.

Setup

Requirements

The iib_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 by Enterprise Modules to use this module.
• Runs on most Linux systems.
• Windows systems are NOT supported

Installing the iib_install module

To install these modules, you can use a Puppetfile

mod 'enterprisemodules/iib_install'               ,'1.0.x'

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-iib_install

Usage

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

• IIB only example
• MQ and IIB example

Thes repos contain examples of how you can install and configure a basic IIB setup.

Reference

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

• The documentation
• The product announcement

Here is a related blog posts:

• Introducing the IBM information Bus Puppet modules.

Some example code:

• Simple IIB demo

Limitations

This module runs most Linux versions. It requires a puppet version higher than 4. The module does NOT run on windows systems. Contact us of you need to run this module on other flavors of UNIX. We can work together with you to make it work.

History

1.3.0

• [publish] Add puppet 7 support to the metadata
• [installiib] default lookup password value added
• [core] Generate passwords for unspecfied passwords

1.2.2

[software] Make default for file_name parameter undef

1.2.1

• [software] Make data type of variable source location less restrictive
• [ace] Add support for fixpack 4

1.2.0

• [software] Update allowed fixpacks
• [software] Fix usage with known file names
• [software] Add support for ACE 11.1

1.0.15

• [software] Fix installation when patchlevel is below 10.0.0.8
• [autostart] Use FP10 for acceptance test
• [core] Update reference to camptocamp-systemd

1.0.14

• [software] Add support for version 11 and version 10 patchlevels upto 14
• [core] Allow archive module version 3.0.0 and higher
• [release] Fix metadata information
• [core] Rubocop correct
• [sync] Enable PuppetLint
• [iib_full_version] Fix rubocop and fasterer message

1.0.13

• [iib_full_version] Fix error when unreadable version or build is returned

1.0.12

• [tasks] Add restart tasks
• [tasks] Add start task
• [tasks] Add status task
• [tasks] Add stop task

1.0.11

• [release] Add license notce, license text and readme
• [release] Always install spec_helper

1.0.10

• [os] Fix password setting for iibadmi user
• [release] Make some gems optional for rake
• [quality] Fix rubocop issue

1.0.9

• [software] Add support for Fixpack 11

1.0.8

• [autostart] Initial implementation for RHEL 6 and 7
• [software] Fix compatibility with Puppet version 4.4 and lower
• [software] Better checks and better warnings
• [software] Fix error in compile when fact not set (Initial run)

1.0.7

• [software] Add support for Fixpack 10

1.0.6

• [software] Add support for puppet urls

1.0.5

• [software] Added support for patch_level 9

1.0.4

• [core] Removed bindings and added type

1.0.3

• [os] Add mqm group creation

1.0.2

• [core] Fix bindings
• [facts] Remove debug puts

1.0.1

• [core] Added bindings

1.0.0

• [docs] Added documentation
• [facts] Improve the version detection
• [facts] Add support to symbolic links for iib_full_versions

0.0.2

• [software] Change default for install_root to /opt/IBM
• [os] Manage user home and add add group mqm
• [installiib] Make password configurable
• [os] Fix puppet naming error
• [software] Add support for multiple versions
• [software] Add support for fixpack 8
• [software] Make Puppet title for license acceptance more specific

0.0.1

• [installiib] Initial version