Error when trying to change user avatar (picture) on Octane installed on Linux systems

  • KM03286743
  • 13-Nov-2018
  • 09-Oct-2019

Summary

Changing the user avatar fails when ALM Octane is deployed on a Linux machine if the DISPLAY environment variable is not configured correctly.

Error

When trying to change the user avatar (picture), it fails when ALM Octane is deployed on a Linux machine.

The UI displays a “General error occurred” message, and the following error appears in the app.log file (default path: /opt/octane/log/nga/app/app.log):

java.awt.AWTError: Can't connect to X11 window server using '<host>:<port>' as the value of the DISPLAY variable.

 

Note: this applies to all All ALM Octane versions prior to 12.60.27.


 

 

Cause

 The DISPLAY environment variable is not configured correctly.

Fix

Follow the instructions below:

  1. Navigate to the ALM Octane wrapper.conf file. The default path to this file is /opt/octane/wrapper/wrapper.conf
  2. Add the following line:
    wrapper.java.additional.99=-Djava.awt.headless=true
  3. Restart ALM Octane