Forms do not open in Agent UI in AEM 6.5 LTS SP2 due to missing libraries

✨ This content is AI generated and could be inaccurate. Generative AI Terms

This article describes how to fix an issue in Adobe Experience Manager 6.5 LTS SP2 where forms do not open in the Agent UI due to missing system libraries and symlinks.

Description description

Environment

  • Adobe Experience Manager (AEM) 6.5 LTS SP2 on Linux

Symptoms

  • Forms do not render or open in the Agent UI when using Preview with sample data.
  • Error messages appear in the AEM error log when attempting to generate or preview forms.
  • The issue occurs only on some servers; other instances work as expected.
  • The following libraries are missing on affected servers:
  • libX11.x86_64
  • libxcb.x86_64
  • libXau.x86_64
  • The problem persists after replacing the bedrock folder and restarting the server, unless the missing libraries and symlinks are addressed.

Cause

Missing system libraries and symlinks prevent the AEM forms module from rendering forms in the Agent UI.

Resolution resolution

Follow the steps below to resolve the issue:

  1. On the affected server, verify that the following libraries are installed: libX11.x86_64, libxcb.x86_64, and libXau.x86_64.
  2. Use your package manager to check the installation status, for example: rpm -q libX11 libxcb libXau.
  3. If any libraries are missing, install them using your package manager, for example: sudo yum install libX11.x86_64 libxcb.x86_64 libXau.x86_64.
  4. Ensure that symlinks for these libraries match those on a working server.
  5. Compare the output of ls -l /usr/lib64/ for the relevant libraries between working and non-working servers.
  6. Create missing symlinks as needed, for example: sudo ln -s /usr/lib64/libX11.so.6 /usr/lib64/libX11.so.
  7. Restart the AEM instance: ./crx-quickstart/bin/start.
  8. Attempt to open forms in the Agent UI and via Preview to confirm that forms now generate as expected.
recommendation-more-help
experience-cloud-kcs-help-kbarticles