Chapter 2. Installation

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

2.1. Prerequisites

  • To use AMQ Python, you must install Python in your environment.

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.11 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 packages.

    Main release stream

    $ sudo yum install python3-qpid-proton python-qpid-proton-docs

    AMQ Clients 2.11 long term support stream

    $ sudo yum install python-qpid-proton python-qpid-proton-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.11.0 Python .whl file for your Python version.

    Python 3.6


    Python 3.8


  5. Open a command prompt window and use the pip install command to install the .whl file.

    Python 3.6

    > pip install python_qpid_proton-0.37.0-cp36-cp36m-win_amd64.whl

    Python 3.8

    > pip install python_qpid_proton-0.37.0-cp38-cp38-win_amd64.whl