Not all installations go flawlessly. Here, I've tried to identify the most common installation problems and have explained how to fix them. Additionally, the OpenCms website—particularly the developers' mailing-list archives—is a good resource for troubleshooting information.
The most common sort of problem with OpenCms installations is that the character set of the Java VM and that of OpenCms do not match, which causes a number of different errors that all have messages that look something like this:
Java VM file encoding: Cp1252 OpenCms encoding: ISO-8859-1
In almost every case, the solution is to make sure that the -Dfile.encoding=ISO-8859-1
flag is passed into the Java VM, either through the CATALINA_OPTS
environment variable or by hardcoding the value into the catalina.sh
(Linux/UNIX) or catalina.bat
(Windows) files. If Tomcat is installed as a Windows Service, you will need to run the service uninstall/install routine I explained in...