[DOCS-13824] Investigate changes in SERVER-49887: requireApiVersion startup parameter Created: 11/Aug/20  Updated: 13/Nov/23  Resolved: 18/May/21

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

Type: Task Priority: Major - P3
Reporter: Backlog - Core Eng Program Management Team Assignee: Joseph Dougherty
Resolution: Gone away Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Documented
documents SERVER-49887 requireApiVersion startup parameter Closed
Related
related to DOCS-14240 Investigate changes in SERVER-53934: ... Closed
is related to SERVER-56925 Remove requireApiVersion server param... Closed
Participants:
Days since reply: 2 years, 38 weeks, 1 day ago
Epic Link: DOCSP-14217

 Description   

Description

Downstream Change Summary

When mongod or mongos are started with --setParameter requireApiVersion=true, all commands require an "apiVersion" parameter.

Description of Linked Ticket

If mongod/mongos is started with --setParameter requireApiVersion=true, it replies with APIVersionError to all command invocations that omit "apiVersion". Commands that prohibit "apiVersion", such as "getMore" and transaction-continuing commands, prohibit "apiVersion" even with requireApiVersion=true.

Write a JSTest to check that API parameters are required in all commands except where "apiVersion" is prohibited.

Scope of changes

Consider doing this and DOCS-14240 together.

Impact to Other Docs

MVP (Work and Date)

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



 Comments   
Comment by A. Jesse Jiryu Davis [ 18/May/21 ]

Outcome: don't document this param.

Comment by Joseph Dougherty [ 13/May/21 ]

This parameter might not need to be documented depending on the resolution of https://jira.mongodb.org/browse/SERVER-56925.

Comment by Joseph Dougherty [ 13/May/21 ]

This parameter might not need to be documented depending upon how https://jira.mongodb.org/browse/SERVER-56925 is resolved.

Comment by A. Jesse Jiryu Davis [ 13/May/21 ]

Update: we're discussing soon whether to remove this parameter, sorry I didn't say so here earlier. SERVER-56925.

Comment by A. Jesse Jiryu Davis [ 05/May/21 ]

Since we decided not to use this for Serverless/Atlas (CLOUDP-87816), its utility is fading. I wonder if any customers would use it on their own. I suppose we'll leave it in the code and we might as well document it, but I recommend emphasizing this option as little as possible. It is now obscure.

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