Wiki Atom based upstream support

ODSWiki now supports Atom based upstreaming. Any cluster can be configured to escalate any changes to one or several remoted ODS Wiki instances.

Configuration

Upstreaming can be configured in Cluster Settings page in Upstreams tab.

The form for adding or changing existing upstream contains following fields:

Field Value
name name of the upstream - list of upstreams actually a list of such names
URL URL of remote ODSWiki Atom endpoint. Usually it is something like =http://{server}[:port]/dataspace/{ownername}/wiki/{clustername}/atom-pub
user name of user who has write permissions on the remote ODSWiki instance
password password of user

Important Notes

  1. Do not run upstreaming as the dav user lest it risk overwriting unrelated articles.
  2. A change that comes about via upstream constitutes a new version number on the page in the destination wiki cluster.
  3. The page in the destination cluster may be locally modified between upstreams
  4. An upstream request will have no effect on pages in the source that have not been modified since the last upstream
  5. When the version number of a page the source cluster is incremented, upstreams will take effect
  6. Local modifications in the destination cluster will be overwritten by subsequent changes in the source (but not until the source is changed).

Simple example:

  1. Install ODS and Wiki packages.
  2. Login at http://host:port/ods
  3. Go to Wiki from the ODS main left vertical navigation.
  4. Click the "Create New" link.
  5. In the shown form click the "Create and Launch application".
  6. As result is shown the WelcomeVisitors wiki home page. From the horizontal navigation click the "Cluster Settings" link.
  7. Click the "Upstreams" tab.
  8. Enter in the shown form:
    1. For field "Name:" My upstream
    2. For field "URL:" http://myopenlink.net:8890/dataspace/test1/wiki/test1Wiki/atom-pub
    3. For field "User:" test1
    4. For field "Password:" 1
    5. Check the check-box for "Make full cluster upstream first".
  9. Click the button "Add/Update Upstream".
  10. Click the button "Back to the Topic".
  11. In the "Go" field enter TestStream and click enter.
  12. Enter for the article's body: simple text.
  13. Click the button "Save and release lock".
  14. After a while, go to http://myopenlink.net/test1/wiki/2/test1Wiki
  15. Click the "Index" link from the bottom of the page.
  16. As result among the articles from this instance, should be shown also the TestStream article.

CategoryODS CategoryOpenSource CategoryWiki