Configuring Email Support and Email Notification

This topic assumes that you have the Server Administration Tool open that you have selected and logged onto the server configuration that you want to change. If you are using the client (available with custom installations only), you can administer remote server configurations only.

  1. Click Tools > Administration > Configure Server .
    The Configure Server page opens.
  2. Select the Email tab.
  3. Check the option to Enable e-mail support.
  4. Type the host name for your SMTP (Simple Mail Transfer Protocol) server in the SMTP server field.

    You can use an IP address if your site uses only static IP addresses. The application uses SMTP, which traditionally operates over TCP using port 25. It is widely used and is the Internet’s standard host-to-host mail transport protocol.

    Note: For Microsoft Windows environments, the Exchange server is usually the SMTP server.
  5. Optionally, type a value in the TCP/IP endpoint field if your SMTP server uses a port other than the default value, 25.
  6. For secure ports, select either SSL or TLS.
  7. If you want to use e-mail notification, check the option to Enable e-mail notification.
  8. If you selected SSL or TLS, you have additional Security Settings:
    1. SMTP Certificate Name
      Name of certificate file to be used for the secure connection. This setting is required on Windows only .
      StarTeam Server will look for certificates in subfolder: install path\CACertificates. You should place the certificates in this folder. On Microsoft Windows, two certificates are pre-installed:
      Equifax
      EquifaxCA.pem - This certificate is useful to connect to GMail SMTP server.
      Verisign
      VeriSignClass3PublicPrimaryCA.pem - This certificate is used to connect to Yahoo SMTP server.
    2. SMTP HostName
      SMTP Hostname as it appears in the SMTP server’s certificate. If the hostname in the certificate does not match with the entered one, we will write a warning to the server log similar to: 62 00000002 2016-02-19 10:30:18 SMTP TLS Unrecognized certificate: error code=13 and error message: Certificate name does not match. Hostname not matching is a potential security issue: if the hostname in the certificate is not the expected one, there could be a "man-in the middle" security attack - this means another site is impersonating the SMTP server.
    3. SMTP Logon Name, SMTP Password
      These are the credentials to be used to login to the SMTP server. These are optional, they should be entered if the SMTP server requires them.
  9. Click OK.
Parent topic: Email Support Notifications