============
QPID proton dependencies
- RHEL >= 6
yum install swig patch libuuid-devel
- RHEL 5
yum install swig patch e2fsprogs-devel java-1.7.0-openjdk
- QPID Proton with experimental CPP Reactor support
git clone [email protected]:cliffjansen/qpid-proton.git -b cpp-work ;
cd qpid-proton ;
curl "http://pastebin.test.redhat.com/pastebin.php?dl=281175" -o default-cpp-on.patch ;
patch -p1 < default-cpp-on.patch ;
cmake -DSYSINSTALL_BINDINGS=ON -DCMAKE_INSTALL_PREFIX=/opt/devel/qpid-proton -DDEFAULT_CPP=ON -DBUILD_TESTING=ON . ;
make all test ;
sudo make install ;
These variables apply to all code base and may affect what code is built with along with the project. For example, they may enable refactored code.
Control where required boost libraries can be found.
- Boost_INCLUDE_DIRS: use to inform the Boost include directory.
- Boost_LIBRARY_DIRS: use to inform the Boost library directory.
Control whether or not to enable the unit tests for the client code.
- BUILD_WITH_UNIT_TESTS: Builds the unit tests for the client and enables a new target ('make test').
These variables control client-specific compilation details.
These variables affect only the QPID Messaging clients.
- ENABLE_QPID_MESSAGING: Enable qpid messaging clients (eg.: aac0, some qc2 and some qmf2 binaries). Default: on.
With that flag enabled, the following other variables may also be set:
- QPID_INCLUDE_DIR: QPID Messaging include directory.
- QPID_LIBRARY_DIR: QPID Messaging library directory.
- QPID_WITH_GET_CONTENT_OBJECT: Whether qpid code contains getContentObjectQPID 'getContentObject'.
- QPID_VERSION: QPID Version.
- QPID_SOURCE: QPID source code directory (required for building QPID's client)
- QPID_SOURCE_INCLUDE_DIR: QPID source code include directory (required for building QPID's client).
- ENABLE_QPID_CLIENT: Enable qpid clients (qpid-send, qpid-receive and its qc2-* counterpars). Note: It requires QPID source code on the build host. Default: off.
- QPID_SOURCE_WITH_SYS_EPOCH: Defines QPIDSYSEPOCH if set or QPID_SOURCE_WITH_SYS_EPOCH if unset. Default: true.
- QPID_WITH_GET_CONTENT_OBJECT: This flags tells the build system whether qpid code contains getContentObject (defines NGETCONTENTOBJECT). It may be required for some older RHEL/qpid versions. Default: false.
These variables affect only the QPID Proton clients.
- ENABLE_QPID_PROTON: Enable qpid proton messaging/reactor clients (eg.: aac3 and aac4).
- PROTON_DIR: QPID Proton base directory.
RHEL >= 6, with QPID Proton clients, using a non-standard QPID Proton directory
cmake -DENABLE_QPID_PROTON=ON -DPROTON_DIR=/opt/devel/qpid-proton \
-DCMAKE_CXX_COMPILER=`which c++` .
RHEL 5.11 without QPID Proton and disabled unit tests
cmake -DENABLE_QPID_PROTON=ON -DPROTON_DIR=/opt/devel/qpid-proton \
-DCMAKE_CXX_COMPILER=`which c++` \
-DCMAKE_VERBOSE_MAKEFILE=OFF -DBUILD_WITH_UNIT_TESTS=OFF \
-DQPID_WITH_GET_CONTENT_OBJECT=ON \
-DBoost_INCLUDE_DIRS=/usr/include/boost141/ \
-DBoost_LIBRARY_DIRS=/usr/lib/boost141/ .
RHEL 5.11 with QPID Proton and disabled unit tests
cmake -DENABLE_QPID_PROTON=ON -DPROTON_DIR=/opt/devel/qpid-proton \
-DCMAKE_CXX_COMPILER=`which c++` `
-DCMAKE_VERBOSE_MAKEFILE=OFF -DBUILD_WITH_UNIT_TESTS=OFF `
-DQPID_WITH_GET_CONTENT_OBJECT=ON `
-DBoost_INCLUDE_DIRS=/usr/include/boost141/ `
-DBoost_LIBRARY_DIRS=/usr/lib/boost141/ -DENABLE_QPID_CLIENT=ON .
To compile the code:
make -j2 all
To run the unit tests:
make test
To generate the documentation (the files will be in the html directory within the target directory):
make documentation
To clean all code, including the build script cache:
make distclean
To run quality checks on the code:
make check
This document contains some hacking tips for Qpid clients.
Building Qpid Proton with C++ reactive API bindings
Current Version (0.11-SNAPSHOT)
Users with access to the source code should look at INSTALL.md file in the root directory of the project for latest details.
git clone https://github.com/apache/qpid-proton.git
mkdir build
cd build
mkdir -p /opt/devel/qpid-proton-0.11
cmake -DCMAKE_INSTALL_PREFIX=/opt/devel/qpid-proton-0.11-SNAPSHOT -DSYSINSTALL_BINDINGS=ON DBUILD_PYTHON=ON -DBUILD_PERL=OFF -DSWIG_EXECUTABLE=/usr/bin/swig ..
make && sudo make install
ln -sf /opt/devel/qpid-proton-0.11 /opt/devel/qpid-protonRelevant: Swig executable must be informed to bypass PROTON-949.
Older Versions (< 0.11-SNAPSHOT)
Note: this is, probably, outdated since it is based on a older C++ work branch.
git clone [email protected]:cliffjansen/qpid-proton.git -b cpp-work
cd qpid-proton
curl "http://pastebin.test.redhat.com/pastebin.php?dl=281175" -o default-cpp-on.patch
patch -p1 < default-cpp-on.patch
cmake -DSYSINSTALL_BINDINGS=ON -DCMAKE_INSTALL_PREFIX=/opt/devel/qpid-proton -DDEFAULT_CPP=ON -DBUILD_TESTING=ON .
make all test
sudo make installBuilding Qpid Proton from source RPM with tests
Note: the rpm name, version and architecture may vary. Please adjust accordingly.
curl http://download.devel.redhat.com/brewroot/packages/qpid-proton/0.9/3.el6/src/qpid-proton-0.9-3.el6.src.rpm -O
rpm -ivh qpid-proton-0.9-3.el6.src.rpm
cd ~/rpmbuild/SPECS
curl "http://pastebin.test.redhat.com/pastebin.php?dl=284041" -o make-test.patch
patch -p0 < make-test.patch
cd ..
rpmbuild -ba SPECS/qpid-proton.specRunning Qpid JMS unit tests from RPM
rpm -ivh qpid-jms-0.1.0-1.el6.src.rpm
cd ~/rpmbuild/SOURCES
unzip qpid-jms-parent-0.1.0-redhat-1-scm-sources.zip
cd rh-qpid-jms
# Download a patch to ignore long-running / timing out tests
curl "http://pastebin.test.redhat.com/pastebin.php?dl=284210" -o ignore-long-running.patch
patch -p1 < ignore-long-running.patch
mvn -Dgeronimo-jms-1-1-spec-version=1.1.1 clean packageRunning Qpid JMS unit tests from upstream
git clone https://github.com/apache/qpid-jms.git
cd qpid-jms
curl "http://pastebin.test.redhat.com/pastebin.php?dl=284210" -o ignore-long-running.patch
patch -p1 < ignore-long-running.patch
mvn clean package