[DOCS-15477] [SERVER] During the upgrade path from 4.0 to 4.2, warn about legacy collMod options crashing secondary during rolling upgrade Created: 12/Jul/22  Updated: 13/Nov/23  Resolved: 15/Aug/22

Status: Closed
Project: Documentation
Component/s: manual, Server
Affects Version/s: 4.0.0, 4.2.0, 5.0.0, 6.0.0
Fix Version/s: 4.2.0, 4.4.0, 5.0.0, 6.0.0, Server_Docs_20231030, Server_Docs_20231106, Server_Docs_20231105, Server_Docs_20231113

Type: Task Priority: Major - P3
Reporter: Edwin Zhou Assignee: Jason Price
Resolution: Done Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Participants:
Days since reply: 1 year, 25 weeks, 2 days ago
Epic Link: DOCSP-11702
Story Points: 3

 Description   

As identified in SERVER-67924, applications that use the 4.0 accepted command

db.getSiblingDB("test").runCommand({ collMod: "test_col", usePowerOf2Sizes: <boolean> });
or
db.getSiblingDB("test").runCommand({ collMod: "test_col", noPadding: <boolean> });

will crash any 4.2 secondaries that attempt to replicate this command.

This can lead to an undesirable upgrade experience that can cause 4.2 secondary nodes to suddenly crash while following the upgrade procedure.

We should recommend that users remove all instances of collMod that uses legacy options in their application.

  1. https://www.mongodb.com/docs/manual/release-notes/4.2-upgrade-replica-set/
  2. https://www.mongodb.com/docs/manual/tutorial/change-replica-set-wiredtiger/

Note that we already document these options as deprecated in our existing collMod documentation:

MongoDB removes the MMAPv1 storage engine and the MMAPv1 specific options noPadding and usePowerOf2Sizes for collMod.



 Comments   
Comment by Githook User [ 15/Aug/22 ]

Author:

{'name': 'jason-price-mongodb', 'email': '69260375+jason-price-mongodb@users.noreply.github.com', 'username': 'jason-price-mongodb'}

Message: DOCS-15477-small-collMod-adjustment (#1645)

Co-authored-by: jason-price-mongodb <jshfjghsdfgjsdjh@aolsdjfhkjsdhfkjsdf.com>
Branch: master
https://github.com/10gen/docs-mongodb-internal/commit/b9674b37a1e68699686a5a839992ccee4c95e7f6

Comment by Githook User [ 15/Aug/22 ]

Author:

{'name': 'jason-price-mongodb', 'email': '69260375+jason-price-mongodb@users.noreply.github.com', 'username': 'jason-price-mongodb'}

Message: DOCS-15477 coll mod rolling upgrade (BACKPORT) (#1643)

  • DOCSP-24185 repl set get status uptime
  • DOCSP-24185 repl set get status uptime

Co-authored-by: jason-price-mongodb <jshfjghsdfgjsdjh@aolsdjfhkjsdhfkjsdf.com>

Co-authored-by: jason-price-mongodb <jshfjghsdfgjsdjh@aolsdjfhkjsdhfkjsdf.com>
Branch: v4.4
https://github.com/10gen/docs-mongodb-internal/commit/c8d59ef2d2f9e451125e814eef2f9984a1695866

Comment by Githook User [ 15/Aug/22 ]

Author:

{'name': 'jason-price-mongodb', 'email': '69260375+jason-price-mongodb@users.noreply.github.com', 'username': 'jason-price-mongodb'}

Message: DOCS-15477 coll mod rolling upgrade (BACKPORT) (#1642)

Co-authored-by: jason-price-mongodb <jshfjghsdfgjsdjh@aolsdjfhkjsdhfkjsdf.com>

Co-authored-by: jason-price-mongodb <jshfjghsdfgjsdjh@aolsdjfhkjsdhfkjsdf.com>
Branch: v5.0
https://github.com/10gen/docs-mongodb-internal/commit/fbb52a56a647c189800e89a8d6fcdd726308bd04

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