svn commit: r568430 - in /portals/wsrp4j/trunk: README.UNSTABLE README.txt

[es...@apache.org]

Author: esm
Date: Tue Aug 21 22:55:19 2007
New Revision: 568430

URL: http://svn.apache.org/viewvc?rev=568430&view=rev
Log:
Updating readme files with current status.

Added:
    portals/wsrp4j/trunk/README.UNSTABLE
Modified:
    portals/wsrp4j/trunk/README.txt

Added: portals/wsrp4j/trunk/README.UNSTABLE
URL: http://svn.apache.org/viewvc/portals/wsrp4j/trunk/README.UNSTABLE?rev=568430&view=auto
==============================================================================
--- portals/wsrp4j/trunk/README.UNSTABLE (added)
+++ portals/wsrp4j/trunk/README.UNSTABLE Tue Aug 21 22:55:19 2007
@@ -0,0 +1,55 @@
+# Copyright 2003-2006 The Apache Software Foundation.
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#      http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+Req's:
+
+Java 5 (Java 4 untested at this point, but should work)
+Maven 2.0.6+
+Tomcat 5.5.x (6.0.x should work, but untested)
+SVN
+
+
+Install Tomcat 5.5.x and Pluto 1.1.4.
+
+1) Download and install Tomcat 5.5.x
+1) <Connector> with emptySessionPath=true in conf/server.xml
+2) Configure user in conf/tomcat-users.xml with roles="tomcat,pluto"
+3) echo "JAVA_OPTS=\"\$JAVA_OPTS -Dorg.apache.pluto.useJaxp=true\"" >> bin/setenv.sh (needed for running under Java 5 w/o XML libs in common/endorsed)
+
+Install a patched Pluto 1.1.4
+
+1) curl http://mirror.candidhosting.com/pub/apache/portals/pluto/pluto-current-src.zip > pluto-1.1.4-current-src.zip
+2) unzip pluto-1.1.4-current-src.zip
+3) cd pluto-1.1.4
+4) patch pluto-container/src/main/java/org/apache/pluto/internal/impl/PortletResponseImpl.java encodeURL method  (see https://issues.apache.org/jira/browse/PLUTO-417, http://uppertank.net/blog/archives/13)
+5) mvn install
+6) mvn -DinstallDir=/path/to/tomcat pluto:install
+
+Check out WSRP4J from trunk, and install it.
+
+1) svn co http://svn.apache.org/repos/asf/portals/wsrp4j/trunk wsrp4j-trunk
+2) cd wsrp4j-trunk
+3) cp build.properties.sample build.properties ; vi build.properties
+4) mvn install
+5) copy proxyportlet webapp to tomcat webapps
+6) copy producer webapp to tomcat webapps
+
+Configure WSRP4J Proxy Portlet
+
+1) Start Tomcat
+1) Web to http://localhost:8080/pluto/portal and login
+2) Add WSRP4J proxy portlets (two of them) using pluto admin
+3) Edit WSRP4J producer config, changing endpoints to port 8080.
+
+TODO Configure WSRP4J Producer

Modified: portals/wsrp4j/trunk/README.txt
URL: http://svn.apache.org/viewvc/portals/wsrp4j/trunk/README.txt?rev=568430&r1=568429&r2=568430&view=diff
==============================================================================
--- portals/wsrp4j/trunk/README.txt (original)
+++ portals/wsrp4j/trunk/README.txt Tue Aug 21 22:55:19 2007
@@ -18,6 +18,22 @@
                 ********** Apache WSRP4J **********
                   http://portals.apache.org/wsrp4j
 
+*********
+Note: The WSRP4J trunk is unstable at the moment.  This README is out
+      of date.  The trunk will become stable in the next two weeks or
+      so, and the docs will be updated accordingly.  
+
+      Until then, a stable WSRP4J with accurate README's is found at:
+        https://svn.apache.org/repos/asf/wsrp4j-0.4-SNAPSHOT-prepluto11/
+
+      Adventurous users can look at the brief notes in README.UNSTABLE
+      if they wish to continue.
+
+      - Elliot Metsger 8/22/2007 (esm@apache.org)
+*********
+
+      
+
 
 Contents
 --------