×
 
 
  •  
$helper.renderConfluenceMacro('{bmc-global-announcement:$space.key}')

This documentation supports the 20.02 version of Remedy Action Request (AR) System.

To view an earlier version, select the version from the Product version menu.


Remedy Action Request System 20.02 ... Troubleshooting Troubleshooting Remedy Email Engine

Troubleshooting Email Engine service failover issues

AR System Email Engine uses the Service Failover feature to handle high availability and to distribute the Email Engine workload across multiple servers. If Service Failover is not configured correctly, one or more mailboxes might not run.

If you are unable to resolve issues with Service Failover after following these guidelines, create a  BMC Support case.

Related topics

Contacting Support

Issue symptoms

  • Email Engine is not sending or receiving emails.
  • Email Engine is stuck in a Suspended state.
  • The wrong server is running Email Engine.

See also Resolutions for common issues.

Issue scope

  • One or more users experience the problem.
  • One or more mailboxes experience the problem.
  • One or more servers are not running Email Engine correctly.
  • In a Server Group environment, the symptoms could affect one or more servers.

Diagnosing and reporting an issue

TaskActionStepsReference

1.

Check the AR system Service Failover Whiteboard form.

  1. By using a browser client, query the AR system Service Failover Whiteboard form to make sure that all your enabled mailboxes are Active on one server.



  2. If all your mailboxes are active, proceed to Task 3.
NA
2.

Check the AR system Service Failover Ranking form to make sure that all your mailboxes are correctly ranked.

By using a browser client, query the AR system Service Failover Ranking form to make sure that all your mailboxes are ranked on the correct Email Engine servers.

Important: All the mailboxes should be ranked. The mailbox ranking happens automatically as each Email Engine starts up for the first time.

NA

3. 

Check the AR system Server Group Operation Ranking form to make sure that the Service Failover operation is correctly ranked.

By using a browser client, query the AR system Server Group Operation Ranking form to make sure that the Service Failover operation is correctly ranked.

It must be ranked number 1 for the primary server that coordinates the mailboxes across the different Email Engine servers according to the Service Failover ranking.

NA

4. 

Restart the Email Engine servers.

Restart all Email Engine servers that are ranked number 1 for at least one mailbox, which causes the Email Engine to re-read the Service Failover information.

NA

5. 

Collect the logs.

From each server that you restarted the Email Engine on, collect the Email Engine log including the .bak log file, if it exists.

  • Windows: <ARSystem Install Dir>\AREmail\Logs\email.log
  • UNIX: <ARSystem Install Dir>/AREmail/Logs/email.log
NA

6.

Collect Email Engine diagnostics.

  1. Download and run the Email Engine Utility.
  2. Collect the testUtil.log file.

Email Engine Test Utility Open link

7.

Analyze the logs.

  • Review the common issues to identify possible symptoms and solutions.
  • If you cannot resolve the problem, create a BMC Support Case.


Resolutions for common issues

8.

Create a BMC Support Case.

  • Collect and send logs and detailed information when you create a case with BMC Support.
  • Collect and send screenshots of the Service Failover forms.
  • Attach a ZIP file, maximum size of 2 GB to your case. You can also upload the file on FTP.
NA

Resolutions for common issues

Symptom

Where

Action

Reference

You cannot connect to the mail server.

 email.log

Use the Email Engine Test Utility to test connection settings.

Email Engine Test Utility Open link

Mailbox is not active.

Whiteboard form

Make sure that the Service Failover operation is ranked in the AR system Server Group Operation Ranking form and that the mailbox is ranked in the AR system Server Failover Ranking form.

NA

Mailbox does not show up in the AR system Service Failover Ranking form.

Service Failover Ranking form

  1. From the Email Engine installation directory, edit the emaildaemon.properties file, and make sure that the following lines are included correctly:
      • com.bmc.arsys.emaildaemon.servers=RemedyProd1.bmc.com
      • com.bmc.arsys.emaildaemon.RemedyProd1.bmc.com .RPC=0
  2. Restart the Email Engine.

NA



Was this page helpful? Yes No Submitting... Thank you
Last modified by Ashwini Sawanth on Nov 08, 2022
unrestored-unknown-attachment

Comments

Log in or register to comment.

Temporary directories and files
Troubleshooting Remedy Approval Server
© Copyright 1991-2021 BMC Software, Inc. © Copyright 1991-2021 BladeLogic, Inc.
Legal notices

Powered by Atlassian Confluence and Scroll Viewport

© Copyright 2005-2024 BMC Software, Inc. Use of this site signifies your acceptance of BMC’s Terms of Use . BMC, the BMC logo, and other BMC marks are assets of BMC Software, Inc. These trademarks are registered and may be registered in the U.S. and in other countries.