Red Hat JBoss Portal 5.1

Site Publisher 5.1.1 Release Notes

For use with the Red Hat JBoss Portal Site Publisher 5.1.1 extension.

Red Hat Documentation Group

Legal Notice

Copyright © 2013 Red Hat, Inc.
This document is licensed by Red Hat under the Creative Commons Attribution-ShareAlike 3.0 Unported License. If you distribute this document, or a modified version of it, you must provide attribution to Red Hat, Inc. and provide a link to the original. If the document is modified, all Red Hat trademarks must be removed.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the Infinity Logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack Logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.


These release notes contain important information related to JBoss Site Publisher 5.1.1 that may not be currently available in the Product Manuals. You should read these Release Notes in their entirety before installing the product.

1. Introduction

JBoss Site Publisher (powered by eXo) is a new add-on component for JBoss Enterprise Portal Platform. Site Publisher enables users to create, edit and publish rich web content within the context of their portal installation.


Subscriptions to JBoss Site Publisher are available at an additional fee over and above JBoss Enterprise Portal Platform subscriptions.
JBoss Site Publisher simplifies the authoring and management for every website an organization needs to deploy. It includes the ability to administer sites, manage navigation, and publish content. Site Publisher delivers powerful functionality to everyone responsible for maintaining web content:
  • Webmasters can easily administer multiple websites.
  • Website administrators can set permission policies according to user roles to better control website changes.
  • Content providers can use JBoss Enterprise Portal Platform’s tools to create content and then choose how to publish it using blogs, RSS feeds, social networks and more.
  • Web developers can introduce other forms of rich media content to create truly professional websites easily and efficiently.

2. Component Features

Categorization and tag features enable users to search contents and documents in the current website or all websites.
Versioning and rollback of content
If needed, administrators can simply roll back website content with automatic site versioning.
Web-based administration
Your website can be administered remotely, simply by using a web browser, and requires no additional software to be installed on your computer.
Media library
Users can add any media they want to use on a website to the media library. They can also re-use this media on other websites and update media across multiple websites.
Web page management tools
Webmasters can organize website content and menus.
Content features
Webmasters can easily edit categories, comments, versions, and permissions.
Search engine optimization (SEO)
SEO processes are now easier and more effective with an intuitive interface to edit meta tags.
Friendly URLs
Site Publisher gives every piece of content a specific URL, which further helps your organization improve SEO processes and results.

3. Installation

The JBoss Site Publisher Installation Guide contains detailed installation instructions as well as environment requirements.

4. Issues Resolved In Production

The following issues were resolved in the production process of Site Publisher:
A bug in the Content Duplicity Check in the multiple content selector has been corrected. The content selector now matches the target path of each selected node against those already selected and, if a duplicate is found a warning is presented and the new node is rejected. This prevents users from selecting the same file more than once.
An 'Unknown error' encountered when attempting to save an HTML page has been resolved in this release.
Problems with URL parameters being lost when returning from in-context editing in the ContentExplorer portlet were encountered in previous versions of JBoss Enterprise Portal Platform. This issue has been resolved in this release.
In previous versions of JBoss Enterprise Portal Platform, the Quick Login links found on the front page of the classic site where rendered inactive when the Site Publisher plugin was deployed. This issue has been corrected in this release.
A bug in the Site Publisher code prevents the system from correctly calculating the size of an upload. This may allow files that do not adhere to the 10MB size limit to be uploaded.

5. Issues Resolved Upstream

