#4519 [HHQ-4474] RabbitMQ plugin - Configure directions need to be

[Hyperic Team]

http://jira.hyperic.com/browse/HHQ-4474
RabbitMQ plugin - Configure directions need to be updated for 4.5.0.1.

For 4.5.0, the Configuration Directions indicate:

Configure RabbitMQ for Monitoring

Prerequisites and Support


The RabbitMQ plugin runs under HQ 4.5 and later and supports RabbitMQ versions 1.8.1 and higher. This version of the plugin requires that the HQ Agent that manages RabbitMQ has permission to read the Erlang cookie.

Configuration Requirements


The HQ Agent on the platform where the RabbitMQ server should auto-discover the "RabbitMQ" server instance — assuming at least one RabbitMQ Node is running. — and present it as a new server on the platform in the Auto-Discovery portlet of the HQ Dashboard. To enable metric collection and auto-discovery of RabbitMQ services:


1. Import the platform with the new RabbitMQ server to inventory


2. Navigate to the Rabbit MQ server, using Resources > Browse > Servers


3. Under the Server (Node), navigate to Tools Menu > Configure Server


4. Enter the RabbitMQ username and password for the RabbitMQ server and click OK. Hyperic assumes the default RabbitMQ username and password have been changed for security reasons and does set them as the default

This will allow enable the plugin to authenticate, auto-discover Queue, Channel, Connection, Exchanges, etc., and proceed with metric collection. Note: Discovered services are automatically imported to HQ inventory.

Help Docs


Monitoring and Managing RabbitMQ

Recommended Updates for 4.5.0.1:


1. Remove note that "This version of the plugin requires the HQ Agent that manages RabbitMQ has permission to read the Erlang cookie." This is no longer required (i.e. hyperic created user can start HQ Agent).


2. Remove instructions to enter usernane and password. Manual configuration no longer required.


3. Indicate no configuration is necessary and servers and services will be automatically discovered.

Expected Result:


Configuration Directions are accurate and reflect the actual behavior.

Actual Result:


Information is out of date and no longer accurate.

Steps to Reproduce:


1. Install and start agent on platform running RabbitMQ.


2. Log into Hyperic


3. Add platform running RabbitMQ into inventory from auto-discovery


4. Select platform running RabbitMQ


5. Select RabbitMQ Node server from Deployed Servers Health


6. Click the Inventory tab


7. Click the Edit button within the Configuration Properties section


8. Note the Configuration Directions are out of date and need updating