Author: smumford Date: 2011-12-06 18:20:56 -0500 (Tue, 06 Dec 2011) New Revision: 8198 Modified: epp/docs/branches/5.2/Migration_Guide/en-US/Book_Info.xml epp/docs/branches/5.2/Migration_Guide/en-US/Revision_History.xml epp/docs/branches/5.2/Migration_Guide/en-US/chapter-2-Portal_Containers.xml epp/docs/branches/5.2/Migration_Guide/en-US/chapter-3-Portal_URLs.xml epp/docs/branches/5.2/Migration_Guide/en-US/chapter-5-User_interface.xml Log: JBEPP-1441: Documented changes to <filename>web.xml</filename>. Modified: epp/docs/branches/5.2/Migration_Guide/en-US/Book_Info.xml =================================================================== --- epp/docs/branches/5.2/Migration_Guide/en-US/Book_Info.xml 2011-12-05 23:53:15 UTC (rev 8197) +++ epp/docs/branches/5.2/Migration_Guide/en-US/Book_Info.xml 2011-12-06 23:20:56 UTC (rev 8198) @@ -6,7 +6,7 @@ <productname>JBoss Enterprise Portal Platform</productname> <productnumber>5.2</productnumber> <edition>5.2.0</edition> - <pubsnumber>2</pubsnumber> + <pubsnumber>3</pubsnumber> <abstract> <para> This guide will assist Portal administrators to migrate from an installation of JBoss Enterprise Portal Platform 5.1 to the 5.2 version. Modified: epp/docs/branches/5.2/Migration_Guide/en-US/Revision_History.xml =================================================================== --- epp/docs/branches/5.2/Migration_Guide/en-US/Revision_History.xml 2011-12-05 23:53:15 UTC (rev 8197) +++ epp/docs/branches/5.2/Migration_Guide/en-US/Revision_History.xml 2011-12-06 23:20:56 UTC (rev 8198) @@ -5,6 +5,20 @@ <simpara> <revhistory> <revision> + <revnumber>5.2.0-3</revnumber> + <date>Wed Dec 7 2011</date> + <author> + <firstname>Scott</firstname> + <surname>Mumford</surname> + <email></email> + </author> + <revdescription> + <simplelist> + <member>JBEPP-1441: Documented changes to <filename>web.xml</filename>.</member> + </simplelist> + </revdescription> + </revision> + <revision> <revnumber>5.2.0-2</revnumber> <date>Fri Nov 25 2011</date> <author> Modified: epp/docs/branches/5.2/Migration_Guide/en-US/chapter-2-Portal_Containers.xml =================================================================== --- epp/docs/branches/5.2/Migration_Guide/en-US/chapter-2-Portal_Containers.xml 2011-12-05 23:53:15 UTC (rev 8197) +++ epp/docs/branches/5.2/Migration_Guide/en-US/chapter-2-Portal_Containers.xml 2011-12-06 23:20:56 UTC (rev 8198) @@ -3,13 +3,13 @@ <chapter id="sid-13467783"> <title>Portal Containers</title> - <para>If a customized portal container was used in JBoss Enterprise Portal Platform 5.1, its login module list should be adapted, in the file gatein-jboss-beans.xml the following would need to be added on top of the other login module definitions.</para> - <para>If this isn't done, it will not be possible to log into the portal.</para> + <para>If a customized portal container was used in JBoss Enterprise Portal Platform 5.1, its login module list should be adapted. The following would need to be added on top of the other login module definitions in the file gatein-jboss-beans.xml:</para> + <para>If this is not done, it will not be possible to log into the portal.</para> <example> - <title>Example</title> -<programlisting>&lt;login-module code="org.gatein.wci.security.WCILoginModule" flag="optional"&gt; -   &lt;module-option name="portalContainerName"&gt;ecmdemo&lt;/module-option&gt; -   &lt;module-option name="realmName"&gt;gatein-domain-ecmdemo&lt;/module-option&gt; -&lt;/login-module&gt;</programlisting> + <title>Example</title> + <programlisting>      &lt;login-module code="org.gatein.wci.security.WCILoginModule" flag="optional"&gt; +        &lt;module-option name="portalContainerName"&gt;ecmdemo&lt;/module-option&gt; +        &lt;module-option name="realmName"&gt;gatein-domain-ecmdemo&lt;/module-option&gt; +      &lt;/login-module&gt;</programlisting> </example> </chapter> Modified: epp/docs/branches/5.2/Migration_Guide/en-US/chapter-3-Portal_URLs.xml =================================================================== --- epp/docs/branches/5.2/Migration_Guide/en-US/chapter-3-Portal_URLs.xml 2011-12-05 23:53:15 UTC (rev 8197) +++ epp/docs/branches/5.2/Migration_Guide/en-US/chapter-3-Portal_URLs.xml 2011-12-06 23:20:56 UTC (rev 8198) @@ -166,7 +166,7 @@ The private redirection performs first an authentication before doing the redirection. In that case the <emphasis role="italics">/private/classic/administration/registry</emphasis> path will resolve be redirected to the - <emphasis role="italics">/portal/groups/:platform:administrators/administration/registry</emphasis> + <emphasis role="italics">/portal/g/:platform:administrators/administration/registry</emphasis> page if the user has the sufficient security rights. </para> </listitem> @@ -222,7 +222,7 @@ &lt;URL-pattern&gt;/dologin&lt;/URL-pattern&gt; &lt;/servlet-mapping&gt;</programlisting> </example> - <para>Declare portal servlet as default Servlet</para> + <para>Delare portal servlet as default Servlet</para> <example> <title>Example</title> <programlisting>&lt;servlet-mapping&gt; @@ -258,6 +258,27 @@ &lt;welcome-file&gt;/index.jsp&lt;/welcome-file&gt; &lt;/welcome-file-list&gt;</programlisting> </example> + <para> + We need to change the location of + <code>PortalLoginController</code> + : + </para> + <para>In 5.1, web.xml contained this:</para> + <example> + <title>Example</title> + <programlisting>&lt;servlet&gt; + &lt;servlet-name&gt;PortalLoginController&lt;/servlet-name&gt; + &lt;servlet-class&gt;org.exoplatform.web.login.PortalLoginController&lt;/servlet-class&gt; +&lt;/servlet&gt;</programlisting> + </example> + <para>In 5.2 it should be:</para> + <example> + <title>Example</title> + <programlisting>&lt;servlet&gt; + &lt;servlet-name&gt;PortalLoginController&lt;/servlet-name&gt; + &lt;servlet-class&gt;org.exoplatform.web.security.PortalLoginController&lt;/servlet-class&gt; +&lt;/servlet&gt;</programlisting> + </example> </section> <section id="sid-13467785_PortalURLs-Dashboardchanges"> Modified: epp/docs/branches/5.2/Migration_Guide/en-US/chapter-5-User_interface.xml =================================================================== --- epp/docs/branches/5.2/Migration_Guide/en-US/chapter-5-User_interface.xml 2011-12-05 23:53:15 UTC (rev 8197) +++ epp/docs/branches/5.2/Migration_Guide/en-US/chapter-5-User_interface.xml 2011-12-06 23:20:56 UTC (rev 8198) @@ -7,7 +7,7 @@ <section id="sid-13467777_Userinterface-Cleanthewebbrowsercache"> <title>Clean the web browser cache</title> - <para>This has not been changed and, while performing the migration, your web browser may still have the content of previous portal in cache. You will need to empty your web browser cache if you see that the UI is malformed or if overlay menus are not appearing. With most browsers you can refresh the cache by clicking on Ctrl+F5 while being on the problematic page.</para> + <para>This has not been changed and, while performing the migration, your web browser may still have the content of previous portal in cache. You will need to empty your web browser cache if you see that the UI is malfored or if overlay menus are not appearing. With most browsers you can refresh the cache by clicking on Ctrl+F5 while being on the problematic page.</para> </section> <section id="sid-13467777_Userinterface-Cleanthecookies">