https://github.com/Saruspete/oom_manager

Script to configure and manage Linux Out-Of-Memory killer
https://github.com/Saruspete/oom_manager

linux memory-killer oom oom-manager out-of-memory

Last synced: about 1 year ago
JSON representation

Script to configure and manage Linux Out-Of-Memory killer

• Host: GitHub
• URL: https://github.com/Saruspete/oom_manager
• Owner: Saruspete
• License: gpl-3.0
• Created: 2014-10-12T23:11:09.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2020-09-30T16:59:13.000Z (over 5 years ago)
• Last Synced: 2024-02-14T21:59:29.474Z (over 2 years ago)
• Topics: linux, memory-killer, oom, oom-manager, out-of-memory
• Language: Shell
• Size: 57.6 KB
• Stars: 8
• Watchers: 2
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
OOM-Manager / javamine

======================

Script to configure and manage Linux Out-Of-Memory killer.

Features

--------

  * **Change the oom_score parameter based on patterns**. The default score script provides the following filters :

    * user (UserName)

    * uid (UserID)

    * ruid (real-UserID)

    * pid (ProcessID)

    * ppid (parent-ProcessID)

    * process (process name)

    * score (OOM-Score)

  * **Trigger OOM at defined RAM & Swap usage**. This is particularely useful to generate an OOM before all memory is used and system is totally unresponsive

  * **Logs all disruptive action** by default. Verbosity level configurable

  * Management scripts runs as *root*, while scoring script runs as user *nobody*

  * scoring script is replaceable by any application that reads stdin for processlist and outputs 

Packaging

---------

RPM Specfile is provided in *goodies/oom_manager.spec*

To build it:

	# Ensure you have the package "rpm-build" installed.

	

	# Create the ~/rpmbuild tree

	rpmdev-setuptree -d

	

	# Downlad the latest version of goodies/oom_manager.spec to ~/rpmbuild/SPECS

	wget https://raw.githubusercontent.com/Saruspete/oom_manager/master/goodies/oom_manager.spec -O ~/rpmbuild/SPECS/oom_manager.spec

	

	# If your rpmbuild version doesn't support "source auto-download", 

	# download the target release from https://github.com/Saruspete/oom_manager/releases 

	# and put it into ~/rpmbuild/SOURCES/

	rpmbuild --undefine=_disable_source_fetch -ba ~/rpmbuild/SPECS/oom_manager.spec

	

	# Your RPM should be available in: 

	# ~/rpmbuild/RPMS/noarch/oom_manager-*.noarch.rpm

	

Manual (non-packaged) Installation

-----------------------------------

If you can't create a package, you can place the script as-is in /usr/local:

	# Set your target folder

	OOMMGR_PATH="/usr/local"

	

	# Download and extract to /usr/local

	wget https://github.com/Saruspete/oom_manager/archive/master.tar.gz -O - | tar -zxv --strip=1 -C $OOMMGR_PATH

	

	# Edit and copy the configuration to standard folder

	echo "PATH_BASE=$OOMMGR_PATH" >> $OOMMGR_PATH/etc/sysconfig/oom_manager

	mv $OOMMGR_PATH/etc/sysconfig/oom_manager /etc/sysconfig/

	

	# Copy the service file depending on the system init

	

	# systemd

	if [[ "$(