How to use WHM for Email Troubleshooting

Part of being an administrator for a dedicated server is the need to maintain your email service. If you have a problem with email, there are tools provided with WHM that can help you determine where the problem is occurring. The following article describes the different tools provided by WHM to troubleshoot your email service.

Mail Delivery Reports

The mail delivery reports allow you to find and review messages sent from and received by your server. You can see the details for each message delivery as well as the details for each delivery attempt. You can filter the messages using month, day, or year. Note that your queries can only return a maximum of 1000 entries per type. Data for email is retained for 30 days. You can use this report to determine if mail is actually being delivered. You can also see the details on mail that fails to be delivered.

How to use the Mail Delivery Report

  1. Login to the WHM
  2. In the left-side menu pane, find Mail Delivery Reports under the Email section and click on it.
  3. Report inquiry form
     

    You will see the Report Inquiry form. Select the search term by typing in a search box. You can change the type data you’re looking for by clicking on the drop-down arrow. By default, it starts with Recipient. You can further refine the search by using the Search Type and Delivery type options.

     
  4. Select start and End date
     

    Select at Start and End date for the search.

     
  5. Click on run report
     

    Click on Run Report.

     
For more information on Mail Delivery Reports settings in WHM, please see the official documentation

.

Mail Queue Manager

When mail is delivered from your server, it may often be queued for delivery if there are a large number of emails being sent at once. Occasionally, email gets stuck in the queue and the service may need to be re-started in order for delivery to occur. The queue manager allows you view, deliver and delete messages in the queue.

How to use the Mail Queue Manager

  1. Login to the WHM
  2. Select Mail Queue Manager from the menu at left.
  3. Mail Queue Manager
     

    You can type in a search term in the Search box, and then narrow the filter to look for sender, recipient and message ID. You can further refine the search using the Search type.

     
  4. Select start and End date
     

    Select a Start and End Date.

     
  5. run report
     

    Click on Run Report.

     
  6. Mail Queue search results
     

    If your report finds anything in the queue, you will see them displayed in the table below. You can select each item (if there are multiple items) and then choose to Deliver or Delete the item in queue.

     
For more information on the Mail Queue Manager in WHM, please see the official documentation

.

Mail Troubleshooter

The Mail Troubleshooter allows you to trace the route that an email takes for delivery. This tool is often used for delivery problems.

How to use the Mail Troubleshooter in WHM

  1. Login to the WHM
  2. Select Mail Troubleshooter from the menu at left.
  3. Mail troubleshooter
     

    When the interface appears, you will see the small entry field labeled “Email to trace”. Type in the name of the email address you wish to trace. Click on Reset to clear the field.

     
  4. Click on SUBMIT button
     

    Click on Submit in order to begin the trace.

     

    Example of trace

     

    When the trace is complete you’ll see details for the delivery of the email. The details provides information on the servers for the recipient.

     
    For more information on the Mail Troubleshooter in WHM, please see the official documentation

.

Repair Mailbox Permissions

The option to repair mail box permissions is often used when an email account is inaccessible or there are problems with a email account working properly. This is often an issue with mail directly transferred to the server from another location. If this tool is unable to fix issue, then it is suggested that you contact our live technical support team or managed hosting support team for further assistance.

How to use the Repair Mailbox Permissions tool

  1. Login to the WHM
  2. Repair mailbox permissions
     

    Select Repair Mailbox Permissions in the menu at left

     
  3. Click on proceed
     

    Click on Proceed in order to run the tool.

     

View Mail Statistics Summary

Mail Statistics Summary

 

The Mail Statistics Summary includes 18 reports that can help immediately pinpoint issues with your mail server. When you enter this section you will see a link for each report. Each report is represented by a graph or table below the link list. These reports are good for providing a quick overview of the email server as it operates. You may need to select a specific report depending on the problem that you are troubleshooting. In order to see each report, simply click on the corresponding link.

 

View Relayers

This report allows you to see emails that have been relayed or forwarded within the time range that you select.

How to use the View Relayers report

  1. Login to the WHM
  2. View Relayers report
     

    Click on View Relayers in the menu at left.

     
  3. Select Start date and time
     

    Select a Start Date and Start time.

     
  4. Select End date and time
     

    Select an End Date and an End time.

     
  5. Click on Run Report.

View Sent Summary Report

The Sent Summary report allows you see the total number of message delivery attempts for each domain. You will see the results organized by successful and failed attempts. You will also see the total number of bytes sent by each domain.

How to use the View Sent Summary Report

  1. Login to the WHM
  2. View Sent Summary report
     

    Click on View Sent Summary in the menu at left.

     
  3. Select Start date and time
     

    Select a Start Date and Start time.

     
  4. Select End date and time
     

    Select an End Date and an End time.

     
  5. Click on Run Report
     

    Click on Run Report.

     

This concludes the tutorial on using WHM Delivery Reports for email. If you use your dedicated hosting server for serving email, then you using these reports will help you quickly confirm delivery, or receipt of emails from your server. If there’s a problem, you can use these reports to help you identify the source of the issues. If you are not able to resolve your email issues, then you should contact our live technical support team or the Managed Hosting team.

Learn more about email troubleshooting from our Managed VPS Hosting Product Guide. If you need to limit a sender’s emails per hour, refer to this guide on setting max emails per hour in WHM.

Get better performance and security with our VPS Hosting.
AC
Arnel Custodio Content Writer I

As a writer for InMotion Hosting, Arnel has always aimed to share helpful information and provide knowledge that will help solve problems and aid in achieving goals. He's also been active with WordPress local community groups and events since 2004.

More Articles by Arnel

Comments

It looks like this article doesn't have any comments yet - you can be the first. If you have any comments or questions, start the conversation!

Was this article helpful? Let us know!