Oracle WebLogic Configuration Wizard Freezes on Linux

During an Oracle Fusion Middleware 14.1.2 upgrade, I encountered an issue while reconfiguring an existing Oracle ADF domain. The WebLogic Configuration Wizard launched successfully through SSH X11 forwarding, but the graphical interface became unresponsive during the reconfiguration.

There was no obvious error message, and the wizard could not proceed.

The solution turned out to be a single Java parameter.

The Fix

Before launching the Configuration Wizard, disable the Java 2D XRender pipeline:

export _JAVA_OPTIONS="-Dsun.java2d.xrender=false"

Then launch the wizard:

$ORACLE_HOME/oracle_common/common/bin/config.sh -log=/u00/app/oracle/product/14c/reconfig_logs/oid_domain_20261019/reconfig_oid_domain_20261019.log -log_priority=ALL

In my environment, this resolved the issue immediately.

Why Does It Work?

Java graphical applications use different rendering pipelines on Linux, including X11 and XRender.

XRender is a Java 2D rendering pipeline that uses the X Render extension to accelerate certain graphical operations.

However, in remote graphical environments using SSH X11 forwarding, compatibility problems between the JVM, XRender, and the X server can sometimes cause graphical applications to freeze or become unresponsive.

Setting:

-Dsun.java2d.xrender=false

disables the XRender pipeline, allowing Java 2D to fall back to the traditional X11 rendering pipeline.

This avoids the problematic rendering path without modifying the Oracle installation or domain configuration.

Confirming the Fix

Initially, I tested two Java parameters together:

export _JAVA_OPTIONS="-Dsun.java2d.xrender=false -Dsun.java2d.opengl=false"

The wizard worked, but it was unclear which parameter made the difference.

During the reconfiguration of another domain, I repeated the test using only -Dsun.java2d.xrender=false.

The Configuration Wizard worked correctly again.

This confirmed that disabling XRender alone was sufficient in this environment. Disabling OpenGL was unnecessary.

Oracle Already Documents This Behavior

After resolving the issue, I checked Oracle’s official Java documentation and found that this behavior is already documented.

In its Java 2D Properties on Linux documentation, Oracle describes the sun.java2d.xrender property and explains that setting it to false disables the XRender pipeline and falls back to the basic X11 pipeline.

This is exactly the behavior we wanted to achieve:

-Dsun.java2d.xrender=false

Oracle does not specifically associate this parameter with the WebLogic Configuration Wizard freezing during domain reconfiguration. However, the documented rendering mechanism explains why this workaround can help in an environment using remote X11 forwarding.

Conclusion

If the Oracle WebLogic Configuration Wizard freezes when running through X11 forwarding on Linux, try disabling the Java 2D XRender pipeline before investigating more complex causes.

A single JVM parameter is enough:

export _JAVA_OPTIONS="-Dsun.java2d.xrender=false"

This workaround was successfully validated during two domain reconfigurations.

It does not prove the exact underlying XRender incompatibility, but it demonstrates that the rendering pipeline was a contributing factor.

After completing the configuration, remove the temporary setting:

unset _JAVA_OPTIONS

Related blogs