cgroup.conf

Section: Slurm Configuration File (5)
Updated: Slurm Configuration File
Index

NAME

cgroup.conf - Slurm configuration file for the cgroup support

DESCRIPTION

cgroup.conf is an ASCII file which defines parameters used by Slurm's Linux cgroup related plugins.
cgroup.confは、SlurmのLinuxcgroup関連プラグインで使用されるパラメーターを定義するASCIIファイルです。
The file location can be modified at system build time using the DEFAULT_SLURM_CONF parameter or at execution time by setting the SLURM_CONF environment variable.
ファイルの場所は、システムのビルド時にDEFAULT_SLURM_CONFパラメーターを使用して変更することも、実行時にSLURM_CONF環境変数を設定することによって変更することもできます。
The file will always be located in the same directory as the slurm.conf file.
このファイルは常にslurm.confファイルと同じディレクトリにあります。

Parameter names are case insensitive.
パラメータ名では大文字と小文字は区別されません。
Any text following a "#" in the configuration file is treated as a comment through the end of that line.
構成ファイルの「＃」に続くテキストは、その行の終わりまでコメントとして扱われます。
Changes to the configuration file take effect upon restart of Slurm daemons, daemon receipt of the SIGHUP signal, or execution of the command "scontrol reconfigure" unless otherwise noted.
構成ファイルへの変更は、特に明記されていない限り、Slurmデーモンの再起動、デーモンによるSIGHUPシグナルの受信、またはコマンド「scontrolreconfigure」の実行時に有効になります。

For general Slurm Cgroups information, see the Cgroups Guide at <https://slurm.schedmd.com/cgroups.html>.
Slurm Cgroupsの一般的な情報については、＜https://slurm.schedmd.com/cgroups.html＞のCgroupsガイドを参照してください。

The following cgroup.conf parameters are defined to control the general behavior of Slurm cgroup plugins.
次のcgroup.confパラメーターは、Slurmcgroupプラグインの一般的な動作を制御するために定義されています。

CgroupAutomount=<yes|no>: Slurm cgroup plugins require valid and functional cgroup subsystem to be mounted under /sys/fs/cgroup/<subsystem_name>.
Slurm cgroupプラグインでは、有効で機能的なcgroupサブシステムを/ sys / fs / cgroup / ＜subsystem_name＞の下にマウントする必要があります。
When launched, plugins check their subsystem availability.
プラグインを起動すると、サブシステムの可用性がチェックされます。
If not available, the plugin launch fails unless CgroupAutomount is set to yes.
使用できない場合、CgroupAutomountがyesに設定されていない限り、プラグインの起動は失敗します。
In that case, the plugin will first try to mount the required subsystems.
その場合、プラグインは最初に必要なサブシステムをマウントしようとします。
CgroupMountpoint=PATH: Specify the PATH under which cgroups should be mounted.
cgroupをマウントするパスを指定します。
This should be a writable directory which will contain cgroups mounted one per subsystem.
これは、サブシステムごとに1つずつマウントされたcgroupを含む書き込み可能なディレクトリである必要があります。
The default PATH is /sys/fs/cgroup.
デフォルトのPATHは/ sys / fs / cgroupです。

TASK/CGROUP PLUGIN

The following cgroup.conf parameters are defined to control the behavior of this particular plugin:
次のcgroup.confパラメーターは、この特定のプラグインの動作を制御するために定義されています。

