Running Multiple Dovetail Email Agent Services

A single Dovetail Email Agent service can poll for incoming email on one email box. It is common that multiple mailboxes need to be polled. For example: Poll the "support@company.com" mailbox, and process as freeform text. Poll the "clearsupport_interface@company.com" mailbox, and process using API Invoke mode.

The first service is installed by default when running the Dovetail Email Agent Setup program. Follow the steps below to run multiple Dovetail Email Agent services on the same server.

Warning: When one instance of the Dovetail Email Agent service sends an email to another instance of the Dovetail Email Agent service (running on the same machine or a different one), it can create an email loop where the two instances of Dovetail Email Agent will bounce responses back and forth forever. This can cause serious performance problems. To prevent this from occurring, each instance of the Dovetail Email Agent service has a unique identifier. When installing additional Dovetail Email Agent instances, you must set this identifier manually with the secServiceUniqueIdentifer parameter. For more information about the secServiceUniqueIdentifer parameter, go to the Dovetail Email Agent Configuration Parameters Reference section.

To setup a 2nd service on the same server

1. Create a new working directory for the 2nd service.
2. Copy all the files from the first installation directory into the new working directory.
   For example, copy all of the files from C:\Program Files\Dovetail Software\Email Agent to C:\Program Files\Dovetail Software\EmailAgent2
3. Run the email-agent-setup.bat script. This needs to be run from a DOS command prompt.

   Usage:

   email-agent-setup [/u] [/v] "servicedisplay" "servicename" "serviceemail" "emailhost" "pop3user"

   "pop3pass" "fromemail" "attachmentpath" "parsemode"

   NOTES:

   • Switches /u and /v are not required
   • When not using /u (uninstall), all parameters are required

   Please put double-quotes (") around parameters as shown in the example above

   Switch	Description
   /u	Uninstall Dovetail Email Agent in this folder (all further parameters and switches are not required)
   /v	Enable verbose log output of install/uninstall

   Parameter	Description
   servicedisplay	The display name of the server (appears in the Services applet, may contain spaces)
   servicename	The internal name of the service (must not contain spaces)
   serviceemail	The email address which will receive administrative notifications from Dovetail Email Agent
   emailhost	Email server (POP3 and SMTP) hostname or IP
   pop3user	POP3 mailbox username
   pop3pass	POP3 mailbox password
   fromemail	The email to use as the FROM address when sending out emails to customers. Use the format: "Display Name <email@address.com>"
   attachmentpath	The local or UNC path to use for storing incoming email attachments IMPORTANT: Do not put trailing slashes on the path.
   parsemode	1 = Freeform, 2 = API Invoke, 3 = EEO Redirect

   For example:

   email-agent-setup "emailagent2" "emailagent2" "clearsupport_interface@company.com", "my_mail_server", "login","password", "outgoing_from_address@company.com", "c:\attachments","2"

4. After the main install is complete, you will be prompted by the ConfigEditor to edit the database connection string. If this new service is going to use the same database instance as original service, click 'No'. Otherwise, click 'Yes' and edit the database parameters as necessary.
5. Once the install is complete, if you wish to set any of the additional configuration parameters, edit the Dovetail Email Agent configuration file (email-agent-config.xml).
6. Start the service.

Did this topic help you? Email us your feedback.
Last updated: 10/18/2007 3:34:48 PM
© by Dovetail Software, Inc.