Siebel Marketing Installation and Administration Guide > Installing and Configuring Email Marketing > Configuring Email Marketing Daemons >

Configuring the Bounce Handler Daemon

The Bounce Handler Daemon notifies the Marketing Component Group that it has processed asynchronous bounces and needs to pass these bounce details to the Marketing Component Group. This topic contains the information that you need to configure the Bounce Handler Daemon to communicate with the Marketing Component Group.

To configure the Bounce Handler Daemon, perform the following tasks:

• Verifying the Bounce Handler Daemon Installation
• Configure the From Address of the SMTP Envelope
• Configure the Click-Through Daemon HTTP Server Port

CAUTION:  During this process, do not start the Bounce Handler Daemon until told to do so. If you do accidentally start it, stop it immediately before proceeding.

Verifying the Bounce Handler Daemon Installation

To verify the installation was successful, you start the Bounce Handler Daemon and then perform installation tests. For information about testing how the Email Marketing components and the Marketing Component Group work together, see Final Test of Email Marketing Components.

To start the Bounce Handler Daemon on Windows 2000 Server

1. From the desktop, click Start and choose Settings > Control Panel.
2. In Control Panel, choose Administrative Tools > Services.
3. Right-click the bhd service and select Start.

To start the Bounce Handler Daemon on a UNIX server

1. Open a window and navigate to the Bounce Handler Daemon install directory.
2. Enter and run the following command:

   ./bin/bhd-ctl.sh start &

3. Optionally, you can enter and run the following commands:

   ./bin/bhd-ctl.sh start &; tail -f bhd.log

   NOTE:  The first command (./bin/bhd-ctl.sh start &) launches the daemon. The second command (tail -f bhd.log) displays output to the bhd log as it is running without generating a read lock on the file. A read lock would prevent these commands from working.

To verify the Bounce Handler Daemon installation

1. Verify that the Bounce Handler Daemon Windows Service or UNIX process is running and stays running without an error message.
2. Open the bhd_InstallLog.log file (found in the <bhd installation directory>) and read the Summary at the start of the file. Make sure it says that the installation was successful with no warnings or errors. If there are warnings or errors, you must identify the cause and fix the error.
3. Verify that a bhd.log file exists in the following directory:

   <bhd installation directory>\logs\bhd.log

4. Verify that the following text is in the bhd.log file:

   INFO ConnectTest Successfully connected to Siebel Server!

   INFO ConnectTest Logged out of Siebel.

5. Make sure there are no ERROR or WARN level messages in the bhd.log file.
6. From a command prompt window, telnet to the Bounce Handler Daemon SMTP port (25) (for example, telnet bhd.siebel.com 25), wait for a greeting, and then enter the word quit and press ENTER. Your telnet session then ends.

Configure the From Address of the SMTP Envelope

This section describes how to configure the hostname that you use to create the from address of the SMTP envelope. This from address is the email address that receives bounced emails. The hostname you use as the from address is the host name of the Bounce Handler Daemon.

To configure the SMTP envelope from address

1. Navigate to the Siebel Marketing login screen at the following location:

   http://<marketing application hostname>/marketing_enu

2. Log in as the server administrator.
3. Navigate to Administration - Marketing screen > Servers.
4. In the Servers list, in the Name field, query for Email Marketing Server.
5. In the parameters list, in the Value field, update the values as shown in the following table:

   Parameter Type	Value
   Bounce Handler Daemon (BHD)	<bhd server hostname>