SyncContrib Package

Synchronisation between a pair of TWiki installs

This contrib (currently only in subversion) provides a command line interface to synchronise two TWiki installs.

It takes forward into a reusable form the code ideas in ReplicationUsingUnison

It is really only an interface to the rather excellent 'unison' tool http://www.cis.upenn.edu/~bcpierce/unison/

I use it to synchronise between my XP-based laptop and a hosted linux install. I can now use either the local or remote servers and have this script replicate the changes back and forth.

The latest version uses hierarchical webs to store the remote web set as subwebs grouped by site.

In time I will probably:

• make it a CommandSet for the TWikiShellContrib
• bundle it into a plugin

However, you are welcome to take what I've done and improve it.

Its all in SVN - no release yet.

Summary of Contents

Detailed Documentation

Settings

Settings are stored as preferences variables. To reference a setting write %<plugin>_<setting>%, e.g. %JSCALENDARCONTRIB_STUB%

• One line description:
  • Set SHORTDESCRIPTION = SyncContrib offers a command line interface to one-way synchronise two TWiki installs (utilizes the Unison file synchronizer)

• Name of the perl package
  • Set STUB = _name of the stub, TWiki::Contrib::..._

Installation Instructions

Note: You do not need to install anything on the browser to use this contrib package. The following instructions are for the administrator who installs the package on the server where TWiki is running.

• Download the ZIP file from the Plugin web (see below)
• Unzip SyncContrib.zip in your twiki installation directory. Content:

  File:	Description:
  data/TWiki/SyncContrib.txt	Contrib topic
  data/TWiki/SyncContrib.txt,v	Contrib topic repository
  lib/TWiki/Contrib/SyncContrib.pm	Contrib Perl module

• Test if the installation was successful:
  • enter samples here

Contrib Info

Related Topics: TWikiPreferences

-- MartinCleaver - 18 Sep 2005