bomonike

Set this higher to prevent errors during high load

US (English)   Norsk (Norwegian)   Español (Spanish)   Français (French)   Deutsch (German)   Italiano   Português   Estonian   اَلْعَرَبِيَّةُ (Egypt Arabic)   Napali   中文 (简体) Chinese (Simplified)   日本語 Japanese   한국어 Korean

Overview

maximum-limits.png

Operating systems (Linux and macOS included) have settings which limit the number of files and processes that are allowed to be open. This limit protects the system from being overrun. But its default is usually set too low, when machines had way less power. Thus a “gotcha” that is only apparent when “too many files open” crashes appear only under load (as in during a stress test or production spike).

man bash, the Bash manual says the ulimit command (common among Linux flavors) provides “control over the resources available to the shell and to processes started by it”.

  1. Obtain the current limit of file descriptors

    ulimit -n

    An example output: “256” or “10032”.

    PROTIP: On MacOS, the maximum number that can be specified is 12288.

  2. Obtain the current limit of processes

    ulimit -u

    An example output: “1418”.

On macOS

  1. Obtain the current limit:

    launchctl limit maxfiles

    The response output should have numbers like this:

    maxfiles    65536          200000

    The first number is the “soft” limit and the second number is the “hard” limit.

    Configuration changes are necessary if lower numbers are displayed, such as:

    maxfiles    256            unlimited
  2. If the soft limit is too low (such as 256), set the current session to:

    sudo launchctl limit maxfiles 65536 200000

    Some set it to 1048576 (over a million).

    Since sudo is needed, you are prompted for a password.

    PROTIP: Because this would go back to defaults on reboot, add this command in your ~/.bash_profile

    Alternately, install Facebook’s Watchman utility which watches and adjusts automatically.

    PROTIP: Take both a full/complete backup to ensure fall-back. Also run a benchmark performance measurement before and after changing the configuration to detect issues.

  3. Over several versions, Apple has changed the way system-wide open file limits can be set upon restart.

    Yosemite and older

    NOTE: On older MacOSX Yosemite, to make the settings permanent, increase the limits, edit (or create) file /etc/launchd.conf to contain:

    limit maxfiles 65536 200000

    Sierra and newer versions

    Newer versions of macOS do not reference the file due to security considerations.

    On newer macOS Sierra and High Sierra, Dejan Kitic and this found that two plist files need to be added.

  4. Copy in folder /Library/LaunchDaemons/ plist files from a GitHub repository:

    https://github.com/wilsonmar/mac-setup/blob/master/configs/limit.maxfiles.plist at 524288

    ```xml <?xml version=”1.0” encoding=”UTF-8”?> <!DOCTYPE plist PUBLIC “-//Apple//DTD PLIST 1.0//EN” “http://www.apple.com/DTDs/PropertyList-1.0.dtd”>

Label limit.maxfiles ProgramArguments launchctl limit maxfiles 524288 524288 RunAtLoad ServiceIPC

   https://github.com/wilsonmar/mac-setup/blob/master/configs/limit.maxproc.plist at 2048

   ```xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>Label</key>
      <string>limit.maxproc</string>
    <key>ProgramArguments</key>
      <array>
        <string>launchctl</string>
        <string>limit</string>
        <string>maxproc</string>
        <string>2048</string>
        <string>2048</string>
      </array>
    <key>RunAtLoad</key>
      <true/>
    <key>ServiceIPC</key>
      <false/>
  </dict>
</plist>

