Getting Started With RHM/HiddenTrunkVersion
From RHM
Contents |
Getting Started with Red Hat messaging
Note: This is the hidden "trunk" version of this page - we will move this to replace the main "Getting Started with RHM" page when the release is ready.
This page is designed to get you up and running with Red Hat Messaging. Within 20 minutes you should be able to download a server, start it, and compile and run a sample application. If you are not familiar with Red Hat Messaging, you can get a better understanding of what it does by reading http://rhm.et.redhat.com.
Note: Sample applications will be provided in the upcoming release.
Download Red Hat Messaging
This site currently provides the C++ implementation of the Milestone 2 branch, which implements AMPQ 0.8, the last stable release of the AMQP standard. A complete Java implementation will be posted here soon. Ruby, and Python clients will also be posted here soon.
i386 packages
These packages are available for 32-bit Intel systems.
- qpidc-0.1-5.M2.i386.rpm — Qpid shared libraries. Needed by the server; also needed if you want to run Qpid client applications.
- qpidd-0.1-5.M2.i386.rpm — Qpid server, binaries for i386.
- qpidc-devel-0.1-5.M2.i386.rpm — Header files, developer documentation, and symbolic links to shared libraries; needed if you want to develop Qpid client applications.
x86_64 packages
These packages are available for 64 bit Intel and AMD systems.
- qpidc-0.1-5.M2.x86_64.rpm — Qpid shared libraries. Needed by the server; also needed if you want to run Qpid client applications.
- qpidd-0.1-5.M2.x86_64.rpm — Qpid server, binaries for x86_64.
- qpidc-devel-0.1-5.M2.x86_64.rpm — Header files, developer documentation, and symbolic links to shared libraries; needed if you want to develop Qpid client applications.
What was installed?
If you installed the above packages using the package installer, you may want to see what was actually installed where. You can do this using rpm as follows:
rpm -ql qpidd
rpm -ql qpidc
rpm -ql qpidc-devel
Run the Qpidd broker
Command line options
The broker can be run with a variety of options. To see a list of these options, type:
$ man qpidd
or
$ /usr/sbin/qpidd --help
Starting the broker
By default, Qpidd is installed in /usr/sbin/qpidd, which is normally not on your path. You can start the broker on the command line by specifying the full path:
$ /usr/sbin/qpidd
If the server starts successfully, you will see messages similar to these:
$ /usr/sbin/qpidd -t Persistence not enabled, no recovery of queues or messages. Listening on port 5672...
The warning about persistence informs you that you do not have guaranteed delivery unless a persistence library is specified.
Enabling persistence
To enable guaranteed delivery, persistent queues, and persistent messages, you need to enable persistence. Red Hat Messaging currently supports one persistence library, libbdbstore.so, which you can load with the -s option:
$ /usr/local/sbin/qpidd -t -s libbdbstore.so 2007-Jun-18 09:45:19 info Listening on port 5672
