Board Mailer Service

Board Support
Board Support Employee
5 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