[DOCS-3083] Make production notes more prominent Created: 07/Apr/14  Updated: 05/May/14  Resolved: 05/May/14

Status: Closed
Project: Documentation
Component/s: manual
Affects Version/s: None
Fix Version/s: v1.3.5

Type: Improvement Priority: Major - P3
Reporter: Jon Rangel (Inactive) Assignee: Sam Kleinman (Inactive)
Resolution: Done Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Participants:
Days since reply: 9 years, 41 weeks, 2 days ago

 Description   

Time and again when meeting with customers we see the same mistakes made when deploying MongoDB in production, such as:

  • suboptimal readahead settings
  • ulimits
  • failing to disable NUMA
  • failing to disable THP
  • suboptimal RAID configuration

to name a few. All of the above are covered in the Production Notes, but in my experience many customers are not even aware this page exists.

We should make the production notes more prominent in a number of places on mongodb.org in order to raise awareness of this checklist that is vital for an optimally performing MongoDB deployment. I suggest adding prominent links and a description of the significance of the production notes to the following pages:



 Comments   
Comment by Githook User [ 05/May/14 ]

Author:

{u'username': u'tychoish', u'name': u'Sam Kleinman', u'email': u'samk@10gen.com'}

Message: DOCS-3083: linking production notes rather than nav page on index file
Branch: v2.4
https://github.com/mongodb/docs/commit/44ea99abfe6bcd515c23358c1019211abca7cda0

Comment by Githook User [ 05/May/14 ]

Author:

{u'username': u'tychoish', u'name': u'Sam Kleinman', u'email': u'samk@10gen.com'}

Message: DOCS-3083: linking production notes rather than nav page on index file
Branch: master
https://github.com/mongodb/docs/commit/5a4dacc8f50fd28306d098e444821786bb3089ad

Comment by Githook User [ 05/May/14 ]

Author:

{u'username': u'idbentley', u'name': u'Ian Bentley', u'email': u'ian.bentley@gmail.com'}

Message: Merge pull request #36 from tychoish/add-prod-notes-link

DOCS-3083: add link to production notes on download page notes section
Branch: master
https://github.com/10gen/mongodb-www/commit/16d30a6cdd0a3afe0363344bc003c0650c781cbb

Comment by Githook User [ 05/May/14 ]

Author:

{u'username': u'tychoish', u'name': u'Sam Kleinman', u'email': u'samk@10gen.com'}

Message: DOCS-3083: add link to production notes on download page notes section
Branch: master
https://github.com/10gen/mongodb-www/commit/3f4f4881c336e465ca75ad9135e6f2e11ee17925

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