• Overview
  • Deploying MCollective
  • Configuration / Deployment Topics
  • Use and Administer MCollective
  • Write Agent Plugins
  • Write Clients and Applications
  • Write Other Plugins
  • Plugin Directory
  • Internals
  • Older and Non-Recommended Information

MCollective Plugin: STOMP Utilities


NOTE: This plugin will be removed when MCollective 2.2.x comes to an end due to the deprecation of the STOMP connector.

Helpers and utilities for the MCollective STOMP connector


The source is on GitHub


Connection Information

The idea is that if you have a network with failover STOMP servers you might need some visibility about what is connected where, this agent and bundled utility will help you with that.

% mco rpc stomputil peer_info
Determining the amount of hosts matching filter for 2 seconds .... 1

 * [ ============================================================> ] 1 / 1

       Host: stomp1.your.net
   Protocol: AF_INET
       Port: 6163

Finished processing 1 / 1 hosts in 71.25 ms

You can also view all the nodes using the peer map utility.

$ mc-peermap country
stomp1.your.net -+ 22 nodes with 16.08ms average ping [de]

stomp3.your.net -+ 19 nodes with 123.07ms average ping [uk]

stomp2.your.net -+ 7 nodes with 363.30ms average ping [us]

Notice that I specified country on the command line this causes the fact country for each STOMP server to be displayed in the output.


If you determined with the command above that you have nodes you’d rather reconnect to their primary STOMP server use this to disconnect and reconnect to the middleware, recreating all subscriptions and reloading all agents.

NOTE: You do not want to run this against all your machines at once, take them in batches.

% mco rpc -I your.node.com stomputil reconnect
Determining the amount of hosts matching filter for 2 seconds .... 1

 * [ ============================================================> ] 1 / 1

   Restarted: 1

Finished processing 1 / 1 hosts in 591.50 ms
See an issue? Please file a JIRA ticket in our [DOCUMENTATION] project
Puppet sites use proprietary and third-party cookies. By using our sites, you agree to our cookie policy.