sshare

Section: Slurm Commands (1)
Updated: Slurm Commands
Index

NAME

sshare - Tool for listing the shares of associations to a cluster.
sshare-クラスターへの関連付けのシェアをリストするためのツール。

SYNOPSIS

sshare [OPTIONS...]

DESCRIPTION

sshare is used to view Slurm share information. This command is only viable when running with the priority/multifactor plugin. The sshare information is derived from a database with the interface being provided by slurmdbd (Slurm Database daemon) which is read in from the slurmctld and used to process the shares available to a given association. sshare provides Slurm share information of Account, User, Raw Shares, Normalized Shares, Raw Usage, Normalized Usage, Effective Usage, the Fair-share factor, the GrpTRESMins limit, Partitions and accumulated currently running TRES-minutes for each association.
sshareはSlurm共有情報を表示するために使用されます。このコマンドは、priority / multifactorプラグインで実行している場合にのみ有効です。sshare情報は、slurmctldから読み込まれ、特定の関連付けで使用可能な共有を処理するために使用されるslurmdbd（Slurmデータベースデーモン）によって提供されるインターフェイスを持つデータベースから取得されます。sshareは、アカウント、ユーザー、未加工の共有、正規化された共有、未加工の使用法、正規化された使用法、効果的な使用法、フェアシェア係数、GrpTRESMins制限、パーティション、および各関連付けの現在実行中の累積TRES分のSlurm共有情報を提供します。

OPTIONS

-A, --accounts=: Display information for specific accounts (comma separated list).
特定のアカウントの情報を表示します（カンマ区切りリスト）。
-a, --all: Display information for all users.
すべてのユーザーの情報を表示します。
-l, --long: Long listing - includes the normalized usage information.
長いリスト-正規化された使用法の情報が含まれます。
-M, --clusters=<string>: Clusters to issue commands to. Note that the SlurmDBD must be up for this option to work properly.
コマンドを発行するクラスター。このオプションが正しく機能するには、SlurmDBDが稼働している必要があります。
-m, --partition: If there are association based partitions in the system print their names.
システムに関連付けベースのパーティションがある場合は、それらの名前を出力します。
-n, --noheader: No header will be added to the beginning of the output.
ヘッダーは出力の最初に追加されません。
-o, --format=: Comma separated list of fields (use "--helpformat" for a list of available fields).
フィールドのカンマ区切りリスト（使用可能なフィールドのリストについては、「-helpformat」を使用してください）。
-p, --parsable: Output will be '|' delimited with a '|' at the end.
出力は '|'になります '|'で区切られた最後に。
-P, --parsable2: Output will be '|' delimited without a '|' at the end.
出力は '|'になります '|'なしで区切られます最後に。
-u, --users=: Display information for specific users (comma separated list).
特定のユーザーの情報を表示します（カンマ区切りリスト）。
-U, --Users: If specified only the users information are printed, the parent and ancestors are not displayed.
指定した場合、ユーザー情報のみが印刷され、親と祖先は表示されません。
-v, --verbose: Display more information about the specified options.
指定したオプションに関する詳細情報を表示します。
-V, --version: Display the version number of sshare.
sshareのバージョン番号を表示します。
--help: --usage Display a description of sshare options and commands.
sshareオプションとコマンドの説明を表示します。

SSHARE OUTPUT FIELDS

