[jboss-svn-commits] JBL Code SVN: r8699 - labs/jbossesb/trunk/product/samples/quickstarts/helloworld_ftp_action

[jboss-svn-commits at lists.jboss.org]

Author: burrsutter
Date: 2007-01-04 20:48:43 -0500 (Thu, 04 Jan 2007)
New Revision: 8699

Modified:
   labs/jbossesb/trunk/product/samples/quickstarts/helloworld_ftp_action/readme.txt
Log:


Modified: labs/jbossesb/trunk/product/samples/quickstarts/helloworld_ftp_action/readme.txt
===================================================================
--- labs/jbossesb/trunk/product/samples/quickstarts/helloworld_ftp_action/readme.txt	2007-01-05 01:47:48 UTC (rev 8698)
+++ labs/jbossesb/trunk/product/samples/quickstarts/helloworld_ftp_action/readme.txt	2007-01-05 01:48:43 UTC (rev 8699)
@@ -1,5 +1,26 @@
-This test assumes:
+Overview:
+=========
+  	This is a very basic example that demonstrates how to configure the FTP gateway
+ 	so that it picks up messages from an ftp server, routes them through a JMS queue
+ 	and finally to your action class for processing.
+  
+Before Running:
+===============
+	1.	Update the "jbosshome.dir" property in the quickstarts.properties file in "../".
+	2.	Make sure the jbossesb.sar is deployed on your JBoss Application Server.
+	3.	Make sure the JBoss Application server is running
+	4.  Make sure you have read/write access to an FTP server.  Write access is required
+	so that a file can be marked as "completed" (or just deleted) and not reprocessed 
+	again and again.
 
+To Run:
+=======
+	1.  In a command window type "ant" to bring up the listener
+	2.  Using your favorite FTP client place a file in the "/tmp/EsbInput" directory
+	3.  You should see the file contents displayed in the listener window
+	
+What to consider in this Quickstart:
+===================================	
 1) There is an FTP server running (port 21) in the host specified in jbossesb.xml:
 	<ftp-provider name="FTPprovider" hostname="localhost" >
 2) That ftp server will take a user 'ftpuser' with password 'ftppasssword' (see jbossesb.xml)
@@ -10,6 +31,18 @@
           			directory="/tmp/esbInput"
 					...
 
-3) there is a directory tmp/esbInput relative to the home directory of ftpuser
+3) There is a directory tmp/esbInput relative to the home directory of ftpuser
 	(e.g. /home/ftpuser/tmp/esbInput)
+	
+4) This user must also have "write" access to the FTP server as the "in process"
+and "completed" files are renamed accordingly. 
+
+If you do not have write access you will receive an error that looks something like the 
+following:
+     [java] 20:41:36,625 ERROR [Thread-5][AbstractFileGateway] Problems renaming
+ file new_file.dat to new_file.dat.esbWorking
+
+
+
+