Error Email Notification

Description

Metadefender Email can send a notification to the Administrator if unexpected events occur, such as loss of connection to Metadefender Core, Mail Sever/Gateway or queue build ups.

For a complete list of notifications please see Mail Agent Alerts.

Location

The tool is called configNotification.exe and is shipped with the installer.

The default location will be C:\Program Files (x86)\OPSWAT\Metadefender Core <x>\Metascan Quarantine

Run

If you run configNotification.exe -h you will be able to see the help info:

configNotification.exe -h
Usage: configNotification.exe [OPTIONS]
Example: configNotification.exe -t All -s administrator@opswat.local -r administrator@opswat.local --orgRecipients --debug
 
Options:
-t, --type=NOTIFICATION TYPE
[REQUIRED] the NOTIFICATION TYPE you wish to change
Possible values:
All -> Enables all notifications (errors,
blocked, sanitized, quarantined)
QuarantinedEmail -> Enables the notification
which is triggered when an email is
sent to Quarantine
QuarantinedFile -> Enables the
notification which is triggered when a file is
sent to Quarantine
Blocked -> Enables the notification which is
triggered when an email is blocked by Mail Agent
Sanitized -> Enables the notification which is
triggered when an email is sanitized by Mail Agent
OnlyErrors -> Enables the error notifications
NonErrors -> Enables the non-error notifications
(blocked, sanitized, quarantined)
-s, --sender=SENDER EMAIL
[REQUIRED] the SENDER EMAIL from where the
notification(s) will be sent
-r, --recipients=RECIPIENT EMAIL(S)
[REQUIRED] if notification type is
All/OnlyErrors otherwise [OPTIONAL]
The RECIPIENT EMAIL(S) where to send
the notification(s)
For non-errors email notifications,
when this parameter
is not set, the notification will be sent
to both original sender and recipient(s)
Note: multiple email addresses can be separated
by comma
--orgSender
[OPTIONAL] applicable only to non-errors notifications
If this option is set the notification will be sent to
the original sender of the email that triggered the
notification
--orgRecipients
[OPTIONAL] applicable only to non-errors notifications
If this option is set the notification will be sent to
the original recipient(s) of the email that triggered
the notification
-u, --url=ENDPOINT
[OPTIONAL] the url ENDPOINT where Quarantine is located
if it is not on the same machine
--https
[OPTIONAL] use https
--disable
[OPTIONAL] disable the specified notification(s)
--debug
[OPTIONAL] show debug info
-h, --help
[OPTIONAL] show help

If you run the tool on the machine where Mail Agent is installed and HTTPS is not enabled

configNotification.exe -t OnlyErrors -s administrator@opswat.local -r administrator@opswat.local

If you run the tool on the machine where Mail Agent is installed and HTTPS is enabled

configNotification.exe -t OnlyErrors -s administrator@opswat.local -r administrator@opswat.local -https

If you don't run the tool on the machine where Mail Agent is installed

configNotification.exe --t OnlyErrors -s administrator@opswat.local -r administrator@opswat.local -u http://<mail_agent_ip>:8000/Quarantine/EmailAlerts

Troubleshooting

If you encounter any problems running the tool, please run with "-d" option so you can get debugging information:

configNotification.exe -t OnlyErrors -s administrator@opswat.local -r administrator@opswat.local -d

Example, if the problem is an invalid email address:

configNotification.exe -s this.isnot.valid -d
 
There was a problem updating email alerts: Invalid email address. You need to specify a valid email.
System.Exception: Invalid email address. You need to specify a valid email.

This information will help us further investigate the problem.