[SERVER-55525] Show a warning in the legacy shell that it is deprecated Created: 25/Mar/21  Updated: 29/Oct/23  Resolved: 07/Jun/21

Status: Closed
Project: Core Server
Component/s: Shell
Affects Version/s: None
Fix Version/s: 5.0.0-rc1, 5.1.0-rc0

Type: Task Priority: Major - P3
Reporter: Jessica Sigafoos Assignee: Robert Guo (Inactive)
Resolution: Fixed Votes: 0
Labels: post-rc0, shell-ga
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Backports
Initiative
Problem/Incident
causes SERVER-59883 Have mongo shell message about using ... Closed
Backwards Compatibility: Fully Compatible
Backport Requested:
v5.0
Sprint: STM 2021-06-14
Participants:
Story Points: 2

 Description   

mongosh will be released for GA concurrently with the 5.0 server release.  At this time, when someone installs and runs mongo, they should see a deprecation warning that points them to download mongosh instead.

This is work is part of the New MongoDB Shell GA and Deprecation & EOL strategy for Legacy Shell Initiative and is outlined in the Initiative Plan.



 Comments   
Comment by Vivian Ge (Inactive) [ 06/Oct/21 ]

Updating the fixversion since branching activities occurred yesterday. This ticket will be in rc0 when it’s been triggered. For more active release information, please keep an eye on #server-release. Thank you!

Comment by Githook User [ 08/Jun/21 ]

Author:

{'name': 'Robert Guo', 'email': 'robert.guo@mongodb.com'}

Message: SERVER-55525 show warning in shell that it's deprecated

(cherry picked from commit 8ffd10695231a88db3cb48023b74e1ae217cea73)
Branch: v5.0
https://github.com/mongodb/mongo/commit/5ab854e540e05463609353a1f725869391cacdfd

Comment by Githook User [ 07/Jun/21 ]

Author:

{'name': 'Robert Guo', 'email': 'robert.guo@mongodb.com'}

Message: SERVER-55525 show warning in shell that it's deprecated
Branch: master
https://github.com/mongodb/mongo/commit/8ffd10695231a88db3cb48023b74e1ae217cea73

Comment by Nick Bell [ 25/May/21 ]

robert.guo  I think we should show the deprecation message every time the shell starts. (massimiliano.marcon supports this also)

(Keep reminding them until they switch over.  We can also not be accused 12 months down the track of "why did you take my shell away and not tell me?")

Comment by Nick Bell [ 23/May/21 ]

robert.guo  If it is going to be in the next major release, I'd go with "upcoming release".  If it will be in a few release time, I'd go with a "future release"

Comment by Robert Guo (Inactive) [ 22/May/21 ]

Another consideration: do we want to show the deprecation message every time the shell starts or only the first time? There is currently a welcome message (here) that is only displayed when the shell is first used. Do we want to replace that with the deprecation message too?

Comment by Robert Guo (Inactive) [ 21/May/21 ]

Thanks for the suggestion Drew.

nicholas.bell massimiliano.marcon, any preferences on "upcoming/future/next release"?

Comment by Nick Bell [ 21/May/21 ]

Can I suggest the following (Clearer statement of what's happened/happening - More positive tone upfront):

The "mongo" shell has been superseded with "mongosh" that delivers improved usability and compatibility.  The "mongo" shell has now been deprecated and will be removed in the next major release.  We recommend you begin using "mongosh".  For installation instructions, see https://docs.mongodb.com/mongodb-shell/install/

Comment by Jessica Sigafoos [ 23/Apr/21 ]

Hello!  When you have a draft copy for the deprecation message, can you send it to massimiliano.marcon for review?

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