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:
On the machine where you have DAS installed, go to:
For UNIX:
$ESEC_HOME/bin
For Windows
%ESEC_HOME%\bin
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:
On the machine where you have DAS installed, go to:
For UNIX:
$ESEC_HOME/bin
For Windows
%ESEC_HOME%\bin
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