Uploaded image for project: 'Couchbase Server'
  1. Couchbase Server
  2. MB-8456

[Doc'd] Update Documentation with the recommendation that THP should be disabled on Couchbase nodes.

    Details

    • Type: Bug
    • Status: Closed
    • Priority: Minor
    • Resolution: Fixed
    • Affects Version/s: 2.0.1
    • Fix Version/s: 2.0.1, 2.1.0, 2.1.1, 2.2.0, 2.5.1, 3.0
    • Component/s: None
    • Security Level: Public
    • Labels:
    • Is this a Regression?:
      Yes
    • Sprint:
      TP Sprint 15

      Description

      Nodes on which THP(Transparent Huge Pages) are enabled, we are seeing high swap usage and severe timeouts in ns_server. This may get much worse under memory pressure. So ns_server had to restart whole bunch of services because of random timeouts and in the end it reached max restart intensity and therefore terminated.

      So by default THP must be disabled and this information needs to be documented.

        Issue Links

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

          Activity

          Hide
          marija Marija Jovanovic added a comment -

          Added a note of the type "Important" at the top of the page
          /Install/rhel-installing.dita
          wit the following warning:
          "RHEL6 and other newer Linux distributions running on physical hardware are known to have transparent hugepages feature enabled. While this can provide a measurable performance boost, under some conditions that Couchbase Server is known to trigger, this option may cause severe delays in page allocations. Therefore, it is strongly recommended to disable the transparent hugepages feature when installing Couchbase Server. "

          This content that was added to the release notes 2.1.0 and is also requested to be repeated in all subsequent releases.

          This resolution applies to the release 3.0.2.

          Show
          marija Marija Jovanovic added a comment - Added a note of the type "Important" at the top of the page /Install/rhel-installing.dita wit the following warning: "RHEL6 and other newer Linux distributions running on physical hardware are known to have transparent hugepages feature enabled. While this can provide a measurable performance boost, under some conditions that Couchbase Server is known to trigger, this option may cause severe delays in page allocations. Therefore, it is strongly recommended to disable the transparent hugepages feature when installing Couchbase Server. " This content that was added to the release notes 2.1.0 and is also requested to be repeated in all subsequent releases. This resolution applies to the release 3.0.2.
          Hide
          anil Anil Kumar added a comment -

          Ruth - Its added to 2.1 release notes which is fine. We should add a *Note section in out installation section of documentation to cover this point.

          Show
          anil Anil Kumar added a comment - Ruth - Its added to 2.1 release notes which is fine. We should add a *Note section in out installation section of documentation to cover this point.
          Hide
          ruth Ruth Harris added a comment -

          Anil,

          Please confirm that this KNOWN ISSUE should be added to all of the release notes. It's already in the 2.1 RN.

          Show
          ruth Ruth Harris added a comment - Anil, Please confirm that this KNOWN ISSUE should be added to all of the release notes. It's already in the 2.1 RN.
          Hide
          pvarley Patrick Varley added a comment -

          This affects all versions of couchbase

          Show
          pvarley Patrick Varley added a comment - This affects all versions of couchbase
          Hide
          ruth Ruth Harris added a comment -

          Does this apply to ONLY 2.1.0?

          In 2.1.0, the Known Issue can also be noted re affecting cluster stabiity.
          If the INSTALLER needs to be updated, then this Issue should be transfered to the BUILD team (not documentation).

          This Known Issue in 2.1.0 is not carried over into subsequent releases.

          --ruth

          Show
          ruth Ruth Harris added a comment - Does this apply to ONLY 2.1.0? In 2.1.0, the Known Issue can also be noted re affecting cluster stabiity. If the INSTALLER needs to be updated, then this Issue should be transfered to the BUILD team (not documentation). This Known Issue in 2.1.0 is not carried over into subsequent releases. --ruth

            People

            • Assignee:
              marija Marija Jovanovic
              Reporter:
              skumar Saran Kumar (Inactive)
            • Votes:
              0 Vote for this issue
              Watchers:
              9 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved:

                Agile

                  Gerrit Reviews

                  There are no open Gerrit changes