AllowedKmemSpace=<number>: Constrain the job cgroup kernel memory to this amount of the allocated memory, specified in bytes.
ジョブcgroupカーネルメモリを、バイト単位で指定された、割り当てられたメモリのこの量に制限します。
The AllowedKmemSpace must be between the upper and lower memory limits, specified by MaxKmemPercent and MinKmemSpace, respectively.
AllowedKmemSpaceは、それぞれMaxKmemPercentとMinKmemSpaceで指定されたメモリの上限と下限の間にある必要があります。
If AllowedKmemSpace goes beyond the upper or lower limit, it will be reset to that upper or lower limit, whichever has been exceeded.
AllowedKmemSpaceが上限または下限を超えると、その上限または下限のいずれかを超えた方にリセットされます。
AllowedRAMSpace=<number>: Constrain the job/step cgroup RAM to this percentage of the allocated memory.
ジョブ/ステップcgroupRAMを、割り当てられたメモリのこのパーセンテージに制限します。
The percentage supplied may be expressed as floating point number, e.g. 101.5.
提供されるパーセンテージは、浮動小数点数、たとえば101.5として表すことができます。
Sets the cgroup soft memory limit at the allocated memory size and then sets the job/step hard memory limit at the (AllowedRAMSpace/100) * allocated memory.
cgroupソフトメモリ制限を割り当てられたメモリサイズに設定してから、ジョブ/ステップハードメモリ制限を（AllowedRAMSpace / 100）*割り当てられたメモリに設定します。
If the job/step exceeds the hard limit, then it might trigger Out Of Memory (OOM) events (including oom-kill) which will be logged to kernel log ringbuffer (dmesg in Linux).
ジョブ/ステップがハード制限を超えると、メモリ不足（OOM）イベント（oom-killを含む）がトリガーされ、カーネルログリングバッファー（Linuxのdmesg）に記録される可能性があります。
Setting AllowedRAMSpace above 100 may cause system Out of Memory (OOM) events as it allows job/step to allocate more memory than configured to the nodes.
AllowedRAMSpaceを100を超えて設定すると、ジョブ/ステップがノードに構成されているよりも多くのメモリを割り当てることができるため、システムのメモリ不足（OOM）イベントが発生する可能性があります。
Reducing configured node available memory to avoid system OOM events is suggested.
システムOOMイベントを回避するために、構成済みノードの使用可能メモリーを減らすことをお勧めします。
Setting AllowedRAMSpace below 100 will result in jobs receiving less memory than allocated and soft memory limit will set to the same value as the hard limit.
AllowedRAMSpaceを100未満に設定すると、ジョブは割り当てられたメモリよりも少ないメモリを受け取り、ソフトメモリ制限はハード制限と同じ値に設定されます。
Also see ConstrainRAMSpace.
ConstrainRAMSpaceも参照してください。
The default value is 100.
デフォルト値は100です。
AllowedSwapSpace=<number>: Constrain the job cgroup swap space to this percentage of the allocated memory.
ジョブのcgroupスワップスペースを、割り当てられたメモリのこのパーセンテージに制限します。
The default value is 0, which means that RAM+Swap will be limited to AllowedRAMSpace.
デフォルト値は0です。これは、RAM + SwapがAllowedRAMSpaceに制限されることを意味します。
The supplied percentage may be expressed as a floating point number, e.g. 50.5.
提供されるパーセンテージは、浮動小数点数、たとえば50.5として表すことができます。
If the limit is exceeded, the job steps will be killed and a warning message will be written to standard error.
制限を超えると、ジョブステップが強制終了され、警告メッセージが標準エラーに書き込まれます。
Also see ConstrainSwapSpace.
ConstrainSwapSpaceも参照してください。
NOTE: Setting AllowedSwapSpace to 0 does not restrict the Linux kernel from using swap space.
注：AllowedSwapSpaceを0に設定しても、Linuxカーネルによるスワップスペースの使用は制限されません。
To control how the kernel uses swap space, see MemorySwappiness.
カーネルがスワップスペースを使用する方法を制御するには、MemorySwappinessを参照してください。
ConstrainCores=<yes|no>: If configured to "yes" then constrain allowed cores to the subset of allocated resources.
「yes」に構成されている場合は、許可されたコアを割り当てられたリソースのサブセットに制限します。
This functionality makes use of the cpuset subsystem.
この機能は、cpusetサブシステムを利用します。
Due to a bug fixed in version 1.11.5 of HWLOC, the task/affinity plugin may be required in addition to task/cgroup for this to function properly.
HWLOCのバージョン1.11.5で修正されたバグのため、これが正しく機能するためには、task / cgroupに加えてtask / affinityプラグインが必要になる場合があります。
The default value is "no".
デフォルト値は「no」です。
ConstrainDevices=<yes|no>: If configured to "yes" then constrain the job's allowed devices based on GRES allocated resources.
「yes」に構成されている場合は、GRESに割り当てられたリソースに基づいてジョブの許可されたデバイスを制約します。
It uses the devices subsystem for that.
そのためにデバイスサブシステムを使用します。
The default value is "no".
デフォルト値は「no」です。
ConstrainKmemSpace=<yes|no>: If configured to "yes" then constrain the job's Kmem RAM usage in addition to RAM usage.
「yes」に構成されている場合は、RAM使用量に加えてジョブのKmemRAM使用量を制限します。
Only takes effect if ConstrainRAMSpace is set to "yes".
ConstrainRAMSpaceが「yes」に設定されている場合にのみ有効になります。
The default value is "no".
デフォルト値は「no」です。
If set to yes, the job's Kmem limit will be set to AllowedKmemSpace if set; otherwise, the job's Kmem limit will be set to its RAM limit.
yesに設定されている場合、ジョブのKmem制限はAllowedKmemSpaceに設定されます（設定されている場合）。それ以外の場合、ジョブのKmem制限はRAM制限に設定されます。
Also see AllowedKmemSpace.
AllowedKmemSpaceも参照してください。
ConstrainRAMSpace=<yes|no>: If configured to "yes" then constrain the job's RAM usage by setting the memory soft limit to the allocated memory and the hard limit to the allocated memory * AllowedRAMSpace.
「yes」に設定されている場合は、メモリのソフト制限を割り当てられたメモリに設定し、ハード制限を割り当てられたメモリに設定することにより、ジョブのRAM使用量を制限します* AllowedRAMSpace。
The default value is "no", in which case the job's RAM limit will be set to its swap space limit if ConstrainSwapSpace is set to "yes".
デフォルト値は「no」です。この場合、ConstrainSwapSpaceが「yes」に設定されていると、ジョブのRAM制限がスワップスペース制限に設定されます。
Also see AllowedSwapSpace, AllowedRAMSpace and ConstrainSwapSpace.
AllowedSwapSpace、AllowedRAMSpace、およびConstrainSwapSpaceも参照してください。
NOTE: When enabled, ConstrainRAMSpace can lead to a noticeable decline in per-node job throughout.
注：ConstrainRAMSpaceを有効にすると、ノードごとのジョブが全体的に著しく低下する可能性があります。
Sites with high-throughput requirements should carefully weigh the tradeoff between per-node throughput, versus potential problems that can arise from unconstrained memory usage on the node.
スループット要件の高いサイトでは、ノードごとのスループットと、ノードでの制約のないメモリ使用量から発生する可能性のある潜在的な問題との間のトレードオフを慎重に検討する必要があります。
See <https://slurm.schedmd.com/high_throughput.html> for further discussion.
詳細については、＜https://slurm.schedmd.com/high_throughput.html＞を参照してください。
ConstrainSwapSpace=<yes|no>: If configured to "yes" then constrain the job's swap space usage.
「yes」に構成されている場合は、ジョブのスワップスペースの使用を制限します。
The default value is "no".
デフォルト値は「no」です。
Note that when set to "yes" and ConstrainRAMSpace is set to "no", AllowedRAMSpace is automatically set to 100% in order to limit the RAM+Swap amount to 100% of job's requirement plus the percent of allowed swap space.
「yes」に設定し、ConstrainRAMSpaceを「no」に設定すると、RAM + Swapの量をジョブの要件の100％に許可されたスワップスペースの割合を加えたものに制限するために、AllowedRAMSpaceが自動的に100％に設定されることに注意してください。
This amount is thus set to both RAM and RAM+Swap limits.
したがって、この量はRAMとRAM + Swapの両方の制限に設定されます。
This means that in that particular case, ConstrainRAMSpace is automatically enabled with the same limit than the one used to constrain swap space.
つまり、その特定のケースでは、ConstrainRAMSpaceは、スワップスペースの制約に使用される制限と同じ制限で自動的に有効になります。
Also see AllowedSwapSpace.
AllowedSwapSpaceも参照してください。
MaxRAMPercent=PERCENT: Set an upper bound in percent of total RAM on the RAM constraint for a job.
ジョブのRAM制約の合計RAMのパーセントで上限を設定します。
This will be the memory constraint applied to jobs that are not explicitly allocated memory by Slurm (i.e. Slurm's select plugin is not configured to manage memory allocations).
これは、Slurmによって明示的にメモリが割り当てられていないジョブに適用されるメモリ制約になります（つまり、Slurmのselectプラグインはメモリ割り当てを管理するように構成されていません）。
The PERCENT may be an arbitrary floating point number.
PERCENTは、任意の浮動小数点数にすることができます。
The default value is 100.
デフォルト値は100です。
MaxSwapPercent=PERCENT: Set an upper bound (in percent of total RAM) on the amount of RAM+Swap that may be used for a job.
ジョブに使用できるRAM +スワップの量の上限（合計RAMのパーセント）を設定します。
This will be the swap limit applied to jobs on systems where memory is not being explicitly allocated to job.
これは、メモリがジョブに明示的に割り当てられていないシステム上のジョブに適用されるスワップ制限になります。
The PERCENT may be an arbitrary floating point number between 0 and 100.
PERCENTは、0〜100の任意の浮動小数点数です。
The default value is 100.
デフォルト値は100です。
MaxKmemPercent=PERCENT: Set an upper bound in percent of total Kmem for a job.
ジョブの合計Kmemのパーセントで上限を設定します。
The PERCENT may be an arbitrary floating point number.
PERCENTは、任意の浮動小数点数にすることができます。
The default value is 100.
デフォルト値は100です。
MemorySwappiness=<number>: Configure the kernel's priority for swapping out anonymous pages (such as program data) verses file cache pages for the job cgroup.
ジョブcgroupの匿名ページ（プログラムデータなど）とファイルキャッシュページを交換するためのカーネルの優先度を構成します。
Valid values are between 0 and 100, inclusive.
有効な値は0〜100です。
A value of 0 prevents the kernel from swapping out program data.
値0は、カーネルがプログラムデータをスワップアウトするのを防ぎます。
A value of 100 gives equal priorioty to swapping out file cache or anonymous pages.
値100は、ファイルキャッシュまたは匿名ページのスワップアウトに同等の優先順位を与えます。
If not set, then the kernel's default swappiness value will be used.
設定されていない場合、カーネルのデフォルトのswappiness値が使用されます。
Either ConstrainRAMSpace or ConstrainSwapSpace must be set to yes in order for this parameter to be applied.
このパラメーターを適用するには、ConstrainRAMSpaceまたはConstrainSwapSpaceのいずれかをyesに設定する必要があります。
MinKmemSpace=<number>: Set a lower bound (in MB) on the memory limits defined by AllowedKmemSpace.
AllowedKmemSpaceで定義されたメモリ制限に下限（MB単位）を設定します。
The default limit is 30M.
デフォルトの制限は30Mです。
MinRAMSpace=<number>: Set a lower bound (in MB) on the memory limits defined by AllowedRAMSpace and AllowedSwapSpace.
AllowedRAMSpaceおよびAllowedSwapSpaceで定義されたメモリ制限に下限（MB単位）を設定します。
This prevents accidentally creating a memory cgroup with such a low limit that slurmstepd is immediately killed due to lack of RAM.
これにより、RAMが不足しているためにslurmstepdがすぐに強制終了されるような下限のメモリcgroupが誤って作成されるのを防ぎます。
The default limit is 30M.
デフォルトの制限は30Mです。
TaskAffinity=<yes|no>: If configured to "yes" then set a default task affinity to bind each step task to a subset of the allocated cores using sched_setaffinity.
「yes」に構成されている場合は、デフォルトのタスクアフィニティを設定して、sched_setaffinityを使用して各ステップタスクを割り当てられたコアのサブセットにバインドします。
The default value is "no".
デフォルト値は「no」です。
Note: This feature requires the Portable Hardware Locality (hwloc) library to be installed.
注：この機能を使用するには、Portable Hardware Locality（hwloc）ライブラリーをインストールする必要があります。

DISTRIBUTION-SPECIFIC NOTES

Debian and derivatives (e.g. Ubuntu) usually exclude the memory and memsw (swap) cgroups by default.
Debianとその派生物（Ubuntuなど）は通常、デフォルトでメモリとmemsw（スワップ）cgroupを除外します。
To include them, add the following parameters to the kernel command line: cgroup_enable=memory swapaccount=1
それらを含めるには、カーネルコマンドラインに次のパラメータを追加します。cgroup_enable= memory swapaccount = 1

This can usually be placed in /etc/default/grub inside the GRUB_CMDLINE_LINUX variable.
これは通常、GRUB_CMDLINE_LINUX変数内の/ etc / default / grubに配置できます。
A command such as update-grub must be run after updating the file.
ファイルを更新した後、update-grubなどのコマンドを実行する必要があります。

EXAMPLE

###
# Slurm cgroup support configuration file
###
CgroupAutomount=yes
ConstrainCores=yes
#

COPYING

This file is part of Slurm, a resource management program. For details, see <https://slurm.schedmd.com/>.

Slurm is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

Slurm is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

This document was created by man2html using the manual pages.
Time: 22:00:05 GMT, April 09, 2020