Author: smumford Date: 2010-11-08 05:19:24 -0500 (Mon, 08 Nov 2010) New Revision: 4966 Modified: epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/5.1.0_Release_Notes.xml epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Book_Info.xml epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Revision_History.xml Log: JBEPP-603: Added further JIRA descriptions to Known and Resolved Isses sections, and added 'Resolved Upstream' section. Modified: epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/5.1.0_Release_Notes.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/5.1.0_Release_Notes.xml 2010-11-08 03:40:16 UTC (rev 4965) +++ epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/5.1.0_Release_Notes.xml 2010-11-08 10:19:24 UTC (rev 4966) @@ -17,7 +17,7 @@ </section> <section id="sect-Release_Notes-New_Features_and_Components"> - <title>New Features and Components</title> + <title>New Features and Component Upgrades</title> <variablelist id="vari-Release_Notes-New_Features_and_Components-New_Features"> <title>New Features</title> <varlistentry> @@ -31,10 +31,9 @@ </para> </listitem> </varlistentry> - </variablelist> <variablelist id="vari-Release_Notes-New_Features_and_Components-Component_Upgrades_in_VERSION_MICRO"> - <title><emphasis role="bold">Component Upgrades in &VERSION_MICRO;</emphasis></title> + <title><emphasis role="bold">Component Upgrades</emphasis></title> <varlistentry> <term>WSRP</term> <listitem> @@ -49,11 +48,8 @@ <para> The JBoss Cache component has been upgraded to version 3.2.6. </para> - </listitem> - </varlistentry> - </variablelist> </section> @@ -212,7 +208,7 @@ </table> - </section> + </section> <!--Close Section: Component Versions--> <section id="sect-Release_Notes-Installation"> <title>Installation</title> @@ -228,7 +224,7 @@ <section id="sect-Release_Notes-Issues_fixed_in_this_release"> <title> Issues fixed in this release </title> <para> - Following is a list of issues fixed in this release: + The following is a list of issues fixed in this release: </para> <!-- Commented out for current release. Retaining the text to be reused in future release drafts. --> <warning> @@ -239,9 +235,9 @@ <para> <emphasis role="bold">They are likely not technically correct at the moment</emphasis>, but they will serve as a basis and will be corrected in subsequent iterations after technical and QE reviews. </para> - </warning> <variablelist> + <title><emphasis role="bold">Issues fixed in the product:</emphasis></title> <varlistentry> <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-513"></ulink>... <listitem> @@ -256,96 +252,221 @@ </para> </listitem> </varlistentry> - <varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-589"></ulink>... + <listitem> + <para> + The RSS reader gadget was displaying incorrect publication dates for items fetched from feed sources. + </para> + <para> + Each item was being displayed with a publish date of <emphasis>less than a minute ago</emphasis>, regardless of when it was published by the feed. + </para> + <para> + The RSS aggregator has been patched to fetch and display the correct publication date. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-587"></ulink>... + <listitem> + <para> + Some gadgets that do not have configurable preferences were displaying an unusable edit icon. + </para> + <para> + The gadget UI has been amended to remove the edit icon in gadgets that do not have configurable preferences. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-585"></ulink>... + <listitem> + <para> + A bug was found that prevented administrators from changing the permissions of a category in the <emphasis role="bold">Application Registry</emphasis> from <emphasis>Public</emphasis> to a restricted group. + </para> + <para> + The Application Registry <emphasis role="bold">UIPermissionForm</emphasis> java code has been patched to correct his behaviour. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-584"></ulink>... + <listitem> + <para> + An ambiguous error message returned when a URL referenced in a gadget does not exist has been revised and clarified. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-571"></ulink>... + <listitem> + <para> + A bug that caused user preferences to be lost when the ToDo gadget was dragged and dropped on a Dashboard has been resolved. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-534"></ulink>... + <listitem> + <para> + Users may have previously encountered errors when trying to add a remote gadget to a portal instance running on a HTTPS domain. + </para> + <para> + The error stated that the URL was invalid even when correct. This was because the Application Registry was expecting a valid certificate signed by a CA to verify the URL. + </para> + <para> + This error can be avoided by adding the certificate to the JRE CA with the command: + </para> +<programlisting>keytool -import -alias toto -keystore /home/<replaceable>USER</replaceable>/Tools/Java/<replaceable>JDK_VERSION</replaceable>/jre/lib/security/cacerts -file ~/<replaceable>mycertificate</replaceable> +</programlisting> + <para> + (Where <emphasis role="bold">mycertificate</emphasis> is the certificate created for SSL) + </para> + <para> + This information has also been added to the &PRODUCT; User Guide. + </para> + </listitem> + </varlistentry> + </variablelist> + + <variablelist> + <title>Issues fixed upstream:</title> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-454"></ulink>... + <listitem> + <para> + This release includes numerous fixes for issues reported upstream. Follow the link above to review a tracking ticket listing these issues and fixes. + </para> + </listitem> + </varlistentry> + </variablelist> + </section> <!-- Close Section: Issues Fixed--> + + <section id="sect-Release_Notes-_Known_Issues_with_this_release_"> + <title> Known Issues with this release (Issues open as at 08 Nov 2010)</title> + <para> + The following is a list of known issues in this release: + </para> + <variablelist> + <varlistentry> <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-508" /></term> <listitem> <para> - A naming duplication in pre-packaged "Hello World" portlet examples would cause an exception when both of the portlet examples were deployed. This issues has been resolved by renaming the <replaceable>Original_name</replaceable> portlet to <replaceable>New_name</replaceable>. - </para> - <para> - Refer to the source commit logs in the above JIRA for specific code changes in this fix. - </para> - <important> - <title><emphasis role="bold">DOC NOTE:</emphasis></title> - <para> - This JIRA, although slated for fix in EPP 5.1.0.ER04, was still open at the time of writing this Release Note. - </para> - </important> + A naming duplication in pre-packaged "Hello World" portlet examples causes an exception when both of the portlet examples are deployed. + </para> </listitem> - </varlistentry> + </varlistentry> <varlistentry> <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-546"></ulink>... <listitem> <para> - A bug was found that affected the selection of users to add to a group. User selections made on the first page of the user list were lost when navigating to subsequent pages of the list. + A bug has been found that affects the selection of users being added to a group. User selections made on the first page of the user list, should the list span multiple pages, are lost when navigating to subsequent pages. </para> <para> - The relevant code has been refined and now user selections are persistent across pages. Refer to the source commit logs in the above JIRA for specific code changes in this fix. + The user selections should be persistent across pages. </para> - <important> - <title><emphasis role="bold">DOC NOTE:</emphasis></title> - <para> - This JIRA, although slated for fix in EPP 5.1.0.ER04, was still open at the time of writing this Release Note. - </para> - </important> </listitem> </varlistentry> <varlistentry> <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-579"></ulink>... <listitem> <para> - A <emphasis role="bold">NullPointerException</emphasis> would be encountered if no <filename>navigation.xml</filename> file had been created for an LDAP user. A change to code in <filename>UIUserToolBarDashboardPortlet.gtmpl</filename> has corrected this issue by including a clause for this circumstance. + A <emphasis role="bold">NullPointerException</emphasis> is encountered if no <filename>navigation.xml</filename> file has been created for an LDAP user. </para> - <important> - <title><emphasis role="bold">DOC NOTE:</emphasis></title> - <para> - This JIRA, although slated for fix in EPP 5.1.0.ER04, was still open at the time of writing this Release Note. - </para> - </important> </listitem> </varlistentry> - </variablelist> - <important> - <title><emphasis role="bold">DOCS NOTE:</emphasis></title> - <para> - Do the <ulink type="http" url="https://jira.jboss.org/browse/JBEPP/component/12312983">... Requirements</ulink> and <ulink type="http" url="https://jira.jboss.org/browse/JBEPP/component/12313444">SP Integration</ulink> JIRAs need Release Notes? - </para> - <para> - All the <emphasis role="bold">EPP51-###</emphasis> JIRAs seem to pertain to features in SP, which will be documented elsewhere (although probably not as Release Notes). - </para> - </important> - </section> - - <section id="sect-Release_Notes-_Known_Issues_with_this_release_"> - <title> Known Issues with this release </title> - <section id="sect-Release_Notes-_Known_Issues_with_this_release_-General_Known_Issues"> - <title>General Known Issues</title> - <para> - A list of general issues in this release can be found at: - </para> - <para> - <ulink type="http" url="https://jira.jboss.org/secure/IssueNavigator.jspa?mode=hide&... /> - </para> - - </section> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-600"></ulink>... + <listitem> + <para> + Creating new portals with names that contain all or part of the word 'portal' (such as: "por", "port", "porta" and "portal") will result in an incorrect URL writing to the Site links section of the main portal. This, in turn, will produce '404: Page not found' HTTP response errors when using these links. + </para> + <para> + Customers are advised to avoid using the problematic character sequences in new portal names until this issue is resolved. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-599"></ulink>... + <listitem> + <para> + If a portal is deleted from its own Site management page (that is; if a user deletes the portal they are currently logged into), the resultant redirect returns the user to the public mode of the default portal (<emphasis>/portal/public/classic</emphasis>). + </para> + <para> + The user should be redirected to the private mode of the default portal (<emphasis>/portal/private/classic</emphasis>). + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-554"></ulink>... + <listitem> + <para> + Safari 4.0.4 users may experience problems adding gadgets to Dashboard pages. JavaScript errors appear when dropping a gadget onto a page and an empty space appears where the gadget was placed. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-592"></ulink>... + <listitem> + <para> + Editing the <emphasis role="bold">Template</emphasis> field of the banner or footer portlet preferences to any non-default value can result in changes not being validated as the portlets, by default, require a groovy template. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-570"></ulink>... + <listitem> + <para> + &PRODUCT; &VERSION_MAJOR; does not start when used in conjunction with Oracle 11g R2 RAC. An error will occur when attempting to start the JCR connected to this type of database. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-562"></ulink>... + <listitem> + <para> + A <emphasis role="bold">NullPointerException</emphasis> can be seen in a server log stacktrace after a user authenticated with the SPNEGO Single Sign-On method is automatically evicted after the set time-out period has elapsed. + </para> + <para> + This issue does not produce any flow-on effects. + </para> + </listitem> + </varlistentry> + </variablelist> + </section> <!-- Close Section: Known Issues--> -<!-- <section> + <section> <title>Security Issues</title> <variablelist> <varlistentry> - <term>No issues</term> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-610"></ulink>... <listitem> <para> - Any security related JIRA issues that need to go in here? JIRA says no. + Customers should be aware that passwords entered into the portal login form and submitted with the <emphasis>Remember me</emphasis> option are stored in the JCR database in plain text. This presents a possible security vulnerability. </para> - <para> - If there aren't any JIRAs that need to be documented here, I'll remove this section. - </para> + <important> + <title><emphasis role="bold">DOC NOTE</emphasis></title> + <para> + As yet there is no workaround/solution to this security issue. + </para> + </important> </listitem> </varlistentry> + <varlistentry> + <term><ulink type="http" url="https://jira.jboss.org/browse/JBEPP-593"></ulink>... + <listitem> + <para> + Safari and Firefox 3.6 users are advised that the 'captcha' security device may not refresh when registering new users, meaning that the same alphanumeric code will be presented when adding another user. + </para> + <important> + <title><emphasis role="bold">DOC NOTE</emphasis></title> + <para> + As yet there is no workaround/solution to this security issue. + </para> + </important> + </listitem> + </varlistentry> </variablelist> - </section> --> - </section> + </section> <!-- Close Section: Security Issues--> <section id="sect-Release_Notes-Migration_from_Enterprise_Portal_Platform_4.3"> <title>Migration from Enterprise Portal Platform 4.3</title> @@ -379,7 +500,7 @@ </section> <section id="sect-Release_Notes-_Documentation_"> - <title> Documentation </title> + <title>Documentation</title> <para> Visit <ulink type="http" url="http://docs.redhat.com/docs/en-US/index.html">http://do... for further documentation regarding &PRODUCT;. </para> Modified: epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Book_Info.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Book_Info.xml 2010-11-08 03:40:16 UTC (rev 4965) +++ epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Book_Info.xml 2010-11-08 10:19:24 UTC (rev 4966) @@ -7,12 +7,12 @@ <title>5.1.0 Release Notes</title> <subtitle>For use with JBoss Enterprise Portal Platform 5.1.0</subtitle> <edition>1</edition> - <pubsnumber>1.0</pubsnumber> + <pubsnumber>1.2</pubsnumber> <productname>JBoss Enterprise Portal Platform</productname> <productnumber>5</productnumber> <abstract> <para> - These release notes contain important information related to JBoss Enterprise Portal Platform 5.1.0 that may not be currently available in the Product Manuals. You should read these Release Notes in their entirety before installing JBoss Enterprise Portal Platform 5.1.0. + These release notes contain important information related to &PRODUCT; &VERSION_MICRO; that may not be currently available in the Product Manuals. You should read these Release Notes in their entirety before installing the product. </para> </abstract> Modified: epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Revision_History.xml =================================================================== --- epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Revision_History.xml 2010-11-08 03:40:16 UTC (rev 4965) +++ epp/docs/branches/EPP_5_1_Branch/Release_Notes/en-US/Revision_History.xml 2010-11-08 10:19:24 UTC (rev 4966) @@ -7,6 +7,34 @@ <title>Revision History</title> <simpara> <revhistory> + <revision> + <revnumber>1-1.2</revnumber> + <date>Mon Nov 08 2010</date> + <author> + <firstname>Scott</firstname> + <surname>Mumford</surname> + <email&gt;smumford(a)redhat.com&lt;/email&gt; + </author> + <revdescription> + <simplelist> + <member>Added further JIRA descriptions to Known and Resolved Issues sections and added 'Resolved Upstream' section.</member> + </simplelist> + </revdescription> + </revision> + <revision> + <revnumber>1-1.1</revnumber> + <date>Thur Nov 04 2010</date> + <author> + <firstname>Scott</firstname> + <surname>Mumford</surname> + <email&gt;smumford(a)redhat.com&lt;/email&gt; + </author> + <revdescription> + <simplelist> + <member>Added draft issues descriptions.</member> + </simplelist> + </revdescription> + </revision> <revision> <revnumber>1-1.0</revnumber> <date>Tues Oct 26 2010</date> @@ -27,7 +55,7 @@ <email&gt;theute(a)redhat.com&lt;/email&gt; </author> --> <revdescription> <simplelist> - <member>Release Notes created for Enterprise Portal Platform 5.1.0 release.</member> + <member>Release Notes created for &PRODUCT; &VERSION_MICRO; release.</member> </simplelist>