State Management

Here you can Compute, Import or Ask a state.

What is a state?

A state represents all the content of a replicated XWiki.

This concept derives from the fact that XWoot and XWiki do not share the same data on an implementation level and, before being able to start to function properly, XWoot needs to have its data initialized.

On a bit more detailed level, a state contain all the content present on the replicated XWiki but in a format on which XWoot can apply its merging algorithms and can keep track of and apply patches containing changes of that content.

Computing a state

In order to be able to start the replication of an XWiki, a state needs to be computed on the XWoot peer that created the group.

If the group was created by this peer, the button "Compute new state" will be available.

When you compute a new state, XWoot synchronizes with the XWiki for the first time.

Asking a state from the group

After joining a group you need to get the state of the XWiki that is being replicated inside that group.

You can do so by pressing the "Ask state from group" button.

After getting the state, XWoot will make it its own and synchronize with your local XWiki by replacing all your XWiki's content with the content described in the received state thus making your XWiki synchronized with the group's XWiki.

Importing a state

A third option is to import a state file in zip format you received from a different source, other than asking it from the group.

Note: You need to provide the state file for the group you are joining and no other. This means you must not change the name of the zip file.