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 序列化：

compact: 尽可能紧凑地输出 JSON。

pretty: 以美观的格式输出 JSON，以提高可读性。

SLURM_YAML

控制 YAML 序列化：

compact 尽可能紧凑地输出 YAML。

pretty 以美观的格式输出 YAML，以提高可读性。

示例

显示特定账户中用户的信息：

$ sshare -A <账户>

以可解析格式显示特定用户的信息：

$ sshare --parsable --users=<用户>

版权

此文件是 Slurm 的一部分，一个资源管理程序。有关详细信息，请参见 <https://slurm.schedmd.com/>。

Slurm 是自由软件；您可以根据自由软件基金会发布的 GNU 通用公共许可证的条款重新分发和/或修改它；无论是许可证的第 2 版，还是（根据您的选择）任何更高版本。

Slurm 的发布是希望它能有用，但不提供任何担保；甚至没有对适销性或特定用途的适用性的默示担保。有关更多详细信息，请参见 GNU 通用公共许可证。

另见

slurm.conf(5), slurmdbd(8)

本文档由 man2html 使用手册页创建。
时间：2025年7月2日 13:21:55 GMT