Troubleshooting Mail Server Settings

Troubleshooting Mail Server Settings

Troubleshooting Mail fetching problems

After you configure the mail server, test the settings by fetching a sample mail. To do so, click the Fetch a sample mail button.



If the settings are configured right and the connection is successful, the oldest mail from your mailbox will be fetched, along with its properties. If not, an error message will be displayed on the screen.

In SupportCenter Plus, mail fetching problems can be categorized as follows:

  • Incorrect username or password.

  • Unable to reach host.

  • Unable to connect to the mail server. Check the configurations and try again.

  • Invalid certification path to target. Configure trusted or self-signed certificate and try again.

  • Unable to open mailbox in READ/WRITE mode.

  • Unable to connect to the mail server. Check Server URL and try again.

  • Unable to save settings


For all the mail fetching exceptions, please check connectivity using the same configurations in other third-party mail clients like Outlook Desktop app and Thunderbird desktop app.


Authentication failed for the given username and password

  • Check whether the configured username and password are correct.

  • If the username and password are correct, check whether the mail server configurations are correct.

  • If the configured protocol is IMAP, the open concurrent IMAP connections could get exhausted sometimes. In such cases, an authentication exception is thrown intermittently (whenever the connection gets exhausted). Mail fetching will resume once an open IMAP connection becomes available. To know more, go to the link: Intermittent AuthenticationFailedException in IMAP protocol in SDP

If  there are no connectivity issues with third-party apps, and there are authentication issues only with SupportCenter Plus, go here.

 

Configured mail host name is unknown or not reachable (or) Unable to connect to the mail server with the provided configurations 

  • Check whether as mentioned, the configured server name is correct.

  • If the server name is correct, check whether the protocol configurations are correct.

  • The software/hardware firewall might be blocking the POP/IMAP port. If this is the case, please try after unblocking the port/try EWS (Exchange Web Services).

If you are able to connect to other third-party apps and unable to connect the mailbox through SupportCenter Plus server, go here.

Could not find valid certification path to requested target, kindly configure to apply Trusted/Self Signed Certificate

  • You are trying to establish a secure connection to your mail server (say POPS or IMAPS), but the certificate for connecting to that mail server is not present in the application (Java key store).

  • Download the file from the link given below and extract it to the SupportCenter Plus Home directory:

For Linux:

For Windows:

  1. https://downloads.zohocorp.com/dnd/SupportCenter_Plus/o_1af360niepdjr7j1flk1o323fa1/wincertgeneration.zip  

  • Run the extracted batch file (Windows / Linux based on your server's operating system) from the command prompt using the syntax given below:

  • Syntax :

For Windows - gencert.bat <hostname>:<port>

E.g. cmd> gencert.bat sdpexchange.com:995

For Linux - sh gencert.sh <hostname>:<port>

E.g. sh gencert.sh sdpexchange.com:995

  • The server will send the available certificates in the command prompt. You will be asked to enter the certificate number to proceed further. On supplying the certificate number, a file called jssecacerts is generated in the SupportCenter Plus Home Directory (if the file is already present, this certificate will be appended to it).

  • Copy the jssecacerts file to jre\lib\security folder and restart SupportCenter Plus application.

  • Save the settings and test the mail connection.

If you still face the issue after applying the certificate, click here.

Unable to open mailbox in READ/WRITE mode

  • The user might not have write access to the mailbox.

  • Please get the appropriate write access for the mailbox from your Administrator. The write access is necessary to delete the mails from your mailbox after it is fetched.

 

Unable to connect to the mail server. Check server URL and try again.

  • The connect URL for EWS might be incorrect. Correct the connect URL. To know the EWS URL for your Exchange Server go to the link below:

Get to know your Exchange Web Services URL (Connect URL)

 

Troubleshooting Mail Sending problems

To check the mail server connectivity, send a sample email by entering a mail address and clicking on the Send a sample mail button in the outgoing tab.


If the settings are configured right and the connection is successful, a sample mail will be sent to given the email address. If not, an error message will be displayed on the screen.

The common exceptions that occur in SupportCenter Plus while sending mails can be categorized as follows:

  • Incorrect username or password.

  • Unable to reach host.

  • Unable to connect to the mail server. Check Connect URL and try again.

  • Unknown error occurred.

 Incorrect username or password

  • Verify if the configured username and password are correct.

  • Check your mail server configurations (protocol, TLS, port).

  • Configure the account using a third-party mail client and send a sample email to the same account. If the credentials are correct, you will be taken to the welcome page. If not, the alert prompt will be displayed repeatedly.

Note: If you are using SMTP/STMPS, do not check your account configurations using Outlook Web Access as it works with the MAPI protocol. If you are using Exchange Web Services, open the connect URL in an incognito window.

If you are still unable to login with your credentials, click here to debug your email and send a log report for analysis.

 

Unable to reach host

  • Check if the configured server name is correct.

  • If the server name is correct, check if the protocol configurations are correct. If you are using Exchange Web Services, ensure the connect URL is correct. To find your Exchange Server URL, go to this link.

  • If you are using SMTP/SMTPS, the software/hardware firewall might be blocking the SMTP/SMTPS port. If this is the case, unblock the port or try EWS (Exchange Web Services).

If the error persists, click here to enable email debugging and send a log report for analysis.

Unable to connect to the mail server. Check connect URL and try again.

  • The connect URL for EWS might be incorrect. Correct the connect URL. To know the EWS URL for your Exchange Server, go to the link below:

Get to know your Exchange Web Services URL (Connect URL)

 

Unknown error occurred

  • If you are using Exchange Server and SMTP protocol (SMTP+TLS), ensure that your Exchange Server's certificate is updated in SupportCenter Plus. To apply for the Exchange Server certificate, go here. If you are using EWS, you need to apply certificate in SupportCenter Plus unless you are using Self-Signed Certificate in your Exchange Server. To apply EWS certificate in SupportCenter Plus, go here. If you are using Office 365, you need not apply certificate.

If you are using SMTP/SMTPS, check if you are allowed to send mail to the entered address. To relay outside your Mail server domain, you will need permission. Contact your IT Administrator on this.

If  there are no connectivity issues with third-party apps, and there are authentication issues only with SupportCenter Plus, enable email debugging and mail the logs for analysis:

To debug your emails, check the Enable Email Debug box and save the settings.

 


  • Re-create the issue to populate the debug prints in the logs.

  • The debug prints will be saved in the logs folder in the application server. For e.g. In Windows, the logs folder will be present in C→ManageEngine→SupportCenter→logs.

  • Zip the logs folder.

  • Mail the zipped folder to support@supportcenterplus.com for analysis. 

Unable to save settings

Mail throttling limits are evaluated for each application ID and mailbox combination. SupportCenter Plus prevents users from configuring the same Client ID and Reply Email for both Incoming and Outgoing Mail Server Settings in the same SupportCenter instance or across instances.

To use the same mailbox in both Incoming and Outgoing Mail Server Settings, create a separate application (with different client ID).

 

Refer to microsoft documents for more details about throttling limits in Microsoft Graph API.

 

    • Related Articles

    • Incoming Mail Server Settings

      Configure your organization's mail server to receive and process incoming emails. You can use email protocols (POP, IMAP, POPS, or IMAPs), Exchange Web Services (EWS), or Microsoft Graph to connect SupportCenter Plus with the mailbox. Role Required: ...

    • Outgoing Mail Server Settings

      Configure your organization's mail server to send emails. Outgoing mail server settings must be configured to trigger email notifications for the following settings. Two-Factor Authentication Backup Scheduling Security Settings Performance Settings ...

    • Mail Fetching Troubleshooting

        1. Unable to fetch mails into SupportCenter Plus as the ports are being blocked by Firewall/Antivirus. 2. Is it important to configure an SSL Certificate to use POPS/IMAPS for fetching mails? 3. Authentication and Configuration Errors: Settings ...

    • Mail Server Configuration

      Mail server configuration is essential to receive requests via email, send notifications, surveys etc. This is a portal-specific configuration. To configure a mail server, go to Admin > Main Settings > Mail Server Settings. Configuring Settings for ...

    • OAuth Authentication for Mail Server

      Introduction   OAuth is a standard authorization protocol that provides delegated access to a protected resource using web tokens instead of passwords. With OAuth, resource owners can configure separate permissions for each client requesting access ...