Getting a Copy of Queue Messages

Document ID : KB000034635
Last Modified Date : 14/02/2018
Show Technical Document Details

Introduction

It is sometimes necessary to harvest a copy of queue messages that come through the primary hub in order to facilitate support and development in troubleshooting a problem.? When there is a subscriber to the queue, the messages are removed after processing so it is often not possible to harvest the messages directly from the queue itself.? This article gives the steps to create a copy of messages so we can non-invasively harvest messages in a controlled fashion.
?
Note that this will require restart of your primary hub to enable the queue, to disable the queue and again to delete the queue.? Please plan accordingly for this.
Additionally, you will need direct file access to the hub; RDP access for Windows and ssh access for Unix and Linux systems.




Procedure

In this case, we?ll use a scenario where we need to harvest discovery messages.
  1. Open hub configuration on your primary hub.
  2. Click the Queues tab
  3. Click the New button
  4. Enter a descriptive Name for the queue such as Discovery_Harvest
  5. Change the Type to attach
  6. Drop the Subject list down and choose probe_discovery
  7. Click OK
  8. Click Apply on the main hub GUI
  9. Click Yes to restart the hub
At this point you can click on the Status tab and you should see your new queue with a yellow icon next to it.? Yellow is normal in this case as the queue has no subscribers getting or consuming messages from this queue.
?
The support engineer should advise you as to how long to allow this queue to gather messages.? Depending on the amount of traffic being generated it may be a few moments or it may be a few hours.
?
Once the appropriate amount of time has passed, we need to deactivate the queue so that the hub releases its lock on the files.
  1. Open hub configuration on the primary hub
  2. Click the Queues tab
  3. Uncheck the Discovery_Harvest queue checkbox
  4. Click Apply to save the configuration
  5. Click Yes to restart the hub
At this point, you will need to access the server?s file system to compress the files.? This exact location may vary depending on operating system and installation location. ?For this example we will use the standard installation location on a Windows hub.
  1. Browse to C:\Program Files (x86)\Nimsoft\hub\q
  2. Right click on the Discovery_Harvest folder
  3. Click Send To
  4. Click Compressed (zipped) Folder
The file may be too large to attach to the case.? Your support engineer will work with you on transferring this file to us.

Once you have gathered the messages and sent them to support, it will be necessary to delete the temporary queue you made.
  1. Open hub configuration on the primary hub
  2. Click the Queues tab
  3. Highlight the Discovery_Harvest queue
  4. Click the Delete button
  5. Click Apply to save the configuration
  6. Click Yes to restart the hub
Your hub configuration is now returned to its original state.

?