[gatein-commits] gatein SVN: r3223 - epp/docs/tags/EPP_5_0_0_GA/Enterprise_Portal_Platform_Release_Notes/en-US.

Author: smumford Date: 2010-06-01 20:12:02 -0400 (Tue, 01 Jun 2010) New Revision: 3223 Added: epp/docs/tags/EPP_5_0_0_GA/Enterprise_Portal_Platform_Release_Notes/en-US/5.0.0_Release_Notes.ent epp/docs/tags/EPP_5_0_0_GA/Enterprise_Portal_Platform_Release_Notes/en-US/5.0.0_Release_Notes.xml Removed: epp/docs/tags/EPP_5_0_0_GA/Enterprise_Portal_Platform_Release_Notes/en-US/Release_Notes.ent epp/docs/tags/EPP_5_0_0_GA/Enterprise_Portal_Platform_Release_Notes/en-US/Release_Notes.xml Modified: epp/docs/tags/EPP_5_0_0_GA/Enterprise_Portal_Platform_Release_Notes/en-US/Book_Info.xml Log: Renaming to '5.0.0 Release Notes' for staging Copied: epp/docs/tags/EPP_5_0_0_GA/Enterprise_Portal_Platform_Release_Notes/en-US/5.0.0_Release_Notes.ent (from rev 3222, epp/docs/tags/EPP_5_0_0_GA/Enterprise_Portal_Platform_Release_Notes/en-US/Release_Notes.ent) =================================================================== --- epp/docs/tags/EPP_5_0_0_GA/Enterprise_Portal_Platform_Release_Notes/en-US/5.0.0_Release_Notes.ent (rev 0) +++ epp/docs/tags/EPP_5_0_0_GA/Enterprise_Portal_Platform_Release_Notes/en-US/5.0.0_Release_Notes.ent 2010-06-02 00:12:02 UTC (rev 3223) @@ -0,0 +1,4 @@ +<!ENTITY HOLDER "Red Hat, Inc"> +<!ENTITY YEAR "2010"> +<!ENTITY PRODUCT "JBoss Enterprise Portal Platform"> +<!ENTITY VERSION "5.0.0"> Copied: epp/docs/tags/EPP_5_0_0_GA/Enterprise_Portal_Platform_Release_Notes/en-US/5.0.0_Release_Notes.xml (from rev 3222, epp/docs/tags/EPP_5_0_0_GA/Enterprise_Portal_Platform_Release_Notes/en-US/Release_Notes.xml) =================================================================== --- epp/docs/tags/EPP_5_0_0_GA/Enterprise_Portal_Platform_Release_Notes/en-US/5.0.0_Release_Notes.xml (rev 0) +++ epp/docs/tags/EPP_5_0_0_GA/Enterprise_Portal_Platform_Release_Notes/en-US/5.0.0_Release_Notes.xml 2010-06-02 00:12:02 UTC (rev 3223) @@ -0,0 +1,1095 @@ +<?xml version='1.0' encoding='utf-8' ?> +<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ +]> +<article id="JBEPP_5_0_Release_Notes"> + <xi:include href="Book_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> + <section id="sect-Release_Notes-Introduction"> + <title>Introduction</title> + <para> + &PRODUCT; offers an intuitive, easy to manage user interface and a proven core infrastructure to enable organizations to quickly build dynamic web sites in a highly reusable way. By bringing the principals of Open Choice to the presentation layer, &PRODUCT; &VERSION; maximizes existing skills and technology investments. + </para> + <para> + By integrating proven open source frameworks such as JBoss Seam, Hibernate, Tomcat and JBoss Cache &PRODUCT; takes advantage of innovations in the open source community. As well, &PRODUCT; version &VERSION; is fully tested and supported by Red Hat, and is certified to work on many leading enterprise hardware and software products. + </para> + </section> + + <section> + <title>New Features</title> + <variablelist> + <varlistentry> + <term>Revamped User Interface</term> + <listitem> + <para> + JBoss Enterprise Portal Platform (EPP) has replaced it's existing JSF user interface with one based upon a new framework that is an extension of the Groovy framework. This new interface includes many new features geared towards enabling more interaction and customization of portals, skins and pages by non-development resources. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Master Object Page Model </term> + <listitem> + <para> + EPP has replaced the existing XML file drive page model towards a new model that treats each portlet page as an object stored in the Java Content Repository (JCR). This new model allows for pages to be highly reusable and enables simple page creation, editing and hierarchical node management within the portal. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>New Navigational Controls</term> + <listitem> + <para> + EPP has implemented navigational controls that dynamically and contextually get data from the JCR. These controls are portlet based and can be customized and modified to meet a wide range of navigational options. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Site and Page Wizards</term> + <listitem> + <para> + EPP has implemented wizard capabilities to simplify the creation of pages for non-development resources. These wizards enable selection of page placement in the portal, implementation of over 10 out of the box page layouts, addition of portlets and gadgets as well as page security. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Administration Portlets</term> + <listitem> + <para> + EPP has implemented an entirely new set of administration portlets to simplify the management of portlets and gadgets and well as users and groups. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Right to Left Language Support</term> + <listitem> + <para> + EPP supports localization and includes over 12 out of the box language localizations. This includes right to left language support. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Gadget Container</term> + <listitem> + <para> + EPP has implemented the Shindig Open Social Gadget container. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Portlet Bridge 2.0</term> + <listitem> + <para> + A new updated version of the Portlet Bridge Project that enables the easy creation of portlets that reuse JSF, Seam and Rich Faces applications. The new version of the bridge spans a wider range of use cases from the underlying applications as well as support for the Portlet 2.0 (JSR286) specification. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Example Portlets</term> + <listitem> + <para> + EPP includes a directory with additional example and sample portlets that can be compiled and modified to meet customer requirements in projects. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>New Identity Manager</term> + <listitem> + <para> + A new framework to manage users, groups and roles is implemented. This new identity manager enables attributes to utilize information from LDAP servers as well as external databases and applications + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>JBoss Enterprise Application Server 5.0</term> + <listitem> + <para> + The JBoss Enterprise Application Server 5.0 (JBoss EAP 5.0) is based on the JBoss AS 5.1.x family and is the latest release of the world's most popular application server. JBoss EAP 5.0 represents the state of the art with the second generation JBoss Microcontainer-based enterprise Java run-time. + </para> + <para> + In addition to supporting the latest Java EE specification (Java EE 5), JBoss EAP 5.0 integrates many of the best enterprise class services for advanced messaging, persistence, transactions, caching and high-availability. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>JBoss Microcontainer</term> + <listitem> + <para> + The JBoss Microcontainer is a refactoring of the modular JBoss JMX Microkernel. It is a lightweight kernel that manages the loading, lifecycle and dependencies between POJOs. Together with a Servlet/JSP container, an EJB container, deployers, and management utilities, the JBoss Microcontainer provides a standard Java EE 5 profile. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>JBoss Cache</term> + <listitem> + <para> + JBoss Cache provides replication for EJB and HTTP session state and supports distributed entity caching for JPA. It also provides superior performance and scalability with the new MultiVersion Concurrency Control (MVCC) locking scheme. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>JBoss Web Services</term> + <listitem> + <para> + JBoss Web Services is a framework that provides support for the latest JAX-WS specification as well as a plugin architecture for supporting alternative Web Services Stacks. + </para> + </listitem> + </varlistentry> + </variablelist> + </section> + + <section id="sect-Release_Notes-Architecture_of_PRODUCT_VERSION"> + <title>Component Versions</title> + <para> + This section details the versions of the components which create the JBoss Enterprise Portal Platform 5.0.0. + </para> + <table> + <title>JBoss Enterprise Portal Platform Component Versions</title> + <tgroup cols="2"> + <thead> + <row> + <entry> + Component + </entry> + <entry> + Version + </entry> + </row> + </thead> + <tbody> + <row> + <entry> + JBoss Enterprise Application Platform + </entry> + <entry> + 5.0.1 GA + </entry> + </row> + <row> + <entry> + JBoss Cache + </entry> + <entry> + 3.2.4 + </entry> + </row> + <row> + <entry> + GateIn Common + </entry> + <entry> + 2.0.2 + </entry> + </row> + <row> + <entry> + GateIn WCI + </entry> + <entry> + 2.0.1 + </entry> + </row> + <row> + <entry> + GateIn PC + </entry> + <entry> + 2.1.1 + </entry> + </row> + <row> + <entry> + GateIn WSRP + </entry> + <entry> + 1.1.1 + </entry> + </row> + <row> + <entry> + GateIn MOP + </entry> + <entry> + 1.0.2 + </entry> + </row> + <row> + <entry> + GateIn SSO + </entry> + <entry> + 1.0.0-epp + </entry> + </row> + <row> + <entry> + PicketLink IDM + </entry> + <entry> + 1.1.3 + </entry> + </row> + <row> + <entry> + eXoplatform JCR + </entry> + <entry> + 1.12.1 + </entry> + </row> + <row> + <entry> + eXoplatform Kernel + </entry> + <entry> + 2.2.1-GA + </entry> + </row> + <row> + <entry> + Portlet Bridge + </entry> + <entry> + 2.0 + </entry> + </row> + <row> + <entry> + Chromattic + </entry> + <entry> + 1.0.1 + </entry> + </row> + </tbody> + </tgroup> + </table> + </section> + + <section id="sect-Release_Notes-Certified_Environments"> + <title>Installation</title> + <para> + The JBoss Enterprise Portal Platform Installation Guide contains details of software and hardware requirements as well as detailed installation instructions. + </para> + <para> + The Installation Guide can be found online at <ulink type="http" url="http://www.redhat.com/docs/en-US/JBoss_Enterprise_Portal_Platfo...;. + </para> +<!-- <para> + The environments &PRODUCT; &VERSION; is certified to run on are: + </para> + <table id="tabl-Release_Notes-Certified_Environments-Java_Virtual_Machine_Support"> + <title>Java Virtual Machine Support</title> + <tgroup cols="2"> + <thead> + <row> + <entry> + Platform + </entry> + <entry> + JVM + </entry> + </row> + </thead> + <tbody> + <row> + <entry> + RHEL 5 x86 + </entry> + <entry> + <para> + Sun JDK 1.6 Update 15 (update v1.8) + </para> + <para> + OpenJDK 1.6.0-b09 (update v1.8) + </para> + <para> + IBM JDK 1.6.0 SR5 (update v1.8) + </para> + </entry> + </row> + <row> + <entry> + RHEL 5 x86_64 + </entry> + <entry> + <para> + Sun JDK 1.6 Update 15 (update v1.8) + </para> + <para> + OpenJDK 1.6.0-b09 (update v1.8) + </para> + <para> + IBM JDK 1.6.0 SR5 (update v1.8) + </para> + </entry> + </row> + <row> + <entry> + MS Windows 2008 x86 + </entry> + <entry> + Sun JDK 1.6 + </entry> + </row> + <row> + <entry> + MS Windows 2008 x86_64 + </entry> + <entry> + Sun JDK 1.6 + </entry> + </row> + <row> + <entry> + Solaris 10 + </entry> + <entry> + Sun JDK 1.6 + </entry> + </row> + </tbody> + </tgroup> + </table> + <table id="tabl-Release_Notes-Certified_Environments-Database_Support_"> + <title>Database Support </title> + <tgroup cols="3"> + <thead> + <row> + <entry> + DBMS + </entry> + <entry> + Server + </entry> + <entry> + JBDC Driver + </entry> + </row> + </thead> + <tbody> + <row> + <entry> + MySQL + </entry> + <entry> + <para> + 5.1 (certified) + </para> + <para> + 5.0 (compatible) + </para> + </entry> + <entry> + <para> + MYSQL Connector/J 5.1.8 (certified) + </para> + <para> + MySQL Connector/J 5.0.8 (compatible) + </para> + </entry> + </row> + <row> + <entry> + Oracle DB + </entry> + <entry> + <para> + 10g R2 (10.2.0.4) (certified) + </para> + <para> + 11g R1 (11.1.0.7.0) (compatible) + </para> + <para> + 11g RAC (11.1.0.7.0) (compatible) + </para> + </entry> + <entry> + <para> + Oracle 10g R2 (10.2.0.4) (certified) + </para> + <para> + Oracle 11g R1 (11.1.0.7) (compatible) + </para> + <para> + Oracle 11g R1 (11.1.0.7) (compatible) + </para> + </entry> + </row> + <row> + <entry> + MS SQL Server + </entry> + <entry> + <para> + 2005 SP3 (certified) + </para> + <para> + 2008 SP1 (certified) + </para> + </entry> + <entry> + JDBC Driver 2.0 (certified) + </entry> + </row> + <row> + <entry> + PostgresSQL + </entry> + <entry> + <para> + 8.3.7 (certified) + </para> + <para> + 8.2.4 (compatible) + </para> + </entry> + <entry> + <para> + JDBC4 Driver, Ver 8.3-605 (certified) + </para> + <para> + JDBC4 Driver, Ver 8.2-510 (compatible) + </para> + </entry> + </row> + <row> + <entry> + DB2 + </entry> + <entry> + 9.7 (certified) + </entry> + <entry> + IBM Data Server Driver for JDBC and SQLJ (JCC Driver) Version: 9.1 (fixpack 3a) (certified) + </entry> + </row> + <row> + <entry> + Sybase + </entry> + <entry> + 15.0.2 (certified) + </entry> + <entry> + JConnect v6.0.5 (Build 26564 / 11 Jun 2009) (certified) + </entry> + </row> + </tbody> + </tgroup> + </table> + <table id="tabl-Release_Notes-Certified_Environments-Directory_Support"> + <title>Directory Support</title> + <tgroup cols="2"> + <thead> + <row> + <entry> + Directory Service + </entry> + <entry> + Version + </entry> + </row> + </thead> + <tbody> + <row> + <entry> + OpenDS + </entry> + <entry> + <para> + 1.2 + </para> + <para> + 2.0 + </para> + </entry> + </row> + <row> + <entry> + OpenLDAP + </entry> + <entry> + 2.4 + </entry> + </row> + <row> + <entry> + Red Hat Identity Server + </entry> + <entry> + 7.1 or later + </entry> + </row> + <row> + <entry> + MS Active Directory + </entry> + <entry> + Windows Server 2008 + </entry> + </row> + </tbody> + </tgroup> + </table> + <table id="tabl-Release_Notes-Certified_Environments-Browser_support"> + <title>Browser support</title> + <tgroup cols="2"> + <thead> + <row> + <entry> + Browser + </entry> + <entry> + Version + </entry> + </row> + </thead> + <tbody> + <row> + <entry> + Internet Explorer + </entry> + <entry> + <para>7</para> + <para>8</para> + </entry> + </row> + <row> + <entry> + Firefox + </entry> + <entry> + <para> + 3 + </para> + <para> + 3.5 + </para> + </entry> + </row> + <row> + <entry> + Safari + </entry> + <entry> + 4 + </entry> + </row> + </tbody> + </tgroup> + </table> --> + </section> + +<!-- <section id="Issues-fixed-in-this-release"> + <title> + Issues fixed in this release + </title> + <warning> + <title>TODO</title> + <para> + Following is a list of issues fixed in this release: + </para> + </warning> + <formalpara> + <title>Component 1</title> + <para> + <itemizedlist> + <listitem> + <para> + Issues fixed. + </para> + </listitem> + </itemizedlist> + </para> + </formalpara> + <formalpara> + <title>Component 2</title> + <para> + <itemizedlist> + <listitem> + <para> + Issues fixed. + </para> + </listitem> + </itemizedlist> + </para> + </formalpara> + <formalpara> + <title>Etc</title> + <para> + <itemizedlist> + <listitem> + <para> + Issues fixed. + </para> + </listitem> + </itemizedlist> + </para> + </formalpara> + </section> --> + + <section id="sect-Release_Notes-_Known_Issues_with_this_release_"> + <title> Known Issues with this release </title> + + <para> + JBoss Enterprise Portal Platform 5.0 is based upon an entirely new JBoss community project named GateIn (<ulink type="http" url="http://www.gatein.org">www.gatein.org</ulink>). Previous releases were based upon the JBoss Portal Community Project (<ulink type="http" url="http://www.jboss.org/jbossportal">http://www.jboss.org/...>). + </para> + <para> + Every reasonable effort has been made to address issues with the previous releases of Enterprise Portal Platform. However, since this is a completely new architecture it is difficult to provide a pure translation of issues from release to release. + </para> + +<!-- <section> + <title>Security Issues</title> + <variablelist> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBPAPP-3171">https://jira... + <listitem> + <para> + Cross-site scripting (XSS) vulnerabilities were found in the Enterprise Application Platform component of &PRODUCT;. While the issue has been addressed, some minor vulnerabilities may linger in this release. + </para> + <para> + This issue will be completely resolved in a future release of &PRODUCT;. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBPAPP-4141">https://jira... + <listitem> + <para> + Some servlets may leak information about a portal's version, running environment, system hardware or Java Virtual Machine setups. + </para> + <para> + This issue will be resolved in a future release of &PRODUCT;. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> Autologin</term> + <listitem> + <para> + The new autologin feature in &PRODUCT;, could be exploited in production environments. + </para> + <para> + To disable autologin ... + </para> + + + </listitem> + </varlistentry> + <varlistentry> + <term>Non-changing Captcha</term> + <listitem> + <para> + The <emphasis>captcha</emphasis> registration feature can be brute-forced to not change, which can allow fake users to be created automatically and in bulk. + </para> + <para> + To prevent this a new captcha must be created with every <literal>post</literal> request to the portal user register. + </para> + <para> + This fix will be implemented in a future release of &PRODUCT;. + </para> + </listitem> + </varlistentry> + </variablelist> + </section> --> + + <section id="sect-Release_Notes-_Known_Issues_with_this_release_-General_Known_Issues"> + <title>General Known Issues</title> + <formalpara> + <title><ulink url="https://jira.jboss.org/secure/IssueNavigator.jspa?mode=hide&... + <para> + A list of general issues in this release. + </para> + </formalpara> + </section> + + <section id="sect-Release_Notes-_Known_Issues_with_this_release_-Component_Specific_Known_Issues"> + <title>Specific Known Issues</title> + <variablelist> + <varlistentry> + <term><ulink type="http" url="">https://jira.jboss.org/browse/JBEPP-167</ulink>... + <listitem> + <para> + EPP will not start on an IBM JVM unless the <filename>jcip-annotations.jar</filename> file is copied into /server/default/lib. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-207">https://jira.j... + <listitem> + <para> + A <literal>NullPointerException</literal> may be encountered when selecting a page which has been deleted in Page Management. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-208">https://jira.j... + <listitem> + <para> + An '<emphasis role="bold">Unknown errror</emphasis>' may be encountered while a editing page or layout in Dashboard under certain circumstances. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> <ulink type="http" url="https://jira.jboss.org/browse/JBEPP-210">https://jira.j... + <listitem> + <para> + An '<emphasis role="bold">Unknown error</emphasis>' may be returned when trying to save a page from which an application has been removed. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-212">https://jira.j... + <listitem> + <para> + Performing concurrent modifications of a dashboard may result in an error. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-226">https://jira.j... + <listitem> + <para> + Uppercase and lowercase characters are not differentiated in the application registry. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-262">https://jira.j... + <listitem> + <para> + &PRODUCT; requires a one-off patch in EAP to fix the bug <ulink type="http" url="https://jira.jboss.org/browse/JBPAPP-3977">JBossWS - Timeout value gets inserted into URLs</ulink>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-296">https://jira.j... + <listitem> + <para> + The error message "<emphasis role="bold">Page not found</emphasis>" is displayed after the layout of any portal page is edited. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-315">https://jira.j... + <listitem> + <para> + Pre-release testing indicated that render parameters in JSR-286 portlets are not replicating in a cluster with 2-nodes. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-326">https://jira.j... + <listitem> + <para> + The error message displayed when creating portal which starts with a number (an illegal character) contains the typographical error '<emphasis role="bold">contains</emphasis>'. + </para> + <para> + The message should read as: <emphasis role="bold">The "Portal Name :" field must start with a character and must not contain special characters</emphasis>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-331">https://jira.j... + <listitem> + <para> + The logo in the logo portlet on the &PRODUCT; Dashboard has a relative URL. This can cause URL validation issues returning the error: <emphasis role="bold">The field "logoUrl" must match the format "URL"</emphasis>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-334">https://jira.j... + <listitem> + <para> + Uppercase lettering does not work with MYSQL databases. This can cause problems when creating pages or portals with the same name. + </para> + <para> + This is caused by MYSQL's <literal>VARCAHR</literal> entry in the <literal>JCR_SITEM</literal> table not being case sensitive. A patch has been written that solves this issue by switching the <literal>VARCHAR</literal> entry to use <literal>VARBINARY</literal> which is case sensitive. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-339">https://jira.j... + <listitem> + <para> + A <literal>NullPointerException</literal> is encountered when attempting to access a Dashboard after a page has been deleted. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-342">https://jira.j... + <listitem> + <para> + Unicode and special characters in some languages (specifically German) are badly escaped in the names of navigation nodes. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-343">https://jira.j... + <listitem> + <para> + When creating or deleting new group navigations, changes do not appear in the portal until after a logout/login. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-344">https://jira.j... + <listitem> + <para> + There are currently some User Interface display inconsistencies when using Internet Explorer 6 to edit or view a portal. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-350">https://jira.j... + <listitem> + <para> + An error is encountered when adding a gadget to a portal using a MYSQL database if the '<filename>/server/production</filename>' folder has been removed but the database has not been cleaned. + </para> + <para> + In this scenario the error; <emphasis role="bold">Unable to retrieve gadget xml. HTTP error 500</emphasis> is returned. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-355">https://jira.j... + <listitem> + <para> + The portal will return a permissions error when trying to add all groups in the group navigation, even if the user is logged in as the portal administrator (root). + </para> + <para> + The error message will read: <emphasis role="bold">This user doesn't have permissions to add navigation</emphasis>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-356">https://jira.j... + <listitem> + <para> + Groups listed in the Add Navigation window of the Group navigation page are not currently listed in alphabetical order. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-358">https://jira.j... + <listitem> + <para> + When using the portal with the French language and attempting to recover a lost/forgotten password, the recovery window is not translated into French and refers to the portal as eXo, as opposed to &PRODUCT;. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-360">https://jira.j... + <listitem> + <para> + The login page shown after a timed-out session or a failed login attempt is currently branded with the <literal>GateIn</literal> name and logo. <literal>GateIn</literal> is a community project that &PRODUCT; is based on. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-362">https://jira.j... + <listitem> + <para> + The JSPHelloWorld portlet example currently returns the line: "<emphasis role="bold">my name is JBoss Portal. What's yours?</emphasis>". The line should read: "<emphasis role="bold">my name is &PRODUCT;. What's yours?</emphasis>". + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-367">https://jira.j... + <listitem> + <para> + The SEAM component used in &PRODUCT; &VERSION; has a bug that makes it generate AS 5 incompatible pages. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-369">https://jira.j... + <listitem> + <para> + The use of two JSR286 portlets that use the same portlet-name but different portlet applications will create an exception in the application registry. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-363">https://jira.j... + <listitem> + <para> + A deleted user's entry can still be seen, and edited, in the database after they are removed from LDAP. + </para> + <para> + If the password for the deleted user's account is changed after deletion, and a login attempt is made using the new password an error is encountered and further logins cannot be completed. + </para> + <para> + Clearing the user session will clear this error and allow normal logins. + </para> + </listitem> + </varlistentry> + </variablelist> + </section> + + </section> + + + <section> + <title>Recommended Practices</title> +<!-- <para> + &PRODUCT; &VERSION; includes four pre-configured user accounts for testing and evaluation puposes. These accounts can be used for direct access to the portal. + </para> --> + <para> + For security reasons, before going in production, you should restrict the access to the login servlet to POST. + </para> + <para> + To do so, edit the file <filename>$JBOSS_HOME/server/[configuration]/gatein.ear/02portal.war/WEB-INF/web.xml</filename> and add: + </para> +<programlisting language="XML" role="XML"><![CDATA[ +<security-constraint> + <web-resource-collection> + <web-resource-name>login</web-resource-name> + <url-pattern>/login</url-pattern> + <http-method>GET</http-method> + <http-method>PUT</http-method> + <http-method>DELETE</http-method> + <http-method>HEAD</http-method> + <http-method>OPTIONS</http-method> + <http-method>TRACE</http-method> + </web-resource-collection> + <auth-constraint/> +</security-constraint> ]]></programlisting> + <para> + Doing this will render the login links provided on the front page inactive. + </para> + + </section> + + <section> + <title>Migration from Enterprise Portal Platform 4.3</title> + <para> + As stated in section 5 of this document, Enterprise Portal Platform 5 is based upon an entirely new core architecture and is not backwards compatible with Enterprise Portal Platform 4.3. + </para> + <para> + As a value added part of an enterprise subscription to EPP the JBoss Portal team is working to develop a set of migration utilities (which may take the form of documentation, guides and/or scripts) to assist customers in migration. We intend to release these utilities in a future revision of JBoss Enterprise Portal Platform 5.x. + </para> + <para> + For customers seeking to begin a migration prior to the availability of any Red Hat provided migration utilities, please contact Red Hat JBoss Support for migration advice. Red Hat JBoss support will be the main communication channel for migration knowledge as it is developed. + </para> + <para> + Red Hat JBoss Customer Support can be accessed <ulink type="http" url="https://www.redhat.com/apps/support/">here</ulink>;. + </para> + </section> + +<!-- <section id="Tech-previews"> + <title>Technology Previews</title> + + <para> + This section describes the Technology Preview features released alongside JBoss Enterprise Portal Platform, their installation, and any known issues. + </para> + + <warning> + <title>Technology Preview</title> + <para> + Technology Preview features are not fully supported under Red Hat subscription level agreements (SLAs), may not be functionally complete, and are not intended for production use. However, these features provide early access to upcoming product innovations, enabling customers to test functionality and provide feedback during the development process. As Red Hat considers making future iterations of Technology Preview features generally available, we will provide commercially reasonable efforts to resolve any reported issues that customers experience when using these features. + </para> + </warning> + <section> + <title>Site Publisher</title> + <para> + EPP includes an optional download from the Red Hat Customer Support Portal for a technical preview for an optional add on called Site Publisher. Site Publisher is an embedded web content authoring and publication component that provides many addtional features for organizations looking to enable line of business resources to directly manage sites, pages and content within the context of the portal versus through integration with an external web content management system. + </para> + </section> + </section> --> + + <section id="sect-Release_Notes-_Documentation_"> + <title> Documentation </title> + <para> + Visit <ulink type="http" url="http://www.redhat.com/docs/en-US/JBoss_Enterprise_Portal_Platfo... for further documentation regarding &PRODUCT;. + </para> + <para> + Amongst the online documentation you will find the following important guides: + </para> + <para> + <variablelist> + <varlistentry> + <term>Installation Guide</term> + <listitem> + <para> + This document explains how to install and verify the installation of &PRODUCT; using different installation methods. + </para> + <para> + Get the Installation Guide from <ulink type="http" url="http://www.redhat.com/docs/en-US/JBoss_Enterprise_Portal_Platfo... + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>User Guide</term> + <listitem> + <para> + This document provides an easy to follow guide to the functions and options available in &PRODUCT;. It is intended to be accessible and useful to both experienced and novice portal users. + </para> + <para> + Get the User Guide from <ulink type="http" url="http://www.redhat.com/docs/en-US/JBoss_Enterprise_Portal_Platfo... + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>Reference Guide</term> + <listitem> + <para> + This is a high-level usage document. It deals with more advanced topics than the Installation and User guides, adding new content or taking concepts discussed in the earlier documents further. It aims to provide supporting documentation for advanced users of &PRODUCT;. Its primary focus is on advanced use of the product and it assumes an intermediate or advanced knowledge of the technology and terms. + </para> + <para> + Get the Reference Guide from <ulink type="http" url="http://www.redhat.com/docs/en-US/JBoss_Enterprise_Portal_Platfo... + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + <para> + The online documentation will be updated as necessary so be sure to check the site regularly, especially when a new version of the &PRODUCT; is released. + </para> + </section> + + <section id="sect-Release_Notes-Product_Support_and_License_Website_Links"> + <title> Product Support and License Website Links </title> + <formalpara id="form-Release_Notes-Product_Support_and_License_Website_Links-Support_Processes"> + <title>Support Processes</title> + <para> + <ulink url="http://www.redhat.com/support/process/">http://www.redh... + </para> + </formalpara> + <formalpara id="form-Release_Notes-Product_Support_and_License_Website_Links-Production_Support_Scope_of_Coverage"> + <title> Production Support Scope of Coverage </title> + <para> + <ulink url="http://www.redhat.com/support/policy/soc/production">ht... + </para> + </formalpara> + <formalpara id="form-Release_Notes-Product_Support_and_License_Website_Links-Production_Support_Service_Level_Agreement"> + <title> Production Support Service Level Agreement </title> + <para> + <ulink url="http://www.redhat.com/support/policy/sla/production/">h... + </para> + </formalpara> + <formalpara id="form-Release_Notes-Product_Support_and_License_Website_Links-Developer_Support_Scope_of_Coverage"> + <title> Developer Support Scope of Coverage </title> + <para> + <ulink url="http://www.redhat.com/support/policy/soc/developer/">ht... + </para> + </formalpara> + <formalpara id="form-Release_Notes-Product_Support_and_License_Website_Links-Developer_Support_Service_Level_Agreement"> + <title> Developer Support Service Level Agreement </title> + <para> + <ulink url="http://www.redhat.com/support/policy/sla/developer/">ht... + </para> + </formalpara> + <formalpara id="form-Release_Notes-Product_Support_and_License_Website_Links-Product_Update_and_Support_Policy_by_Product"> + <title> Product Update and Support Policy by Product </title> + <para> + <ulink url="http://www.redhat.com/security/updates/jboss_notes/">ht... + </para> + </formalpara> + <formalpara id="form-Release_Notes-Product_Support_and_License_Website_Links-JBoss_End_User_License_Agreement"> + <title> JBoss End User License Agreement </title> + <para> + <ulink url="http://www.redhat.com/licenses/jboss_eula.html">http://... + </para> + </formalpara> + </section> + + <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> +</article> + Modified: epp/docs/tags/EPP_5_0_0_GA/Enterprise_Portal_Platform_Release_Notes/en-US/Book_Info.xml =================================================================== --- epp/docs/tags/EPP_5_0_0_GA/Enterprise_Portal_Platform_Release_Notes/en-US/Book_Info.xml 2010-06-01 23:51:30 UTC (rev 3222) +++ epp/docs/tags/EPP_5_0_0_GA/Enterprise_Portal_Platform_Release_Notes/en-US/Book_Info.xml 2010-06-02 00:12:02 UTC (rev 3223) @@ -2,7 +2,7 @@ <!DOCTYPE bookinfo PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ ]> <articleinfo id="arti-Release_Notes-Release_Notes"> - <title>Release Notes</title> + <title>5.0.0 Release Notes</title> <subtitle>For use with JBoss Enterprise Portal Platform 5.0.0</subtitle> <edition>1.0</edition> <pubsnumber>1</pubsnumber> Deleted: epp/docs/tags/EPP_5_0_0_GA/Enterprise_Portal_Platform_Release_Notes/en-US/Release_Notes.ent =================================================================== --- epp/docs/tags/EPP_5_0_0_GA/Enterprise_Portal_Platform_Release_Notes/en-US/Release_Notes.ent 2010-06-01 23:51:30 UTC (rev 3222) +++ epp/docs/tags/EPP_5_0_0_GA/Enterprise_Portal_Platform_Release_Notes/en-US/Release_Notes.ent 2010-06-02 00:12:02 UTC (rev 3223) @@ -1,4 +0,0 @@ -<!ENTITY HOLDER "Red Hat, Inc"> -<!ENTITY YEAR "2010"> -<!ENTITY PRODUCT "JBoss Enterprise Portal Platform"> -<!ENTITY VERSION "5.0.0"> Deleted: epp/docs/tags/EPP_5_0_0_GA/Enterprise_Portal_Platform_Release_Notes/en-US/Release_Notes.xml =================================================================== --- epp/docs/tags/EPP_5_0_0_GA/Enterprise_Portal_Platform_Release_Notes/en-US/Release_Notes.xml 2010-06-01 23:51:30 UTC (rev 3222) +++ epp/docs/tags/EPP_5_0_0_GA/Enterprise_Portal_Platform_Release_Notes/en-US/Release_Notes.xml 2010-06-02 00:12:02 UTC (rev 3223) @@ -1,1095 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ -]> -<article id="JBEPP_5_0_Release_Notes"> - <xi:include href="Book_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> - <section id="sect-Release_Notes-Introduction"> - <title>Introduction</title> - <para> - &PRODUCT; offers an intuitive, easy to manage user interface and a proven core infrastructure to enable organizations to quickly build dynamic web sites in a highly reusable way. By bringing the principals of Open Choice to the presentation layer, &PRODUCT; &VERSION; maximizes existing skills and technology investments. - </para> - <para> - By integrating proven open source frameworks such as JBoss Seam, Hibernate, Tomcat and JBoss Cache &PRODUCT; takes advantage of innovations in the open source community. As well, &PRODUCT; version &VERSION; is fully tested and supported by Red Hat, and is certified to work on many leading enterprise hardware and software products. - </para> - </section> - - <section> - <title>New Features</title> - <variablelist> - <varlistentry> - <term>Revamped User Interface</term> - <listitem> - <para> - JBoss Enterprise Portal Platform (EPP) has replaced it's existing JSF user interface with one based upon a new framework that is an extension of the Groovy framework. This new interface includes many new features geared towards enabling more interaction and customization of portals, skins and pages by non-development resources. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Master Object Page Model </term> - <listitem> - <para> - EPP has replaced the existing XML file drive page model towards a new model that treats each portlet page as an object stored in the Java Content Repository (JCR). This new model allows for pages to be highly reusable and enables simple page creation, editing and hierarchical node management within the portal. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>New Navigational Controls</term> - <listitem> - <para> - EPP has implemented navigational controls that dynamically and contextually get data from the JCR. These controls are portlet based and can be customized and modified to meet a wide range of navigational options. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Site and Page Wizards</term> - <listitem> - <para> - EPP has implemented wizard capabilities to simplify the creation of pages for non-development resources. These wizards enable selection of page placement in the portal, implementation of over 10 out of the box page layouts, addition of portlets and gadgets as well as page security. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Administration Portlets</term> - <listitem> - <para> - EPP has implemented an entirely new set of administration portlets to simplify the management of portlets and gadgets and well as users and groups. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Right to Left Language Support</term> - <listitem> - <para> - EPP supports localization and includes over 12 out of the box language localizations. This includes right to left language support. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Gadget Container</term> - <listitem> - <para> - EPP has implemented the Shindig Open Social Gadget container. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Portlet Bridge 2.0</term> - <listitem> - <para> - A new updated version of the Portlet Bridge Project that enables the easy creation of portlets that reuse JSF, Seam and Rich Faces applications. The new version of the bridge spans a wider range of use cases from the underlying applications as well as support for the Portlet 2.0 (JSR286) specification. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Example Portlets</term> - <listitem> - <para> - EPP includes a directory with additional example and sample portlets that can be compiled and modified to meet customer requirements in projects. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>New Identity Manager</term> - <listitem> - <para> - A new framework to manage users, groups and roles is implemented. This new identity manager enables attributes to utilize information from LDAP servers as well as external databases and applications - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>JBoss Enterprise Application Server 5.0</term> - <listitem> - <para> - The JBoss Enterprise Application Server 5.0 (JBoss EAP 5.0) is based on the JBoss AS 5.1.x family and is the latest release of the world's most popular application server. JBoss EAP 5.0 represents the state of the art with the second generation JBoss Microcontainer-based enterprise Java run-time. - </para> - <para> - In addition to supporting the latest Java EE specification (Java EE 5), JBoss EAP 5.0 integrates many of the best enterprise class services for advanced messaging, persistence, transactions, caching and high-availability. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>JBoss Microcontainer</term> - <listitem> - <para> - The JBoss Microcontainer is a refactoring of the modular JBoss JMX Microkernel. It is a lightweight kernel that manages the loading, lifecycle and dependencies between POJOs. Together with a Servlet/JSP container, an EJB container, deployers, and management utilities, the JBoss Microcontainer provides a standard Java EE 5 profile. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>JBoss Cache</term> - <listitem> - <para> - JBoss Cache provides replication for EJB and HTTP session state and supports distributed entity caching for JPA. It also provides superior performance and scalability with the new MultiVersion Concurrency Control (MVCC) locking scheme. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>JBoss Web Services</term> - <listitem> - <para> - JBoss Web Services is a framework that provides support for the latest JAX-WS specification as well as a plugin architecture for supporting alternative Web Services Stacks. - </para> - </listitem> - </varlistentry> - </variablelist> - </section> - - <section id="sect-Release_Notes-Architecture_of_PRODUCT_VERSION"> - <title>Component Versions</title> - <para> - This section details the versions of the components which create the JBoss Enterprise Portal Platform 5.0.0. - </para> - <table> - <title>JBoss Enterprise Portal Platform Component Versions</title> - <tgroup cols="2"> - <thead> - <row> - <entry> - Component - </entry> - <entry> - Version - </entry> - </row> - </thead> - <tbody> - <row> - <entry> - JBoss Enterprise Application Platform - </entry> - <entry> - 5.0.1 GA - </entry> - </row> - <row> - <entry> - JBoss Cache - </entry> - <entry> - 3.2.4 - </entry> - </row> - <row> - <entry> - GateIn Common - </entry> - <entry> - 2.0.2 - </entry> - </row> - <row> - <entry> - GateIn WCI - </entry> - <entry> - 2.0.1 - </entry> - </row> - <row> - <entry> - GateIn PC - </entry> - <entry> - 2.1.1 - </entry> - </row> - <row> - <entry> - GateIn WSRP - </entry> - <entry> - 1.1.1 - </entry> - </row> - <row> - <entry> - GateIn MOP - </entry> - <entry> - 1.0.2 - </entry> - </row> - <row> - <entry> - GateIn SSO - </entry> - <entry> - 1.0.0-epp - </entry> - </row> - <row> - <entry> - PicketLink IDM - </entry> - <entry> - 1.1.3 - </entry> - </row> - <row> - <entry> - eXoplatform JCR - </entry> - <entry> - 1.12.1 - </entry> - </row> - <row> - <entry> - eXoplatform Kernel - </entry> - <entry> - 2.2.1-GA - </entry> - </row> - <row> - <entry> - Portlet Bridge - </entry> - <entry> - 2.0 - </entry> - </row> - <row> - <entry> - Chromattic - </entry> - <entry> - 1.0.1 - </entry> - </row> - </tbody> - </tgroup> - </table> - </section> - - <section id="sect-Release_Notes-Certified_Environments"> - <title>Installation</title> - <para> - The JBoss Enterprise Portal Platform Installation Guide contains details of software and hardware requirements as well as detailed installation instructions. - </para> - <para> - The Installation Guide can be found online at <ulink type="http" url="http://www.redhat.com/docs/en-US/JBoss_Enterprise_Portal_Platfo...;. - </para> -<!-- <para> - The environments &PRODUCT; &VERSION; is certified to run on are: - </para> - <table id="tabl-Release_Notes-Certified_Environments-Java_Virtual_Machine_Support"> - <title>Java Virtual Machine Support</title> - <tgroup cols="2"> - <thead> - <row> - <entry> - Platform - </entry> - <entry> - JVM - </entry> - </row> - </thead> - <tbody> - <row> - <entry> - RHEL 5 x86 - </entry> - <entry> - <para> - Sun JDK 1.6 Update 15 (update v1.8) - </para> - <para> - OpenJDK 1.6.0-b09 (update v1.8) - </para> - <para> - IBM JDK 1.6.0 SR5 (update v1.8) - </para> - </entry> - </row> - <row> - <entry> - RHEL 5 x86_64 - </entry> - <entry> - <para> - Sun JDK 1.6 Update 15 (update v1.8) - </para> - <para> - OpenJDK 1.6.0-b09 (update v1.8) - </para> - <para> - IBM JDK 1.6.0 SR5 (update v1.8) - </para> - </entry> - </row> - <row> - <entry> - MS Windows 2008 x86 - </entry> - <entry> - Sun JDK 1.6 - </entry> - </row> - <row> - <entry> - MS Windows 2008 x86_64 - </entry> - <entry> - Sun JDK 1.6 - </entry> - </row> - <row> - <entry> - Solaris 10 - </entry> - <entry> - Sun JDK 1.6 - </entry> - </row> - </tbody> - </tgroup> - </table> - <table id="tabl-Release_Notes-Certified_Environments-Database_Support_"> - <title>Database Support </title> - <tgroup cols="3"> - <thead> - <row> - <entry> - DBMS - </entry> - <entry> - Server - </entry> - <entry> - JBDC Driver - </entry> - </row> - </thead> - <tbody> - <row> - <entry> - MySQL - </entry> - <entry> - <para> - 5.1 (certified) - </para> - <para> - 5.0 (compatible) - </para> - </entry> - <entry> - <para> - MYSQL Connector/J 5.1.8 (certified) - </para> - <para> - MySQL Connector/J 5.0.8 (compatible) - </para> - </entry> - </row> - <row> - <entry> - Oracle DB - </entry> - <entry> - <para> - 10g R2 (10.2.0.4) (certified) - </para> - <para> - 11g R1 (11.1.0.7.0) (compatible) - </para> - <para> - 11g RAC (11.1.0.7.0) (compatible) - </para> - </entry> - <entry> - <para> - Oracle 10g R2 (10.2.0.4) (certified) - </para> - <para> - Oracle 11g R1 (11.1.0.7) (compatible) - </para> - <para> - Oracle 11g R1 (11.1.0.7) (compatible) - </para> - </entry> - </row> - <row> - <entry> - MS SQL Server - </entry> - <entry> - <para> - 2005 SP3 (certified) - </para> - <para> - 2008 SP1 (certified) - </para> - </entry> - <entry> - JDBC Driver 2.0 (certified) - </entry> - </row> - <row> - <entry> - PostgresSQL - </entry> - <entry> - <para> - 8.3.7 (certified) - </para> - <para> - 8.2.4 (compatible) - </para> - </entry> - <entry> - <para> - JDBC4 Driver, Ver 8.3-605 (certified) - </para> - <para> - JDBC4 Driver, Ver 8.2-510 (compatible) - </para> - </entry> - </row> - <row> - <entry> - DB2 - </entry> - <entry> - 9.7 (certified) - </entry> - <entry> - IBM Data Server Driver for JDBC and SQLJ (JCC Driver) Version: 9.1 (fixpack 3a) (certified) - </entry> - </row> - <row> - <entry> - Sybase - </entry> - <entry> - 15.0.2 (certified) - </entry> - <entry> - JConnect v6.0.5 (Build 26564 / 11 Jun 2009) (certified) - </entry> - </row> - </tbody> - </tgroup> - </table> - <table id="tabl-Release_Notes-Certified_Environments-Directory_Support"> - <title>Directory Support</title> - <tgroup cols="2"> - <thead> - <row> - <entry> - Directory Service - </entry> - <entry> - Version - </entry> - </row> - </thead> - <tbody> - <row> - <entry> - OpenDS - </entry> - <entry> - <para> - 1.2 - </para> - <para> - 2.0 - </para> - </entry> - </row> - <row> - <entry> - OpenLDAP - </entry> - <entry> - 2.4 - </entry> - </row> - <row> - <entry> - Red Hat Identity Server - </entry> - <entry> - 7.1 or later - </entry> - </row> - <row> - <entry> - MS Active Directory - </entry> - <entry> - Windows Server 2008 - </entry> - </row> - </tbody> - </tgroup> - </table> - <table id="tabl-Release_Notes-Certified_Environments-Browser_support"> - <title>Browser support</title> - <tgroup cols="2"> - <thead> - <row> - <entry> - Browser - </entry> - <entry> - Version - </entry> - </row> - </thead> - <tbody> - <row> - <entry> - Internet Explorer - </entry> - <entry> - <para>7</para> - <para>8</para> - </entry> - </row> - <row> - <entry> - Firefox - </entry> - <entry> - <para> - 3 - </para> - <para> - 3.5 - </para> - </entry> - </row> - <row> - <entry> - Safari - </entry> - <entry> - 4 - </entry> - </row> - </tbody> - </tgroup> - </table> --> - </section> - -<!-- <section id="Issues-fixed-in-this-release"> - <title> - Issues fixed in this release - </title> - <warning> - <title>TODO</title> - <para> - Following is a list of issues fixed in this release: - </para> - </warning> - <formalpara> - <title>Component 1</title> - <para> - <itemizedlist> - <listitem> - <para> - Issues fixed. - </para> - </listitem> - </itemizedlist> - </para> - </formalpara> - <formalpara> - <title>Component 2</title> - <para> - <itemizedlist> - <listitem> - <para> - Issues fixed. - </para> - </listitem> - </itemizedlist> - </para> - </formalpara> - <formalpara> - <title>Etc</title> - <para> - <itemizedlist> - <listitem> - <para> - Issues fixed. - </para> - </listitem> - </itemizedlist> - </para> - </formalpara> - </section> --> - - <section id="sect-Release_Notes-_Known_Issues_with_this_release_"> - <title> Known Issues with this release </title> - - <para> - JBoss Enterprise Portal Platform 5.0 is based upon an entirely new JBoss community project named GateIn (<ulink type="http" url="http://www.gatein.org">www.gatein.org</ulink>). Previous releases were based upon the JBoss Portal Community Project (<ulink type="http" url="http://www.jboss.org/jbossportal">http://www.jboss.org/...>). - </para> - <para> - Every reasonable effort has been made to address issues with the previous releases of Enterprise Portal Platform. However, since this is a completely new architecture it is difficult to provide a pure translation of issues from release to release. - </para> - -<!-- <section> - <title>Security Issues</title> - <variablelist> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBPAPP-3171">https://jira... - <listitem> - <para> - Cross-site scripting (XSS) vulnerabilities were found in the Enterprise Application Platform component of &PRODUCT;. While the issue has been addressed, some minor vulnerabilities may linger in this release. - </para> - <para> - This issue will be completely resolved in a future release of &PRODUCT;. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBPAPP-4141">https://jira... - <listitem> - <para> - Some servlets may leak information about a portal's version, running environment, system hardware or Java Virtual Machine setups. - </para> - <para> - This issue will be resolved in a future release of &PRODUCT;. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term> Autologin</term> - <listitem> - <para> - The new autologin feature in &PRODUCT;, could be exploited in production environments. - </para> - <para> - To disable autologin ... - </para> - - - </listitem> - </varlistentry> - <varlistentry> - <term>Non-changing Captcha</term> - <listitem> - <para> - The <emphasis>captcha</emphasis> registration feature can be brute-forced to not change, which can allow fake users to be created automatically and in bulk. - </para> - <para> - To prevent this a new captcha must be created with every <literal>post</literal> request to the portal user register. - </para> - <para> - This fix will be implemented in a future release of &PRODUCT;. - </para> - </listitem> - </varlistentry> - </variablelist> - </section> --> - - <section id="sect-Release_Notes-_Known_Issues_with_this_release_-General_Known_Issues"> - <title>General Known Issues</title> - <formalpara> - <title><ulink url="https://jira.jboss.org/secure/IssueNavigator.jspa?mode=hide&... - <para> - A list of general issues in this release. - </para> - </formalpara> - </section> - - <section id="sect-Release_Notes-_Known_Issues_with_this_release_-Component_Specific_Known_Issues"> - <title>Specific Known Issues</title> - <variablelist> - <varlistentry> - <term><ulink type="http" url="">https://jira.jboss.org/browse/JBEPP-167</ulink>... - <listitem> - <para> - EPP will not start on an IBM JVM unless the <filename>jcip-annotations.jar</filename> file is copied into /server/default/lib. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-207">https://jira.j... - <listitem> - <para> - A <literal>NullPointerException</literal> may be encountered when selecting a page which has been deleted in Page Management. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-208">https://jira.j... - <listitem> - <para> - An '<emphasis role="bold">Unknown errror</emphasis>' may be encountered while a editing page or layout in Dashboard under certain circumstances. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term> <ulink type="http" url="https://jira.jboss.org/browse/JBEPP-210">https://jira.j... - <listitem> - <para> - An '<emphasis role="bold">Unknown error</emphasis>' may be returned when trying to save a page from which an application has been removed. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-212">https://jira.j... - <listitem> - <para> - Performing concurrent modifications of a dashboard may result in an error. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-226">https://jira.j... - <listitem> - <para> - Uppercase and lowercase characters are not differentiated in the application registry. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-262">https://jira.j... - <listitem> - <para> - &PRODUCT; requires a one-off patch in EAP to fix the bug <ulink type="http" url="https://jira.jboss.org/browse/JBPAPP-3977">JBossWS - Timeout value gets inserted into URLs</ulink>. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-296">https://jira.j... - <listitem> - <para> - The error message "<emphasis role="bold">Page not found</emphasis>" is displayed after the layout of any portal page is edited. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-315">https://jira.j... - <listitem> - <para> - Pre-release testing indicated that render parameters in JSR-286 portlets are not replicating in a cluster with 2-nodes. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-326">https://jira.j... - <listitem> - <para> - The error message displayed when creating portal which starts with a number (an illegal character) contains the typographical error '<emphasis role="bold">contains</emphasis>'. - </para> - <para> - The message should read as: <emphasis role="bold">The "Portal Name :" field must start with a character and must not contain special characters</emphasis>. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-331">https://jira.j... - <listitem> - <para> - The logo in the logo portlet on the &PRODUCT; Dashboard has a relative URL. This can cause URL validation issues returning the error: <emphasis role="bold">The field "logoUrl" must match the format "URL"</emphasis>. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-334">https://jira.j... - <listitem> - <para> - Uppercase lettering does not work with MYSQL databases. This can cause problems when creating pages or portals with the same name. - </para> - <para> - This is caused by MYSQL's <literal>VARCAHR</literal> entry in the <literal>JCR_SITEM</literal> table not being case sensitive. A patch has been written that solves this issue by switching the <literal>VARCHAR</literal> entry to use <literal>VARBINARY</literal> which is case sensitive. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-339">https://jira.j... - <listitem> - <para> - A <literal>NullPointerException</literal> is encountered when attempting to access a Dashboard after a page has been deleted. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-342">https://jira.j... - <listitem> - <para> - Unicode and special characters in some languages (specifically German) are badly escaped in the names of navigation nodes. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-343">https://jira.j... - <listitem> - <para> - When creating or deleting new group navigations, changes do not appear in the portal until after a logout/login. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-344">https://jira.j... - <listitem> - <para> - There are currently some User Interface display inconsistencies when using Internet Explorer 6 to edit or view a portal. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-350">https://jira.j... - <listitem> - <para> - An error is encountered when adding a gadget to a portal using a MYSQL database if the '<filename>/server/production</filename>' folder has been removed but the database has not been cleaned. - </para> - <para> - In this scenario the error; <emphasis role="bold">Unable to retrieve gadget xml. HTTP error 500</emphasis> is returned. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-355">https://jira.j... - <listitem> - <para> - The portal will return a permissions error when trying to add all groups in the group navigation, even if the user is logged in as the portal administrator (root). - </para> - <para> - The error message will read: <emphasis role="bold">This user doesn't have permissions to add navigation</emphasis>. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-356">https://jira.j... - <listitem> - <para> - Groups listed in the Add Navigation window of the Group navigation page are not currently listed in alphabetical order. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-358">https://jira.j... - <listitem> - <para> - When using the portal with the French language and attempting to recover a lost/forgotten password, the recovery window is not translated into French and refers to the portal as eXo, as opposed to &PRODUCT;. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-360">https://jira.j... - <listitem> - <para> - The login page shown after a timed-out session or a failed login attempt is currently branded with the <literal>GateIn</literal> name and logo. <literal>GateIn</literal> is a community project that &PRODUCT; is based on. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-362">https://jira.j... - <listitem> - <para> - The JSPHelloWorld portlet example currently returns the line: "<emphasis role="bold">my name is JBoss Portal. What's yours?</emphasis>". The line should read: "<emphasis role="bold">my name is &PRODUCT;. What's yours?</emphasis>". - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-367">https://jira.j... - <listitem> - <para> - The SEAM component used in &PRODUCT; &VERSION; has a bug that makes it generate AS 5 incompatible pages. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-369">https://jira.j... - <listitem> - <para> - The use of two JSR286 portlets that use the same portlet-name but different portlet applications will create an exception in the application registry. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-363">https://jira.j... - <listitem> - <para> - A deleted user's entry can still be seen, and edited, in the database after they are removed from LDAP. - </para> - <para> - If the password for the deleted user's account is changed after deletion, and a login attempt is made using the new password an error is encountered and further logins cannot be completed. - </para> - <para> - Clearing the user session will clear this error and allow normal logins. - </para> - </listitem> - </varlistentry> - </variablelist> - </section> - - </section> - - - <section> - <title>Recommended Practices</title> -<!-- <para> - &PRODUCT; &VERSION; includes four pre-configured user accounts for testing and evaluation puposes. These accounts can be used for direct access to the portal. - </para> --> - <para> - For security reasons, before going in production, you should restrict the access to the login servlet to POST. - </para> - <para> - To do so, edit the file <filename>$JBOSS_HOME/server/[configuration]/gatein.ear/02portal.war/WEB-INF/web.xml</filename> and add: - </para> -<programlisting language="XML" role="XML"><![CDATA[ -<security-constraint> - <web-resource-collection> - <web-resource-name>login</web-resource-name> - <url-pattern>/login</url-pattern> - <http-method>GET</http-method> - <http-method>PUT</http-method> - <http-method>DELETE</http-method> - <http-method>HEAD</http-method> - <http-method>OPTIONS</http-method> - <http-method>TRACE</http-method> - </web-resource-collection> - <auth-constraint/> -</security-constraint> ]]></programlisting> - <para> - Doing this will render the login links provided on the front page inactive. - </para> - - </section> - - <section> - <title>Migration from Enterprise Portal Platform 4.3</title> - <para> - As stated in section 5 of this document, Enterprise Portal Platform 5 is based upon an entirely new core architecture and is not backwards compatible with Enterprise Portal Platform 4.3. - </para> - <para> - As a value added part of an enterprise subscription to EPP the JBoss Portal team is working to develop a set of migration utilities (which may take the form of documentation, guides and/or scripts) to assist customers in migration. We intend to release these utilities in a future revision of JBoss Enterprise Portal Platform 5.x. - </para> - <para> - For customers seeking to begin a migration prior to the availability of any Red Hat provided migration utilities, please contact Red Hat JBoss Support for migration advice. Red Hat JBoss support will be the main communication channel for migration knowledge as it is developed. - </para> - <para> - Red Hat JBoss Customer Support can be accessed <ulink type="http" url="https://www.redhat.com/apps/support/">here</ulink>;. - </para> - </section> - -<!-- <section id="Tech-previews"> - <title>Technology Previews</title> - - <para> - This section describes the Technology Preview features released alongside JBoss Enterprise Portal Platform, their installation, and any known issues. - </para> - - <warning> - <title>Technology Preview</title> - <para> - Technology Preview features are not fully supported under Red Hat subscription level agreements (SLAs), may not be functionally complete, and are not intended for production use. However, these features provide early access to upcoming product innovations, enabling customers to test functionality and provide feedback during the development process. As Red Hat considers making future iterations of Technology Preview features generally available, we will provide commercially reasonable efforts to resolve any reported issues that customers experience when using these features. - </para> - </warning> - <section> - <title>Site Publisher</title> - <para> - EPP includes an optional download from the Red Hat Customer Support Portal for a technical preview for an optional add on called Site Publisher. Site Publisher is an embedded web content authoring and publication component that provides many addtional features for organizations looking to enable line of business resources to directly manage sites, pages and content within the context of the portal versus through integration with an external web content management system. - </para> - </section> - </section> --> - - <section id="sect-Release_Notes-_Documentation_"> - <title> Documentation </title> - <para> - Visit <ulink type="http" url="http://www.redhat.com/docs/en-US/JBoss_Enterprise_Portal_Platfo... for further documentation regarding &PRODUCT;. - </para> - <para> - Amongst the online documentation you will find the following important guides: - </para> - <para> - <variablelist> - <varlistentry> - <term>Installation Guide</term> - <listitem> - <para> - This document explains how to install and verify the installation of &PRODUCT; using different installation methods. - </para> - <para> - Get the Installation Guide from <ulink type="http" url="http://www.redhat.com/docs/en-US/JBoss_Enterprise_Portal_Platfo... - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>User Guide</term> - <listitem> - <para> - This document provides an easy to follow guide to the functions and options available in &PRODUCT;. It is intended to be accessible and useful to both experienced and novice portal users. - </para> - <para> - Get the User Guide from <ulink type="http" url="http://www.redhat.com/docs/en-US/JBoss_Enterprise_Portal_Platfo... - </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Reference Guide</term> - <listitem> - <para> - This is a high-level usage document. It deals with more advanced topics than the Installation and User guides, adding new content or taking concepts discussed in the earlier documents further. It aims to provide supporting documentation for advanced users of &PRODUCT;. Its primary focus is on advanced use of the product and it assumes an intermediate or advanced knowledge of the technology and terms. - </para> - <para> - Get the Reference Guide from <ulink type="http" url="http://www.redhat.com/docs/en-US/JBoss_Enterprise_Portal_Platfo... - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - <para> - The online documentation will be updated as necessary so be sure to check the site regularly, especially when a new version of the &PRODUCT; is released. - </para> - </section> - - <section id="sect-Release_Notes-Product_Support_and_License_Website_Links"> - <title> Product Support and License Website Links </title> - <formalpara id="form-Release_Notes-Product_Support_and_License_Website_Links-Support_Processes"> - <title>Support Processes</title> - <para> - <ulink url="http://www.redhat.com/support/process/">http://www.redh... - </para> - </formalpara> - <formalpara id="form-Release_Notes-Product_Support_and_License_Website_Links-Production_Support_Scope_of_Coverage"> - <title> Production Support Scope of Coverage </title> - <para> - <ulink url="http://www.redhat.com/support/policy/soc/production">ht... - </para> - </formalpara> - <formalpara id="form-Release_Notes-Product_Support_and_License_Website_Links-Production_Support_Service_Level_Agreement"> - <title> Production Support Service Level Agreement </title> - <para> - <ulink url="http://www.redhat.com/support/policy/sla/production/">h... - </para> - </formalpara> - <formalpara id="form-Release_Notes-Product_Support_and_License_Website_Links-Developer_Support_Scope_of_Coverage"> - <title> Developer Support Scope of Coverage </title> - <para> - <ulink url="http://www.redhat.com/support/policy/soc/developer/">ht... - </para> - </formalpara> - <formalpara id="form-Release_Notes-Product_Support_and_License_Website_Links-Developer_Support_Service_Level_Agreement"> - <title> Developer Support Service Level Agreement </title> - <para> - <ulink url="http://www.redhat.com/support/policy/sla/developer/">ht... - </para> - </formalpara> - <formalpara id="form-Release_Notes-Product_Support_and_License_Website_Links-Product_Update_and_Support_Policy_by_Product"> - <title> Product Update and Support Policy by Product </title> - <para> - <ulink url="http://www.redhat.com/security/updates/jboss_notes/">ht... - </para> - </formalpara> - <formalpara id="form-Release_Notes-Product_Support_and_License_Website_Links-JBoss_End_User_License_Agreement"> - <title> JBoss End User License Agreement </title> - <para> - <ulink url="http://www.redhat.com/licenses/jboss_eula.html">http://... - </para> - </formalpara> - </section> - - <xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude" /> -</article> -