Overview

This class install’s specified version of the the MQ software on the system. The source zip file from IBM is found at the location specified at source_location. By default it will install only the minimal required set. By using the install_... parameters, you can install optional components.

Here is an example on how to use it:

class { '::mq_install::software':
  source_location  => '/software',
  version          => '9.0.0.0'
  tmp_dir          => '/tmp'
  install_ams      => true,
  install_ft       => false,
  install_client   => false,
  install_explorer => true,
  install_xrserver => false,
  install_samples  => false,
  install_sdk      => false,
  install_man      => false,
  install_gskit    => false,
  install_amqp     => false,
  logoutput        => 'true,
}

On systems with a secured /tmp direcory, you MUST specify the tmp_dir parameter and specify a directory that puppet is allowed to execute scripts from. It must also have enough space to receive the extracted MQ installation kit.

Attributes

Attribute Name Short Description
file_name The file containing the install kit for the MQ software.
install_amqp Specify a value of true when you want to install this component.
install_ams Specify a value of true when you want to install this component.
install_blockchain Specify a value of true when you want to install the IBM MQ Bridge to blockchain component.
install_client Specify a value of true when you want to install this component.
install_explorer Specify a value of true when you want to install this component.
install_ft Specify a value of true when you want to install this component.
install_gskit Specify a value of true when you want to install this component.
install_man Specify a value of true when you want to install this component.
install_rdqm Specify a value of true when you want to install the replicated data queue manager component.
install_salesforce Specify a value of true when you want to install the Bridge to Salesforce component.
install_samples Specify a value of true when you want to install this component.
install_sdk Specify a value of true when you want to install this component.
install_toolkit Specify a value of true when you want to install this component.
install_web  
install_xrserver Specify a value of true when you want to install this component.
logoutput If you want to see the output of the exec resources in the type, you can set this value to true.
source_location The location of the MQ software.
tmp_dir This defined type uses a temporary directory.
version The version to be installed.

source_location

The location of the MQ software.

Here is an example on how to use this:

class { '::mq_install::...':
  ...
  source_location => '/software',
  ...
}

Type: String[1]

Back to overview of software

version

The version to be installed. Here is an example on how to use this:

class { '::mq_install::software':
  ...
  version => '9.0.0.0',
  ...
}

Type: Pattern[/\d+\.\d+\.\d+\.\d/]

Back to overview of software

file_name

The file containing the install kit for the MQ software.

Type: Optional[String[1]]

Default:undef

Back to overview of software

tmp_dir

This defined type uses a temporary directory. By default this is \tmp. If you want to use an other directory for this, you must specify this parameter.

Here is an example on how to use this:

class { '::mq_install::...':
  ...
  tmp_dir => '/my_tmp_dir',
  ...
}

On systems with a secured /tmp direcory, you MUST specify the tmp_dir parameter and specify a directory that puppet is allowed to execute scripts from. It must also have enough space to receive the extracted MQ installation kit.

Type: String[1]

Default:'/tmp'

Back to overview of software

install_ams

Specify a value of true when you want to install this component. Here is an example:

class { '::mq_install::software':
  ...
  install_ams => true,
  ...
}

The default is ‘false’. Meaning this component is not installed.

Type: Boolean

Default:false

Back to overview of software

install_ft

Specify a value of true when you want to install this component. Here is an example:

class { '::mq_install::software':
  ...
  install_ft => true,
  ...
}

The default is ‘false’. Meaning this component is not installed.

Type: Boolean

Default:false

Back to overview of software

install_client

Specify a value of true when you want to install this component. Here is an example:

class { '::mq_install::software':
  ...
  install_client => true,
  ...
}

The default is ‘false’. Meaning this component is not installed.

Type: Boolean

Default:false

Back to overview of software

install_explorer

Specify a value of true when you want to install this component. Here is an example:

class { '::mq_install::software':
  ...
  install_explorer => true,
  ...
}

The default is ‘false’. Meaning this component is not installed.

Type: Boolean

Default:false

Back to overview of software

install_xrserver

