Board Mailer Service

Board Support
Board Support Employee
500 Likes Photogenic
edited January 18 in Support Articles

Functionality

The Mailer is the service responsible of sending emails when using the Board functionalities of Broadcasting, Subscription and Send-To.

To activate it, it is necessary to configure the correct parameters within the following files located in the Board Web Server file system:

  • Broadcasting.config
  • Mailer.config

How to Configure It

Broadcasting.config

C:\Program Files (x86)\Board\Board WebApi Server\App_Data\config

The file contains the following fields:

Key name

Function

Mandatory

<add key="internalSmtpAddress" value="board-com.mail.protection.outlook.com"/>

FQDN of SMPT server used to send automatic emails.

X

<add key="internalSmtpPort" value="25"/>

Port used by the SMTP server

X

<add key="internalSmtpEnableSsl" value=""/>

Flag to enable/disable SSL encryption. Accepted values: true or false.

X

<add key="mailerUsername" value=""/>

User used to authenticate on SMTP server

<add key="mailerPassword" value=""/>

Password of SMTP server user

<add key="workingFolder" value="C:\Program Files (x86)\Board\Board WebApi Server\App_Data\broadcasting"/>

Physical folder on the web server where temporary files are generated before being sent as attachments in the emails

X

<add key=" mailerSender " value=""/>

Email sender address that will be displayed in the received emails

<add key =" pollingMinutes " value="" />

Frequency (in minutes) at which the broadcasting service checks if there are requests to be processed

Mailer.config

Path: C:\Program Files (x86)\Board\Board WebApi Server\App_Data\config\mailer.config

Key name

Function

Mandatory

<add key="webUrl" value="http://localhost:80/"/>

is the URL used by Web Clients to access Board, as set in the key “host” of the file C:\Program Files (x86)\Board\Board WebApi Server\App_Data\config \appSettings.config like in the example below

X

<add key="watchPath" value="C:\Program Files (x86)\Board\Board WebApi Server\App_Data\broadcasting"/>

it contains the files that Board Mailer Service will attach to emails and must be the same path set as WorkingFolder in broadcasting.config

X

<add key="logFolder" value="C:\Program Files (x86)\Board\Board WebApi Server\App_Data\broadcasting"/>

Board Mailer Service log folder

X

In case you deploy Board through IIS (here), please remember to move the Board Mailer Service accordingly, removing it from the standard path

You need to:

  1. uninstall the Board WebAPI Engine if still installed
  2. restart the Server
  3. open the CMD with the "run as administrator" option
  4. execute this command"C:\Windows\Microsoft.NET\Framework\v4.0.30319\installutil.exe" “C:\inetpub\wwwroot\BoardWeb\Bin\Board.Mailer.Service.exe"where "BoardWeb" is the name of your phisical folder of the website.
  5. check that the Board Mailer Service has been moved to the new path and start it