Uploaded image for project: 'Documentation'
  1. Documentation
  2. DOCS-13235

Investigate changes in SERVER-44282: Set NUMAPolicy in systemd unit

    XMLWordPrintable

    Details

    • Type: Task
    • Status: Closed
    • Priority: Major - P3
    • Resolution: Fixed
    • Affects Version/s: None
    • Fix Version/s: Backlog
    • Component/s: manual

      Description

      Description

      Downstream Change Summary

      We need to create some documentation that explains how to properly modify our SystemD service file to include numactl for systems using NUMA. The original SysV init scripts used to do this but very few customers, if any, are still using those as most Linux distros have phased that out in favor of SystemD.

      The steps required are as follows:

      • copy /lib/systemd/system/mongod.service to /etc/systemd/system/mongod.service
      • modify /etc/systemd/system/mongod.service such that the line "ExecStart=/usr/bin/mongod --config /etc/mongod.conf" is now "ExecStart=/usr/bin/numactl --interleave=all /usr/bin/mongod --config /etc/mongod.conf"
      • run `systemctl stop mongod`
      • run `systemctl daemon-reload`
      • run `systemctl start mongod`

      I'm not sure if the path to numactl is exactly correct (/usr/bin/numactl) or what the normal path for it is. That's just an educated guess as I don't have access to a NUMA enabled system.

      Description of Linked Ticket

      The legacy init scripts for mongod set the memory policy to interleave SERVER-3574
      However the systemd units do not.

      New versions of systemd support the NUMAPolicy=interleave directive. https://www.freedesktop.org/software/systemd/man/systemd.exec.html#NUMAPolicy=

      Adding this configuration would minimize the differences between the init scripts and systemd unit files.

      Scope of changes

      Impact to Other Docs

      MVP (Work and Date)

      Resources (Scope or Design Docs, Invision, etc.)

        Attachments

          Issue Links

            Activity

              People

              Assignee:
              andrew.feierabend Andrew Feierabend (Inactive)
              Reporter:
              backlog-server-pm Backlog - Core Eng Program Management Team
              Participants:
              Last commenter:
              Andrew Feierabend Andrew Feierabend (Inactive)
              Votes:
              0 Vote for this issue
              Watchers:
              5 Start watching this issue

                Dates

                Created:
                Updated:
                Resolved:
                Days since reply:
                1 year, 36 weeks, 3 days ago
                Date of 1st Reply: