sshare
部分:Slurm 命令 (1)更新:Slurm 命令
索引
名称
sshare - 列出与集群关联的共享工具。概要
sshare [选项...]描述
sshare 用于查看 Slurm 共享信息。此命令仅在使用优先级/多因素插件时有效。 sshare 信息来自一个数据库,接口由 slurmdbd(Slurm 数据库守护进程)提供,该信息从 slurmctld 读取,并用于处理给定关联可用的共享。sshare 提供的 Slurm 共享信息包括账户、用户、原始共享、标准化共享、原始使用、标准化使用、有效使用、公平共享因子、GrpTRESMins 限制、分区以及每个关联的当前运行 TRES-分钟的累积。
选项
- -A, --accounts=<账户>
- 显示特定账户的信息(以逗号分隔的列表)。
-
- -a, --all
- 显示所有用户的信息。
-
- -M, --clusters=<字符串>
- 要发出命令的集群。 注意,slurmdbd 必须处于运行状态,以使此选项正常工作,除非在配置了 FederationParameters=fed_display 的联邦中运行。
-
- -o, --format=<输出格式>
- 以逗号分隔的字段列表(使用 "--helpformat" 获取可用字段的列表)。
-
- --help
- 显示 sshare 选项和命令的描述。
-
- -l, --long
- 长列表 - 包括标准化使用信息。
-
- --json, --json=列表, --json=<数据解析器>
- 使用默认数据解析器插件或显式数据解析器及其参数以 JSON 格式转储信息。排序和格式化参数将被忽略。
-
- -n, --noheader
- 输出的开头将不添加标题。
-
- -p, --parsable
- 输出将以 '|' 分隔,并在末尾有一个 '|'。
-
- -P, --parsable2
- 输出将以 '|' 分隔,但末尾没有 '|'。
-
- -m, --partition
- 如果系统中存在基于关联的分区,则打印其名称。
-
- --usage
- 显示 sshare 选项和命令的描述。
-
- -u, --users=<用户列表>
- 显示特定用户的信息(以逗号分隔的列表)。
-
- -U, --Users
- 如果指定,仅打印用户信息,父级和祖先不显示。
-
- -v, --verbose
- 显示有关指定选项的更多信息。
-
- -V, --version
- 显示 sshare 的版本号。
-
- --yaml, --yaml=列表, --yaml=<数据解析器>
- 使用默认数据解析器插件或显式数据解析器及其参数以 YAML 格式转储信息。排序和格式化参数将被忽略。
-
SSHARE 输出字段
- 账户
- 账户信息。
-
- 用户
- 用户信息。
-
- 原始共享
- 分配给用户或账户的原始共享。
-
- 标准化共享
- 分配给用户或账户的共享,标准化为总分配共享的数量。
-
- 原始使用
- 所有作业计入账户或用户的 tres-秒数(如果未定义 TRESBillingWeights,则为 cpu-秒数)。当定义 PriorityDecayHalfLife 时,此数字会随时间衰减。
-
- 标准化使用(仅在 sshare -l 选项下出现)
- 原始使用标准化为在集群上运行的所有作业的总 tres-秒数,受定义的 PriorityDecayHalfLife 衰减影响。
-
- 有效使用
- 有效使用增加了标准化使用,以考虑来自兄弟账户的使用。
-
- 公平共享
- 公平共享因子,基于用户或账户的分配共享和计入他们或他们账户的有效使用。
-
- GrpTRESMins
- 设置在账户上的 TRES-分钟限制。过去、现在和未来从该账户及其子账户运行的作业可以使用的总 cpu 分钟数。
-
- GrpTRESRaw
- 由从该账户及其子账户运行的作业使用的原始 TRES 使用量。
-
- TRESRunMins
- 当前针对该账户运行的作业分配的 TRES-分钟数。用于限制所有与该账户及其子账户一起运行的作业使用的 TRES 分钟的总和。这考虑到正在运行的作业的时间限制并消耗它,如果达到限制,则在其他作业完成之前不启动新作业,以释放时间。
-
公平树修改
当 PriorityFlags=FAIR_TREE 被设置(默认值,除非设置 NO_FAIR_TREE),计算方式会有所不同。 因此,以下字段被添加或修改:
- 标准化共享
- 分配给用户或账户的共享,标准化为该级别内的总分配共享数量。
-
- 有效使用
- 有效使用是与其父级标准化的关联使用。
-
- 级别 FS(仅在 sshare -l 选项下出现)
- 这是与其兄弟相比的关联公平共享值,计算为标准化共享 / 有效使用。如果一个关联被过度服务,则值在 0 和 1 之间。如果一个关联被服务不足,则值大于 1。没有使用的关联获得最高可能值,无限大。
-
有关公平树的更多信息,请参见 doc/html/fair_tree.html 或 在 https://slurm.schedmd.com/fair_tree.html
性能
执行 sshare 会向 slurmctld 发送远程过程调用。如果来自 sshare 或其他向 slurmctld 守护进程发送远程过程调用的 Slurm 客户端命令的调用过于频繁,可能会导致 slurmctld 守护进程的性能下降,甚至可能导致服务拒绝。
请勿在 shell 脚本或其他程序的循环中运行 sshare 或其他向 slurmctld 发送远程过程调用的 Slurm 客户端命令。确保程序将对 sshare 的调用限制在收集所需信息的最低限度。
环境变量
某些 sshare 选项可以通过环境变量设置。这些环境变量及其对应的选项如下所示。 (注意:命令行选项将始终覆盖这些设置。)
- SLURM_CONF
- Slurm 配置文件的位置。
-
- SLURM_DEBUG_FLAGS
- 指定 sshare 使用的调试标志。有关完整的标志列表,请参见 slurm.conf(5) 手册页。环境变量优先于 slurm.conf 中的设置。
-
- SLURM_JSON
- 控制 JSON 序列化:
示例
- 显示特定账户中用户的信息:
-
$ sshare -A <账户>
- 以可解析格式显示特定用户的信息:
-
$ sshare --parsable --users=<用户>
版权
版权所有 (C) 2008 劳伦斯利弗莫尔国家实验室。 在劳伦斯利弗莫尔国家实验室制作(参见免责声明)。版权所有 (C) 2010-2022 SchedMD LLC。
此文件是 Slurm 的一部分,一个资源管理程序。 有关详细信息,请参见 <https://slurm.schedmd.com/>。
Slurm 是自由软件;您可以根据自由软件基金会发布的 GNU 通用公共许可证的条款重新分发和/或修改它;无论是许可证的第 2 版,还是(根据您的选择)任何更高版本。
Slurm 的发布是希望它能有用,但不提供任何担保;甚至没有对适销性或特定用途的适用性的默示担保。有关更多详细信息,请参见 GNU 通用公共许可证。
另见
slurm.conf(5), slurmdbd(8)
索引
本文档由 man2html 使用手册页创建。
时间:2025年7月2日 13:21:55 GMT