Troubleshooting the Installation
This section provides troubleshooting information for issues that may arise during the Enterprise Console installation.
Installation Stuck at License Agreement
If your installation becomes stuck at displaying the license agreement on the console, then the EULA may be having issues with special characters. To fix this issue, add the -VdisableEULA=true
flag to your installation command or response.var
file. For example:
./platform-setup-64bit-linux.sh -c -VdisableEULA=true
Enterprise Console Application Is in Use Error
If you get an error that states that the "Enterprise Console Application (9191/3377) is in use," you should check that you have specified the correct hostname during the installation.
Default Font Change on Linux Machines
If your Enterprise Console installation fails on a Red Hat system, it may be due to an install4j issue. If the default font has been changed, the JRE cannot interpret it, leading to a "could not display the GUI" error. You can fix this error by running the installation with -VdisableEULA=true
and creating the file /etc/fonts/local.conf
with the following contents:
<?xml version='1.0'?>
<!DOCTYPE fontconfig SYSTEM
'fonts.dtd'>
<fontconfig>
<alias>
<family>serif</family>
<prefer><family>Utopia</family></prefer>
</alias>
<alias>
<family>sans-serif</family>
<prefer><family>Utopia</family></prefer>
</alias>
<alias>
<family>monospace</family>
<prefer><family>Utopia</family></prefer>
</alias>
<alias>
<family>dialog</family>
<prefer><family>Utopia</family></prefer>
</alias>
<alias>
<family>dialoginput</family>
<prefer><family>Utopia</family></prefer>
</alias>
</fontconfig>
Rename the Directory Error on Windows Machines
If the Enterprise Console installation fails with an error on "rename of the directory," it may be due to an antivirus scan. Stopping the antivirus scan on the machine fixes the issue. You should also exclude the Enterprise Console directory from the scan if it sits outside of the Controller directory. See Prepare Windows for the Controller.