Setting email options

You must enable email and configure email server settings before the Helix ALM License Server can send email. Email is sent when an administrator resets a user password or the user clicks the Forgot Password? link in a Helix ALM application. See Resetting user passwords.

1. Click Server Options.

The Server Options dialog box opens.

2. Select the Email category.

3. Select Enable sending emails to enable sending email from the license server.

4. Select a Protocol to use to send email.

5. Enter the information for the selected protocol.

  • Host — Host used to send outgoing mail. Enter an IP address (e.g., 123.34.5.26) or your mail server’s fully qualified domain name (e.g., mail.yourcompany.com).
  • SSL — SSL protocol to use to encrypt communication between the mail server and license server. You can use the Negotiate, STARTTLS 1.0, or TLS 1.2 protocols. Select <not set> if you do not want to use a secure protocol.
  • Port — Port number to use to send email. The default port is 465 if you select an SSL protocol and 25 if you do not.
  • Username and Password — Credentials if the SMTP host requires an authenticated login. Leave these fields empty if the host does not require authenticated login.
  • Tenant ID — Tenant ID for the Azure Active Directory that the license server is registered in.
  • Application ID — ID that Azure Active Directory assigned to the license server app registration.
  • Client secret — Client secret generated in Azure Active Directory for the license server app registration.
  • Azure AD authentication endpoint — Azure Active Directory authentication endpoint to acquire the appropriate token for each national cloud.
  • Microsoft Graph endpoint — Microsoft Graph API endpoint to access the Microsoft 365 platform.
  • Email address —Email account in Exchange Online that the license server uses to send email that cannot be sent for some reason. This is also known as the User Principal Name in Azure Active Directory.

6. Click Test Connection to validate the connection to the email server.

The Connection Test Results dialog box opens. If the test connection fails, you can copy and paste the text into an email or text file and send it to your system administrator for help.

7. If you are experiencing problems, select the following options to help with troubleshooting.

  • Only send one message per SMTP connection sends one message per connection. Enable this option if the license server error log contains entries stating 'The SMTP host’s reply code to the MAIL command was 503' or an entry stating 'only one MAIL per message'. This option is only available if you are using the SMTP protocol to send email.
  • Pause sending stops sending email. Make sure you clear this option as soon as the problem is resolved because outgoing mail will back up in the queue.
Most mail servers have strong security, which may affect sending email from the license server. Many servers require advanced authentication to execute a send mail command. Some servers may restrict some send mail types, such as multiple recipient sends and multiple send requests per SMTP connection. In some cases, virus scanners may add wrappers to an email, which can change the email to a point where the send mail commands it initiates are no longer recognizable by SMTP standards.

If you experience problems sending email, check the license server log. See Viewing the server log. If you know the specific SMTP error code, search the knowledgebase using the code for troubleshooting information.