Relevant Product: Signature Manager Exchange Edition
WARNING! The following products were discontinued on 30 September 2022:
- Exclaimer Signature Manager Outlook Edition
- Exclaimer Signature Manager Exchange Edition
The end of Support for these products is 30th September 2024.
For more information, please see the Discontinued Questions and Answers page.
Scenario
You have installed Exclaimer Signature Manager Exchange Edition on your Microsoft Exchange server and configured signature policies to append a signature to messages submitted to the server.
However, when you send a message from your email client (Microsoft Outlook, OWA, mobile device, etc.) you find that either the wrong signature is applied, or there is no signature at all.
Resolution
In this situation, we advise the following checks:
- Multiple Microsoft Exchange servers
- The policy tester
- Signature formats
- Network service permissions
- The Exclaimer event log
- The Exclaimer Signature Manager Exchange Edition Routing Agent
Multiple Microsoft Exchange servers
If you have more than one Microsoft Exchange server capable of processing messages, ensure that Signature Manager Exchange Edition is installed on all servers.
If the sent message is submitted to a server where Signature Manager Exchange Edition is NOT installed, no signature will be appended.
Signature Manager Exchange Edition should be installed on any Microsoft Exchange server with the Hub Transport role (Exchange 2007/2010) or Mailbox role (Exchange 2013/2016) installed. This ensures that a signature is appended, irrespective of which Microsoft Exchange server the message is submitted to.
The policy tester
The Exclaimer console has a built-in Policy Tester, which allows you to define a message with particular properties (sender, recipients, subject, etc.) and test which signature policies would be applied.
To access the Policy Tester , open the Exclaimer console and select the Policy Tester branch in the navigation tree. Then, specify required properties and click the Run Test button.
Using the policy tester does not send a real message. Its purpose is only to show which policies are (and are not) applied, and why:
It also provides an example of the outputted message (on the Messages tab) to show how the email would look to the recipient if it was real.
If the policy tester shows that no policies, or the wrong policy, is applied, you should review any conditions, exceptions and other settings defined for the required policy to ensure that (a) it is defined correctly and (b) that the test message meets at least one of the required policy’s requirements.
Signature formats
To allow for the fact that email messages are received on a range of devices and email clients, signatures templates can (and should) be defined in three formats: HTML, Rich Text and Plain Text.
If the Policy Tester shows that a signature policy is applied, but the received message has the wrong signature applied, access the signature template that SHOULD be applied and ensure you have configured each of the three messaging formats. To do this:
1. Open the Exclaimer console
2. Select the required template and open it in the template editor
3. On the toolbar (above the Save and Close icon) you will see tabs for each of the three formats (HTML, Rich Text and Plain Text):
4. Click on each tab to create the template for that format.
Network service permissions
In order to apply any images defined in signatures for messages submitted to the server, the NETWORK SERVICE account needs access to those images.
This is because the Microsoft Exchange Transport Service (on the computer where Signature Manager Exchange Edition is installed) runs under the NETWORK SERVICE account.
If the NETWORK SERVICE account does not have sufficient permissions to access required images, they cannot be appended to messages. In practice, this could result in a failure at run time so, to avoid this, the message is delivered with no signature appended.
To configure required permissions for the NETWORK SERVICE account, please see instructions in this Knowledge Base article.
The Exclaimer event log
If the Policy Tester shows that the message should have a policy applied, but a real message test results in no signature being applied, use the Exclaimer Event Log to see how the message was processed by Exclaimer.
To access the Exclaimer Event Log, open the Exclaimer console and click the Status link in the Actions pane:
The Windows Event Viewer is displayed, with the Exclaimer branch selected:
Here, every message submitted to the server will have a separate event logged, at the time the message was submitted to the server.
Using properties of the message that you wish to investigate (date, time, subject, sender, etc.) you can locate the entry for that message in the event log and see how Exclaimer processed it. Depending on the circumstances, an error event may be logged (error messages can vary), or it may be an information event such as that no policy was applied or that a policy was applied.
In some instances, there might be no event logged for the message; typically, this indicates that the message was processed on another Exchange server.
The Exclaimer Signature Manager Exchange Edition Routing Agent
If the Exclaimer Signature Manager Exchange Edition Routing Agent is not installed or is disabled, messages will not be processed by Exclaimer when they are submitted to the server.
To view the list of installed Routing Agents on the Microsoft Exchange server, run the following command in the Exchange Management Shell:
Ensure that the Exclaimer Signature Manager Exchange Edition Routing Agent is present and that it is not disabled:
If the Exclaimer Signature Manager Exchange Edition Routing Agent is disabled, run the following command to enable it:
Afterwards, restart the Microsoft Exchange Transport service to complete the changes.
If the Exclaimer Signature Manager Exchange Edition Routing Agent is not listed, uninstall Exclaimer Signature Manager Exchange Edition and then reinstall it (by downloading the latest Setup.exe from here).
During the uninstall and reinstall process, the Exclaimer configuration is retained and unchanged. No server reboot is required but the Microsoft Exchange Transport service be restarted.