Skip to content

Suggestion: Update installer scripts to set kernel parameters for Mongo #414

Description

@LindsayHill

If a user follows our standard installation instructions, either using the one-liner, or following the manual steps, they will get these warning messages with MongoDB:

2017-02-01T23:10:31.846+0000 I CONTROL  [initandlisten] ** WARNING: /sys/kernel/mm/transparent_hugepage/enabled is 'always'.
2017-02-01T23:10:31.846+0000 I CONTROL  [initandlisten] **        We suggest setting it to 'never'
2017-02-01T23:10:31.847+0000 I CONTROL  [initandlisten]
2017-02-01T23:10:31.847+0000 I CONTROL  [initandlisten] ** WARNING: /sys/kernel/mm/transparent_hugepage/defrag is 'always'.
2017-02-01T23:10:31.847+0000 I CONTROL  [initandlisten] **        We suggest setting it to 'never'
2017-02-01T23:10:31.847+0000 I CONTROL  [initandlisten]
2017-02-01T23:10:31.847+0000 I CONTROL  [initandlisten] ** WARNING: soft rlimits too low. rlimits set to 4096 processes, 64000 files. Number of processes should be at least 32000 : 0.5 times number of files.

(NB Above is seen with CentOS 7.3. Ubuntu 14.04 will only have the first two warnings).

Should we:
(A) Update our installer script to set these values
(B) Update our documentation to recommend that the user changes these values

Thoughts?

Activity

  1. arm4b commented on Feb 2, 2017

    @arm4b
    Member

    Yeah, we had discussions similar to that previously.
    The general idea is that we provide minimal installation and more fine tuning like kernel, mongo, rabbit, postgres is out of scope, because it's possible to write a novel for optimizing each service/setting.
    Even st2.conf has so many advanced options https://github.com/StackStorm/st2/blob/master/conf/st2.conf.sample.

    So IMO if it blocks installation and minimally working st2, - we include the change in packaging/scripts, if it's "fine-tuning" - leave that for users.

    I have no strong opinions about updating documentation, but there are respective articles in mongo docs: https://docs.mongodb.com/manual/tutorial/transparent-huge-pages/ and https://docs.mongodb.com/manual/reference/ulimit/

  2. LindsayHill commented on Feb 2, 2017

    @LindsayHill
    ContributorAuthor

    I think updating the docs is a minimum, even if it is just to link to the MongoDB docs directly. The problem is the WARNING statement above - some users see it and freak out. The fewer distractions for users, the better.

    (IIRC, there's something similar related to PostgreSQL/Mistral that probably needs following up)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions