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:
- Navigate to the ALM Octane wrapper.conf file. The default path to this file is /opt/octane/wrapper/wrapper.conf
-
Add the following line:
wrapper.java.additional.99=-Djava.awt.headless=true - Restart ALM Octane