Error "Can't connect to X11 window server" during AAI upgrade

Products

• Automation Analytics & Intelligence

Issue/Introduction

When attempting to upgrade AAI the upgrade fails with a Java AWT error indicating a connection failure to the X11 window server․ This issue typically occurs when performing an upgrade on a headless server without a display variable set, or when the upgrade.properties file is missing required configuration for an unattended upgrade​​​​​​​‍​.

ERROR MESSAGE: "[java] Exception in thread "main" java.awt.AWTError: Can't connect to X11 window server using ':0.0' as the value of the DISPLAY variable."

SYMPTOMS:

• Upgrade script terminates prematurely

• Log contains: "Property ${jaws.existing.dir} has not been set"

• GUI installer attempts to launch but fails

 

Environment

AAI 

Linux without x11

Cause

The installer attempts to launch a GUI by default․ If the X11 DISPLAY variable is not set and no upgrade.properties file exists to trigger a silent/headless upgrade, the Java process fails to initialize the graphics environment․ Additionally, the error Property ${jaws.existing.dir} has not been set confirms the installer could not locate the existing installation path․

Resolution

 

• The error indicates the X11 variable is not set which is required for the upgrade unless you are trying a unattended upgrade.

   

  The ' characters around the executable and arguments are
  not part of the command.
       [java] Exception in thread "main" java.awt.AWTError: Can't connect to X11 window server using ':0.0' as the value of the DISPLAY variable.
   
   
  It also shows that the AAI installation directory was not set, which I do not see in the upgrade.properties file:
   
  Property ${jaws.existing.dir} has not been set
   
   
  If you have x11 installed on the server please set the x11 display variable and try the upgrade again.
   
   
  If you are trying to do a headless upgrade, create a new upgrade.properties file in the <upgrade_bundle_dir>/install/ directory.
   
  Then just put the fields below in the files depending on your database type:
   
   

  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

   

  jaws.existing.dir would be your current AAI install directory.

  For Oracle you will also need the name of the DATA and INDICES tablespaces.