The following issues were resolved upstream:
A bug that prevented users from logging in using the pre-formatted URL http://localhost:8080/ecmdemo/login?username=john&password=gtn&initialURI=/ecmdemo/private/classic has been corrected with an upstream patch.
An bug found when setting a Publication Lifecycle resulted in the Authoring life-cycle being activated regardless of the user's selection. This behavior has been corrected with an upstream patch.
This patch also corrects a similar behavior as documented in
A bug which prevented custom .war files from being successfully imported through the Application Registry of the ecmdemo domain has been corrected.
A bug resulting in an Unexpected Error encountered when adding a document to /exo:ecm/exo:taxonomyTrees/definition/acme has been resolved.
A ConstraintViolationException encountered when importing a versioned nt:folder node was found to be caused by the nt:versionedChild disallowing nt:versionedChild subnodes. An upstream patch has corrected this behavior, avoiding the error and allowing successful import of versioned subnodes and their history.
An upstream patch has modified Site Publisher's default behavior if an invalid value was entered as a file Category. Now, instead of clearing the field without feedback, a warning message is displayed that informs the user that they have entered an invalid value.
A memory leak discovered in PortletFutureCache has been corrected.
A code bug prevented PDF files attached to Article documents from being viewable in the Content Detail Portlet. This has been corrected with an upstream patch.
A bug was encountered that caused the Content by URL portlet to display incorrect content to public users in some instances. For instance; the URL pointing to document1 might correctly show document1 in one browser window, while the same URL might incorrectly present document2 in a different browser tab or window.
An upstream patch has resolved this issue.
A bug that prevented a new file (either uploaded or created) from appearing under a taxonomy tree immediately after it had been added to that taxonomy category has been corrected in an upstream patch.
A code bug that prevented Internet Explorer 8 from sanitizing special (accented) characters in URLs has been corrected.
A bug in the pagination code prevented the Pager in Content Selector from rendering page views correctly in Internet Explorer 8, Firefox 3.5 or Google Chrome. This bug was fixed in an upstream patch.
Upstream patches have corrected code bugs that resulted in multi-valued WYSIWYG fields being uneditable and set to null.
A warning message has been added to the Manage Users form to advise users attempting to delete Administrator privileges that they cannot do so.
The Newsletter category General and the subscription Check-list are no longer loaded by default.
A patch has been applied to the code which implements a task within the JCR to remove any unassigned symlinks. This update resolves the issue of symlinks being retained in the JCR after the original object is deleted.
A bug that prevented the Manage Lock list from updating with a group added to the lock list in Group Management has been corrected in a upstream patch.,
Upstream patches have resolved various bugs in the RSS function that resulted in some feed URLs pointing to incorrect content or not rendering correctly if they contained special or accented characters. RSS links now work as expected.
A new feature has been added to Site Publisher which displays a warning message when a user is about to close a document that has unsaved changes. The message warns the user that they will lose unsaved changes if they close the current document.
A bug that prevented users from opening nodes whose names begin with a period (.) has been corrected. Users can now open files as expected.
A code bug that produced an error message when adding universal permissions (*) to view new system elements (views, templates, etc) after adding tag permissions for managers has been corrected by an upstream patch.
A bug which resulted in newly added node properties not appearing in the property list has been corrected in an upstream patch.,
A bug which produced an "Unknown Error" message when attempting to save edited permission settings on nt:unstructured nodes has been resolved in an upstream patch.
A bug which prevented users from viewing the content of a document attached to an article in SCV has been corrected in an upstream patch.
A bug which produced an error pop-up when attempting to view an uploaded image while in "jailed" mode has been corrected in an upstream patch.
A bug that prevented the 'collapse' icon (-) from switching to the 'expand' icon (+) after a folder was collapsed has been corrected.
A code bug which may have revealed the edit/remove options on Queries to users without the required authorizations has been corrected. Edit permissions are now validated before the options are presented.
A code bug was found to revert the mode selector in the administration bar from Edit to Published when the user switched from one site to another, even though the edit buttons remained visible on page elements. This bug has been corrected in an upstream patch.
A bug which threw an exception when a user attempted to edit content which has different permissions than it's parent directory has been corrected.
A bug in the code caused Site Publisher to attempt to open a new page from the last opened folder rather than the correct file path. This caused an exception to be thrown in the console. This bug has been corrected in an upstream patch.
A bug which caused Site Publisher to throw an exception when a user attempted to create and use a Category which contained an accented character has been corrected in an upstream patch.
A bug which allowed empty property fields to overwrite original values when editing an uploaded content file (an image or pdf, for example), resulting in an exception has been corrected in an upstream patch.
A bug which caused published content in CLV portlets to remain visible and accessible even after it had been deleted has been corrected in an upstream patch.
A bug causing some browser tabs to show 'null', rather than the title of the Site Publisher page being viewed has been corrected.
A bug which caused the most recent versions of edited documents to appear on a page even after the document had been restored to an earlier (possibly non-edited version) has been corrected in an upstream patch.
A bug that prevented commenting on documents when using IE7 has been corrected.
A bug which threw an exception after a user attempted to access a Newsletter category after having deleted a newsletter from that category has been corrected in an upstream patch.
A bug which prevented newly created documents from appearing in simple searches has been corrected.
A bug which prevented a node that was locked by a user from being unlocked by an administrator has been corrected in an upstream patch.
Importing portlets through the Application Registry using the Import Application button results in some portlets being registered twice. This is because these portlets are registered once during the portal initialization and then registered again during the Import action.
A bug that prevented images uploaded during the creation of a free layout web content from saving to the to the appropriate content folder has been addressed in an upstream patch.
An upstream patch has improved the jQuery implementation in Site Publisher. This improvement allows developers and system administrators to include their own version of jQuery.
A bug which, in some circumstances, caused multi-line comments on free layout web contents to be truncated in the document view tab has been resolved in an upstream patch.
The fix for this bug should also resolve
The node locking mechanism has been patched to allow children of locked nodes to be checked in, without modifying the parent node, as part of the publication process.
A bug which caused the ampersand characters that separate URL parameters to be rendered as & (and hence lost to the browser) when leaving in-context editing has been fixed with an upstream patch.
'Unknown Error' messages encountered when performing searches using special characters (eg; [ ] ' " *) have been corrected in an upstream patch. Site Publisher now escapes special characters correctly.
A bug that rendered the Category Content portlet blank when attempting to edit it after deleting the 'acme' category in the ACME example site has been patched upstream.
URLs generated using the 'Copy URL to clipboard' node context option were invalid as the URL path was hard-coded with the /rest-ecmdemo/private/jcr/ path, regardless of the location of the node being referenced. This error has been resolved in this release.
A bug in how Site Publisher displayed taxonomy names with more than twenty (20) characters has been corrected.
The SCVPortletPreferenceMigrationService service has been deactivated in the 'default' profile of this release of Site Publisher. This is to improve start up performance. The service has been commented out in the core-services-configuration.xml file and can be reactivated by removing the comment mark-up.
Chrome Browser: A bug which prevented the file upload pop-up window from closing after a user clicked the Save button has been resolved.
Chrome Browser: A bug which caused the Rich Text Editor to not honor site CSS styles has been resolved in an upstream patch.
A security vulnerability that allowed XSS javascript to be injected into a site through the text fields of view templates has been closed in this release. A front-side filter now removes any entered content inside <script> tags, any javascript calls and any on* attributes (such as onLoad and onClick before the content is saved.
A bug which caused Site Publisher to not honor the timezone of the server on which it is running has been corrected in an upstream patch.
A bug which overwrote any manually entered name applied to an uploaded PDF file with the file's original name has been corrected upstream.
An Unknown Error encountered when attempting to add a newly created category as content in a SCV portlet on a new page in the acme drive has been corrected in an upstream patch.
An initialization error in the DriverConnector service's constructor was found to be caused by the service calling the resourceBundleService.getResourceBundle method before the ResourceBundleService had been started.
A patch to the upstream code has introduced fallback clauses which prevent the error.

6. Known Issues

There are no known issues in this release.

7. Documentation

An Installation Guide and a User Guide for JBoss Site Publisher are available at JBoss Enterprise Portal Platform specific documentation is also available from this location.

8.  Product Support and License Website Links

Production Support Scope of Coverage
Production Support Service Level Agreement
Developer Support Scope of Coverage
Developer Support Service Level Agreement
Product Update and Support Policy by Product
JBoss End User License Agreement

A. Revision History

Revision History
Revision 5.1.1-1.4002013-10-31Rüdiger Landmann
Rebuild with publican 4.0.0
Revision 5.1.1-1Fri Aug 9 2013Jared Morgan
Updated the Product Name to reflect the new name grouping for the product. No update was made to details in the guide.
Revision 2-5.1.7Thu Aug 11 2011Scott Mumford
Added new issues.
Prep for 5.1.1 release.