How to reinstall Microsoft Message Queues (MSMQ) on a system running Enterprise Vault

How to reinstall Microsoft Message Queues (MSMQ) on a system running Enterprise Vault

Article: 100017680
Last Published: 2021-05-24
Ratings: 4 0
Product(s): Enterprise Vault


How to reinstall Microsoft Message Queues (MSMQ) on a system running Enterprise Vault


This may be necessary if the message queues stop responding to Enterprise Vault, e.g. due to Permission errors, corruption in the MSMQ's, or the MSMQ service fails to start.

  1. Confirm that the Message Queues are empty and determine the MSMQ storage location (See NOTE 1 below)
    Log in as the Vault Service Account (VSA)

    a. Launch Server Manager
    b. Expand Features
    c. Determine the location of the MSMQ files. Right-click, Properties of the icon Message Queuing.  Choose the Storage tab and make note of the storage locations.  Default is c:\windows\system32\msmq\.  
    d. Expand Message Queuing
    e. Expand Private Queues - check to make sure if these are empty. If not, then make sure you understand the ramifications of clearing the queues before doing so.
  2. Stop the Enterprise Vault services.
  3. Stop the Message Queuing service.
  4. Rename the old message queue directory to msmq_old
  5. Uninstall the message queue

    From Server Manger > Features > Remove Features
  6. Reinstall the message queues

    Add Features - Click the root check box for Message Queuing
  7. The Message queue service should automatically start, but if it is not started, start it.
  8. Confirm the newly created MSMQ directory exists.
  9. Restart the Enterprise Vault services
    a. The missing message queues will be recreated in Private Queues when the Tasks begin to process.
  10. Delete the msmq_old directory created earlier to reclaim disk space.
    No reboot should be necessary. 


NOTE: Since Journal mailboxes continually have messages to process, allowing the queues to empty cannot be realized with the Journal archiving task or EV services stopped. To allow the journal queues to empty, the following needs to be performed:

  1. Create a new user mailbox on the Exchange Mailbox server.
  2. Redirect all Exchange journaling from the existing mailbox to the new mailbox.
    Do not add the new journal mailbox as a Journal target in Enterprise Vault
  3. Once Exchange starts redirecting the messages to the new journal mailbox, the existing EV journal target will complete its archiving, thus allowing the message queues to empty.
  4. Once Message Queuing has been reinstalled on the EV server, you may either add the new mailbox as a journal target, or move all of the messages from the new mailbox to the previous mailbox that was listed as an EV journal target.


Was this content helpful?