Specify a value of true when you want to install this component. Here is an example:

class { '::mq_install::software':
  ...
  install_xserver => true,
  ...
}

The default is ‘false’. Meaning this component is not installed.

Type: Boolean

Default:false

Back to overview of software

install_samples

Specify a value of true when you want to install this component. Here is an example:

class { '::mq_install::software':
  ...
  install_samples => true,
  ...
}

The default is ‘false’. Meaning this component is not installed. This component can only be installed on Linux systems.

Type: Boolean

Default:false

Back to overview of software

install_sdk

Specify a value of true when you want to install this component. Here is an example:

class { '::mq_install::software':
  ...
  install_sdk => true,
  ...
}

The default is ‘false’. Meaning this component is not installed. This component can only be installed on Linux systems.

Type: Boolean

Default:false

Back to overview of software

install_man

Specify a value of true when you want to install this component. Here is an example:

class { '::mq_install::software':
  ...
  install_man => true,
  ...
}

The default is ‘false’. Meaning this component is not installed. This component can only be installed on Linux systems.

Type: Boolean

Default:false

Back to overview of software

install_gskit

Specify a value of true when you want to install this component. Here is an example:

class { '::mq_install::software':
  ...
  install_gskit => true,
  ...
}

The default is ‘false’. Meaning this component is not installed. This component can only be installed on Linux systems.

Type: Boolean

Default:false

Back to overview of software

install_amqp

Specify a value of true when you want to install this component. Here is an example:

class { '::mq_install::software':
  ...
  install_amqp => true,
  ...
}

The default is ‘false’. Meaning this component is not installed.

Type: Boolean

Default:false

Back to overview of software

install_web

Type: Boolean

Default:false

Back to overview of software

install_salesforce

Specify a value of true when you want to install the Bridge to Salesforce component.

Here is an example:

class { '::mq_install::software':
  ...
  install_salesforce => true,
  ...
}

The default is ‘false’. Meaning this component is not installed.

Install this component to configure the connections to Salesforce and IBM MQ, then run the runmqsfb command to subscribe to events from Salesforce and publish them to an IBM MQ network.

This component can only be installed on Linux systems.

Type: Boolean

Default:false

Back to overview of software

install_blockchain

Specify a value of true when you want to install the IBM MQ Bridge to blockchain component.

Here is an example:

class { '::mq_install::software':
  ...
  install_blockchain => true,
  ...
}

The default is ‘false’. Meaning this component is not installed.

Install this component to configure the connections to your blockchain network and IBM MQ. You can then run the runmqbcb command to start the bridge and send queries and updates to, and receive responses from your blockchain network. The queue manager that the bridge connects to must be an IBM MQ Advanced queue manager.

This component is available only on Linux for System x (64 bit), on RHEL 7.3 or later and is only supported for MQ 9.1 and higher.

This component can only be installed on Linux systems.

Type: Boolean

Default:false

Back to overview of software

install_rdqm

Specify a value of true when you want to install the replicated data queue manager component.

Here is an example:

class { '::mq_install::software':
  ...
  install_rqdm => true,
  ...
}

The default is ‘false’. Meaning this component is not installed.

Install this component to make the replicated data queue manager high availability configuration available. See Installing RDQM (replicated data queue managers) for more information. This component is available only on Linux for System x (64 bit), on RHEL 7.3 or later and is only supported for MQ 9.1 and higher.

This component can only be installed on Linux systems.

Type: Boolean

Default:false

Back to overview of software

install_toolkit

Specify a value of true when you want to install this component. Here is an example:

class { '::mq_install::software':
  ...
  install_toolkit => true,
  ...
}

The default is ‘false’. Meaning this component is not installed. This component can only be installed on Windows systems.

Type: Boolean

Default:false

Back to overview of software

logoutput

If you want to see the output of the exec resources in the type, you can set this value to true. The default is on_failure.

Here is an example on how to use this:

class { '::mq_install::...':
  ...
  logoutput => true,
  ...
}

Type: Variant[Enum['on_failure'], Boolean]

Default:'on_failure'

Back to overview of software