Book Image

Building Websites with OpenCms

Book Image

Building Websites with OpenCms

Overview of this book

This book takes you through the process of creating content-rich websites and applications using OpenCms. Although powerful and flexible, OpenCms can be daunting on first approach, but its advanced features reward the investment in learning. This book exists to ease Java developers into getting the most from OpenCms. OpenCms OpenCms is a professional-level, open source Website Content Management System, with which you can create and manage complex websites. Based on Java and XML technology, it fits into almost any modern IT environment. With hard-won experience of the practical difficulties faced by developers working with OpenCms, this book is the embodiment of the author's expertise, and the perfect way to master the system.
Table of Contents (12 chapters)
Building Websites with OpenCms
Credits
About the Author
Introduction

Installation Troubleshooting


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.

Character-Set Issues

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...