[SERVER-18726] Add example configuration files Created: 28/May/15  Updated: 05/Dec/22  Resolved: 16/Nov/22

Status: Closed
Project: Core Server
Component/s: Admin, Packaging
Affects Version/s: None
Fix Version/s: features we're not sure of

Type: Improvement Priority: Major - P3
Reporter: Justin Lee Assignee: [DO NOT ASSIGN] Backlog - Server Development Platform Team (SDP) (Inactive)
Resolution: Won't Do Votes: 3
Labels: sdp-backlog-purge
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Related
is related to SERVER-14750 Convert RPM and DEB mongod.conf files... Closed
Assigned Teams:
Server Development Platform
Participants:

 Description   

It would probably be tremendously helpful to ship complete examples of config files (both in yaml and legacy format) with all the options and values documented. All I've been able to find are just tidbits here and there and have no idea what a reasonably complete configuration file might look like.



 Comments   
Comment by Iryna Zhuravlova [ 16/Nov/22 ]

After a careful backlog refinement, the team decided to close this ticket because of its low priority and limited resource capacity. If you believe that this ticket requires additional attention from the team and should be re-opened, feel free to change the status to "Needs Scheduling" and ping me or @alexander.neben

Comment by Adam Comerford [ 19/Aug/15 ]

Just for reference, until this is done, I wrote up some examples here:

http://dba.stackexchange.com/a/82592/6441

Comment by Thomas J. Girsch [ 15/Jul/15 ]

ernie.hershey@10gen.com Thanks. I definitely need a stable release. I was more commenting on behalf of others who may not be as proficient in config file editing and want a quick-and-easy installation.

(I wanted to enable Wired Tiger, and could only find YAML instructions for that, hence the need to convert the file.)

I agree with previous commenters that a comprehensive file with every parameter documented would be ideal, but the modern format sample would be a good start.

Comment by Ernie Hershey [ 15/Jul/15 ]

tgirsch - got it. The 3.1 branch is still in development so you have to point to the "unstable" repo in order to get the 3.1.x releases that have the new format. If you already created your own config file, you probably don't need this, but if you want to grab 3.1 packages, you can download https://repo.mongodb.org/yum/redhat/mongodb-org-unstable.repo and use in addition to or instead of the "mongodb-org-3.0.repo" file referenced in the docs.

Comment by Thomas J. Girsch [ 15/Jul/15 ]

ernie.hershey@10gen.com: I was just looking for the updated config file format. I've already created my own, but wanted to make sure it's being added to a future release, for ease.

I just tried "yum update mongodb-org" and didn't get any updates, so apparently the new config isn't generally available yet (at least not in CentOS package form).

Note that I was mistaken above. I'm using CentOS 7, not Ubuntu. [Since corrected]

Comment by Ernie Hershey [ 15/Jul/15 ]

Hi tgirsch - are you looking for an updated config file format or example configuration files with all options?

The updated format is available in versions including 3.1.2 and higher.
Example files with all available options haven't been created yet but you can track progress in this ticket.

Comment by Thomas J. Girsch [ 15/Jul/15 ]

Within the past couple of weeks, I did a "yum install mongodb-org" on CentOS 7, following these directions:

http://docs.mongodb.org/manual/tutorial/install-mongodb-on-red-hat/

...and the mongod.conf file that got installed was still the old format.

But it's DB version 3.0.4, so perhaps the repository is out of date, or the fix is not yet available in a sane version?

Comment by Ernie Hershey [ 29/May/15 ]

The default files are YAML starting with 3.1.2 in SERVER-14750. They're not complete with all options though, just sane defaults that will work with packages.

Could we generate full examples somehow using options in the code?

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