EducationSoftwareStrategy.com
StrategyCommunity

Knowledge Base

Product

Community

Knowledge Base

TopicsBrowse ArticlesDeveloper Zone

Product

Download SoftwareProduct DocumentationSecurity Hub

Education

Tutorial VideosSolution GalleryEducation courses

Community

GuidelinesGrandmastersEvents
x_social-icon_white.svglinkedin_social-icon_white.svg
Strategy logoCommunity

© Strategy Inc. All Rights Reserved.

LegalTerms of UsePrivacy Policy
  1. Home
  2. Topics

KB36591: How to troubleshoot failed Administrative Notification emails in MicroStrategy Distribution Services


Stefan Zepeda

Salesforce Solutions Architect • Strategy


KB36591: How to troubleshoot failed Administrative Notification emails in MicroStrategy Distribution Services.

Delivery email notifications are designed to alert administrators when subscriptions have problems. However, sometimes, those delivery notification emails themselves have problems. When this happens the following steps can be taken to attempt to locate the cause of why the notification emails are not being received:
 
Check the settings at the Project level
To do this, right click on a project in Desktop, and select Project Configuration. On the left side under Categories, find deliveries, and check the settings for each type of delivery.
 

ka04W000001IwdRQAS_0EM440000002Dib.png

 
Make sure the email address specified here is correct and that the notification is turned on.
 
 
Check the Transmitter for Email
Delivery notifications use the default 'Email' transmitter provided out of the box. In order to check this object, log into a 3-tier project source, then go to Administration > Delivery Managers > Transmitters.
 
Editing the transmitter will display the email addresses used for the From and optional Reply-to fields specified when sending the notification emails. Some mail servers have access controls that prevent certain email addresses from sending mail. Ensure that the addresses specified here are valid.
 

ka04W000001IwdRQAS_0EM440000002Did.png

 
On the 'Message Output' tab, check and verify that the transmitter is configured to actually send the email by ensuring the option 'Send messages to recipients via SMTP' is checked. If this option is not checked, then no emails will be sent over the network.
 

ka04W000001IwdRQAS_0EM440000002DiZ.png

 
 
Check the settings for the Generic email Device
The device used by all delivery notifications is the default 'Generic email' device; this cannot be changed. Edit this device by connecting to a 3-tier project source, going to Administration > Delivery Managers > Devices.
 
If the network requires a mail relay server to be configured, ensure that the proper IP address or server name and port number are set under the 'Smart Host' section:
 

ka04W000001IwdRQAS_0EM440000002DiY.png

 
Also, try enabling 'Always use Smart Host' to ensure that this relay address is used. The smart host feature is used to designate a server through which all outgoing messages are routed. The smart host then makes the remote connection outside or inside the network as necessary. If a smart host is designated, Strategy transmits to the smart host server, instead of attempting to contact the domain of the email address specified at the project level. If a Smart Host, relay, server is used, check with the administrator of this machine to verify that there are not problems at this level which would be outside the scope of what the Strategy product can see.
 
 
Enable SMTP Tracing
If all of the above settings have been verified and emails are still not being delivered then detailed SMTP level tracing can be enabled.
 
This level of tracing will show what happens when Strategy tries to send the notification email. To turn this on, go to the Strategy Diagnosis Configuration (Strategy Diagnosis and Performance logging Tool) on the Intelligence Server machine. For 'Select Configuration' make sure that the 'CastorServer instance' option is selected. Under the 'Component' column find 'SMTPSender' and then locate the associated 'Trace' under 'Dispatcher'. Select a new file or existing log under 'File Log' to log this information to.
 

ka04W000001IwdRQAS_0EM440000002DiW.png

 
The output for the log will be similar to below:
 
 


Local machine domain: HOST
Processing destination domain: Strategy.com
Connecting to domain: Strategy.com
Connecting to ip address: 641.514.702.421
Establishing handshake via Hello on domain: Strategy.com
Checking recipients
Recipient address example@Strategy.com accepted
Sending email
Email sent. Waiting for acknowledge
Email send acknowledged

  
If the log shows no errors and records a successfully attempt, "Email send acknowledged", then the issue is most likely a network or mail server problem. If there is an error, the error should indicate what problem the mail server had with Strategy's delivery. Since Strategy always delivers emails the same way, there is most likely a problem with one of the settings or with the access controls on the mail server. In either case, take this log snippet to the mail server administrator to resolve the issue.
 
 
Send an Email Manually
An alternative approach to troubleshooting at the SMTP level, instead of using the SMTP trace, is to manually attempt to send an email from the command line. This will take all Strategy software out of the equation and is useful to confirm that the problem resides on the mail server or further down the network pipe. For details on how the follow this process is documented in the following Strategy Knowledge Base technical note:
KB11482: "How to deliver an e-mail manually for SMTP troubleshooting purposes?"
 


Comment

0 comments

Details

Knowledge Article

Published:

May 23, 2017

Last Updated:

March 19, 2020