Uploaded image for project: 'Couchbase Documentation'
  1. Couchbase Documentation
  2. DOC-3194

Incorrect compatibility statement and default for CBL 2.0 replicator configuration

    XMLWordPrintable

Details

    Description

      The unsupported.replicator_2 setting is described thus:

      Property to enable the replication protocol used in Couchbase Lite 2.0 Developer Builds. Note that if this property is set to true, Sync Gateway will no longer accept incoming requests from clients running the 1.x implementation. This includes Couchbase Lite 1.x and CouchDB-based databases (such as PouchDB and Cloudant).

      From practical testing the latter sentence seems to be false, and also contradicts the CBL 2.0 Getting Started doc that states:

      Sync Gateway 1.5 will automatically use the 1.x replication protocol when a Couchbase Lite 1.x client connects through "http://localhost:4984/db" and the 2.0 replication protocol when a Couchbase Lite 2.0 client connects through "ws://localhost:4984/db".

      Furthermore, the SG doc indicates that the default setting for unsupported.replicator_2 is true. Practical testing also proves that to be wrong: the new version is unsupported when the setting is absent from the config, and therefore the default is false.

      In order to support CBL 2.0 clients, it is necessary to explicitly turn on this setting; doing so, however, does not appear to impede concurrent support for CBL 1.x clients.

      I presume these are documentation errors.

      Reporter: Ben Kennedy
      E-mail: ben.kennedy@kashoo.com

      Attachments

        No reviews matched the request. Check your Options in the drop-down menu of this sections header.

        Activity

          People

            jamiltz James Nocentini
            docsite-collector Docs Site Collector
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved:

              Gerrit Reviews

                There are no open Gerrit changes

                PagerDuty