From c54e92f76f1137ae9b2bd3aa33b2c35961658d57 Mon Sep 17 00:00:00 2001 From: Josh Date: Thu, 18 Jan 2024 21:06:43 -0500 Subject: [PATCH] Fix(email_configuration): Fix conflicting debug mode sections `mail_smtpdebug` was being described in two places, one of which was incomplete (it didn't note the requirement to also change `loglevel` to `0`... leading to confusion). * Removes the inaccurate spot and moves the accurate one into its place so there are no longer two debug logging sections. Signed-off-by: Josh --- .../email_configuration.rst | 37 ++++++++----------- 1 file changed, 15 insertions(+), 22 deletions(-) diff --git a/admin_manual/configuration_server/email_configuration.rst b/admin_manual/configuration_server/email_configuration.rst index 2aba730b7..6ed906ed8 100644 --- a/admin_manual/configuration_server/email_configuration.rst +++ b/admin_manual/configuration_server/email_configuration.rst @@ -259,12 +259,24 @@ of the Admin settings page. Troubleshooting --------------- -If you are unable to send email, try turning on debugging. Do this by enabling -the ``mail_smtpdebug`` parameter in ``config/config.php``. +Enabling debug mode +""""""""""""""""""" + +If you are unable to send email, it might be useful to activate further debug +messages by enabling the ``mail_smtpdebug`` parameter and temporarily setting your NC loglevel to DEBUG: :: - "mail_smtpdebug" => true; + "mail_smtpdebug" => true, + "loglevel" => 0, + +Be cautious setting your ``loglevel`` to DEBUG (``0``) since it'll apply to everything occurring on your NC instance, not just email. +And don't forget to set it back to a more reasonable level when you're done troubleshooting: + +:: + + "mail_smtpdebug" => false, + "loglevel" => 2, .. note:: Immediately after pressing the **Send email** button, as described before, several **SMTP -> get_lines(): ...** messages appear on the screen. @@ -396,25 +408,6 @@ All emails keep getting rejected even though only one email address is invalid. Partial sending, i. e. sending to all but the faulty email address is not possible. -Enabling debug mode -------------------- - -If you are unable to send email, it might be useful to activate further debug -messages by enabling the ``mail_smtpdebug`` parameter and temporarily setting your NC loglevel to DEBUG: - -:: - - "mail_smtpdebug" => true, - "loglevel" => 0, - -Be cautious setting your ``loglevel`` to DEBUG (``0``) since it'll apply to everything occurring on your NC instance, not just email. -And don't forget to set it back to a more reasonable level when you're done troubleshooting: - -:: - - "mail_smtpdebug" => false, - "loglevel" => 2, - .. note:: Immediately after pressing the **Send email** button, as described before, several **SMTP -> get_lines(): ...** messages appear on the screen. This is expected behavior and can be ignored.