Apache Qpid C++ 0.5 Installation Notes

Thank you for installing the Apache Qpid version 0.5 C++ kit. If the requisite features were installed, you can now run a broker, use the example programs, and design your own messaging programs while reading the Qpid C++ API reference documentation.

Running a Message Broker

In AMQP, programs that send and receive messages are clients. The agents that route and queue messages to and from clients are brokers. In order to use any Qpid-based messaging program there must be at least one broker running which the client(s) can communicate with. The broker need not execute on the same system as the client, but it must be reachable using TCP/IP.

The broker executable is installed in the bin subdirectory of your Qpid installation directory. The broker program is qpidbroker.exe. The simplest way to experiment with the broker is to open a command prompt window, cd to the installation directory, and execute the broker:

cd "C:\Program Files\Apache\qpidc-0.5\bin"
qpidbroker
A small amount of information will be displayed to let you know the broker is running and listening for client connections.

To stop the broker, you can simply type ^C in the command prompt window where the broker is running.

For a full list of options for the broker, you can use the --help option.

Using the Example Programs

The example programs are located in the examples subdirectory of the Qpid installation directory. There are a number of examples, each with its own subdirectory under examples. You can use the examples to

Each example's directory contains source code and Visual Studio 2008 project files you can use to build the examples.

Reading the C++ API Reference Documentation

The C++ API reference documentation is HTML and can be viewed using your web browser. It is located in the docs\api\html subdirectory of the installation directory, but there is also a shortcut to the documentation in Start > All Programs > Apache Qpid > Qpid C++ Reference Documentation. Selecting that menu item will launch the documentation's main page in your default web browser.

Complete Source Code is Available

If you installed the complete source code feature (which is disabled by default) you can explore all the source code for all of Apache Qpid. This includes the Visual Studio 2008 project files necessary for rebuilding Qpid should you wish to do so.

For More Information

For more information on Apache Qpid, please visit the web site http://qpid.apache.org/.

The Qpid site contains more information about Qpid and AMQP as well as directions for joining and reading the Qpid-related email lists.