The Email Action failed to complete

Eclipse Forms shows the error “The Email Action failed to complete” when there was potentially a problem with sending an email. Check other errors around the same time to determine the cause of the failure.

Note that this error might be shown even though the email was able to send.  If preceded by the error “Dynamic Picture cannot convert”, the email most likely was sent out, but it might be missing a logo or signature image.

How do I troubleshoot outbound email on Linux?

Check which MTA is being used

First, determine which mail transfer agent (MTA) you are using. Currently, Eclipse Linux servers are configured using the postfix MTA. If you are running an older system, you may be using the sendmail MTA. To determine which MTA you are running, use the following command:

ls -l /etc/alternatives/mta

If the command returns a link to “/usr/sbin/sendmail.postfix”, your system is configure to use postfix. If it returns a link to “/usr/sbin/sendmail.sendmail”, your system is configured to use sendmail.

Check the SMTP relay server

Next, verify that your system is pointing to the correct SMTP relay server.

For systems using postfix, the command is:

grep ^relayhost /etc/postfix/

For systems using sendmail, the command is:

grep ^DS /etc/mail/

Check the mail logs

Once you have confirmed that the MTA is relaying to the correct SMTP server, the next step is to check the email service logs. To view the last 10 log messages and monitor the file, run:

tail -f /var/log/maillog

Check the mail queue

Once you have checked the mail logs, the next step is to check the mail queue for pending and differed email messages.


Tell Postfix to process the queue now

postqueue -f

Delete all queued mail

postsuper -d ALL

Send a test message from the command line

To send a test message from the Linux command line, use the following command (replace with your email address):

echo test | mail

If you don’t receive your email, check the logs (see above) for error messages.

Send a test message from Eclipse

In a separate Eterm or Solar window, try sending an email. If you don’t receive the message, check the logs (see above). Make note of any error messages, such as “relay denied” or “cannot connect to SMTP server.” These messages are the best source for determining which element in the email service architecture is incorrect. In our experience, most issues are related to incorrectly configured SMTP relay servers, or SMTP servers that do not allow relay from the Eclipse server.

How do I disable Adobe Acrobat from displaying registration prompts?

Adobe Acrobat has an annoying tendency to present registration or EULA prompts when launching the software. This is a mere annoyance to a regular user, but it can completely hang the Eclipse Forms PDF generation process and cause email and PDF archives to fail.

To prevent the issue from occurring, reinstall Acrobat using the following procedure:

  • Verify your Acrobat serial number.
  • Deregister and uninstall Acrobat.
  • Reinstall Acrobat manually using the following command (replace C:\DFG\Acrobat\AcroStan.msi with the appropriate path to the Acrobat .msi installer):
  • The Acrobat installer will launch. Enter the customer name and serial number when prompted and complete the installation.
  • Launch both Acrobat and Distiller, and you shouldn’t be presented with prompts for the EULA or registration.

How do I configure sendmail to relay outbound email under Linux?

  • Install prerequisite packages:
yum -y install sendmail-cf
  • Open the configuration file /etc/mail/ for editing
  • Locate the section below and uncomment the SMART_HOST line:
dnl # Uncomment and edit the following line if your outgoing mail needs to
dnl # be sent out through an external mail server:
dnl #
dnl define(`SMART_HOST', `smtp.your.provider')dnl
  • Configure appropriately, like below:
define(`SMART_HOST', `')dnl
  • Apply the changes and refresh sendmail:
make -C /etc/mail/
service sendmail reload

How do I forward root’s mail to another email address?

It may be useful to create an alias for the root user’s email address, so that another user or group of users receives important system messages.

  • Open the /etc/aliases file for editing
vim /etc/aliases
  • Append a line to the bottom redirecting mail to an external email address
root:           dawit. gebru
  • Refresh the aliases database