Error "No X11 DISPLAY variable was set" during AAI Headless Upgrade

Products

• Automation Analytics & Intelligence

Issue/Introduction

The AAI upgrade fails with a Java graphics error when running on a server without an X11 display. This occurs when the installer defaults to GUI mode because the headless (silent) configuration properties are missing or incorrect.

ERROR MESSAGE: "net.sourceforge.tahini.InterfaceLoadingException: Could not instantiate: javax.swing.JFrame" "Caused by: java.awt.HeadlessException: No X11 DISPLAY variable was set"

SYMPTOMS:

• Upgrade script terminates immediately with "Java returned: 1"

• Stack trace shows SelectJawsInstallationMain failure

Cause

This can occur if the upgrade.properties file is misconfigured in the [Upgrade_Dir]/install/properties/ directory

Resolution

1. Delete or move the existing upgrade.properties file and areate a new ugprade.properties file in the[Upgrade_Dir]/install/properties/ directory

 

2. Enter only the lines below in the file, using the actual path to your AAI installation directory

Example upgrade.properties file when using an SQL Server or PostgreSQL database

jaws.existing.dir=/opt/Automation_Analytics_Intelligence

jaws.upgrade.caution.reviewed=true

jaws.upgrade.auto=true

Example upgrade.properties file when using an Oracle database

jaws.existing.dir=/opt/Automation_Analytics_Intelligence

jaws.upgrade.caution.reviewed=true

jaws.upgrade.auto=true

oracle.data.device.name=AAI_PROD_DATA

oracle.index.device.name=AAI_PROD_INDICES

 

3. cd to the [Upgrade_Dir] and run the command below to run the unattended upgrade again:

./upgrade.sh -a