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.
sshareは、Slurm共有情報を表示するために使用されます。
This command is only viable when running with the priority/multifactor plugin.
このコマンドは、priority / multifactorプラグインで実行している場合にのみ実行可能です。
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情報は、slurmctldから読み込まれ、特定のアソシエーションで使用可能な共有を処理するために使用されるslurmdbd(Slurm Databaseデーモン)によって提供されるインターフェースを持つデータベースから取得されます。
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は、アカウント、ユーザー、未加工の共有、正規化された共有、未加工の使用、正規化された使用、有効な使用、フェアシェア係数、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.
アカウントまたはユーザーに請求されたすべてのジョブのtres-seconds(TRESBillingWeightsが定義されていない場合はcpu-seconds)の数。
This number will decay over time when PriorityDecayHalfLife is defined.
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の減衰が発生します。

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.
アカウントに設定されたTRES-分制限。
The total number of cpu minutes that can possibly be used by past, present and future jobs running from this account and its children.
このアカウントとその子から実行されている過去、現在、および将来のジョブで使用できる可能性のある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.
アカウントに対して現在実行中のジョブによって割り当てられたTRES分数。
Used to limit the combined total number of TRES minutes used by all jobs running with this account and its children.
このアカウントとその子で実行されているすべてのジョブが使用するTRES分の合計数を制限するために使用されます。
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.
これは、実行中のジョブの時間制限を考慮してそれを消費します。制限に達した場合、他のジョブが終了して時間を解放するまで、新しいジョブは開始されません。

 

FAIR_TREE MODIFICATIONS

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

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.
これは、兄弟と比較した協会のフェアシェア値であり、Norm Shares / EffectvUsageとして計算されます。
If an association is over-served, the value is between 0 and 1.
アソシエーションが過剰に提供されている場合、値は0から1の間です。
If an association is under-served, the value is greater than 1.
アソシエーションが十分に提供されていない場合、値は1より大きくなります。
Associations with no usage receive the highest possible value, infinity.
使用されていない関連付けは、可能な限り高い値である無限大を受け取ります。

More information about Fair Tree can be found in doc/html/fair_tree.html or
at https://slurm.schedmd.com/fair_tree.html
Fair Treeの詳細については、doc / html /fair_tree.htmlまたはhttps://slurm.schedmd.com/fair_tree.htmlを参照してください。

 

PERFORMANCE

Executing sshare sends a remote procedure call to slurmctld.
sshareを実行すると、リモートプロシージャコールが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.
リモートプロシージャコールをslurmctldデーモンに送信するsshareまたは他の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.
シェルスクリプトまたは他のプログラムのループからslurmctldにリモートプロシージャコールを送信するsshareまたは他のSlurmクライアントコマンドを実行しないでください。
Ensure that programs limit calls to sshare to the minimum necessary for the information you are trying to gather.
プログラムがsshareへの呼び出しを、収集しようとしている情報に必要な最小限に制限していることを確認してください。

 

ENVIRONMENT VARIABLES

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

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

 

EXAMPLES


> sshare -A <Account>

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

 

COPYING

Copyright (C) 2008 Lawrence Livermore National Security. Produced at Lawrence Livermore National Laboratory (cf, DISCLAIMER).
Copyright (C) 2010-2013 SchedMD LLC.

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.

 

SEE ALSO

slurm.conf(5), slurmdbd(8)


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
SSHARE OUTPUT FIELDS
FAIR_TREE MODIFICATIONS
PERFORMANCE
ENVIRONMENT VARIABLES
EXAMPLES
COPYING
SEE ALSO

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