Datazen SMTP Configuration

During my Datazen installation, I noticed I could not set an SMTP account which required authentication. (I’m using Office365, so outbound mail authentication is required.)

Below is a picture of the fields available during the install.

After installing the Datazen Enterprise Server, I was able to finish configuring the Datazen mail settings.

The only file we need to adjust is the Web.config. The file we need is <<install drive>>\Program Files\Datazen Enterprise Server\controlpanel\Web.config. (The default is C:\Program Files\Datazen Enterprise Server\controlpanel\Web.config)

I’m using Notepad++ to edit. After opening the file in Notepad++, the first thing I do is change the language to XML. This allows for color coding of the the XML. By default Notepad++ will make your elements names blue, your attribute names red, and your attribute values  purple.

Following the language change to XML, scroll towards the end of the file where you find the XML element <mailSettings>. The area will look something like this.

<system.net>
<mailSettings>
<smtp
from=“admin@yourorganization.com”>
<network host=“localhost” port=“25”/>
  </smtp>
</mailSettings>
</system.net>

Here are the changes we need to make:

  1. Change the smtp element from attribute “admin@yourorganization.com” to the address that you want to show up in the email. For me, this looked like DatazenServer@someaccount.com. This does not have to be the email address used to log on to your SMTP server unless your email admin requires.
  2. Inside the network element we need to change the host and port attribute values. Since I’m using Office365, the values will be “smtp.Office365.com” and “587” respectively.
  3. Still inside the “network” element we need to add some new attributes and values to the file. The attribute names are case sensitive.
    • Add userName=”DatazenServer@someaccount.com”
    • Add password=”S3cur3P@ssw0rd123$%”
    • Add defaultCredentials= “false” This forces Datazen to use the username and password that we supplied.
    • Add enableSsl=“true” For a secure connection to the SMTP server.
  4. Make sure the network element is closed with />. Don’t add another /> if you did not delete the original one while adding the new attributes.
  5. Make sure all of your attributes are inside double quotes.

When complete these steps your mail settings should look something like this.

<system.net>
<mailSettings>
<smtp
from=“DatazenServer@someaccount.com”>
<network host=“smtp.Office365.com” port=“587”
userName=”DatazenServer@someaccount.com” password=“S3cur3P@ssw0rd123$%” defaultCredentials= “false” enableSsl=“true” />
</smtp>
</mailSettings>
</system.net>

Save the file. Reboot the server OS for the setting to take effect.

And you’re done.

References:

Advertisements
Datazen SMTP Configuration