Troubleshooting Aeon Client Slowness

Print Friendly and PDF Follow

This article will provide troubleshooting information to help identify and resolve issues that may be causing slowness in the Aeon Client when loading forms, processing requests, or performing other functions.

Routing Rules Syntax | Addons | Z39.50 Search | Old Staff User Accounts | High Memory Usage by Other Applications

Possible Issue #1 - Routing Rules Syntax

Your routing rules configured in the Aeon Customization Manager under the Routing tab may cause performance issues in the Aeon Client if they:

  • Contain SQL syntax errors leading to increased memory usage in the Client
  • Contain Match Strings using subselects to query a large amount of data

Common SQL Syntax Errors

Small errors in punctuation that cause increased memory usage and lead to slowness issues may go unnoticed as they generally do not cause the rule to break. Therefore, it is a good idea to review all of the routing rules you have configured to ensure that they do not contain any of these common errors:

Error 1: Missing Quotation Marks

Closing quotation marks should be placed at the end of a string of text:

Incorrect Syntax Corrected Syntax
t.DocumentType = 'Default
t.DocumentType = 'Default'

Error 2: Missing Parentheses

Closing parentheses should be placed at the end of a list:

Incorrect Syntax Corrected Syntax
t.DocumentType in ('Default', 
t.DocumentType in ('Default', 

Error 3: Using Double Quotes

Single quotation marks should be used instead of double quotation marks:

Incorrect Syntax Corrected Syntax
t.DocumentType = "Default"
t.DocumentType = 'Default'

Possible Issue #2 - Addons

When a request form is opened, any active addons with an Auto Search feature configured will search and wait for a return of results before displaying the form. If a large number of these addons are installed, more time may be needed to process and return the search results, leading to slowness in displaying the request form. To troubleshoot this issue:

  • Staff should go to Manage > Addons in the Aeon Client and set the Active status of any unused addons to No
  • On the same screen, check each Active addon to see if any have an AutoSearch setting and consider turning this off if the addon's search results are not regularly accessed

Third-Party Addons

If error handling is not coded into an addon, this will cause it to experience "memory leaks" that increase the memory used by the Client and lead to slowness issues. Atlas does not support user-created addons. Please contact us at for a custom services quote if you need assistance with troubleshooting or rewriting a third-party addon that may be causing performance issues. You may also consider finding the addon's creator in the Addon Directory and reaching out directly for assistance. 

Possible Issue #3 - Z39.50 Search

If the Z39.50 interface is used and an automatic Default Search has been configured for its search profile in the Aeon Customization Manager, consider if this search is producing too many results and affecting the time it takes to load the request form in the Client. For example, since a Default Search on the Keyword parameter is not very specific and may return many unnecessary results, you can try setting the Default Search to Title instead.

If staff members are not using the Z39.50 search results, make sure the Default Search is set to [Not Specified] in the Customization Manager so that the search is not occurring for each request opened in the Client. 

Possible Issue #4 - Old Staff User Accounts

Perform a review of your staff user accounts in the Aeon Staff Manager and consider removing any old or unused accounts. Each staff user account is associated with a set of layout records that tell the Client how to display each Client form as it opens. Each time any staff user opens a form in the Client, the Client must query all staff layout records to find the right one to use. If old staff accounts are still present, the number of layout records that the Client has to query will be unnecessarily large and may lead to slowness issues displaying forms. Removing old staff accounts is also a best practice to avoid the chance of security issues. 

To delete a staff user:

  1. Open the Aeon Staff Manager
  2. Within the Users tab, click on the entry in the grid for the account you'd like to delete
  3. Click Remove
  4. Click Yes in the Confirm Delete User popup to confirm your decision
  5. Repeat for all unused staff accounts
Removing old user accounts from Staff Manager does not remove any of the Notes or History entries from any requests/items that the user processed.

How to remove a staff user from the Staff Manager

Possible Issue #5 - High Memory Usage by Other Applications

In some cases, slowness issues in the Aeon Client may be caused by other applications running on your workstation. For example, web browser applications such as Google Chrome or Firefox may use an excessive amount of the available memory on your computer if a large number of tabs are left open in your browser window(s). To troubleshoot this issue:

  1. Open the Task Manager application on your computer
  2. Within the Processes tab, review the memory usage of your currently running applications
  3. Close applications using an excessive amount of memory. If the application is a web browser, close any unnecessary tabs open in your browser window
  4. Check to see if the Aeon Client still experiences slowness issues after the tabs/application(s) are closed


If this article didn’t resolve your issue, please contact Atlas Support for assistance:

Contact Support