Scaling Puppet Enterprise – Part IV – ActiveMQ Hub and Spokes

As in the previous installment, you need to have already completed a few steps before arriving at this post. You should have already completed a “split installation” (Documented here). Also, your load balancer needs to be configured and running. The procedure for this portion can be found here. Finally, you should have the additional compilers installed and configured along with two example agent nodes as covered here and here.. If you’ve completed all these portions, you are now ready to configure ActiveMQ for scaling MCollective.

Once the preceding items are performed, you may find it necessary to add ActiveMQ hubs and spokes to increase capacity for MCollective and/or the Code Sync and Code Manager functions of Puppet Enterprise. This installment documents how to install these additional components and tie them into the existing infrastructure.

Create an ActiveMQ Hub

  1. Go to the Puppet Enterprise Console in your browser.
  2. Select Nodes | Classification and create a new group called “PE ActiveMQ Hub”
  3. Stand up two new nodes for the ActiveMQ Hub and Spoke (in our example, and according to the following specifications:

Once your nodes have been provisioned, install the Puppet Agent on each node, making sure to point the installer DIRECTLY at the MoM (**) instead of at the compiler VIP.

curl -k | bash

and let the agent install complete in its entirety.

Next, from your browser, retrieve the Puppet Enterprise Console and select the “PE ActiveMQ Hub” group you created earlier. Pin the node into the PE ActiveMQ Hub group.

  1. Select the “Classes” tab and add a new class entitled: “puppet_enterprise::profile::amq::hub
  2. Click “Add Class“.
  3. Under the Parameters drop-down, select “network_collector_spoke_collect_tag” and set its value to “
  4. Commit the changes.
  5. SSH to the and run puppet agent -t to make all your changes effective for the Hub node.

Create ActiveMQ Spoke (or “broker”)

  1. In the Puppet Enterprise Console, Select Nodes | Classification | PE ActiveMQ Broker
  2. Pin your new ActiveMQ broker into the PE ActiveMQ Broker group.
  3. Select the “Classes” tab.
  4. Under the puppet_enterprise::profile::amp::broker class, choose the activemq_hubname parameter and set it to the FQDN of the hub you just created. In our case,
  5. SSH to the new broker ( and run puppet agent -t.
  6. Finally, unpin from the PE ActiveMQ Broker group.


At this point, you should have:

  • Puppet Master of Masters –
  • PuppetDB –
  • PE Console –
  • HAProxy Node –
  • 2 Catalog compilers – and
  • An ActiveMQ Hub –
  • An ActiveMQ Spoke –
  • Two Agent Nodes – and

with their respective configurations. Your serving infrastructure is complete, and you are now ready to configure it for use.

Comments are Closed