In the previous article we look at the AMQP messaging standard that sits behind RabbitMQ. In this article we will look at installing and configuring RabbitMQ.

Basic Installation

Now that we have covered the basics of message queuing, RabbitMQ, and the AMQP model, let’s get RabbitMQ installed and configured. When you set up RabbitMQ on a server, you need to install two components. First, you need the Erlang run time and then RabbitMQ itself. First, go to the RabbitMQ website to download it.

Once you are on this page, select “Install: Windows” from the grey panel to the right of the screen:

Download RabbitMQ
Download RabbitMQ

From this page, click the link to the “Erlang Windows Binary File” as shown in the following screen shot. This will take you to the Erlang website downloads page.

Download the Erlang Runtime
Download the Erlang Runtime

When you are on the Erlang site, pick the latest version of the runtime that matches your operating system. If you are running a 64bit operating system, then pick the 64bit version and visa versa with the 32bit version.

Download the Erlang Runtime
Download the Erlang Runtime

When the installer file has downloaded, start it running. With this installer you can stick with the defaults as they are all sensible defaults. Click through the menus so that all the files get installed.

Installing the Erlang Runtime
Installing the Erlang Runtime

Once the Erlang runtime has installed, go back to the RabbitMQ site and download the latest copy of the RabbtMQ server. This installer is very small so will not take very long to download.

Download the RabbitMQ Server
Download the RabbitMQ Server

Once this is downloaded, run the installer, again like with the Erlang runtime you can stay with the defaults. During the installation you may get some firewall pop-ups appear asking you to set some firewall rules. If this happens click the “Allow Access” buttons.

Install the RabbitMQ Server
Install the RabbitMQ Server

RabbitMQ installs with a usable default message broker environment, but you can change and customize the environment if you wish. This is beyond the scope of this series , but further instructions for doing so are on the RabbitMQ site.

Once RabbitMQ has installed the RabbitMQ service it will startup automatically, so this means you have a running message broker ready to go.

Setting up the management portal

RabbitMQ comes with a web based management portal. This portal serves as a place to configure RabbitMQ and also as a useful dashboard to monitor what is happening with the message broker. The management portal is not enabled by default, you need to do this separately.

Open up a command prompt and navigate to “C:\Program Files (x86)\RabbitMQ Server\rabbitmq_server-3.4.4\sbin

From the command prompt type:

 rabbitmq-plugins enable rabbitmq_management

This will configure the web management portal. You should see the following in your command prompt once the portal is configured.

Configure the RabbitMQ Management Portal
Configure the RabbitMQ Management Portal

If you are following the examples in this series, then you should keep this command line window open as you will need to use it in the next chapter.

To go to the portal, use the following web address where server-name is substituted with the name of the server containing the instance of RabbitMQ.

http://server-name:15672

If you are running this on your local machine then the address will be http://localhost:15672

Once you go to this address you will see a RabbitMQ logon screen like in the following screenshot.

RabbitMQ Management Portal Logon Screen
RabbitMQ Management Portal Logon Screen

To log into the management portal, the default credentials are:

Username : guest

Password : guest

Once you log in, you will see the following overview screen. This page gives you a dashboard view of RabbitMQ running on that server where you can see how many message are flowing through the system, the message throughput rates, and the numbers of exchanges, queues and consumers.

RabbitMQ Management Portal Dashboard
RabbitMQ Management Portal Dashboard

In the next article we will look at the management portal in more detail.

Advertisements

One comment

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s