How do I configure an e-mail server for notifications?

Purpose

Use this procedure to configure connection information for an e-mail server. The e-mail feature may be used to contact NSP users, send alarm notifications as configured in an alarm policy, or provide notifications of scheduled Analytics reports.

You can configure only one e-mail server in an NSP deployment.

Steps
 
1 

Sign in to the NSP as an administrator.

2 

On the NSP banner bar, click User, Settings.

3 

Click E-mail Server Configuration on the navigation panel.

4 

Configure the parameters listed in the following table.

Parameters

Notes

E-mail server address

IPv4 address, hostname, or FQDN of e-mail server

An e-mail server with an IPv6 address must use a hostname or FQDN.

A hostname or FQDN must be DNS resolvable.

Port number

TCP listening port on e-mail server

E-mail address

Sending e-mail address of e-mail notifications

Username and Password

Authentication credentials for e-mail server

Protocol

E-mail authentication protocol

The SMTP option is not secure. In order to enable secure e-mail notifications using the SMTPS or STARTTLS option, you must:

  • Ensure that the mail server TLS certificate is specified in the trustedCertificates parameter in nsp-config.yml:

    /opt/nsp/NSP-CN-DEP-release-ID/NSP-CN-release-ID/config/nsp-config.yml

    Example:

    trustedCertificates: ["/opt/certs/mail.pem", “/opt/certs/otherCert.pem”, “/opt/certs/otherCert.pem”]

    Where trustedCertificates specifies a comma-separated list of paths to certificate files. The above example includes the path to the mail.pem mail server TLS certificate.

  • Run config/deploy on the NSP deployer VM to install the mail server certificate on the system:

    # /opt/nsp/NSP-CN-DEP-release-ID/bin/nspdeployerctl install --config --deploy ↵

5 

The Test and Test Email to Current User functions are highlighted when the e-mail server configuration is updated.

Perform one or more of the following, as required.

  1. To send a test message to the specified e-mail server and address, click Test.

  2. Click Test Email to Current User to send a test message to the currently logged in user. Such an action is recommended to verify successful e-mail delivery before turning on the global Verify Email setting in Users and System Security.

6 

Click Save when you have finished changing settings.

End of steps