Account: The Account.
アカウント。
User: The User.
ユーザー。
Raw Shares: The raw shares assigned to the user or account.
ユーザーまたはアカウントに割り当てられた未加工の共有。
Norm Shares: The shares assigned to the user or account normalized to the total number of assigned shares.
ユーザーまたはアカウントに割り当てられたシェアは、割り当てられたシェアの総数に正規化されます。
Raw Usage: The number of tres-seconds (cpu-seconds if TRESBillingWeights is not defined) of all the jobs charged to the account or user. This number will decay over time when PriorityDecayHalfLife is defined.
アカウントまたはユーザーに請求されたすべてのジョブのtres-seconds（TRESBillingWeightsが定義されていない場合はcpu-seconds）の数。PriorityDecayHalfLifeが定義されると、この数は時間とともに減衰します。
Norm Usage (only appears with sshare -l option): The Raw Usage normalized to the total number of tres-seconds of all jobs run on the cluster, subject to the PriorityDecayHalfLife decay when defined.
定義された場合のPriorityDecayHalfLifeの減衰に従って、クラスターで実行されるすべてのジョブの合計トレズ秒に正規化されたRaw使用量。
Effectv Usage: The Effective Usage augments the normalized usage to account for usage from sibling accounts.
有効使用量は、正規化された使用量を増やして、兄弟アカウントの使用量を考慮します。
FairShare: The Fair-Share factor, based on a user or account's assigned shares and the effective usage charged to them or their accounts.
ユーザーまたはアカウントに割り当てられたシェアと、ユーザーまたはアカウントに請求された有効使用量に基づく、フェアシェア係数。
GrpTRESMins: The TRES-minutes limit set on the account. The total number of cpu minutes that can possibly be used by past, present and future jobs running from this account and its children.
アカウントに設定されたTRES分制限。このアカウントとその子から実行されている過去、現在、未来のジョブで使用できる可能性のあるCPU分数の合計。
GrpTRESRaw: The raw TRES usage that has been used by jobs running from this account and its children.
このアカウントとその子から実行されているジョブによって使用された未加工のTRES使用量。
TRESRunMins: The number of TRES-minutes allocated by jobs currently running against the account. Used to limit the combined total number of TRES minutes used by all jobs running with this account and its children. This takes into consideration time limit of running jobs and consumes it, if the limit is reached no new jobs are started until other jobs finish to allow time to free up.
現在アカウントに対して実行されているジョブによって割り当てられたTRES分数。このアカウントとその子で実行されているすべてのジョブによって使用されるTRES分を組み合わせた合計数を制限するために使用されます。これは、実行中のジョブの時間制限を考慮してそれを消費します。制限に達した場合、他のジョブが終了して時間を解放するまで、新しいジョブは開始されません。

FAIR_TREE MODIFICATIONS

When PriorityFlags=FAIR_TREE is set (the default, unless NO_FAIR_TREE is set), calculations are done differently. As a result, the following fields are added or modified:
PriorityFlags = FAIR_TREEが設定されている場合（NO_FAIR_TREEが設定されていない場合のデフォルト）、計算方法は異なります。その結果、次のフィールドが追加または変更されます。

Norm Shares: The shares assigned to the user or account normalized to the total number of assigned shares within the level.
ユーザーまたはアカウントに割り当てられたシェアは、レベル内で割り当てられたシェアの総数に正規化されます。
Effectv Usage: Effectv Usage is the association's usage normalized with its parent.
Effectv Usageは、その親で正規化された関連付けの使用法です。
Level FS (only appears with sshare -l option): This is the association's fairshare value compared to its siblings, calculated as Norm Shares / Effectv Usage. If an association is over-served, the value is between 0 and 1. If an association is under-served, the value is greater than 1. Associations with no usage receive the highest possible value, infinity.
これは、兄弟と比較した協会のフェアシェア値であり、Norm Shares / Effectv Usageとして計算されます。アソシエーションが過剰に提供されている場合、値は0から1の間です。アソシエーションが過小に提供されている場合、値は1より大きいです。使用されていないアソシエーションは、可能な最大値である無限大を受け取ります。
More information about Fair Tree can be found in doc/html/fair_tree.html or: at https://slurm.schedmd.com/fair_tree.html
フェアツリーの詳細については、doc / html / fair_tree.htmlまたはhttps://slurm.schedmd.com/fair_tree.htmlを参照してください。

PERFORMANCE

Executing sshare sends a remote procedure call to slurmctld. If enough calls from sshare or other Slurm client commands that send remote procedure calls to the slurmctld daemon come in at once, it can result in a degradation of performance of the slurmctld daemon, possibly resulting in a denial of service.
sshareを実行すると、slurmctldにリモートプロシージャコールが送信されます。sshareまたはslurmctldデーモンにリモートプロシージャコールを送信する他のSlurmクライアントコマンドからの十分な呼び出しが一度に着信すると、slurmctldデーモンのパフォーマンスが低下し、サービス拒否が発生する可能性があります。

Do not run sshare or other Slurm client commands that send remote procedure calls to slurmctld from loops in shell scripts or other programs. Ensure that programs limit calls to sshare to the minimum necessary for the information you are trying to gather.
シェルスクリプトまたは他のプログラムのループからslurmctldにリモートプロシージャコールを送信するsshareまたは他のSlurmクライアントコマンドを実行しないでください。プログラムが、sshareの呼び出しを、収集しようとしている情報に必要な最小限に制限していることを確認してください。

ENVIRONMENT VARIABLES

Some sshare options may be set via environment variables. These environment variables, along with their corresponding options, are listed below. (Note: commandline options will always override these settings)
一部のsshareオプションは、環境変数を介して設定できます。これらの環境変数と対応するオプションを以下に示します。（注：コマンドラインオプションは常にこれらの設定を上書きします）

SLURM_CONF: The location of the Slurm configuration file.
Slurm構成ファイルの場所。

EXAMPLES

> sshare -A <Account>

> sshare --parsable --users=<User>

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