Forge Home

activemq

Installs and configures ActiveMQ.

6,800 downloads

6,677 latest version

1.3 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 0.4.1 (latest)
  • 0.4.0
released May 11th 2017
This version is compatible with:
  • Puppet Enterprise 3.x
  • Puppet 3.x
  • , , , , ,

Start using this module

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

Add this module to your Puppetfile:

mod 'marianschmotzer-activemq', '0.4.1'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add marianschmotzer-activemq
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install marianschmotzer-activemq --version 0.4.1

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

marianschmotzer/activemq — version 0.4.1 May 11th 2017

ActiveMQ

This module configures ActiveMQ. It is primarily designed to work with MCollective on Debian like systems. Ii is rework of https://github.com/puppetlabs/puppetlabs-activemq module.

Parameters

version

version to install

package

package name to install

ensure

one of latest|present(default)|absent

instance

instance name

kahadb_datadir

kahabd persistence directory

kahadb_opts

special options for kahadb

persistent

if do you want to use persistent store true|false

webconsole

if do you want to install jetty webserver console true|false

mq_connectors

arrray of hashes with connectors list

ssl

enable ssl support true|false

ssl_keystorepath

java keystore path

ssl_keystorepass

java keystore password

ssl_truststorepath

java certificate truststore path

ssl_truststorepass

java certificate truststore password

activemq_opts

active mq process options

java_xmx

maximum memory for java process

java_xms

minimum allocated memory for java process

java_home

jdk home

memory_usage_limit

limit (in M|G|K) of memory to use

store_usage_limit

limit (in M|G|K) of persisent store

temp_usage_limit

limit (in M|G|K) of temporary storage

Usage

Default activemq instalation

The example in the tests directory provides a good example of how the ActiveMQ module may be used. In addition, the MCollective Module provides a good example of a service integrated with this ActiveMQ module.

node default {
  class  { 'java':
    distribution => 'jdk',
    version      => 'latest',
  }
  ->
  class  { 'activemq': }
  ->
}

Activemq with ssl

Example of instalation with ssl support for storm. I used java_ks module for java certificate store creation from my X.509 keys/certs

node default
{
  $activemq_truststorepath='/etc/activemq/ca.jks'
  $activemq_truststorepass='puppet'

  $activemq_keystorepath='/etc/activemq/activemq.jks'
  $activemq_keystorepass='puppet'

  java_ks { 'puppetca:keystore':
    ensure          => latest,
    certificate     => '/var/lib/puppet/ssl/certs/ca.pem',
    target          => $activemq_truststorepath,
    password        => $activemq_truststorepass,
    trustcacerts    => true,
  }->
  java_ks { "${fqdn}:${activemq_keystorepath}":
    ensure         => latest,
    certificate    => '/var/lib/puppet/ssl/certs/mycert.pem',
    private_key    => '/var/lib/puppet/ssl/private_keys/mykey.pem',
    password       => $activemq_keystorepass,
  }->
  class {'activemq':
    kahadb_opts        => { journalMaxFileLength => "32mb" },
    ssl                => true,
    ssl_truststorepath => $activemq_truststorepath,
    ssl_truststorepass => $activemq_truststorepass,
    ssl_keystorepath   => $activemq_keystorepath,
    ssl_keystorepass   => $activemq_keystorepass,

  }

}

Activemq without ssl but using hiera

Is possible to use this module with hiera as well

node default
{
  java::oracle { 'jdk8': }
  ->
  class  { 'activemq': }
}

And all vallues are in hiera file

activemq::memory_usage_limit: 512M
activemq::mq_connectors:
  stomp+nio:
    uri: stomp://0.0.0.0:61613
  openwire:
    uri: nio://0.0.0.0:61616
activemq::mq_cluster_brokers:
  int01:
    uri: static:(nio://int02:61616)
    duplex: false
  int02:
    uri: static:(nio://int01:61616)
    duplex: false

Public Classes

Class: activemq

package

Package name= 'activemq'

Contact Information

Related Work

The puppetlabs-activemq module provided basics for this module.

Web Console

The module manages the web console by default. The web console port is usually located at port 8160:

To disable this behavior, pass in webconsole => false to the class. e.g.

node default {
  class { 'activemq':
    webconsole => false,
  }
}