Thank you for installing Apache Qpid version 0.25 for Windows. 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.
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
qpidd.exe. The installation procedure adds the Qpid bin
directory to the PATH environment variable, so the simplest way to experiment
with the broker is to open a command prompt window and execute the broker:
qpiddA 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.
If you installed the example programs, a new environment variable was
set. QPID_ROOT refers to the Qpid installation directory. The
Visual Studio project files located in the examples area refer to
QPID_ROOT to locate both header files and library files.
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
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.
If you wish to view Qpid's source code, please visit http://qpid.apache.org/download.html. The source components used to build this installed kit are "C++ broker & client" and "C# (.NET, WCF) WCF channel (C++ Broker Compatible)."
Please read the following sections for important notes regarding this release.
This release includes a second persistence module. The broker can use this
module to facilitate durable queues, exchanges, bindings, configuration, and
messages. The new persistence module, like the SQL-based store introduced in
Qpid 0.6, uses SQL Server Express (or SQL Server) 2005 or newer. However, it
also used Common Log File System (CLFS) to store message and transaction-related
information. CLFS and, thus, the new store, is available on Windows Vista and
Server 2005 and newer.
The persistence module is a Qpid broker plugin. It is not loaded by
default; therefore, to gain support for durable items the persistence plugin
must be loaded into the broker. This can be done using the
--load-module option to load the needed plugins. For example:
cd "C:\Program Files\Apache\qpidc-0.25" qpidd.exe --load-module plugins\broker\store.dll --load-module plugins\broker\msclfs_store.dllThe
--load-module option can also take a full path. The option
can also be included in the broker configuration file. A sample is located
in the conf\qpidd.conf file under the installation directory.
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.