Author: imario
Date: Thu May 12 13:34:55 2005
New Revision: 169880
URL: http://svn.apache.org/viewcvs?rev=169880&view=rev
Log:
Documentation how to setup a VFS testserver.
On the way found some problems with the webdav provider.
Might be due to new apache?
Modified:
jakarta/commons/sandbox/vfs/trunk/build.xml
jakarta/commons/sandbox/vfs/trunk/project.properties
jakarta/commons/sandbox/vfs/trunk/xdocs/navigation.xml
jakarta/commons/sandbox/vfs/trunk/xdocs/testserver.xml
Modified: jakarta/commons/sandbox/vfs/trunk/build.xml
URL:
http://svn.apache.org/viewcvs/jakarta/commons/sandbox/vfs/trunk/build.xml?rev=169880&r1=169879&r2=169880&view=diff
==============================================================================
--- jakarta/commons/sandbox/vfs/trunk/build.xml (original)
+++ jakarta/commons/sandbox/vfs/trunk/build.xml Thu May 12 13:34:55 2005
@@ -132,6 +132,7 @@
</include>
<exclude name="**/test/Abstract*TestCase.java">
</exclude>
+ <!-- tests disabled -->
<exclude name="**/*.java">
</exclude>
</fileset>
Modified: jakarta/commons/sandbox/vfs/trunk/project.properties
URL:
http://svn.apache.org/viewcvs/jakarta/commons/sandbox/vfs/trunk/project.properties?rev=169880&r1=169879&r2=169880&view=diff
==============================================================================
--- jakarta/commons/sandbox/vfs/trunk/project.properties (original)
+++ jakarta/commons/sandbox/vfs/trunk/project.properties Thu May 12 13:34:55
2005
@@ -24,6 +24,10 @@
maven.test.failure.ignore=true
maven.ant.excludeTests=**/*.java
+test.user=vfsusr
+test.password=vfsusr
+test.path=/vfstest
+
test.data.src=${maven.src.dir}/test-data
test.basedir=${maven.build.dir}/test-data
test.policy=${maven.test.data.src}/test.policy
@@ -32,6 +36,6 @@
test.ftp.uri=ftp://${test.user}:[EMAIL PROTECTED]
test.http.uri=http://${test.hostname}${test.path}
test.webdav.uri=webdav://${test.user}:[EMAIL PROTECTED]
-test.sftp.uri=sftp://${test.user}:[EMAIL
PROTECTED]/home/${test.user}${test.path}
+test.sftp.uri=sftp://${test.user}:[EMAIL PROTECTED]
maven.checkstyle.properties = ${basedir}/checkstyle.properties
Modified: jakarta/commons/sandbox/vfs/trunk/xdocs/navigation.xml
URL:
http://svn.apache.org/viewcvs/jakarta/commons/sandbox/vfs/trunk/xdocs/navigation.xml?rev=169880&r1=169879&r2=169880&view=diff
==============================================================================
--- jakarta/commons/sandbox/vfs/trunk/xdocs/navigation.xml (original)
+++ jakarta/commons/sandbox/vfs/trunk/xdocs/navigation.xml Thu May 12 13:34:55
2005
@@ -26,6 +26,7 @@
<item name="File Systems" href="/filesystems.html"/>
<item name="Ant Tasks" href="/anttasks.html"/>
<item name="To Do List" href="/todo.html"/>
+ <item name="Development" href="/testserver.html"/>
</menu>
&common-menus;
</body>
Modified: jakarta/commons/sandbox/vfs/trunk/xdocs/testserver.xml
URL:
http://svn.apache.org/viewcvs/jakarta/commons/sandbox/vfs/trunk/xdocs/testserver.xml?rev=169880&r1=169879&r2=169880&view=diff
==============================================================================
--- jakarta/commons/sandbox/vfs/trunk/xdocs/testserver.xml (original)
+++ jakarta/commons/sandbox/vfs/trunk/xdocs/testserver.xml Thu May 12 13:34:55
2005
@@ -35,9 +35,9 @@
<li>You need maven to build the local test-data structure.
This is done automatically during build of VFS.</li>
<li>Create a user 'vfsusr' with password 'vfsusr' and home
directory '/home/vfsusr'
<br/>
- <code><![CDATA[
-useradd -p vfsusr -m vfsusr</code>
- ]]></code>
+ <source><![CDATA[
+useradd -p vfsusr -m vfsusr
+ ]]></source>
</li>
<li>Create the directories
<ol>
@@ -45,9 +45,9 @@
<li>/vfstest/write-tests</li>
</ol>
and copy from your local 'target/test-data' the
directories
- <code>code,read-tests</code> into it.<br />
+ <source>code,read-tests</source> into it.<br />
Now your structure looks like this:<br />
- <code><![CDATA[
+ <source><![CDATA[
/vfstest
/vfstest/write-tests
/vfstest/read-tests
@@ -75,29 +75,33 @@
/vfstest/code/sealed
/vfstest/code/sealed/AnotherClass.class
/vfstest/code/ClassToLoad.class
- ]]></code>
+ ]]></source>
</li>
<li>Setup a symbolic link to '/vfstest'<br />
- <code><![CDATA[
+ <source><![CDATA[
ln -s /vfstest /home/vfsusr/vfstest
- ]]></code>
+ ]]></source>
</li>
<li>Set permissions
<br/>
- <code><![CDATA[
+ <source><![CDATA[
find /vfstest -print0 | xargs -0 chown vfsusr.users
- ]]></code>
+ ]]></source>
</li>
- <li>After setup the server ensure they are installed and
running
+ <li>After you followed the steps below and setup the
server ensure they
+ are activated and running.<br />
+ This is only needet if you installed a fresh system.
Otherwise simply restart them.
<br/>
- <code><![CDATA[
+ <source><![CDATA[
+insserv xinetd
insserv apache2
insserv smb
insserv nmb
+/etc/rc.d/xinetd restart
/etc/rc.d/apache2 restart
/etc/rc.d/smb restart
/etc/rc.d/nmb restart
- ]]></code>
+ ]]></source>
</li>
</ol>
</subsection>
@@ -105,7 +109,7 @@
<subsection name="Apache 2 Webserver">
<ol>
<li>Create a file named '/etc/apache2/conf.d/vfstest.conf'
with this content<br />
- <code><![CDATA[
+ <source><![CDATA[
#
# VFSTEST
#
@@ -133,28 +137,29 @@
Require user vfsusr
</Limit>
</Location>
- ]]></code>
+ ]]></source>
</li>
<li>change the permission on
- <code><![CDATA[
+ <source><![CDATA[
chown vfsusr.users /var/lib/apache2
- ]]></code>
+ ]]></source>
</li>
<li>Activate the WebDAV module by adding 'dav' and
'dav_fs' to the list of modules in '/etc/sysconfig/apache2'. e.g <br/>
- <code><![CDATA[
-APACHE_MODULES="access actions alias auth auth_dbm autoindex cgi dir env
expires include log_config mime negotiation setenvif ssl suexec userdir php4
php5 dav dav_fs"
- ]]></code>
+ <source><![CDATA[
+APACHE_MODULES="access actions alias auth auth_dbm autoindex cgi dir env
expires include log_config
+mime negotiation setenvif ssl suexec userdir php4 php5 dav dav_fs"
+ ]]></source>
</li>
<li>Setup the webserver to use user-id 'vfsusr' and group
'users'. This can be done by changing the file '/etc/apache2/uid.conf'<br />
- <code><![CDATA[
+ <source><![CDATA[
User vfsusr
Group users
- ]]></code>
+ ]]></source>
</li>
<li>Create the VFS user to access the Webdav resource<br />
- <code><![CDATA[
+ <source><![CDATA[
htpasswd2 -cmb /etc/apache2/passwd vfsusr vfsusr
- ]]></code>
+ ]]></source>
</li>
</ol>
</subsection>
@@ -162,18 +167,18 @@
<subsection name="Samba 3">
<ol>
<li>Create a share 'vfsusr'<br />
- <code><![CDATA[
+ <source><![CDATA[
[vfsusr]
comment = VFS Test Directory
path = /home/vfsusr
guest ok = yes
writable = yes
- ]]></code>
+ ]]></source>
</li>
<li>Setup a 'vfsusr' with password 'vfsusr'<br />
- <code><![CDATA[
+ <source><![CDATA[
smbpasswd -a vfsusr
- ]]></code>
+ ]]></source>
</li>
</ol>
</subsection>
@@ -181,9 +186,9 @@
<subsection name="ssh">
<ol>
<li>In '/etc/ssh/sshd_config' ensure<br />
- <code><![CDATA[
+ <source><![CDATA[
PasswordAuthentication yes
- ]]></code>
+ ]]></source>
</li>
</ol>
</subsection>
@@ -191,19 +196,37 @@
<subsection name="vsftp">
<ol>
<li>Ensure the server is not disabled in the xinetd
configuration<br />
- Set <code>disable=no</code> in '/etc/xinetd.d/vsftpd'
+ Set <source>disable=no</source> in
'/etc/xinetd.d/vsftpd'
</li>
<li>Setup the server config: '/etc/vsftpd.conf'<br/>
- <code>
+ <source>
write_enable=YES
local_enable=YES
- </code>
+ </source>
</li>
</ol>
</subsection>
+ <subsection name="Tests">
+ Now we are finished and you can try to activate the tests by
+ <ol>
+ <li>reactivate the tests in 'build.xml'.<br/>
+ Search for <code><![CDATA[<!-- tests disabled
-->]]></code> and comment the exclude.</li>
+ <source><![CDATA[
+<!-- tests disabled
+<exclude name="**/*.java">
+</exclude>
+ -->
+ ]]></source>
+ <li>or use the class org.apache.commons.vfs.RunTest where
you have
+ to adapt some properties at the top of the file and
choose which test
+ you would like to run by comment the others.<br />
+ This is the way how I debug a failed testcase.
+ </li>
+ </ol>
+ </subsection>
</section>
</body>
</document>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
