この文書ではPBS ProfessionalのスケジューリングツールであるStrict OrderingとBackfillingの設定・動作の確認方法を説明します。
----------------------------------------------------
当文書では以下の3台で環境を構成している例を使用します。
pbs-head: pbs_server,pbs_sched,pbs_commの各デーモンが稼働。当例ではjobのsubmitもこのサーバで実施。
node01: pbs_momデーモンが稼働する計算ノード
node02: pbs_momデーモンが稼働する計算ノード
----------------------------------------------------
ジョブの優先度に従って並び替えられたルールに従い追い越しを許可しない設定です。
前提としてPBS Professionalによるジョブの並び替えは以下の順に実施されます。
Queue order (by_queue: True の場合に適用されます。インストールデフォルトはTrueです。）
job_sort_formula (job_sort_formulaが設定されている場合に適用されます。インストールデフォルトでjob_sort_formulaは設定されていません。）
fairshare (fair_share: true の場合に適用されます。インストールデフォルトはfairshareは設定されていません。）
job sort key (job_sort_key: "cput LOW" などソートが設定されている場合に適用されます。インストールデフォルトでコメントアウトされ無効です。）
job submission time（qsubを実行した順番です）
つまり、インストールデフォルトのスケジューリング設定では、
複数のキューが設定され、それにpriorityが設定され明示的な優先度がある環境を前提とした場合、以下の順でソートされます。
高Priorityのキューのジョブ
低Priorityのキューのジョブ
各キュー内のジョブの並び替えはjob submission time
Strict Orderingを設定すると上記の例外を無くしjob submission timeでジョブをソートし実行します。
上記を前提に実際の確認をしてみます。
[root@pbs-head ~]# qmgr -c "delete queue workq"
[root@pbs-head ~]# qmgr -c "create queue high_q queue_type=e,enabled=t,started=t,priority=100"
[root@pbs-head ~]# qmgr -c "create queue low_q queue_type=e,enabled=t,started=t,priority=50"
・sched_configファイルの設定
* インストールデフォルトなので以下となっています。
by_queue: True <= 有効
fair_share: false <= 無効
job_sort_key <= コメントアウトなので以下には表示されない（未設定）
[root@pbs-head ~]# . /etc/pbs.conf
[root@pbs-head ~]# cat $PBS_HOME/sched_priv/sched_config | grep -v -e '^$' -e '^#'
round_robin: False all
by_queue: True prime
by_queue: True non_prime
strict_ordering: false ALL
backfill_prime: false ALL
prime_exempt_anytime_queues: false
primetime_prefix: p_
nonprimetime_prefix: np_
node_sort_key: "sort_priority HIGH" ALL
provision_policy: "aggressive_provision"
resources: "ncpus, mem, arch, host, vnode, aoe, eoe"
smp_cluster_dist: pack
fair_share: false ALL
fairshare_usage_res: cput
fairshare_entity: euser
fairshare_decay_time: 24:00:00
fairshare_decay_factor: 0.5
preemptive_sched: true ALL
dedicated_prefix: ded
・serverに設定されているattributeの確認
* インストールデフォルトなので以下となっています。
job_sort_formula <= 設定されていないので表示されない
[root@pbs-head ~]# qmgr -c 'l s' | grep job_sort_formula
[root@pbs-head ~]
・設定したqueueが作成されているかを確認
[root@pbs-head ~]# qstat -Qf
Queue: high_q
queue_type = Execution
Priority = 100
total_jobs = 0
state_count = Transit:0 Queued:0 Held:0 Waiting:0 Running:0 Exiting:0 Begun
:0
enabled = True
started = True
Queue: low_q
queue_type = Execution
Priority = 50
total_jobs = 1
state_count = Transit:0 Queued:0 Held:1 Waiting:0 Running:0 Exiting:0 Begun
:0
enabled = True
started = True
・nodeのリソースを確認（node01,node02それぞれncpus 8のリソースが確認できる）
[root@pbs-head ~]# pbsnodes -aS
vnode state OS hardware host queue mem ncpus nmics ngpus comment
--------------- --------------- -------- -------- --------------- ---------- -------- ------- ------- ------- ---------
node01 free -- -- node01 -- 794mb 8 0 0 --
node02 free -- -- node02 -- 794mb 8 0 0 --
[root@pbs-head ~]#
・事後、Jobの詳細情報を確認するためjob_history_enableを有効にします。
[root@pbs-head user01]# qmgr -c 's s job_history_enable = true'
[root@pbs-head user01]#
・テスト対象ジョブを一つのscheduling cycle(ジョブ並び替えの単位）に含めて実行させたいため一旦schedulingを停止します。
[root@pbs-head ~]# qmgr -c 's s scheduling = false'
[root@pbs-head ~]#
・ジョブをsubmit(一般ユーザuser01で実行)
[user01@pbs-head ~]$ qstat -s
[user01@pbs-head ~]$ echo 'sleep 30' | qsub -q low_q -lncpus=6
57.pbs-head
[user01@pbs-head ~]$ echo 'sleep 30' | qsub -q high_q -lncpus=6
58.pbs-head
[user01@pbs-head ~]$ echo 'sleep 30' | qsub -q low_q -lncpus=4
59.pbs-head
[user01@pbs-head ~]$ echo 'sleep 30' | qsub -q high_q -lncpus=4
60.pbs-head
[user01@pbs-head ~]$ echo 'sleep 30' | qsub -q low_q -lncpus=2
61.pbs-head
[user01@pbs-head ~]$ echo 'sleep 30' | qsub -q high_q -lncpus=2
62.pbs-head
[user01@pbs-head ~]$
･rootに戻ってschedulingを再開し、ジョブを実行する
[root@pbs-head CS0484021]# qmgr -c 's s scheduling = true'
* s s scheduling = true によって意図したタイミングでのschduling cycleの実行が可能です。
[root@pbs-head CS0484021]# qstat -s
pbs-head:
Req'd Req'd Elap
Job ID Username Queue Jobname SessID NDS TSK Memory Time S Time
--------------- -------- -------- ---------- ------ --- --- ------ ----- - -----
57.pbs-head user01 low_q STDIN -- 1 6 -- -- Q --
Not Running: Not enough free nodes available
58.pbs-head user01 high_q STDIN 4064 1 6 -- -- R 00:00
Job run at Tue Jul 11 at 11:25 on (node01:ncpus=6)
59.pbs-head user01 low_q STDIN 3607 1 4 -- -- R 00:00
Job run at Tue Jul 11 at 11:25 on (node02:ncpus=4)
60.pbs-head user01 high_q STDIN 3606 1 4 -- -- R 00:00
Job run at Tue Jul 11 at 11:25 on (node02:ncpus=4)
61.pbs-head user01 low_q STDIN -- 1 2 -- -- Q --
Not Running: Not enough free nodes available
62.pbs-head user01 high_q STDIN 4065 1 2 -- -- R 00:00
Job run at Tue Jul 11 at 11:25 on (node01:ncpus=2)
[root@pbs-head CS0484021]#
・schedulerログで優先度による並び替えを確認
/var/spool/pbs/sched_logs/<ジョブ実行日付> ファイルで's s scheduling = true'を実行したタイミングの
scheduling cycleを確認
（scheduling cycleは、Starting Scheduling Cycleと;Leaving Scheduling Cycleが一つの単位です）
* by_queueがtrueなのでpriorityが高いhigh_qで実行されたjobid 58,60,62がそれ以外より優先されています。
* リソースが足りずに実行できない57を追い抜いて59が先に実行されています。
...
...
07/11/2023 11:25:24;0080;pbs_sched;Req;;Starting Scheduling Cycle
07/11/2023 11:25:24;0080;pbs_sched;Job;58.pbs-head;Considering job to run
07/11/2023 11:25:24;0040;pbs_sched;Job;58.pbs-head;Job run
07/11/2023 11:25:24;0080;pbs_sched;Job;60.pbs-head;Considering job to run
07/11/2023 11:25:24;0040;pbs_sched;Job;60.pbs-head;Job run
07/11/2023 11:25:24;0080;pbs_sched;Job;62.pbs-head;Considering job to run
07/11/2023 11:25:24;0040;pbs_sched;Job;62.pbs-head;Job run
07/11/2023 11:25:24;0080;pbs_sched;Job;57.pbs-head;Considering job to run
07/11/2023 11:25:24;0040;pbs_sched;Job;57.pbs-head;Insufficient amount of resource: ncpus (R: 6 A: 4 T: 16)
07/11/2023 11:25:24;0080;pbs_sched;Job;59.pbs-head;Considering job to run
07/11/2023 11:25:24;0040;pbs_sched;Job;59.pbs-head;Job run
07/11/2023 11:25:24;0080;pbs_sched;Job;61.pbs-head;Considering job to run
07/11/2023 11:25:24;0040;pbs_sched;Job;61.pbs-head;Not enough free nodes available
07/11/2023 11:25:24;0080;pbs_sched;Req;;Leaving Scheduling Cycle
...
...
* 設定のポイント
strict_ordering: True
round_robin: False
job_sort_key: コメントアウト
fair_share: false
backfill_depth: 0
job_sort_formula: 未設定
* strict_orderingの詳細に関しては以下マニュアルを参照お願いします。
* 章番号はversionにより異なる場合がございます。
PBS Professional <version> Administrator’s Guide
4.9.48.1 Configuring Strict Ordering
・エディタでsched_configファイルの編集
●部分を変更しました。round_robin、fair_shareはすでにfalseのなのでそのままとします。
・変更箇所の確認
[root@pbs-head ~]# . /etc/pbs.conf
[root@pbs-head ~]# cat $PBS_HOME/sched_priv/sched_config | grep -v -e '^$' -e '^#'
round_robin: False all
by_queue: True prime
by_queue: True non_prime
strict_ordering: true ALL ●
backfill_prime: false ALL
prime_exempt_anytime_queues: false
primetime_prefix: p_
nonprimetime_prefix: np_
node_sort_key: "sort_priority HIGH" ALL
provision_policy: "aggressive_provision"
resources: "ncpus, mem, arch, host, vnode, aoe, eoe"
smp_cluster_dist: pack
fair_share: false ALL
fairshare_usage_res: cput
fairshare_entity: euser
fairshare_decay_time: 24:00:00
fairshare_decay_factor: 0.5
preemptive_sched: true ALL
dedicated_prefix: ded
[root@pbs-head ~]#
・pbs_schedのPIDを確認
[root@pbs-head ~]# ps -ef | grep [p]bs_sched
root 1635 1 0 10:04 ? 00:00:00 /opt/pbs/sbin/pbs_sched
・kill -HUP <pbs_schedのpid>
[root@pbs-head ~]# kill -HUP 1635
・"Scheduler is reconfiguring"メッセージを確認
[root@pbs-head ~]# cat $PBS_HOME/sched_logs/20230711 | grep reconf
07/11/2023 14:22:35;0040;pbs_sched;Sched;reconfigure;Scheduler is reconfiguring
・backfill_depthを無効にするため各queueおよびserverにbackfill_depth = 0を設定
[root@pbs-head ~]# qmgr -c 's s backfill_depth = 0'
[root@pbs-head ~]# qmgr -c 's q low_q backfill_depth = 0'
[root@pbs-head ~]# qmgr -c 's q high_q backfill_depth = 0'
・job_sort_formulaが未設定であることを確認
[root@pbs-head ~]# qmgr -c 'l s' | grep job_sort_formula
[root@pbs-head ~]
・テスト対象ジョブを一つのscheduling cycle(ジョブ並び替えの単位）に含めて実行させたいため一旦schedulingを停止します。
[root@pbs-head ~]# qmgr -c 's s scheduling = false'
[root@pbs-head ~]#
・ジョブをsubmit(一般ユーザuser01で実行)
[user01@pbs-head ~]$ echo 'sleep 30' | qsub -q low_q -lncpus=6
63.pbs-head
[user01@pbs-head ~]$ echo 'sleep 30' | qsub -q high_q -lncpus=6
64.pbs-head
[user01@pbs-head ~]$ echo 'sleep 30' | qsub -q low_q -lncpus=4
65.pbs-head
[user01@pbs-head ~]$ echo 'sleep 30' | qsub -q high_q -lncpus=4
66.pbs-head
[user01@pbs-head ~]$ echo 'sleep 30' | qsub -q low_q -lncpus=2
67.pbs-head
[user01@pbs-head ~]$ echo 'sleep 30' | qsub -q high_q -lncpus=2
68.pbs-head
･rootに戻ってschedulingを再開し、ジョブを実行する
[root@pbs-head CS0484021]# qmgr -c 's s scheduling = true'
[root@pbs-head ~]# qstat -s
pbs-head:
Req'd Req'd Elap
Job ID Username Queue Jobname SessID NDS TSK Memory Time S Time
--------------- -------- -------- ---------- ------ --- --- ------ ----- - -----
63.pbs-head user01 low_q STDIN -- 1 6 -- -- Q --
Not Running: Insufficient amount of resource: ncpus (R: 6 A: 4 T: 16)
64.pbs-head user01 high_q STDIN 6465 1 6 -- -- R 00:00
Job run at Tue Jul 11 at 14:34 on (node01:ncpus=6)
65.pbs-head user01 low_q STDIN -- 1 4 -- -- Q --
Not Running: Job would break strict sorted order
66.pbs-head user01 high_q STDIN 6060 1 4 -- -- R 00:00
Job run at Tue Jul 11 at 14:34 on (node02:ncpus=4)
67.pbs-head user01 low_q STDIN -- 1 2 -- -- Q --
Not Running: Job would break strict sorted order
68.pbs-head user01 high_q STDIN 6466 1 2 -- -- R 00:00
Job run at Tue Jul 11 at 14:34 on (node01:ncpus=2)
[root@pbs-head ~]#
・schedulerログで優先度による並び替えを確認
* by_queueがtrueなのでpriorityが高いhigh_qで実行されたjobid 64,66,68がそれ以外より優先されています。
* リソースが足りずに実行できない64を追い抜かずsubmission timeが遅い、65,67は64の実行を待っています。
（このタイミングいでは、ncpus (R: 6 A: 4 T: 16) なので空きが4ありますが、submission timeを厳守
するstrict orderが有効なためJobid 65,67は空きリソースがあっても待ちになります。）
...
...
07/11/2023 14:34:40;0080;pbs_sched;Req;;Starting Scheduling Cycle
07/11/2023 14:34:40;0080;pbs_sched;Job;64.pbs-head;Considering job to run
07/11/2023 14:34:40;0040;pbs_sched;Job;64.pbs-head;Job run
07/11/2023 14:34:40;0080;pbs_sched;Job;66.pbs-head;Considering job to run
07/11/2023 14:34:40;0040;pbs_sched;Job;66.pbs-head;Job run
07/11/2023 14:34:40;0080;pbs_sched;Job;68.pbs-head;Considering job to run
07/11/2023 14:34:40;0040;pbs_sched;Job;68.pbs-head;Job run
07/11/2023 14:34:40;0080;pbs_sched;Job;63.pbs-head;Considering job to run
07/11/2023 14:34:40;0040;pbs_sched;Job;63.pbs-head;Insufficient amount of resource: ncpus (R: 6 A: 4 T: 16)
07/11/2023 14:34:40;0040;pbs_sched;Job;65.pbs-head;Job would break strict sorted order
07/11/2023 14:34:40;0040;pbs_sched;Job;67.pbs-head;Job would break strict sorted order
07/11/2023 14:34:40;0080;pbs_sched;Req;;Leaving Scheduling Cycle
...
...
strict_ordering設定やFairshare設定などで優先度がついたジョブの実行順に一定の例外を設定します。
例えば、上記のjobid 65,67はジョブが実行可能なリソースが存在するにも関わらず待ちになりましたが、このようなジョブに対して
一定の条件を満たした場合にジョブの実行(追い越し）を可能にします。
* 設定のポイント
server, queueのいずれか、もしくは両方にbackfill_depth attributeを設定
* strict_orderingの詳細に関しては以下マニュアルを参照お願いします。
PBS Professional <version> Administrator’s Guide
4.9.3.6 Configuring Backfilling
* 本例ではqueue attributeとしてlow_qキューにbackfill_depthを設定します。
queueとserverの両方にbackfill_depthが設定されている場合、キューの設定が優先されます。
明示的にbackfill_depth=0をしない限り、デフォルトの1が設定されています。
（つまりインストール後のデフォルト状態ではBackfillingが有効になっている点に注意が必要です。）
* backfill_depth=nのnはtopジョブの数を制御します。
例えば、nが2の場合は一つのscheduling cycleで２つのtopジョブが存在できます。
topジョブとは高優先だがリソース不足のため実行できないジョブにtopジョブフラグがついたものです。
[root@pbs-head user01]# qmgr -c 's q low_q backfill_depth=1'
[root@pbs-head user01]#
・テスト対象ジョブを一つのscheduling cycle(ジョブ並び替えの単位）に含めて実行させたいため一旦schedulingを停止します。
[root@pbs-head ~]# qmgr -c 's s scheduling = false'
[root@pbs-head ~]#
・ジョブをsubmit(一般ユーザuser01で実行)
* Backfillingは適切なwalltimeで指定した時間を前提に動作する設定なので、原則として全てのジョブにwalltimeを設定します。
[user01@pbs-head ~]$ qstat -s
[user01@pbs-head ~]$ echo 'sleep 600' | qsub -q low_q -lncpus=6 -lwalltime=0:10:00
92.pbs-head
[user01@pbs-head ~]$ echo 'sleep 600' | qsub -q high_q -lncpus=6 -lwalltime=0:10:00
93.pbs-head
[user01@pbs-head ~]$ echo 'sleep 300' | qsub -q low_q -lncpus=4 -lwalltime=0:05:00
94.pbs-head
[user01@pbs-head ~]$ echo 'sleep 300' | qsub -q high_q -lncpus=4 -lwalltime=0:05:00
95.pbs-head
[user01@pbs-head ~]$ echo 'sleep 300' | qsub -q low_q -lncpus=2 -lwalltime=0:05:00
96.pbs-head
[user01@pbs-head ~]$ echo 'sleep 300' | qsub -q high_q -lncpus=2 -lwalltime=0:05:00
97.pbs-head
[user01@pbs-head ~]$
･rootに戻ってschedulingを再開し、ジョブを実行する
[root@pbs-head user01]# qmgr -c 's s scheduling = true'
[root@pbs-head user01]# qstat -s
pbs-head:
Req'd Req'd Elap
Job ID Username Queue Jobname SessID NDS TSK Memory Time S Time
--------------- -------- -------- ---------- ------ --- --- ------ ----- - -----
92.pbs-head user01 low_q STDIN -- 1 6 -- 00:10 Q --
Not Running: Insufficient amount of resource: ncpus (R: 6 A: 4 T: 16)
93.pbs-head user01 high_q STDIN 8597 1 6 -- 00:10 R 00:00
Job run at Tue Jul 11 at 16:56 on (node01:ncpus=6)
94.pbs-head user01 low_q STDIN 7991 1 4 -- 00:05 R 00:00
Job run at Tue Jul 11 at 16:56 on (node02:ncpus=4)
95.pbs-head user01 high_q STDIN 7990 1 4 -- 00:05 R 00:00
Job run at Tue Jul 11 at 16:56 on (node02:ncpus=4)
96.pbs-head user01 low_q STDIN -- 1 2 -- 00:05 Q --
Not Running: Not enough free nodes available
97.pbs-head user01 high_q STDIN 8598 1 2 -- 00:05 R 00:00
Job run at Tue Jul 11 at 16:56 on (node01:ncpus=2)
[root@pbs-head user01]#
* by_queueがtrueなのでpriorityが高いhigh_qで実行されたjobid 93,95,97がそれ以外より優先されています。
* リソースが足りずに実行できないjobid 92にtop job フラグが設定され実行開始予定時間が算出されています。
* top jobであるjobid 92の実行開始予定時間（at Tue Jul 11 17:01:26 2023）に
影響を及ぼさず実行可能なjobid 94がjobid 92を追い越して実行開始しています。
(jobid 94はwalltime=0:05:00を指定して実行しているので、 17:01:26 2023 までに実行終了すると見なされる。）
07/11/2023 16:56:26;0080;pbs_sched;Req;;Starting Scheduling Cycle
07/11/2023 16:56:26;0080;pbs_sched;Job;93.pbs-head;Considering job to run
07/11/2023 16:56:26;0040;pbs_sched;Job;93.pbs-head;Job run
07/11/2023 16:56:26;0080;pbs_sched;Job;95.pbs-head;Considering job to run
07/11/2023 16:56:26;0040;pbs_sched;Job;95.pbs-head;Job run
07/11/2023 16:56:26;0080;pbs_sched;Job;97.pbs-head;Considering job to run
07/11/2023 16:56:26;0040;pbs_sched;Job;97.pbs-head;Job run
07/11/2023 16:56:26;0080;pbs_sched;Job;92.pbs-head;Considering job to run
07/11/2023 16:56:26;0080;pbs_sched;Job;92.pbs-head;Job is a top job and will run at Tue Jul 11 17:01:26 2023
07/11/2023 16:56:26;0040;pbs_sched;Job;92.pbs-head;Insufficient amount of resource: ncpus (R: 6 A: 4 T: 16)
07/11/2023 16:56:26;0080;pbs_sched;Job;94.pbs-head;Considering job to run
07/11/2023 16:56:26;0040;pbs_sched;Job;94.pbs-head;Job run
07/11/2023 16:56:26;0080;pbs_sched;Job;96.pbs-head;Considering job to run
07/11/2023 16:56:26;0040;pbs_sched;Job;96.pbs-head;Not enough free nodes available
07/11/2023 16:56:26;0080;pbs_sched;Req;;Leaving Scheduling Cycle
* Queuing中、もしくは、Rnning中のジョブは
qstat -f <jobid>
すでに終了しているジョブの情報は
qstat -fx <jobid>
で確認します。
* qstat -fxは、事前に、job_history_enable が有効になっている場合に確認可能です。
[root@pbs-head user01]# qstat -fx 92 | grep estimated
estimated.exec_vnode = (node02:ncpus=6)
estimated.start_time = Tue Jul 11 17:01:27 2023
[root@pbs-head user01]#