Troubleshooting Mimecast MSO Fixes for Exchange Environments

How to Fix Mimecast MSO Issues: Step-by-Step Guide

This guide walks through diagnosing and resolving common Mimecast MSO (Mimecast Services for Outlook) issues in Microsoft Exchange/Outlook environments. Follow the steps in order; perform each step fully before moving on.

1. Symptoms to confirm

• Outlook add-in missing or not loading
• Emails not routing through Mimecast (bounces, non-delivery reports)
• MSO toolbar buttons disabled or greyed out
• Slow Outlook performance or crashes when MSO is enabled

2. Gather basic information

• Environment: Exchange on-premises or Exchange Online (Office 365)
• Outlook versions: list affected clients (Windows/macOS, build numbers)
• MSO version: Mimecast for Outlook add-in version(s) from affected clients
• Error messages/logs: screenshot or copy exact text from NDRs or Outlook errors
• Recent changes: updates, policy changes, certificates, CNAME/DNS edits

3. Check service and network basics

1. Verify Mimecast service status: Ensure Mimecast platform shows normal operation (admin portal status).
2. DNS records: Confirm MX, CNAME, and SPF records required by Mimecast are correct and propagated.
3. Network connectivity: From affected clients, test connectivity to Mimecast endpoints (ping/traceroute and HTTPS to https://login.mimecast.com and service IPs).
4. Proxy/firewall: Ensure proxy or firewall allows required Mimecast ports (HTTPS/443) and IP ranges. Bypass proxy for testing if possible.

4. Validate authentication and SSO

• If using SSO/SAML, confirm identity provider tokens are valid and not expired.
• Test login to Mimecast Administration Console using affected credentials.
• Renew any expired certificates used for SSO or API integrations.

5. Inspect Exchange/Mail flow settings

• Transport rules and connectors: Ensure inbound/outbound connectors to Mimecast are present and match Mimecast documentation.
• Recipient limits and policies: Check for routing rules that might bypass Mimecast.
• Queue and retry status: In Exchange, inspect queues for messages stuck trying to route to Mimecast; note error codes.

6. Fix Outlook/MSO add-in problems

1. Confirm add-in deployment: If deployed via Microsoft 365 admin center or Group Policy, ensure deployment completed and manifests are correct.
2. Re-register COM add-in (Windows Outlook):
   • Close Outlook.
   • Run Command Prompt as admin and re-register Mimecast DLLs per Mimecast instructions (e.g., regsvr32 where applicable).
3. Clear Outlook cache and restart: Use Outlook safe mode (outlook.exe /safe) to test if other add-ins conflict.
4. Repair Office installation: Use Settings > Apps > Microsoft Office > Modify > Quick Repair.
5. Reinstall Mimecast for Outlook: Uninstall via Control Panel, reboot, install latest MSO package from Mimecast Downloads.

7. Check Mimecast client configuration and policies

• Policy sync: From the Mimecast Administration Console, confirm policies assigned to users are correct and not blocking mail flow.
• Client authentication tokens: Remove cached tokens and force re-authentication in MSO settings if sign-in issues persist.
• Update signatures and settings: Ensure client-side settings match server-side configurations.

8. Review logs and diagnostic files

• Collect Mimecast client logs (from affected workstation) and Exchange transport logs.
• Use Mimecast diagnostic utilities (if provided) to run health checks.
• Search logs for common errors: authentication failures, TLS/SSL handshake errors, 4xx/5xx SMTP responses.