Configuring Sentinel E-mail

Sentinel email configuration settings are stored in the execution.properties file during installation. This file can be edited after installation. This file is on the machine where DAS is installed and is located:

For Windows:

%ESEC_HOME%\config

For UNIX:

$ESEC_HOME/config

There are two scripts (*.sh for UNIX and *.bat for Windows) that change and test the email settings within the execution.properties file. The mailconfig.* script changes the email settings and the mailconfigtest.* script tests the email settings. The bolded areas are the email settings that can be changed.

The properties within execution.properties are:

mail.authentication.user=<domain\\user>

 

correlated events retry wait=5000

 

mail.smtp.host=<SMTP_HOST>

The SMTP host that will be used to send email.

mail.events.max=1000

Maximum number of events that will be sent in an email that is automatically triggered by the correlation engine. Its purpose is to limit the size of emails for correlated events that have a very large set of trigger events.

correlated events retry count=10

 

mail.address.from=<SMTP_FROM_ADDR>

The email address that appears in the From field of the email sent from DAS.

mail.authentication.password=<password>

password for mail.authentication.user.

The mailconfig.sh and mailconfig.bat scripts use the following arguments:

-host

SMTP host name or IP address

-from

From field of the email

-user

The mail authentication user

-password

Password for the mail authentication user

NOTE: Do not enter your password after the –password argument. You will be prompted for a new password after you enter the command. The console output will be masked by asterisks (*).

The mailconfigtest.sh and mailconfig.bat file use the following arguments:

-to

Destination email address

To set email properties in the execution.properties file:

  1. On the machine where you have DAS installed, go to:

For UNIX:

$ESEC_HOME/bin

For Windows

%ESEC_HOME%\bin

  1. Execute mailconfig as follows:

For UNIX:

./mailconfig.sh -host <SMTP Server> -from <source email address> -user <mail authentication user> –password

For Windows:

mailconfig.bat -host <SMTP Server> -from <source email address> -user <mail authentication user> -password

UNIX example:

./mailconfig.sh -host 10.0.1.14 -from my_name@domain.com -user my_user_name –password

Windows example:

mailconfig.bat -host 10.0.1.14 -from my_name@domain.com -user my_user_name –password

After entering this command you will be prompted for a new password.

Enter your password:*********

Confirm your password:*********

NOTE: When using the password option, it must be the last argument.

To test your email settings in the execution.properties file:

  1. On the machine where you have DAS installed, go to:

For UNIX:

$ESEC_HOME/bin

For Windows

%ESEC_HOME%\bin

  1. Execute mailconfigtest as follows:

For UNIX:

./mailconfigtest.sh -to <destination email address>

For Windows:

mailconfigtest.bat -to <destination email address>

If your mail is sent successfully, you will get the following on screen output and e-mail received at the destination address.

Email has been sent successfully!

Check the destination e-mail mailbox to confirm receipt of email. The subject line and content should be:

Subject: Testing e-security mail property

This is a test for e-security mail property set up. If you see this message, your e-security mail property has been configured correctly to send emails