Uploaded image for project: 'Documentation'
  1. Documentation
  2. DOCS-13609

Investigate changes in SERVER-47190: Shutdown command with force:true should ignore all stepdown errors

    XMLWordPrintable

    Details

    • Type: Task
    • Status: Resolved
    • Priority: Major - P3
    • Resolution: Done
    • Affects Version/s: None
    • Fix Version/s: 4.2.7, 4.4.0-rc4, 4.7.0
    • Component/s: manual, Server
    • Labels:
      None
    • Last comment by Customer:
      true
    • Sprint:
      ServerDocs: April27-May01, ServerDocs: May04-May08, ServerDocs: May11-May15, ServerDocs: May18-May22, ServerDocs: May26-May29, ServerDocs2020: Jun 1 -Jun5, ServerDocs2020: Jun8-Jun12, ServerDocs2020: Jun16-Jun19

      Description

      Description

      Downstream Change Summary

      It is a bit ambitious in the current documentation what the force option in the shutdown command means. https://docs.mongodb.com/manual/reference/command/shutdown/

      But in implementation prior to this ticket, force means "force to stepDown" the primary. And if force stepDown fails, the shutdown will also fail. But this is no longer true after SERVER-47190.

      This ticket slightly changed the semantics of the force option. Now specifying force in shutdown command would ignore all errors during the shutdown process and will shut down the mongod process regardless. Therefore, we should make it clear to users the shutdown command with {force: true} will shut down the server no matter what.

      Description of Linked Ticket

      The shutdown command returns an error if stepdown fails with any error code other than NotMaster, even if force:true is specified. This can fail with InterruptedDueToReplStateChange if there is a concurrent stepdown in progress, since it kills user operations that take certain locks. In contrast, signal-based shutdown ignores all stepdown errors and proceeds with the shutdown. It is expected that shutdown with force:true would always shut down the server, so we should make it behave like signal-based shutdown.

      Scope of changes

      Impact to Other Docs

      MVP (Work and Date)

      Resources (Scope or Design Docs, Invision, etc.)

        Attachments

          Issue Links

            Activity

              People

              Assignee:
              ravind.kumar Ravind Kumar (Inactive)
              Reporter:
              backlog-server-pm Backlog - Core Eng Program Management Team
              Participants:
              Last commenter:
              Backlog - Core Eng Program Management Team Backlog - Core Eng Program Management Team
              Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

                Dates

                Due:
                Created:
                Updated:
                Resolved:
                Days since reply:
                1 year, 18 weeks ago
                Date of 1st Reply: