Overview

The defined type mq_install::autostart allows you to create a systemd startup unit for a specified MQ queue manager and make sure it is restarted after a system reboot.

The simples way to use it is:

mq_install::autostart{'QM1':}

Here is an example with all possible properties used:

mq_install::autostart{'QM1':
    path         => '/etc/systemd/system',
    service_name => 'my_mq,
    mq_version   => 8,
    mq_user      => 'mqm_user',
    mq_group     => 'mqm_group',
    nofile_limit => 20480,
    nproc_limit  => 4096,
}

Attributes

Attribute Name Short Description
mq_group Allows you to specify the OS group the queue manage will be started under.
mq_user Allows you to specify the OS user the queue manage will be started under.
mq_version Allows you to specify the MQ versions.
multi_instance When true the queue manager wll be started in multi instance mode.
nofile_limit The nofile limit used for the process running the queue manager.
nproc_limit The nproc limit used for the process running the queue manager.
path Allows you to specify the path where the unit-file will be placed.
service_name Allows you to specfy the name of the service.
title The title is used to specfy the name of the queue manaer you want to ensure autostarted.
unit_template The name of the epp template to use for the systemd unit file.

title

The title is used to specfy the name of the queue manaer you want to ensure autostarted.

Here is an example on how to use this:

mq_install::autostart{'QM1':
}

Back to overview of autostart

path

Allows you to specify the path where the unit-file will be placed.

Here is an example on how to use this:

mq_install::autostart{'QM1':
  ...
  path         => '/etc/mysystemd/system',
  ...
}

The default value is `/etc/systemd/system’.

Type: String[1]

Default:lookup('mq_install::autostart::path')

Back to overview of autostart

service_name

Allows you to specfy the name of the service.

Here is an example on how to use this:

mq_install::autostart{'QM1':
  ...
  service_name => 'my_mq,
  ...
}

The default value is : "mq@$queuemanager_name. Type: String[1]

Default:lookup('mq_install::autostart::service_name')

Back to overview of autostart

mq_version

Allows you to specify the MQ versions.

At this point in time it is only used for comments in the unit.

Here is an example on how to use this:

mq_install::autostart{'QM1':
  ...
  mq_version   => 8,
  ...
}

Type: Integer

Default:lookup('mq_install::autostart::mq_version')

Back to overview of autostart

mq_user

Allows you to specify the OS user the queue manage will be started under.

Here is an example on how to use this:

mq_install::autostart{'QM1':
  ...
  mq_user      => 'mqm_user',
  ...
}

The default value is mqm and is correct in most situations. Type: String[1]

Default:lookup('mq_install::autostart::mq_user')

Back to overview of autostart

mq_group

Allows you to specify the OS group the queue manage will be started under.

Here is an example on how to use this:

mq_install::autostart{'QM1':
  ...
  mq_group     => 'mqm_group',
  ...
}

The default value is mqm and is correct in most situations. Type: String[1]

Default:lookup('mq_install::autostart::mq_group')

Back to overview of autostart

nofile_limit

The nofile limit used for the process running the queue manager.

Here is an example on how to use this:

mq_install::autostart{'QM1':
  ...
  nofile_limit => 20480,
  ...
}

Type: Integer

Default:lookup('mq_install::os::nofile')

Back to overview of autostart

nproc_limit

The nproc limit used for the process running the queue manager.

Here is an example on how to use this:

mq_install::autostart{'QM1':
  path         => '/etc/systemd/system',
  service_name => 'my_mq,
  mq_version   => 8,
  mq_user      => 'mqm_user',
  mq_group     => 'mqm_group',
  nofile_limit => 20480,
  nproc_limit  => 4096,
}

Type: Integer

Default:lookup('mq_install::os::nproc')

Back to overview of autostart

multi_instance

When true the queue manager wll be started in multi instance mode.

Here is an example on how to use this:

mq_install::autostart{'QM1':
  ...
  multi_instance => true,
  ...
}

Type: Boolean

Default:lookup('mq_install::autostart::multi_instance')

Back to overview of autostart

unit_template

The name of the epp template to use for the systemd unit file. The default value is: mq_install/mq.service.epp.

Here is an example on how to use this:

mq_install::autostart{'QM1':
  ...
  unit_template => 'my_module/my_template.epp',
  ...
}

The template is called with these parameters:

'mq_version'     => $mq_version,
'mq_user'        => $mq_user,
'mq_group'       => $mq_group,
'nofile_limit'   => $nofile_limit,
'nproc_limit'    => $nproc_limit,
'multi_instance' => $multi_instance,
'standby'        => $standby,

Type: String[1]

Default:lookup('mq_install::autostart::unit_template')

Back to overview of autostart