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

Documentation related to index node recovery is incorrect

    XMLWordPrintable

Details

    • Bug
    • Resolution: Unresolved
    • Major
    • None
    • Server 5.0.1, Server 5.5/Vulcan
    • documentation
    • None
    • DOC-S23-Aug17(Alice Beta)

    Description

      The documentation on the below page related to Index Service recovery is incorrect:

      https://developer.couchbase.com/documentation/server/5.5/clustersetup/rejoin-cluster.html
      https://developer.couchbase.com/documentation/server/5.1/clustersetup/rejoin-cluster.html

      1. Full Recovery

      "Indexes must be rebuilt on the server node that is being re-added."

      The indexes don't need to be rebuilt after recovery. If this line pertains to View Indexes, then it needs to be clarified.

      2. Delta Node Recovery

      " Index nodes retain their index definitions when being failed over and recovered using delta recovery, although the data within the indexes is deleted. When they are re-added to the cluster, the indexes will be automatically rebuilt by the Index service. "

      The index data is not deleted. It is rather preserved and when the recovered node gets re-added, it continues from the point where it left off.

      3. Similar to 2 is repeated under section "Delta recovery characteristics"

      "Index definitions are retained on the node being recovered. Once the node has been re-added, these indexes are automatically rebuilt by the Index service."

      This also needs to be corrected.

      4. With different services supporting indexes (e.g View/GSI/FTS Indexes), it would be better break up this page into sub-sections describing the behavior of each service. It is not clear which "Index" the documentation refers to.

      Attachments

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

        Activity

          People

            tony.hillman Tony Hillman (Inactive)
            deepkaran.salooja Deepkaran Salooja
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

            Dates

              Created:
              Updated:

              Gerrit Reviews

                There are no open Gerrit changes

                PagerDuty