Chapter 3. Getting MRG Messaging Software

Installing MRG Messaging using Yum

The best strategy for installing MRG Messaging components is to use the mrg-beta yum repository.

Important

Before you install Red Hat Enterprise MRG check that your hardware and platform is supported. A complete list is available on the Red Hat Enterprise MRG Supported Hardware Page.

Become the root user, then download the mrg-beta repository to /etc/yum.repos.d.

# cd /etc/yum.repos.d
# wget ftp://ftp.redhat.com/pub/redhat/linux/beta/MRG/RHEL-5/mrg-beta.repo

Once mrg-beta.repo exists in your local yum repository, you can view the list of available packages by using the list available command. This command will list only those packages not already installed on your system.
```
# yum --disablerepo='*' --enablerepo=mrg-beta list available
```
Use the following yum commands to install each of the components you require:
MRG Messaging Broker:
```
# yum install rhm
```
Documentation and Sample Code:
```
# yum install rhm-docs
```
C++ client libraries:
```
# yum install qpidc-devel
```
Python client libraries:
```
# yum install python-qpid amqp
```
Java JMS client libraries:
```
# yum install qpid-java-client
```

You can check the installation location and that the components have been installed successfully by using the rpm -ql command with the name of the package you installed. For example:

# rpm -ql rhm
/etc/rc.d/init.d/rhmd
/etc/rhmd.conf
/usr/lib/libbdbstore.so.0
/usr/lib/libbdbstore.so.0.1.0
/usr/sbin/rhmd
/usr/share/doc/rhm-0.2
/usr/share/doc/rhm-0.2/COPYING
/usr/share/doc/rhm-0.2/README
/var/rhm

Note

The documentation from rhm-docs is installed in the /usr/share/doc/rhm-0.2/ directory. The examples are found in language-specific subdirectories (For example /usr/share/doc/rhm-0.2/java).

Starting the Broker

By default, the broker is installed in /usr/sbin/ If this is not on your path, you will need to type the whole path to start the broker.

# /usr/sbin/rhmd -t
[date] [time] info Loaded Module: libbdbstore.so.0
[date] [time] info Management not enabled
[date] [time] info Listening on port 5672

The -t or --trace option enables debug tracing, printing messages to the terminal.

For production use, MRG Messaging is usually run as a service. To start the broker as a service, run the following command as the root user:

# service rhmd start
Starting Qpid AMQP daemon:

Note

For more detail on downloading, installing and starting the broker, including troubleshooting information, refer to the MRG Messaging Installation Guide