StackStorm / StackStorm/st2-packages

Suggestion: Update installer scripts to set kernel parameters for Mongo

Open
#414 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

documentation enhancement question
Dominant language
Shell
Stars
28
Forks
63
PR merge metrics
No merged PRs in 30d

Description

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?

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Locate the standard installation one-liner, manual installation steps, and installer scripts, then compare the reported CentOS 7.3 and Ubuntu 14.04 warnings. Done means the project has a decided and documented approach for the MongoDB kernel parameters and soft rlimits, with the affected installation path updated accordingly.

Written by the indexing model from the issue text.

Assessment

Tech stack
linux, mongodb, shell
Domain
databases, devops, operating-systems
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
32/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.