This is version . It is not the current version, and thus it cannot be edited.
[Back to current version]   [Restore this version]

VersioningFileProvider is a new PageProvider, meant to replace the RCSFileProvider, which has problems especially with Windows.

It is available from JSPWiki 1.7.0 onwards.

see also FileProviderComparing


Is the VersioningFileProvider now workable on Windows?

How do I go about using it / testing it?

--MattMower

It should be quite functional. Just do the following:

  1. Open jspwiki.properties file in your favorite editor
  2. change the jspwiki.pageProvider property to VersioningFileProvider (the former version of this page called for "com.ecyrd.jspwiki.VersioningFileProvider").
  3. a few lines below you have to set the directory where the VersioningFileProvider stores its files. Just change the property jspwiki.fileSystemProvider.pageDir according to the file and directory naming conventions...
--GernotStarke

Now you should be set (at least for version 2.0.0 alpha).

Moving from RCSFileProvider is a bit more complicated, since it involves you checking out the pages manually and storing them in the OLD directory. Could someone perhaps contribute a short script for this?

BTW, if you can live without your previous version history, just delete the RCS-subdirectory in the JSPWiki page repository, and then change the page provider. All new versions will then go to the VersioningFileProvider directory.

Though in all honesty, I haven't tested it all under Windows. There should be nothing Linux-specific in it, though... :-)

--JanneJalkanen

Well the neat thing (I suppose) is that I haven't managed to get the RCSFileProvider to work yet so nothings actually been checked in to the RCS directory yet. Given that though, will the VersioningFileProvider actually work either?

--MattMower

It should - it does not require anything extra. Just set the provider and you're set to go. (Before 1.8.0 you needed to have the RCS diff as well, though.)

The problem with RCSFileProvider is that it requires you to set up RCS, which was always designed as an UNIX tool, and none of the Windows ports have ever tried to integrate to Windows in any clean way. VersioningFileProvider does not have this problem.

--JanneJalkanen

I seem to remember a Java port of the CVS client, I wonder if that had a diff client that could be re-used...

--MattMower

Since 1.8.0, we are using an internal Java diff routine, so we now require no other software =).

--JanneJalkanen


What do you put as your "# The command for RCS checkin" etc when you are using VersioningFileProvider ?

Commenting them out seems to work.

--NigelThorne

You don't need the RCS checkin commands at all when you're using VersioningFileProvider. RCS is not used at all in that case.

--JanneJalkanen


One Problem I have noticed with the VersioningFileProvider (using JSPWiki v2.1.22-cvs) is that the "last changed date" displayed at the bottom of pages is never updated as it was using the RCSFileProvider. Could this be because I did not follow the recommended procedure for switching from RCSFileProvider to VersioningFileProvider?

I have in my archives somewhere an RCSFileProvider ready tarball of the initial set of Wiki pages (at least as of some version of JSPWiki from quite long ago). If anybody wants them, just drop me a line. I am happy to contribute them if anyone thinks they would be useful to help people get going quickly with the RCSFileProvider.

--MikeMorris


Setting a maximum number of versions to store?#

Something that might be useful would be a property that can be set expressing the maximum number of revisions stored. If this value were set to 10, then when the 11th version were added it could automatically delete the first. I suppose the rest of the files could be then renamed (2 to 1, 3, to 2, etc) but I'm not sure I see much need for that. That might reduce some of the administration necessary. I don't see a whole lot of interest with maintaining the ability to go back to the absolute first version of something. I find that being able to back a few to maybe a dozen is sufficient, but YMMV, I suppose.

-- RobSeegel

Nice idea. It would make sense to enable something like that for intranet wikis and so on; on public wikis you really want rollback to any version (to make sure you can get over from WikiGraffiti).

-- JanneJalkanen


Add new attachment

Only authorized users are allowed to upload new attachments.

List of attachments

Kind Attachment Name Size Version Date Modified Author Change note
txt
README.txt 66.9 kB 4 04-Feb-2006 07:18 148.221.80.109
java
VersioningFileProvider.java 15.2 kB 1 21-Feb-2005 21:48 MikeOliverAZ
« This particular version was published on 01-Apr-2004 13:24 by SebastianPetzelberger.  
G’day (anonymous guest) My Prefs
JSPWiki v2.8.4-svn-9