svn commit: r753597 - /cxf/trunk/distribution/src/main/release/samples/ws_security/interopfest/README.txt

[dk...@apache.org]

Author: dkulp
Date: Sat Mar 14 03:30:49 2009
New Revision: 753597

URL: http://svn.apache.org/viewvc?rev=753597&view=rev
Log:
Update the readme for the interop samples


Modified:
    cxf/trunk/distribution/src/main/release/samples/ws_security/interopfest/README.txt

Modified: cxf/trunk/distribution/src/main/release/samples/ws_security/interopfest/README.txt
URL: http://svn.apache.org/viewvc/cxf/trunk/distribution/src/main/release/samples/ws_security/interopfest/README.txt?rev=753597&r1=753596&r2=753597&view=diff
==============================================================================
--- cxf/trunk/distribution/src/main/release/samples/ws_security/interopfest/README.txt (original)
+++ cxf/trunk/distribution/src/main/release/samples/ws_security/interopfest/README.txt Sat Mar 14 03:30:49 2009
@@ -1,4 +1,4 @@
-About these samples:
+*** About these samples ***
 
 This CXF sample is being used to help implement WS-SecurityPolicy,
 WS-SecureConversation, and WS-Trust within CXF.
@@ -11,13 +11,26 @@
 [2] http://131.107.72.15/ilab/WSSecurity/WCFInteropPlugFest_Security.doc
 
 
-**** Running the WS-Security samples:
+*** Requirements ***
 
-Since these projects rely on the SNAPSHOT (2.2) version of CXF, you'll need 
-to check out CXF from svn first and build[3] the CXF project. 
+The samples in this directory use STRONG encryption.  The default encryption algorithms 
+included in a JRE is not adequate for these samples.   The Java Cryptography Extension 
+(JCE) Unlimited Strength Jurisdiction Policy Files available on Sun's JDK download 
+page[3] *must* be installed for the examples to work.   If you get errors about invalid
+key lengths, the Unlimited Strength files are not installed.
 
-The wssec11 project can be run by entering mvn clean install from the
-wssec11 folder, and then entering the following command:
+[3] http://java.sun.com/javase/downloads/index.jsp
+
+
+*** Running the WS-Security samples against the Microsoft servers ***
+
+Each of the samples are setup to test a CXF client against the public servers provided
+by Microsoft.    To build and run the client, run:
+
+mvn -Pclient
+
+This will download the WSDL and Certs from Microsoft, build the code, and runs the client 
+testing all the known working test cases.   If you want to run a specific test, run:
 
 mvn -Pclient -Dtest.method=XX
 
@@ -27,12 +40,16 @@
 wsdl:port under the wsdl:service element in the WSDL above).  So -Dtest.method=UX will 
 call the UX_IPingService listed in the WSDL.
 
-SOAP clients for these web services are in the process of being developed and tested, but not 
-yet CXF-based web service providers implementing these services.  Help is most welcome.
 
-Note:  The Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files 
-available on Sun's JDK download page[4] *must* be installed for the examples to work.
+*** Running the WS-Security samples against the local CXF servers ***
+
+The wssec10, wssec11, and wssc samples contain working CXF servers.  (The WS-Trust 
+samples do not yet have working servers.)  To start the server, just run:
+
+mvn -Pserver
+
+
+To run the CXF clients agains the local server, run:
 
-[3] http://cxf.apache.org/building.html
-[4] http://java.sun.com/javase/downloads/index.jsp
+mvn -Pclient -Dtest.server=local