[DOCS-9947] Comment on: "MongoDB Atlas/mongo-shell-connection.txt" Created: 28/Feb/17  Updated: 04/Apr/18  Resolved: 29/Mar/18

Status: Closed
Project: Documentation
Component/s: Atlas
Affects Version/s: None
Fix Version/s: None

Type: Bug Priority: Major - P3
Reporter: Andrew Davidson Assignee: Robert Justice (Inactive)
Resolution: Done Votes: 0
Labels: collector-298ba4e7
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified
Environment:

Location: https://docs.atlas.mongodb.com/mongo-shell-connection/
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/56.0.2924.87 Safari/537.36
Referrer: https://docs.atlas.mongodb.com/connect-to-cluster/
Screen Resolution: 1440 x 900


Participants:
Days since reply: 6 years, 1 week, 2 days ago
Epic Link: DOCSP-1743
Story Points: 0.25

 Description   

Updated ToDo:

ToDo:

Update https://docs.atlas.mongodb.com/mongo-shell-connection/ to include a brief procedure for manually downloading and installing the Mongo shell.

Existing steps will get users as far as downloading, but not installing/running the file. Windows users need to install and run `mongo` using the full path to the file (need to test if .MSI installation adds mongo to path). Other users need to extract and run from extract location, or add binary to /usr/bin.

----- Original -----
This page would benefit from a being a little bit more focused on the totally new user.

Specifically it would be good to show
1) High level instructions on downloading and extracting the shell
2) High level instructions on running it (./bin/mongo "uri") and also changing the PATH env variable so that the new version can be run as >mongo
3) It would be good to emphasize that the shell version 3.4 is required to use the mongoURI (so we could even demonstrate running mongo --version and if the output is not 3.4 suggest getting newer version).



 Comments   
Comment by Andrew Davidson [ 05/Feb/18 ]

While the UI shows a link to download the shell I still think the docs page should be a little more giving to a totally new user who is not familiar with download utilities and extracting them for use on their local machine..

so I'd show the
> curl -Of <URL to download latest version of shell>
> tar -xf ./file_you_just_downloaded.tgz
> cd ./<directory_you_just_extracted>/bin
> ./mongo to run

or similar.

We are leaping to a conclusion that a user is command-line ready when that is not always the case

Comment by Ravind Kumar (Inactive) [ 03/Feb/18 ]

andrew.davidson given the changes to the Atlas cluster connect dialog and the current iteration of the linked page, I'm thinking we can close this ticket - especially since the UI provides a link to download the appropriate MongoDB version.

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