Installation troubleshooting v15
Difficulty displaying Java-based applications
If you have difficulty displaying Java-based server features (controls or text not displaying correctly or blank windows), upgrading to the latest libxcb-xlib
libraries corrects the problem on most distributions. See the Java bug database for other possible workarounds.
The installation fails to complete due to existing data directory contents
If an installation fails to complete due to existing content in the data directory, the server writes an error message to the server logs:
A data directory is neither empty, or a recognisable data directory.
If you encounter a similar message, confirm that the data directory is empty. The presence of files, including the system-generated lost+found
folder, prevents the installation from completing. Either remove the files from the data directory, or specify a different location for the data directory before invoking the installer again to complete the installation.
Difficulty installing the EPEL release package
If you have difficulty installing the EPEL release package, you can use the following command to install the epel-release
package on RHEL/Rocky Linux/AlmaLinux 8.x:
You might need to enable the [extras]
repository definition in the CentOS-Base.repo
file, located in /etc/yum.repos.d
. If yum can't access a repository that contains epel-release
, an error message appears:
If you receive this error, you can download the EPEL rpm package and install it manually. To manually install EPEL, download the rpm package, assume superuser privileges, navigate into the directory that contains the package, and use this command: