[Myfaces Wiki] Update of "Setting_up_Portal_Environments_for_Bridge" by MichaelFreedman

[Apache Wiki <wi...@apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Myfaces Wiki" for change notification.

The "Setting_up_Portal_Environments_for_Bridge" page has been changed by MichaelFreedman.
http://wiki.apache.org/myfaces/Setting_up_Portal_Environments_for_Bridge?action=diff&rev1=6&rev2=7

--------------------------------------------------

  = JSF 1.2 and Portlet 1.0 Configurations =
  == eXo Plaftorm: PC, WCM, etc ==
  See [[eXo Platform]].
- == Tomcat 6 and Pluto 1.1.4 ==
+ == Tomcat 6 and Pluto 1.1.x ==
- The JSF Portlet Bridge for JSF 1.2 and Portlet 1.0 should run with the existing Pluto implementation provided you meet the pre-requisites for JSF 1.2.  In order for this to work, Pluto needs to be installed on Tomcat 6.  Below is some documentation on how to do this.
+ The Portlet 1.0 Bridge for JSF 1.2 should run with existing Pluto 1.1.x implementations provided you meet the pre-requisites for JSF 1.2, namely JavaEE 5 support including servlet 2.5, jsp 2.1, and jstl 1.2.  This means that when using Pluto in a Tomcat environment you must use Tomcat 6 and not Tomcat 5.x.  Unfortunately, Pluto doesn't provide a prepackaged installable Tomcat 6/Pluto 1.1.x download.  This means if you want to run in a Pluto 1.1.x environment you will need to manually install/configure the software.  Below is some documentation on how to do this.
+ 
+ === Alternatives ===
+ Use Pluto 2.x instead of Pluto 1.1.x:  The Portlet 2.0 specification is backwards compatible with Portlet 1.0, therefore you can run the Portlet 1.0 Bridge for JSF 1.2 in a Pluto 2.x installation.  Since Pluto 2.x does come in a download prebundled with Tomcat 6, installation is much simpler.  Download pluto-2.0.x-bundle.zip(tar) from the Pluto (2.0) download page at http://portals.apache.org/pluto/download.html
+ 
  === Prerequisites ===
  These items must be installed and working on your system before you get started:
   * J2SE JDK 1.5 or later
@@ -21, +25 @@

     ...
   </settings>
   }}}
-  1. Download Tomcat 6.0.16 or greater ([[http://tomcat.apache.org/download-60.cgi#6.0.16]]).  Extract it into a directory.
+  1. Download Tomcat 6.0.20 or greater ([[http://tomcat.apache.org/download-60.cgi]]).  Extract it into a directory.
   1. Make sure the {{{ <Connector> }}} element in Tomcat's ''conf/server.xml'' file has the attribute {{{ emptySessionPath="true" }}} set.  If more then one connection is identified, this will be the "HTTP/1.1" connector.
   1. Add some users to Tomcat's ''conf/tomcat-users.xml'' file.  My understanding is that Pluto installer is supposed to do this for you, but it didn't in my case.  The default users file has comments around the default users so be sure to remove them.  Here is a good example:  {{{
   <tomcat-users>
@@ -35, +39 @@

     <user username="pluto" password="pluto" roles="pluto,manager"/>
   </tomcat-users>
  }}}
+  1. Determine the version of Pluto 1.1.x you want to install and use.  The current latest version is 1.1.7 and is referenced in the rest of the example below.
-  1. Create a directory for your Pluto 1.4.4 source tree and cd into it from a command line.
+  1. Create a directory for your Pluto 1.1.7 source tree and cd into it from a command line.
-  1. Type: {{{ svn checkout https://svn.apache.org/repos/asf/portals/pluto/tags/pluto-1.1.4 }}}
+  1. Type: {{{ svn checkout https://svn.apache.org/repos/asf/portals/pluto/tags/pluto-1.1.7 }}}
   1. Type: {{{ mvn pluto:install -DinstallDir="<TOMCAT_DIR>" }}}  '''''Note:''''' in Windows you may need to append the Drive Letter as well as the path
   1. In Tomcat's bin directory, execute {{{ startup.sh }}} (linux) or {{{ startup.bat }}} (windows)
   1. Browse to {{{ http://localhost:8080/pluto/portal }}}