(Thank you to sebco for the correction)

  1. Run this shell script:

    ```

    OS (Outside of System Settings): Limit of File Descriptors:

    This needs to be done only once:

    Explained in https://bomonike.github.io/maximum-limits

    Mentions of this issue about the limit of open files on macOS & Linux:

    https://neo4j.com/developer/kb/setting-max-open-file-limits-on-osx/

    https://gist.github.com/tombigel/d503800a282fcadbee14b537735d202c?permalink_comment_id=3361594

    https://superuser.com/questions/1634286/how-do-i-increase-the-max-open-files-in-macos-big-sur

    https://www.baeldung.com/linux/limit-file-descriptors

    This is in .zshrc to set only for current session (since Yosemite):

    sudo launchctl limit maxfiles 65536 200000

    This requires manual password entry.

    ULIMIT_SOFT_LIMIT=$( ulimit -Sn ) # 2560 on my mac ULIMIT_HARD_LIMIT=$( ulimit -Hn ) # unlimited echo “*** File Descriptors: ulimit -Sn: ${ULIMIT_SOFT_LIMIT} ulimit -Hn: ${ULIMIT_HARD_LIMIT}”

    To permanently increase the maximum number of open files:

We get it this file locally so values are under your control:

sudo mv limit.maxfiles.plist /Library/LaunchDaemons

TODO: Copy from https://raw.githubusercontent.com/wilsonmar/mac-setup/refs/heads/main/configs/limit.maxfiles.plist

# to /Library/LaunchDaemons

chown for “-rw-r–r–”, set by sudo chmod 644:

sudo chown root:wheel /Library/LaunchDaemons/limit.maxfiles.plist sudo launchctl load -w /Library/LaunchDaemons/limit.maxfiles.plist # In the file, 524288 is the soft limit (instead of 12288) # The hard limit is up to 1048576 for high-performance scenarios. # Per https://apple.stackexchange.com/a/366319, value of unlimited can be up to the max value of SIGNED INT of 2147483647.

The default maxproc is 2666 soft and 4000 hard.

sudo mv limit.maxproc.plist /Library/LaunchDaemons

TODO:Copy from https://raw.githubusercontent.com/wilsonmar/mac-setup/refs/heads/main/configs/limit.maxproc.plist

# to /Library/LaunchDaemons # In the file, 2048 is the soft and hard limit (instead of 256) sudo chown root:wheel /Library/LaunchDaemons/limit.maxproc.plist sudo launchctl load -w /Library/LaunchDaemons/limit.maxproc.plist

Additionally, Java applications need to use the -XX:-MaxFDLimit JVM option to bypass the internal 10,240 file descriptor limit.

```

  1. Invoke the files:

    sudo launchctl load -w /Library/LaunchDaemons/limit.maxfiles.plist
    sudo launchctl load -w /Library/LaunchDaemons/limit.maxproc.plist

    The files’ ownership needs to be changed to “root:wheel”.

    Their permissions need to be “-rw-r–r–”, set by sudo chmod 644.

  2. So how do you turn csrutil off? Google says “sudo csrutil disable…”. But not so easy. That can only be done in Recovery Mode. So, reboot, hold command + R to enter Recovery Mode, once there open terminal and do csrutil disable… Finally a breakthrough…disabled.

  3. Now you can adjust the process limit on Mac OS X Yosemite and El Capitan versions:

    sudo ulimit -n 65536 200000

    Since sudo is needed, you are prompted for a password.

  4. To increase the inotify watchers max limit, edit (or create) file /etc/sysctl.conf (inherited from BSD) to contain:

    kern.maxfiles=49152
    kern.maxfilesperproc=24576

    or

    kern.maxfiles=200000
    kern.maxfilesperproc=200000

    Alternately, run interactive commands:

    sudo sysctl -w kern.maxfiles=5242880

    The response:

    kern.maxfiles: 49152 -> 5242880
    sudo sysctl -w kern.maxfilesperproc=524288

    The response:

    kern.maxfilesperproc: 24576 -> 524288
  5. Restart the system for the new limits to take effect.

  6. After restarting, verify the new limits by running:

On RedHat and CentOS

  1. To enable PAM-based user limits so that non-root users, such as the riak user, may specify a higher value for maximum open files, edit (or create) file /etc/security/limits.conf to contain:

    * soft nofile 65536
    * hard nofile 200000

    If the file already exists, append the above to the bottom of the file.

  2. To activate limits, edit (or create) file /etc/pam.d/login to contain:

    session    required   pam_limits.so
  3. Restart the machine.
  4. Verify by “ulimit -a” again.

    ulimit -n
    ulimit -Hn # Hard limit
    ulimit -Sn # Soft limit

    If the response is “10032”