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

Article:TECH48588  |  Created: 2006-01-25  |  Updated: 2015-02-19  |  Article URL http://www.symantec.com/docs/TECH48588
Article Type
Technical Solution


Issue



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


Solution



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.

Resolution:
  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

    For Windows Server 2003:
    a. Launch Computer Management
    b. Expand "Services and Applications"

    For Window Server 2008:
    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

    For Windows Server 2003:
    From Add/Remove Programs - Windows Components

    For Windows Server 2008:
    From Server Mananger - Features - Remove Features
     
  6. Reinstall the message queues

    For Windows Server 2003:
    (Select 'Common', Active Directory will be selected by default, but is not needed - and causes a performance hit)

    For Windows Server 2008:
    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 up.
     
  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.

Supplemental Materials

SourceEvent ID
Value6655
Description

The process has failed abnormally and will not be restarted.


SourceEvent ID
Value6532
Description

Index reconstruction abandoned. Error accessing Microsoft Message Queue.


SourceEvent ID
Value6654
Description

Restarting failed process PID: %3 Exit Code: %4 The process has failed abnormally and will be restarted automatically



Legacy ID



284452


Article URL http://www.symantec.com/docs/TECH48588


Terms of use for this information are found in Legal Notices