Error: An unexpected error occurred in AWI due to SSO configuration typo

Products

• CA Automic Workload Automation - Automation Engine

Issue/Introduction

When accessing the Automic Web Interface (AWI) URL, users encounter a generic error message before the login page appears. Additionally, the option to select a Login Type (e.g., AutomationEngine or SAML) is missing from the interface on specific nodes.

Symptoms

• User sees the following error in the UI: Error: An unexpected error occurred. Further details are available in the logfiles.
• The Login Type dropdown menu is missing or blank.
• Clearing browser cache provides only temporary relief or does not resolve the issue.
• The issue may occur on one AWI node but not others in a load-balanced environment.

Environment

• Automic Web Interface (AWI) 24.x+
• Apache Tomcat
• SSO/SAML Configuration enabled

Cause

A typographical error exists in the configuration.properties file on the affected AWI node, specifically within the SSO configuration string. This prevents the AWI from correctly initializing the login components.

Resolution

1. Log in to the affected AWI server.
2. Navigate to the configuration directory: ####/apache-tomcat/webapps/awi/config/.
3. Open the configuration.properties file in a text editor.
4. Locate the SSO configuration parameters.
5. Verify the spelling of all keys and values (e.g., ensure sso is not misspelled).
6. Correct any typos and save the file.
7. Restart the Apache Tomcat service to apply changes.
8. Verify the AWI login page now displays the expected Login Type options.