Chapter 2. Installation

This chapter guides you through the steps to install AMQ C++ in your environment.

2.1. Prerequisites

  • To build programs using AMQ C++ on Red Hat Enterprise Linux, you must install the gcc-c++, cmake, and make packages.
  • To build programs using AMQ C++ on Microsoft Windows, you must install Visual Studio.

2.2. Installing on Red Hat Enterprise Linux


  1. Use the subscription-manager command to subscribe to the required package repositories. Replace <version> with 2 for the main release stream or 2.9 for the long term support release stream. If necessary, replace <variant> with the value for your variant of Red Hat Enterprise Linux (for example, server or workstation).

    Red Hat Enterprise Linux 7

    $ sudo subscription-manager repos --enable=amq-clients-<version>-for-rhel-7-<variant>-rpms

    Red Hat Enterprise Linux 8

    $ sudo subscription-manager repos --enable=amq-clients-<version>-for-rhel-8-x86_64-rpms

  2. Use the yum command to install the qpid-proton-cpp-devel and qpid-proton-cpp-docs packages.

    $ sudo yum install qpid-proton-cpp-devel qpid-proton-cpp-docs

For more information about using packages, see Appendix B, Using Red Hat Enterprise Linux packages.

2.3. Installing on Microsoft Windows


  1. Open a browser and log in to the Red Hat Customer Portal Product Downloads page at
  2. Locate the Red Hat AMQ Clients entry in the INTEGRATION AND AUTOMATION category.
  3. Click Red Hat AMQ Clients. The Software Downloads page opens.
  4. Download the AMQ Clients 2.10.0 C++ .zip file.
  5. Extract the file contents into a directory of your choosing by right-clicking on the zip file and selecting Extract All.

When you extract the contents of the .zip file, a directory named amq-clients-2.10.0-cpp-win is created. This is the top-level directory of the installation and is referred to as <install-dir> throughout this document.