Setting email sending options

You must enable email and configure email server settings before users or the Helix ALM Server can send email.

1. Click Server Options. You can also choose View > Server Options.

The Options dialog box opens.

2. Select Sending from the Email category.

3. Select Enable sending mail via Simple Mail Transport Protocol to send email via SMTP.

4. Enter the SMTP information.

  • Enter the 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).
  • Select the SSL protocol to use to encrypt communication between the mail server and Helix ALM Server. You can use the Negotiate, STARTTLS 1.0, or TLS 1.0, 1.1, or 1.2 protocols. Select <not set> if you do not want to use a secure protocol.
  • Enter the Port number. The default port is 465 if you select an SSL protocol and 25 if you do not.
  • Enter a Username and Password if the SMTP host requires an authenticated login. Leave these fields empty if the host does not require authenticated login.

5. 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.

6. If you are experiencing SMTP 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 Helix ALM 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'.
  • Pause sending via SMTP stops sending email via SMTP. Make sure you clear this option as soon as the problem is resolved because outgoing mail will back up in the queue.

7. Click OK to save the changes.

Note:  Most mail servers have strong security, which may affect sending email from Helix ALM. 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 Helix ALM Server log. See Working with the server log. If you know the specific SMTP error code, search the knowledgebase using the code for troubleshooting information.