Setting up DS-Client Notifications
Creation Date: April 28, 1997
Revision Date: March 21, 2008
Product: DS‑Client (Windows)
Summary
DS‑Client can be configured to send email or pager notifications in the event of a critical backup failure. In addition, DS‑Client can regularly send mail with a summary of backup activities (during Admin processes).
DS-Client notifications can be SMTP or MAPI.
Messaging Service Setup
Restrictions
The delivery of notifications is provided by 3rd‑party mail clients installed on the DS‑Client computer and registered with the Windows Messaging Subsystem (MAPI). By design, MAPI and most mail clients cause their client applications to pop up dialog boxes to interact with a user. Because DS‑Client is an unattended service software, it would hang if it displays a dialog. Therefore, DS‑Client will only use compatible mail clients known to never display a user interface. Such mail clients are listed in the order of preference in the Registry value
[HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\DS‑Client\Parameters]
MailClientsSupported
The entry for Microsoft Outlook is added to this list during the installation process. DS‑Client will use the first MailClientsSupported entry installed on the computer, i.e. listed under:
[HKEY_LOCAL_MACHINE\Software\Clients\Mail]
NOTE: DS‑Client is not compatible with the Outlook Express mail client.
Restrictions Specific to Windows
The normal procedure for sending email in Windows is as follows. The client application places the message in the Outbox of a message store provider, the latter notifies the MAPI Spooler, the Spooler dispatches the message to the appropriate transport provider based on message recipients and, finally, the transport provider takes over message delivery.
Since Microsoft overlooked security and identity issues in designing the MAPI Spooler, it cannot properly work with client applications that are services. For instance, the Spooler may not be able to access Mail Profiles due to incorrect security context, and may not receive new message notifications from a message store provider by way of window messages (every service runs in its own virtual desktop and window messages do not propagate between desktops). Because DS‑Client runs as a service on Windows, it must not use the MAPI Spooler. This means DS‑Client notifications will forever remain in the Outbox of the message store provider unless the latter is tightly coupled to a transport provider, so that the two can work out between themselves how to send the message without the intervention of the MAPI Spooler.
At this time, only the Microsoft Exchange Server mail client is known to offer tightly coupled message store and transport.
To use DS‑Client with non‑tightly coupled transports, such as Internet Mail, you can force DS‑Client to use the MAPI Spooler by setting the Registry value
[HKEY_LOCAL_MACHINE \ System \ CurrentControlSet \ Services \ DS‑Client \ Parameters]
MailUsingSpooler
to a nonzero DWORD value. Keep in mind that such use is not supported by Windows architecture and errors are bound to ensue. Make sure no other MAPI client applications are executed on the DS‑Client computer.
How to Create a Mail Profile for DS‑Client
1. Create a mail account on the mail server for use by DS‑Client.
2. Log on to the DS‑Client computer using the <<DS‑Client service account>>.
If the DS‑Client computer is running Windows, it is the account found in the Services Control Panel.
3. Ensure that you select the correct domain when logging on.
4. While you are logged on with the DS‑Client service account, install your mail client (if not already installed) and use it to create a new (or edit an existing) Mail Profile.
a) Add to the Mail Profile a messaging service that includes a tightly coupled message store and transport, such as
Microsoft Exchange Server, and configure this messaging service to use the mail account created in step
1.
b) Specify a message store added in step
a as the default message store.
c) Move transports added in step
a to the top of the transport order.
d) Specify the default address book of your choice.
e) Save the Mail Profile, start a mail application, configure it to use the Profile just created, and proceed to send a test message.
Notes
• We strongly recommend using SMTP notifications.
• Certain mail clients (e.g. Eudora Mail) may replace the MAPI Stub Library (MAPI32.DLL) with a version that does not support the Extended MAPI interface. If this happens, reinstall Microsoft Outlook.