Forge Home

qdr

Puppet Qpid Dispatch Router Module

15,589 downloads

133 latest version

4.7 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

  • 12.0.0 (latest)
  • 11.0.0
  • 10.0.0
  • 9.3.0
  • 9.2.0
  • 9.1.0
  • 9.0.0
  • 8.4.0
  • 8.3.0
  • 8.2.0
  • 8.1.0
  • 8.0.0
  • 7.4.0
  • 7.3.0
  • 7.2.0
  • 7.1.0
  • 7.0.0
  • 6.4.0
  • 6.3.0
  • 6.2.0
  • 6.1.0
  • 5.3.1
  • 5.3.0
  • 5.2.1
  • 5.1.0
  • 5.0.0
  • 4.4.0
  • 4.2.0
  • 4.1.0
  • 4.0.0
  • 3.4.0
  • 3.2.0
released Oct 16th 2023
This version is compatible with:
  • Puppet Enterprise 2023.2.x, 2023.1.x, 2023.0.x, 2021.7.x, 2021.6.x, 2021.5.x, 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x
  • Puppet >= 7.0.0 < 8.0.0
  • , , ,

Start using this module

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

Add this module to your Puppetfile:

mod 'openstack-qdr', '12.0.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add openstack-qdr
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install openstack-qdr --version 12.0.0

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

openstack/qdr — version 12.0.0 Oct 16th 2023

Team and repository tags

Team and repository tags

qdr

Table of Contents

  1. Overview
  2. Module Description - Manage the QPID Dispatch Router
  3. Setup - The basics of getting started with qdr
  4. Usage - Configuration options and additional functionality
  5. Reference - An under-the-hood peek at what the module is doing and how
  6. Limitations - OS compatibility, etc.
  7. Development - Guide for contributing to the module
  8. Contributors - Those with commits
  9. Release Notes - Release notes for the project
  10. Repository - The project source code repository

Overview

This module manages the QPID Dispatch Router (qdr) found at:

 http://qpid.apache.org/components/dispatch-router/

The dispatch router provides flexible and scalable interconnect between any AMQP 1.0 endpoints, whether they be clients, brokers or other AMQP-enabled services

Support is intended for Red Hat and Ubuntu OS family deployed with Pupppet V4.x

Module Description

This module sets up the installations, configuration and management of the QPID Dispatch Router (qdr) class and has a number of providers that correpsond the router configuration entities such as listeners and connectors.

This module will facilitate the deployment of a full/partial mesh topology of QPID Dispatch Routers serving as the messaging interconnect for a site.

Setup

What qdr affects

  • repository files
  • packages
  • configuration files
  • service
  • configuration entities

Beginning with qdr

include qdr

The default configuration currently installs Qpid-Dispatch-Router 0.6

Usage

All configuration parameters can be managed via the main qdr class.

class { 'qdr' :
  service_enable            => true,
  container_workder_threads => 4,
  listener_port             => 15672,
}

Class Reference

  • qdr: Provides the basic installation and configuration sequence
  • qdr::config: Provides qdrouterd configuration
  • qdr::install: Performs package installations
  • qdr::params: Aggregates configuration data for router
  • qdr::service: Manages the qdrouterd service state

Resource Types

qdr_address

Resource to manage address prefixes for distribution and phasing

Query all current internal addresses: '$puppet resource qdr_address'

qdr_address { 'anyAddress' :
  prefix       => 'unicast',
  distribution => 'closest',
}

qdr_connector

Resource configuration entity to establish outgoing connections from the router.

Query all current connectors: '$puppet resource qdr_connector'

qdr_connector { 'anyConnector' :
  addr           => '10.10.10.10',
  port           => '1234',
  role           => 'inter_router',
  max_frame_size => '65536',
}

qdr_listener

Listens for incoming connection requests to the router

Query all current listeners: '$puppet resource qdr_listener'

qdr_listener { 'anyListener' :
  addr            => '10.10.10.10',
  port            => '5678',
  role            => 'normal',
  sasl_mechanisms => 'DIGEST-MD5,EXTERNAL',
}

qdr_log

Control log settings for a particular module on the running router

Query all current log module settings: '$puppet resource qdr_log'

qdr_user

Users for internal sasl authentication

Query all current internal users: '$puppet resource qdr_user'

qdr_user { 'anyUser' :
  password => 'changeme',
}

Resource Providers

qdmanage

An AMQP management client tool for used with any standard AMQP managed endpoint.

Limitations

This module has been tested on the following platforms:

  • CentOS 7
  • Ubuntu 15.10

Apt module dependence

If running Debian os family, puppetlabs-apt module is required

Development

Developer documentation for the entire puppet-openstack project.

Contributors

Release Notes

Repository

If you aren't using changelog, put your release notes here (though you should consider using changelog). You may also add any additional sections you feel are necessary or important to include here. Please use the ## header.