Configuring a mail server


TrueSight Server Automation jobs can generate an email upon their completion. To enable this capability, you must configure a mail server. If you do not want to use email notifications, this mail server configuration is not required. TrueSight Server Automation supports email communication over Simple Mail Transfer Protocol Secure (SMTPS). You must select SMTPS to use authentication. Authentication over SMTP IIRC is not supported.

Do the following:

  1. Start the Application Server Administration console as described in Starting-the-Application-Server-Administration-console.
  2. Run the following command to view the blasadmin parameters for configuring the mail settings:
    show email all
  3. Configure the following blasadmin parameters:

    Parameter

    Description

    Command example

    fromaddress

    Specify the email address to be used for sending the system-generated email.

    set EmailConfig fromaddress test@gmail.com

    smtpserver

    Specify the host name or IP address of the SMTP server. If you want to use a non-default port, specify that port along with the host name. For example, <host_name>:3465
    To use the default ports (25 for the SMTP server and 465 for SMTPS), do not specify anything after the host name.

    set EmailConfig smtpserver test123:3465

    techsupport

    Displays the email address for technical support.
    Note: This parameter is a read-only parameter.

    -

    New in 20.02.01useSecure

    Set to true to enable email communication over SMTPS. Else, the email communication occurs via SMTP.

    set EmailConfig useSecure true

    New in 20.02.01 username

    Specify the user name.

    set EmailConfig username test_user

    New in 20.02.01password

    Specify the password for the user.

    set EmailConfig password testpassword
  4. Restart the Application Server.

Important

  • You must configure a mail server for all the Application Servers that run jobs. Otherwise, email delivery might be intermittent. The email delivery works only when a job is run on the Application Server with the correct emailconfig settings.
  • SMTP with STARTTLS is not supported.

Importing the certificate of the SMTPS server

To prevent certificate-related warnings while accessing the SMTPS server, you must import the CA-signed certificate chain for the SMTPS server into TrueSight Server Automation.

Do the following:

  1. Obtain the SMTPS server certificate.
  2. Log in to the system where TrueSight Server Automation is installed.
    • (Windows) Log in as an administrator.
    • (Linux) Log in as a root user.
  3. Navigate to the path where the keytool is located.
  4. Run the following command to import the certificate:
    (Windows)

    <path_to_keytool>\keytool -import -trustcacerts -keystore <BladeLogic_install_path>\NSH\jre\lib\security\cacerts
    -storepass <password> -noprompt -alias <cert_name> -file <certificate_from_email_Server>.crt

    (Linux)

    <path_to_keytool>/keytool -import -trustcacerts -keystore <BladeLogic_install_path>/NSH/br/java/lib/security/cacerts"
    -storepass <password> -noprompt -alias <cert_name> -file <certificate_from_email_Server>.crt
  5. Similarly, import the other certificates from the certificate chain.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*