Release Notes for OpenCms 9.5.1

March 2, 2015: OpenCms 9.5.1 is a maintenance update for OpenCms 9.5 that fixes a number of issues and adds some functional enhancements.

New in OpenCms 9.5.1

  • # Added "DependentSelectWidget" that obtains values depending on other content fields.
  • Added alternative login handler to authorize users with a cookie.
  • Added option to search for expired / unreleased resources to all gallery dialogs.
  • Added option "galleryselect" to select a gallery to file selector widget.
  • Added further configuration options for OpenCms auto-setup.
  • Added option to use permanent instead of temporary redirects from a non-secure to a secure server.
  • Added Solr "rows" parameter in workplace's source search.
  • Added support for configuring a JDBC connection in the OpenCms db properties.
  • Demo template updated to Bootstrap 3.3.2.

Items marked with # are considered important improvements in this version.

Improved in OpenCms 9.5.1

  • Fixed issue #197 with static export links being generated even if the static export was disabled.
  • Fixed issue #240 with malfunctioning "invalid date" error message in date select widget.
  • Fixed issue #258 with URL name mappings not working correctly with locales of the form "language_COUNTRY".
  • Fixed issue #285 with encoding problems / wrong escape character handling in CmsParameterConfiguration.
  • Fixed issue #287 with external link validation failing for expired resources.
  • Fixed issue #289 with opening the gallery tab in the workplace preferences dialog.
  • Fixed issue #291 that occurred when using "Assign categories" in the legacy xmlpage direct edit provider.
  • Fixed issue #292 that an exception was thrown when editing settings for the "content check" tool.
  • Fixed issue #295 with user administration when using MS SQL Server.
  • Fixed issue #296 with XML content correction saving a wrong order of choice elements after a schema change.
  • Fixed XSS security issues affecting the request parameter based locale handler.
  • Fixed several issues with secure site handling.
  • Fixed issue in page editor where a selected formatter was reset to the default when content was dragged to a different container.
  • Fixed issue where detail page URLs with fragments were not processed correctly in the editor.
  • Fixed issue that the "Keep permissions" option was ignored during database imports.
  • Fixed issue where database entries were not removed after a deleted file was published if versioning was disabled.    
  • Fixed issue where only the latest historic version was actually saved when the file history was set to "unlimited".
  • Fixed issue where OU deletion caused server timeouts with large VFS repositories.
  • Fixed issue where new roles were not created for existing sub OUs of the root OU.
  • Fixed issue with slow performance for systems using many web user OUs. .
  • Fixed issue where the initial role given to a new user was always in the root OU.
  • Fixed issue with "editableby" attribute of <cms:container> not working correctly for roles of users outside the root OUs.
  • Fixed issue where modified JSPs were infrequently not updated after publishing.
  • Fixed issue where new resources were removed from offline search indexes if a user modified them.
  • Fixed issue with Solr returning expired documents by default.
  • Fixed issue where the workplace search dialog lost the current directory. 
  • Fixed issue with the "Create new" option not always appearing in the settings dialog.
  • Fixed issue where model page elements on which the "Create new" option was set were treated as new elements.
  • Fixed issue where enabling detail views in traditional workplace lists affected all other users.
  • Fixed issue in link substitution with folders using the OpenCms servlet name when OpenCms is installed as ROOT application.  
  • Fixed issue with editor change handler not updating optional fields in the content editor.
  • Fixed issue with validation of hidden fields in the content editor.
  • Fixed issue with <cms:bundle> tag not using the default locale as a fallback.
  • Fixed issue in and so that running the scripts outside of WEB-INF is now possible.
  • Fixed issue with CodeMirror editor configuration not working for Internet Explorer 11.

General OpenCms features

  • The page editor allows WYSIWYG inline editing of web pages and arrangement of content by drag & drop.
  • The form based editor allows editing of structured content in a well defined form mask.
  • The sitemap editor allows to create new pages and re-arrange the navigation tree by drag & drop.
  • Responsive demo template based on Bootstrap 3.
  • Content creation for mobile devices with preview and device specific content control.
  • Structured contents can be defined using a simple XML schema.
  • Easy to use "Online / Offline" workflow, changes must be approved before they become visible.
  • Link management for all internal resources with broken link detection.
  • Integrated image scaling and cropping.
  • SEO features with automatic sitemap.xml generation and page alias support.
  • Full featured user management that supports the concept of "Organizational Units" (OUs).
  • Allows management of multiple websites within one installation.
  • Contents can be served dynamically or exported to static HTML files.
  • Direct access to the OpenCms content repository over a shared network drive.
  • CMIS and WebDAV access to the OpenCms content repository.
  • Integrates Apache SOLR for powerful content searching and noSQL like queries.
  • Full text search for web pages as well as in office documents like PDF, MS Office and Open Office.
  • Extensions can be added through a flexible module system.
  • The "time warp" feature allows to view resources which are expired or not yet released.
  • JSP integration for dynamic functionality in templates, dynamic forms etc.
  • ... and many more

Backward compatibility

OpenCms 9.5.1 is fully backward compatible with all 8.x and 9.x versions. Templates and other OpenCms developed code from these versions should work "out of the box" with version 9.5.1.

Notice for users of Alkacon OCEE OpenCms 9.5.1 requires a new version of Alkacon OCEE. The update is free for Alkacon customers with a valid OCEE update subscription. Please contact Alkacon to receive the new version.

Compatibility with Java versions, servlet containers and databases

OpenCms 9.5.1 has been written and tested for Java 6 and 7. We have tested with ORACLEs JDK as well as OpenJDK. OpenCms should run with all compliant JVMs.

We have tested this release on the Tomcat servlet engine. OpenCms works "out of the box" with Tomcat 7, which we recommend. Others have reported deploying OpenCms successfully on other servlet containers like JBoss, BEA, Websphere, Glassfish and Resin Professional.

On the database side, we have tested with MySQL, Oracle, PostgreSQL, MS SQL Server, DB2 and HSQLDB.

Regarding version numbers and build tags

The main OpenCms Git repository is available on Github at

In case you want to get the most current OpenCms 9.5.1 sources from Git, please check out branch_9_5_x. The 9.5.1 release is tagged build_9_5_1.

How you can help

Contributions to the OpenCms core development are most welcome. Please send us your pull requests directly on GitHub.

Please report issues found in OpenCms using our GitHub issue tracker.

Thank you for using OpenCms and have fun with OpenCms 9.5.1 :-)