Forge Home

ibm_profile

pdk
Easy customisable profile classes for IBM MQ and IBM IIB nodes

Enterprise Modules

enterprisemodules

9,906 downloads

502 latest version

4.8 quality score

Version information

  • 1.5.0 (latest)
  • 1.4.0
  • 1.3.0
  • 1.2.4
  • 1.2.3
  • 1.2.2
  • 1.2.1
  • 1.2.0
  • 1.1.0
  • 1.0.1
  • 1.0.0
  • 0.5.4
  • 0.5.3
  • 0.5.2
  • 0.5.1
  • 0.5.0
  • 0.4.0
  • 0.3.0
released Jul 23rd 2021
This version is compatible with:
  • Puppet Enterprise 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x, 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x, 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
  • Puppet >= 4.7.0 < 8.0.0
  • Solaris
    ,
    AIX
    ,
    CentOS
    ,
    OracleLinux
    ,
    RedHat

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this declaration to your Puppetfile:

mod 'enterprisemodules-ibm_profile', '1.5.0'
Learn more about managing modules with a Puppetfile

Add this module to a Bolt project:

bolt module add enterprisemodules-ibm_profile
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install enterprisemodules-ibm_profile --version 1.5.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

enterprisemodules/ibm_profile — version 1.5.0 Jul 23rd 2021

Enterprise Modules

Table of Contents

  1. Overview
  2. Experience the Power of Puppet for IBM MQ
  3. License
  4. Description - What the module does and why it is useful
  5. Setup
  1. Usage - Configuration options and additional functionality
  2. Reference - An under-the-hood peek at what the module is doing and how
  3. Limitations - OS compatibility, etc.

Overview

The ibm_profile module allows an easy path from first simple installation to a fully customized Enterprise setup. It is part of our family of Puppet modules to install, manage IBM MQ and IBM IIB with Puppet. Besides the ibm_profile module, this family also contains:

  • mq_config For configuring IBM MQ.
  • mq_install For installing IBM MQ software on Linux systems
  • iib_config For configuring IBM Integration Bus on Linux systems
  • iib_install For installing IBM Integration Bus on Linux systems

Experience the Power of Puppet for IBM MQ

Installing IBM MQ software and managing your IBM MQ configuration can be hard. With Puppet at your side, you get super-powers when installing and managing IBM MQ. If you want to play and experiment with this please take a look at our playgrounds.

Experience the Power

License

Most of the Enterprise Modules modules are commercial modules. This one is NOT. It is an Open Source module. You are free to use it any way you like. It, however, is based on our commercial Puppet WebLogic modules.

Description

The ibm_profile::mq_machine class

The ibm_profile::mq_machine class allows you to get a full fledged MQ setup on your system in a minute. It contains all default settings needed, but you can also tweak it in a lot of ways. It contains the following stages (These are not puppet stages):

All these stages have a default implementation. This implementation is suitable to get started with. These classed all have parameters you can customize through hiera values. The defaults are specified in the module's data/default.yaml file.

But sometimes this is not enough and you would like to add some extra definitions, you can, for example, add a Puppet class to be executed after the systctl stage is done and before the limits is done. You can do this by adding the next line to your yaml data:

ibm_profile::mq_machine::before_sysctl:   my_profile::my_extra_class

or after:

ibm_profile::mq_machine::after_sysctl:   my_profile::my_extra_class

If you want to, you can also skip this provided class:

ibm_profile::mq_machine::sysctl:   skip

Or provide your own implementation:

ibm_profile::mq_machine::sysctl:   my_profile::my_own_implementation

This mechanism can be used for all named stages and makes it easy to move from an easy setup with a running standard database to a fully customized setup using a lot of your own classes plugged in.

The ibm_profile::iib_machine class

Besides setting up MQ, the ibm_profile module also has support for setting up IBM Integration Bus (IIB). The ibm_profile::iib_machine class allows you to get a full -fledged IIB setup on your system in a minute. It contains all default settings needed, but you can also tweak it in a lot of ways. It contains the following stages (These are not puppet stages):

All these stages have a default implementation. This implementation is suitable to get started with. These classed all have parameters you can customize through hiera values. The defaults are specified in the module's data/default.yaml file.

But sometimes this is not enough and you would like to add some extra definitions, you can, for example, add a Puppet class to be executed after the systctl stage is done and before the limits is done. You can do this by adding the next line to your yaml data:

ibm_profile::iib_machine::before_sysctl:   my_profile::my_extra_class

or after:

ibm_profile::iib_machine::after_sysctl:   my_profile::my_extra_class

If you want to, you can also skip this provided class:

ibm_profile::iib_machine::sysctl:   skip

Or provide your own implementation:

ibm_profile::iib_machine::sysctl:   my_profile::my_own_implementation

This mechanism can be used for all named stages and makes it easy to move from an easy setup with a running standard database to a fully customized setup using a lot of your own classes plugged in.

Setup

Requirements

The ibm_profile module requires:

This module uses some other public Puppet forge modules. Check the metadata to ensure you have all dependencies installed.

We support MQ and IIB versions:

  • MQ 8 all fixpacks
  • MQ 9 all fixpacks
  • IIB 10 fixpack 6 to 14

Installing the ibm_profile module

To install these modules, you can use a Puppetfile

mod 'enterprisemodules/ibm_profile'               ,'0.x.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-ibm_profile

Usage

ibm_profile::mq_machine

To get started, include the ibm_profile::mq_machine class in your role, make sure you have a module called software that has a folder files and that directory contains the next files:

  • IBM_MQ_9.0.0.0_LINUX_X86-64.tar.gz

Add the following line to the hiera data:

ibm_profile::mq_managers:
  MQ01:
    ensure: present

Run Puppet and you have a Server with MQ installed an MQ Queue Manager named MQ01 Check the documentation for all the settings you can manage.

ibm_profile::iib_machine

To get started, include the ibm_profile::iib_machine class in your role, make sure you have a module called software that has a folder files and that directory contains the next files:

  • 10.0.0-IIB-LINUXX64-FP0011.tar.gz

Add the following line to the hiera data:

ibm_profile::iib_brokers:
  '10.0.0.11/BROKER_01':
    ensure: present

ibm_profile::iib_machine::server_setup::list:
  '10.0.0.11/BROKER_01/SERVER_01':
    ensure: present

Run Puppet and you have a Server with IIB Broker BROKER_01 running and server SERVER_01 running on it. Check the documentation for all the settings you can manage.

Reference

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

Limitations

This module runs on most Linux versions, AIX and Solaris. It requires a puppet version higher than 4.10.8. The module does NOT run on windows systems.