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.
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:
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.
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.
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.
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.
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.
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.
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.
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.
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.
In the next article we will look at the management portal in more detail.