VFS Transport Installation Instructions

Prerequisites

Installing the Binary

1. Install Mule 1.3.3 to your machine, if not already installed.  When done, set your $MULE_HOME environment variable to where you installed Mule, for example c:/mule/mule-1.3.3.  Also, add $MULE_HOME/bin to your $PATH.
2. Download the VFS Connector zip and unpack it to a directory, say $VFS_DIST.  From $VFS_DIST, copy mule-transport-vfs-*.jar and mule-examples-vfs-*.jar to $MULE_HOME/lib/user.
3. Copy $VFS_DIST/lib/*.jar directory to $MULE_HOME/lib/user.
4. Proceed to Running the VFS Connector Examples.
   

Installing from Source

1. Install Mule 1.3.3 to your machine, if not already installed.  When done, set your $MULE_HOME environment variable to where you installed Mule, for example c:/mule/mule-1.3.3.  Also, add $MULE_HOME/bin to your $PATH.
2. Download Maven 2.0.5 or higher and add the $MAVEN_HOME/bin to your $PATH
3. Check out the latest VFS connector code from Subversion at: https://svn.codehaus.org/mule-contrib/transports/vfs
   For this example, let's say your Subversion workspace is $WS.
4. cd to $WS
5. Run "mvn -Dmaven.test.skip=true install" at the command prompt.  This builds the VFS connector.  Running unit tests is not recommended unless you update the $WS/src/test/resources/mule-vfs-test-sftp-config.xml with your sftp service settings.
6. Deploy the VFS connector by copying $WS/target/mule-transports-vfs-*.jar to $MULE_HOME/lib/user.
7. cd to $WS/examples, and run "mvn install" at the command prompt. This builds the VFS connector examples.
8. Deploy the VFS connector examples by copying $WS/examples/target/mule-examples-vfs-*.jar to $MULE_HOME/lib/user.
9. There are 3rd party libraries needed by the VFS library.  Copy the jars in the "VFS Library Dependencies" section below to $MULE_HOME/lib/user
10. Proceed to Running the VFS Connector Examples.

Note on VFS Library Dependencies

The following libraries are needed by VFS.  They are copied to you M2_REPO location during the build:

$M2_REPO/com/jcraft/jsch/0.1.25/jsch-0.1.25.jar
$M2_REPO/commons-vfs/commons-vfs/1.0/commons-vfs-1.0.jar
$M2_REPO/jcifs/jcifs/0.8.3/jcifs-0.8.3.jar
$M2_REPO/oro/oro/2.0.7/oro-2.0.7.jar
$M2_REPO/slide/webdavlib/2.0/webdavlib-2.0.jar

Note: The $M2_REPO location on Linux/Unix the location is  ~/.m2 by default. On Windows it's usually c:/Documents and Settings/<user>/.m2.