[DOCS-12561] Docs for SERVER-38994: Step down on SIGTERM Created: 20/Mar/19  Updated: 13/Nov/23  Resolved: 21/Oct/19

Status: Closed
Project: Documentation
Component/s: manual, Server
Affects Version/s: None
Fix Version/s: 4.1.10, 4.0.8, 3.6.15, Server_Docs_20231030, Server_Docs_20231106, Server_Docs_20231105, Server_Docs_20231113

Type: Task Priority: Major - P3
Reporter: Kay Kim (Inactive) Assignee: Kay Kim (Inactive)
Resolution: Fixed Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Documented
documents SERVER-38994 Step down on SIGTERM Closed
Participants:
Days since reply: 4 years, 10 weeks, 2 days ago
Epic Link: DOCS: 4.2 Server/Tools

 Description   

Description

Description:

This changes the behavior of clean shutdown.

Probably most noticeable for users, a shutdown initiated by SIGTERM will now attempt a step down in a way very similar to the shutdown command without arguments. It differs in that:

  • Where a default shutdown command would have failed, returning to the user with an error, failing to stepdown will not stop shutdown in this path.
  • The node will not vote in elections that occur after the step down

Engineering Ticket Description:

Kubernetes uses SIGTERM to spin down containers, and our sysv init and systemd unit files use SIGTERM to shutdown the mongodb service. It would greatly reduce election time and prevent potential data loss due to replicaset rollback if we were able to use the election handoff path of stepdown instead of waiting for the full electionTimeoutMillis.

Scope of changes

Impact to Other Docs

MVP (Work and Date)

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



 Comments   
Comment by Githook User [ 02/Dec/19 ]

Author:

{'name': 'Kay Kim', 'username': 'kay-kim', 'email': 'kay.kim@10gen.com'}

Message: DOCS-12561: update blurb in v4.0 for v3.6.15
Branch: v4.0
https://github.com/mongodb/docs/commit/e992849ebcb14ef6045ec6f97877c5e4de85793c

Comment by Githook User [ 06/Nov/19 ]

Author:

{'username': 'kay-kim', 'email': 'kay.kim@10gen.com', 'name': 'Kay Kim'}

Message: DOCS-12561: update manual for v3.6.15
Branch: master
https://github.com/mongodb/docs/commit/493b9236fc0e94331810ba037919ec81c1cb9cd1

Comment by Githook User [ 06/Nov/19 ]

Author:

{'username': 'kay-kim', 'email': 'kay.kim@10gen.com', 'name': 'Kay Kim'}

Message: DOCS-12561: 3.6.15 - stepdown on SIGTERM
Branch: v3.6
https://github.com/mongodb/docs/commit/46e0c2f3d8fd92c469487bbc867bea1425e0f9af

Comment by Githook User [ 21/Oct/19 ]

Author:

{'username': 'kay-kim', 'email': 'kay.kim@10gen.com', 'name': 'Kay Kim'}

Message: DOCS-12561: update manual for v3.6.15
Branch: master-3.6.15
https://github.com/mongodb/docs/commit/fc55ac8823811e0cf0c3cde1e5cc1c5d48232958

Comment by Githook User [ 21/Oct/19 ]

Author:

{'username': 'kay-kim', 'email': 'kay.kim@10gen.com', 'name': 'Kay Kim'}

Message: DOCS-12561: 3.6.15 - stepdown on SIGTERM
Branch: v3.6.15
https://github.com/mongodb/docs/commit/2aa4bce5fddf7a242634dfc1f1c3f2dd6de2fcfa

Comment by Kay Kim (Inactive) [ 18/Oct/19 ]

Backport to 3.6.15

Comment by Githook User [ 30/Sep/19 ]

Author:

{'username': 'kay-kim', 'email': 'kay.kim@10gen.com', 'name': 'Kay Kim'}

Message: DOCS-12561: SIGTERM of replica set primary
Branch: v4.0
https://github.com/mongodb/docs/commit/451fe2c801b1c1219a9bfce5c388ef3ab47ea81f

Comment by Githook User [ 30/Sep/19 ]

Author:

{'name': 'Kay Kim', 'username': 'kay-kim', 'email': 'kay.kim@10gen.com'}

Message: DOCS-12561: SIGTERM of replica set primary
Branch: master
https://github.com/mongodb/docs/commit/9144b2500fd740ee0571861a189e1469e075b562

Generated at Thu Feb 08 08:05:33 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.