Home » Categories » Multiple Categories

PHPMailer - Troubleshooting Using Debug Logging

Overview

This KB article explains how you can enable debug logging with the PHPMailer to troubleshoot SMTP mail sending problems.

The PHPMailer is used in Nagios Fusion and Nagios XI for sending emails using SMTP. If your system is configured for Sendmail then this KB article does not apply to you.

 

Enable Debug Logging

To enable debug logging you need to edit the class.phpmailer.php file and define the following:

public $SMTPDebug = 2;

By default the value is set to 0.

The following commands will make that change for you:

Nagios Fusion

cd /usr/local/nagiosfusion/html/includes/utils/phpmailer/
sed -i 's/public \$SMTPDebug.*/public \$SMTPDebug = 2;/g' class.phpmailer.php

Nagios XI

cd /usr/local/nagiosxi/html/includes/phpmailer/
sed -i 's/public \$SMTPDebug.*/public \$SMTPDebug = 2;/g' class.phpmailer.php

 

Proceed to the next section to view the debug output.

 

View Debug Output

To view the debug output you need to send a test email.

Nagios Fusion

Open the Nagios Fusion web interface and navigate to Admin > System Configuration > Email Settings.

Click the Send a Test Email button which will then take you to the Test Email Settings page.

Here you need to click the Sent Test Email button.

 

Nagios XI

Open the Nagios XI web interface and navigate to Admin > System Config > Manage Email Settings.

Click the Send a Test Email button which will then take you to the Test Email Settings page.

Here you need to click the Sent Test Email button.

 

The output generated from the test will be placed as raw text at the top of the page, here is an example:

 

 

You can see in the screenshot above that there was an authentication issue. The output you see on your screen will be different and you can use that output to further troubleshoot your SMTP problems. Please refer to the following link for troubleshooting resources:

Troubleshooting PHPMailer Problems

 

 

Disable Debug Logging

When you no longer require the debug logging you will need to disable it by editing the class.phpmailer.php file and define the following:

public $SMTPDebug = 0;

 

The following commands will make that change for you:

Nagios Fusion

cd /usr/local/nagiosfusion/html/includes/utils/phpmailer/
sed -i 's/public \$SMTPDebug.*/public \$SMTPDebug = 0;/g' class.phpmailer.php

Nagios XI

cd /usr/local/nagiosxi/html/includes/phpmailer/
sed -i 's/public \$SMTPDebug.*/public \$SMTPDebug = 0;/g' class.phpmailer.php

 

 

Final Thoughts

For any support related questions please visit the Nagios Support Forums at:

http://support.nagios.com/forum/

0 (0)
Article Rating (No Votes)
Rate this article
  • Icon PDFExport to PDF
  • Icon MS-WordExport to MS Word
Attachments Attachments
There are no attachments for this article.
Related Articles RSS Feed
Nagios XI - NSP: Sorry Dave, I can’t let you do that
Viewed 11898 times since Tue, Jan 27, 2015
Nagios XI - Integrating On-Call Schedules with Nagios - NWC13
Viewed 2783 times since Tue, Feb 9, 2016
Nagios XI - Configuring Core Contacts to Use XI’s phpmailer SMTP Settings
Viewed 3473 times since Wed, Jan 27, 2016
Nagios XI - Managing Mobile Carriers
Viewed 1174 times since Wed, Jul 19, 2017
Nagios XI - Empty Screen for Wizard, Component, Dashlet
Viewed 3947 times since Wed, Jan 27, 2016
Nagios XI - MRTG Reports SNMP_Session Errors
Viewed 2569 times since Wed, Jul 27, 2016
Nagios XI - Unable to Delete Host
Viewed 9512 times since Tue, Dec 16, 2014
Installation errors on customized corporate builds of CentOS or RHEL
Viewed 8478 times since Tue, Jan 26, 2016
Nagios XI - SQL Error [nagiosxi] : ERROR: syntax error
Viewed 1863 times since Sun, Sep 10, 2017
Nagios XI - CentOS 6 Installation Problems XI 2011R1.7 2011R1.8
Viewed 2895 times since Tue, Feb 2, 2016