JH Unischeduler
關于
概述
景行資源管理與調度軟件（JH Unischeduler）作為一款支持多種類型的應用軟件的通用中間件集成應用，其作用范圍涵蓋機械行業設計軟件、制造業CAD/CAE設計軟件、石油勘探分析軟件、模擬仿真軟件、科學計算軟件和大數據分析軟件等。這些不同類型的應用軟件可以同時被集成到由景行資源管理與調度軟件管理的計算集群中，從而實現了多領域、多學科和多類型應用資源的充分共享。
為了使有限的資源得到高效和充分的利用，景行資源管理與調度軟件內置了多種高效的調度管理策略，包括先來先服務、用戶/用戶組資源配額管理、基于隊列的優先級設置、資源公平共享調度、獨占式作業調度、搶占式作業調度等。
景行資源管理與調度軟件基于以上調度策略，會將各類應用軟件的每次執行實例作為一個作業來進行調度和管理，并為管理員和用戶提供更為方便的作業狀態監控和友好的使用界面。
體系架構
景行資源管理與調度軟件作為云計算基礎架構產品的支柱，與以此為基石的景行應用門戶軟件、景行安全控制軟件等，均是以安全可靠，體驗至上為原則服務用戶，通過與景行資源分析軟件的集成，可以為用戶呈現詳細的資源使用情況、靈活的作業調度和統計分析報表功能。
技術架構
景行資源管理與調度軟件是一款完全自主研發的云計算資源管理調度程序。它使用jhds模塊收集系統和作業進程的資源使用信息，并使用jobagent、jobexecutor和scheduler模塊實際控制和執行作業。
在此基礎上，景行資源管理與調度軟件擴展了資源管理模塊，并創建了多個云計算資源的負載探測器來檢測節點資源負載情況，景行資源管理與調度軟件擁有統一的調度模塊以實現先進的作業管理調度策略，如公平共享調度策略、搶占式作業調度策略和獨占式作業調度策略等，同時還提供了資源和許可證的管理與調度。這些模塊是完全獨立運行的系統進程。
功能簡介
云計算資源管理： 景行資源管理與調度軟件能夠將網絡上多臺異構類型的計算機資源整合為一個集群應用服務平臺。應用程序資源的調用不再只局限于個人工作站，也不需要為了滿足個性化的資源需求而手動修改應用程序，只需要編輯一些簡單的應用腳本和命令就能夠使用平臺上的計算資源。景行資源管理與調度軟件還可以根據節點的負載條件和應用程序的資源需求，從整個集群應用服務平臺中選擇最合適的計算節點。
執行作業： 對于景行資源管理與調度軟件管理的應用服務系統而言，遠程和本機執行作業的行為是一致的，即使是最復雜的終端交互控制作業，也如同是在本機執行。當作業獲得所需要的軟硬件資源，或當應用服務平臺的系統負載較輕時，景行資源管理與調度軟件會根據預定的策略自動執行作業，并可以根據資源負載情況，完全控制作業。如：掛起作業和恢復作業運行。景行資源管理與調度軟件能夠以交互式作業或批處理作業的形式執行串行或并行的應用程序。當作業在一組資源負載較輕或空閑的資源節點上執行時，執行效率會大幅提高。
管理應用： 對于由景行資源管理與調度軟件管理的應用服務系統，用戶可以遠程運行本地工作站上沒有的，甚至因為本地工作站配置低而無法完成安裝或運行的大型應用軟件，例如：CAD、CAE和CFD等大型應用軟件。用戶的作業實際是運行在集群后臺的高端服務器上，其執行過程和結果完全透明地展現在用戶的桌面機上。
控制系統資源的訪問： 系統管理員可以輕松地控制應用服務系統中資源的使用，例如：
- 對用戶提交作業的權限控制以及作業提交后的執行節點控制。
- 用戶或用戶組可同時執行作業的數量限制，以及可使用資源的種類限制。
- 提交到指定隊列的作業的資源限制。
- 每個計算單元可執行作業的時間窗口。
- 在某種負載條件下指定的計算節點可以接收或掛起某些低優先級的作業。
- 可對用戶提交的作業進行內存的限制等。
資源和作業記賬： 景行資源管理與調度軟件提供了資源和作業記賬的機制。這些信息可以幫助管理員分析資源的使用情況和作業的執行情況，以及系統在一天或者一周內的負載情況，同時幫助管理員確定是否有資源過載情況發生，為合理化系統配置或擴展和升級系統提供詳盡的數據支持。
作業記賬： 記錄了作業運行的大量信息，所有這些數據都被存儲在一個作業記賬文件中。如：
- 提交節點和執行節點。
- 提交、派發、執行作業和作業的結束時間。
- 作業執行時占用資源的消耗。
- CPU時間、作業排隊時間和運行時間等。
應用： 絕大多數的應用都可以通過景行資源管理與調度軟件的接口被啟用，不需要直接與之發生交互，也不需要為了使用景行資源管理與調度軟件而刻意的修改程序。目前，景行資源管理與調度軟件可支持大多數的Linux、CentOS或者Windows的命令和第三方應用程序。
容錯： 一旦有計算資源請求，景行資源管理與調度軟件會通過內置高效的調度策略尋找可用的計算資源，并保證計算資源的請求被及時的派發執行。在應用服務系統中，只要還有一臺服務器在運行，景行資源管理與調度軟件就能夠繼續接收計算資源請求。如果計算資源請求失敗，則會主動把該請求重新派發到另一臺可滿足資源需求的服務器上執行。景行資源管理與調度軟件將整個應用服務系統的狀態保存在文件數據庫中，只要該事務日志文件可訪問，景行資源管理與調度軟件就能保證執行所有的計算資源請求，并可為該事務日志文件設置鏡像備份，以保證主文件服務器停止工作時，可根據鏡像的事務日志文件繼續執行作業的操作，為整個集群應用服務系統提供執行作業的容錯能力。
異構系統的支持： 景行資源管理與調度軟件是連接不同操作系統的中心樞紐，通用的架構使其能夠支持多種類型的操作系統（如：Linux、CentOS和Windows），還可支持這幾種操作系統之間的相互操作。
并行處理： 景行資源管理與調度軟件支持MPI（Message Passing Interface）。它既是集群資源的分配者也是管理者，并可為每個并行作業尋找最佳的節點。
調度策略： 景行資源管理與調度軟件提供了快速高效的調度策略，保證了受其管理的應用服務系統正常運行。用戶可以根據不同的需求使用不同的策略，例如，用戶可以設置隊列級的公平共享調度策略，控制和管理應用資源的需求沖突。景行資源管理與調度軟件還內置了許多其他隊列級的調度策略，如最基本的先來先服務、搶占式和獨占式策略。
功率限制調度： 支持為集群設置功率封頂上限，結合高峰、平時、低谷等不同時段設置不同的功率封頂調度策略；支持全局節點統一功率封頂、功率負載自動分配，支持各節點單獨設置功率封頂等調度策略。
資源預留： 是指對某個作業或隊列強制預留資源。資源預留保證了正在運行的作業有足夠的資源（通過對資源提前占位，可以很好的解決作業運行過程中因請求資源的動態變化而不夠的問題）。
作業數組： 作業數組延伸了作業的概念，作業從單個輸入文件、單例執行的應用程序延伸為多個并行文件、多例執行的應用程序。使用景行資源管理與調度軟件的作業數組功能，可以允許用戶提交單個數組作業，而該數組作業可以使用不同的數據參數來多次執行同一應用程序。
共享資源： 共享資源是指由景行資源管理與調度軟件管理的集群中所有節點上的可用資源，這些資源可以在節點組之間共享。如應用軟件的浮動許可證就是一個典型的可共享資源，集群中的所有節點都可以通過自動獲取到的浮動許可證來執行該軟件。景行資源管理與調度軟件保證了在作業派發到各執行節點前獲得有效的許可證后執行作業，從而使得該浮動許可證資源在各執行節點間得到合理化的應用。
并行作業的處理器預留： 在同一個景行資源管理與調度軟件管理的集群中執行并行和普通應用程序時，因為普通作業只需要一個CPU而并行作業需要等待多個空閑的CPU，所以并行作業所需要的CPU會被普通作業先占用。并行作業處理器的預留功能，允許并行作業在排隊期間將所需的空閑處理器（作業槽slots）預留一段時間而不被其他的普通作業使用。
Job Starter： 每一個景行資源管理與調度軟件隊列都可以配置一個Job Starter。Job Starter是一個可執行腳本或者是可執行程序，主要用來創建作業執行的環境。通過JobStarter，景行資源管理與調度軟件管理員可以自定義作業執行的環境。例如：
- 配置作業的輸入/輸出緩存和重定向。
- 配置執行如fluent和cfx仿真類作業的運行環境。
可配置作業控制的方式： 可通過景行資源管理與調度軟件的作業控制功能，修改作業在集群系統中的運行狀態。通常情況下，作業先是進入PEND狀態，然后進入RUN狀態，作業執行完成后顯示為DONE狀態。有時會在作業的生命周期內，被系統掛起進入SSUSP狀態，或者是被用戶掛起而進入USUSP狀態。景行資源管理與調度軟件給管理員提供了配置控制作業時所觸發的一系列動作，當作業狀態改變時，這些自定義的觸發動作將會被執行。
AI模型測試： 支持多種主流基準測試，包括MMLU、ARC、DROP、GPQA、HumanEval、GSM-8K、MATH、AGIEval、BIG-Bench Hard 等。
容器支持： 支持由 Docker 或 Singularity 容器封裝的應用啟動和資源調度，內置容器集成腳本，用戶可通過配置修改腳本達到集成使用。
命令行接口： 提供豐富的資源查詢、集群管理和作業提交、管理的命令行接口。
概要
jsub [-h] [-V] [-x] [-H] [-I] [-IX] [-Is] [-djm]
[-L login_shell]
[-P project_name] [-R res_req] [-q queue_name]
[-app application_name]
[-m “host_name[+[pref_level]] | host_group[+[pref_level]]…”]
[-n min_processors[,max_processors]] [-J job_name] [-Jd job_desc]
[-i in_file] [-o out_file] [-e err_file]
[-E pre_exec_command[argument…]]
[-Ep post_exec_command[argument…]]
[-cwd current_working_directory]
[-gpgpu “num [type=type1,type2…] [gmem=gmemsize] [mig=gsize]”]
[-r | rn] [-M mem_limit] [-W run_limit] [-We limit]
[-hosts “num [hselect=hselect_string]”] [-port num] [-mf file]
[-aps priority] [-f [host:]local_file operator [remote_file]]
[-command command [command …]] [-command command [command…]]
選項
- -h：顯示此幫助信息。
- -V：打印景行資源管理與調度軟件發行版本信息。
- -x：指定節點以獨占模式運行作業。
- -H：提交一個暫時不執行的作業。
- -I：提交一個交互式作業。
- -IX：提交一個帶X11轉發功能的交互式作業。
- -Is：提交一個服務模式的交互式作業。
- -djm：提交一個分布式作業。
- -L login_shell：指定shell登錄并執行作業，支持的shells有：sh、bash、csh和tcsh。
- -P project name：指定提交作業的項目名稱。
- -R res_req：指定提交作業特定的資源需求信息。
- -q queue_name：指定提交作業的隊列。
- -app application_name：提交作業到指定的應用程序。
- -m “host_name[+[pref_level]] | host_group[+[pref_level]]…”：指定作業可選擇的執行節點或者節點組。
- -n min_processors[,max_processors]：指定處理器的最小和最大數量。
- -J job_name：指定提交的作業名稱。
- -Jd job_desc：指定作業的描述信息或指定作業數組。
- -i in_file：從指定文件獲取作業的標準輸入，可指定環境變量。
- -o out_file：從指定文件獲取作業的標準輸出，可指定環境變量。
- -e err_file：從指定的作業獲取標準錯誤輸出，可指定環境變量。
- -E pre_exec_command[argument…]：作業執行前需要運行pre-exec。
- -Ep post_exec_command[argument…]：作業執行結束后需要運行post-exec。
- -cwd current_working_directory：指定作業的工作目錄，可指定環境變量。
- -gpgpu：為作業指定GPU卡或MIG的類型和數量以及需要預留的GPU顯存。
- -r：指定作業可以重新運行。
- -rn：指定作業忽略重新運行隊列上的配置。
- -M mem_limit：指定內存限制，以MB為單位。
- -W run_limit：指定作業的運行時間限制，以分鐘為單位。
- -We limit：指定作業的預估運行時間，以分鐘為單位。
- -hosts “num [hselect=hselect_string]”：指定hosts number和hselect_string，用于host分配資源hselect_string由num@hostgroup或host組成，用逗號隔開。
- -port num：指定作業的端口號。
- -mf file：為作業指定使用機器配置文件。
- -aps priority：指定作業優先級。
- -f [host:]local_file operator[remote_file]：將本地文件或目錄從I/O節點傳輸到作業執行節點的緩存目錄。支持的操作符有：> < < > > <
- -command command：指定作業命令行參數或腳本。
命令示例
- 示例1
提交一個作業到指定節點host1，并指定作業運行隊列為short。
$ jsub -m host1 -q short my_job- 示例2
提交一個作業并指定運行節點，其中 host1 是最適合運行作業的節點，其次是host2，最后是 host3，"+"增加的數值越高，其節點的優先級就越高。
$ jsub -m "host1+2 host2+1 host3" my_job- 示例3
提交一個作業并指定特定的資源需求，如果 type==NTX64 節點內存大于50MB，作業將派發到 type==NTX64，如果 type==LINUX64 節點內存大于 100MB，作業將派發到type==LINUX64，若這兩個條件都不滿足，作業將不被派發。
$ jsub -R "select[((type==NTX64 && mem > 50)||(type==LINUX64&& mem> 100))]" my_job- 示例4
提交一個作業并指定資源預留數量mem為50MB，swap為100MB。
$ jsub -R "rusage[mem=50&swap=100]" my_job- 示例5
提交一個作業并指定運行作業最少需要 4 個 CPU 數，并且只能在一個節點上運行該作業。
$ jsub -n 4 -R "span[hosts=1]" my_job- 示例6
提交一個作業并指定運行作業最少需要 4 個 CPU 數，并且每個節點只能為該作業提供 2 個 CPU。
$ jsub -n 4 -R "span[ptile=2]" my_job- 示例7
提交一個作業并指定運行作業需要的 CPU 最大數和最小數。
$ jsub -n 2,4 my_job- 示例8
提交一個禁止調度到 host1 上運行的作業。
$ jsub -m ~host1 my_job- 示例9
提交一個作業，并指定將該作業的運行信息輸出保存為文件output.sh，保存路徑為該作業提交用戶的家目錄。
$ jsub -o ~/output.sh my_job- 示例10
在作業提交參數"-i/-o/-e/-cwd"中可指定路徑環境變量，設置環境變量in=/apps/dir_input和out=/apps/dir_output（路徑可自定義），提交含有指定路徑變量的作業，在作業的詳細信息中可以看到路徑環境變量已經生效。
$ jsub -i /apps/dir_input/input.sh -o /apps/dir_output/output.log -e
/apps/dir_output/error.log -cwd /apps/dir_output "hhh;sleep 10;hostname"
$ jjobs -l 59
Job <59>, Job Name <hhh;sleep 10;hostname>, User <user1>, Project
<default>, Status <PSUSP>, Queue <normal>, Application
<default>, APS Priority <5000>, Command <hhh;sleep 10;hostname>
Thu Mar 31 17:22:43: Submitted from host <host1>, CWD
</apps/dir_output>, Input File <dir_input/input.sh>, Output File
<dir_output/output.log>, Error File <dir_output/error.log>,
Specified Hosts <host1>;- 示例11
將提交節點的/files/abc.conf文件傳輸至執行節點的$JH_STAGE_DIR/目錄下，再將abc.conf文件名修改為test.conf，再傳回至提交節點的/tmp目錄下。
$ jsub -f '/files/abc.conf > abc.conf' -f ' /tmp/ < test.conf' 'mv
$JH_STAGE_DIR/abc.conf $JH_STAGE_DIR/test.conf'注：$JH_STAGE_DIR 對應的值為管理門戶->調度管理->高級配置功能頁面表單中對應的配置項"Linux節點數據緩存目錄(STAGE_TOP_DIR_LINUX)"的值（此處以/tmp/stagein為例）。
在此作業的執行節點文件系統下會按照以下規則產生作業文件臨時目錄：
/tmp/stagein/.${JOB_ID}.${JOB_INDEX}.stage例如：
/tmp/stagein/.54.0.stage/xxx概要
jjobs [-h] [-V] [-w | -l] [-a] [-d] [-p] [-s]
[-r][-A] [-m host_name]
[-q queue_name] [-app application_name] [-u user_name | -u all]
[-P project_name] [-o “field_name[:[-][output_width]] …
[delimiter=‘character’]”] [-J name_spec] [-Jd desc_spec][-env]
[-t] [-regexp] [jobId [jobId …]]
選項
- -h：顯示此幫助信息。
- -V：打印景行資源管理與調度軟件發行版本信息。
- -w：以寬格式顯示作業的詳細信息。
- -l：以長格式顯示作業的詳細信息。
- -a：顯示一定時間范圍內所有狀態的作業信息。
- -d：顯示一定時間范圍內已經結束的作業信息。
- -p：顯示作業狀態為pend的作業信息，并顯示pend的原因。
- -s：顯示作業狀態為suspend的作業信息，并顯示suspend的原因。
- -r：顯示作業狀態為run的作業信息。
- -A：顯示作業數組信息。
- -m host_name：顯示已經派發到指定節點上的作業信息。
- -q queue_name：顯示指定隊列上運行作業信息。
- -app application_name：只顯示指定應用程序中的作業。
- -u user_name | -u all：只顯示指定用戶/用戶組提交的作業，關鍵字’all’指定所有用戶。
- -P project_name：顯示指定項目的作業信息。
- -o：顯示自定義輸出格式的作業信息。
- -J name_spec：顯示指定作業名稱的作業或者作業數組的信息。
- -Jd desc_spec：指定作業的描述信息。
- -env：顯示指定作業提交環境中的環境變量。
- -t：顯示指定DJM作業的任務信息。
- -regexp：在篩選條件中使用正則表達式。
命令示例
- 示例1
顯示用戶user1的等待作業信息和作業的PENDING REASONS。
$ jjobs -p -u user1- 示例2
顯示節點host1上所有正在運行的作業信息。
$ jjobs -r -m host1- 示例3
顯示在隊列short上且項目名稱為my_project的所有用戶的作業信息。
$ jjobs -q short -P my_project -u all- 示例4
顯示指定的作業詳細信息。
$ jjobs -l job_id- 示例5
按照指定格式輸出作業信息（jobid寬度為4，stat寬度為10，并右對齊，分隔符為分號）。
$ jjobs -o "jobid:4 stat:-10 from_host delimiter=';'"選項
- -h：打印命令使用方法。
- -V：打印景行資源管理與調度軟件發行版本信息。
- init：初始化集群master節點。
- join：初始化非master集群并加入集群。
- clean：清除已初始化的集群節點。
概要
jhosts [-h] [-V] [-w | -l] [-R res_req] [-s
[res_name [res_name …]]]
[host_name [host_name …]] {stat,attrib,remove} …
選項
- -h：打印命令使用方法。
- -V：打印景行資源管理與調度軟件發行版本信息。
- -w：以寬格式形式顯示詳細信息。
- -l：以長格式形式顯示詳細信息。
- -R res_req：顯示滿足特定資源需求的節點信息。
- -s [res_name [res_name…]]：查詢節點上的共享資源信息，不能與其他參數一起使用。
命令示例
- 示例1
顯示節點host1的狀態和作業資源信息。
$jhosts -l host1- 示例2
顯示集群中內存大于600MB的節點信息。
$jhosts -R "select[mem>600]"選項
- -h：打印命令使用方法。
- -V：打印景行資源管理與調度軟件發行版本信息。
- -w：以寬格式形式顯示隊列信息。
- -l：以長格式形式顯示隊列的詳細信息。
- -m host_name：顯示指定節點或節點組上能夠運行作業的隊列信息。
- -u user_name：顯示指定用戶或用戶組所屬的隊列信息。
- queue_name：顯示指定隊列信息。
概要
jmod [-h] [-V] [-L login_shell | -Ln] [-R res_req
| -Rn]
[-q queue_name | -qn] [-m “host_name[+[pref_level]] | host_group[+[pref_level]]…” | -mn]
[-n min_processors[,max_processors] | -nn] [-J job_name]
[-Jd job_desc | -Jdn] [-gpgpu “num [type=type1,type2…]
[gmem=gmemsize] [mig=gsize]” | -gpgpun]
[-app application_name | -appn]
[-hosts “num [hselect=hselect_string]” | -hostsn]
[-port num | -portn] [-mf file | -mfn] [-aps priority | -apsn]
[-M mem_limit | -Mn] [-W run_limit | -Wn] [-P project_name]
[jobId | jobId[index_list]] [[jobId | jobId[index_list]]…]
選項
詳細信息見 jsub 命令，注意：不能修改已經派發成功的作業的-o、-e選項的值。如果在選項后面跟一個’n’，表示重置相應的作業選項信息。
- -h：打印命令使用方法。
- -V：打印景行資源管理與調度軟件發行版本信息。
- -L login_shell：使用指定的登錄shell修改執行環境。
- -Ln：取消作業級登錄shell命令的設置。
- -R res_req：修改作業指定的資源要求。
- -Rn：取消作業級資源需求命令的設置。
- -q queue_name：修改作業指定的執行隊列。
- -qn：取消作業指定的執行隊列。
- -m “host_name[+[pref_level]] |
host_group[+[pref_level]]…”：修改作業指定的執行主機。 - -mn：取消作業指定的執行主機。
- -n
min_processors[,max_processors]：修改作業指定的最小和最大處理器數。 - -nn：取消作業指定的最小和最大處理器數。
- -J job_name：修改作業名稱或修改作業數組。
- -Jd job_desc：修改作業描述信息。
- -Jdn：刪除作業描述信息。
- -gpgpu "num [type=type1,type2]
[gmem=gmemsize] [mig=gsize]
"：修改 GPU 請求。 - -gpgpun：取消GPU請求。
- -app application_name：修改作業指定的執行應用程序。
- -appn：取消工作指定的執行申請。
- -hosts “num [hselect=hselect_string]”：修改host num請求。
- -hostsn：取消作業指定的host num請求。
- -port num：修改端口請求。
- -portn：取消端口請求。
- -mf file：修改作業指定的機器文件。
- -mfn：取消作業指定的機器文件。
- -aps priority：修改作業aps優先級。
- -apsn：取消作業指定的優先級。
- -M mem_limit：修改內存限制，單位為MB。
- -Mn：取消作業的內存限制。
- -W run_limit：修改作業的運行時間限制，單位為分鐘。runtime的格式是hours:minutes，-hours:minutes或者+hours:minutes。
- -Wn：取消作業指定的運行時間限制。
- -P project_name：修改作業的項目名稱。
命令示例
- 示例1
修改指定作業的提交隊列 test1。
$jmod -q test1 jobID- 示例2
取消指定作業的提交隊列。
$jmod -qn jobID- 示例3
給指定作業的運行時間限制，增加50分鐘的運行時間。
$jmod -W +50 jobID $jmod -W +00:50 jobID- 示例4
給指定作業的運行時間限制，減少2小時的運行時間。
$jmod -W -120 jobID$jmod -W -02:00 jobID其他選項示例可以參考jsub進行使用。
概要
jctrl stop [-h] [-m host_name] [-q queue_name]
[-u user_name | -u all]
[-J job_name] [-app application_name]
jobId | jobId[index_list] | 0 [jobId | jobId[index_list] | 0 …]
選項
- -h：打印命令使用方法。
- -m host_name：僅掛起分派到指定主機或主機組的作業。
- -q queue_name：僅掛起指定隊列中的作業。
- -u user_name | -u all：僅暫停指定用戶或用戶組擁有的作業，如果指定了關鍵字 all，表示暫停所有用戶的作業。
- -J job_name：僅掛起具有指定作業名稱的作業。
- -app application_name：僅暫停指定應用程序中的作業。
概要
jctrl resume [-h] [-m host_name] [-q
queue_name]
[-u user_name | -u all] [-J job_name]
[-app application_name]
jobId | jobId[index_list] | 0 [jobId | jobId[index_list] | 0 …]
選項
- -h：打印命令使用方法。
- -m host_name：恢復指定節點或者節點組上已被掛起的作業。
- -q queue_name：恢復指定隊列中已被掛起的作業。
- -u user_name | -u all：恢復指定用戶或者所有用戶已被掛起的作業。
- -J job_name：恢復已被掛起的指定作業名稱的作業。
- -app application_name：只恢復指定應用程序中的作業。
概要
jctrl kill [-h] [-m host_name] [-q queue_name]
[-u user_name | -u all]
[-J job_name] [-f] [-app application_name]
jobId | jobId[index_list] | 0 [jobId | jobId[index_list] | 0 …]
選項
- -h：打印命令使用方法。
- -m host_name：停止指定節點上的作業。
- -q queue_name：停止指定隊列上的作業。
- -u user_name | -u all：停止指定用戶提交的作業，若指定參數為all，表示終止所有用戶未完成的作業。
- -J job_name：停止指定作業名稱的作業。
- -f：強制從非調度程序系統中終止作業，而無需等待作業在操作系統中終止。
- -app application_name：停止指定應用程序中的作業。
選項
- -h：打印命令使用方法。
- -c：可選，指定操作是集群級別。
- -p position：可選，可以指定 position參數以指示將作業放置在用戶或集群中的哪個位置，position是一個正整數，表示作業從用戶或集群的末尾開始的目標位置。
命令示例
- 示例
同時對多個PEND狀態的作業進行置底排序，-p2表示將等待作業置底排序到第2位。
[user1@host1 apps]$ jctrl bot -p 2 241 243 242
Job <241> has been moved to position 2 from bottom
Job <243> has been moved to position 2 from bottom
Job <242> has been moved to position 2 from bottom
[user1@host1 apps]$ jjobs
JOBID USER STAT QUEUE FROM_HOST EXEC_HOST JOB_NAME SUBMIT_TIME ORDER
237 user1 RUN normal host1 host2 sleep 1000 Mar 30 15:40 -
238 user1 RUN normal host1 host2 sleep 1000 Mar 30 15:40 -
239 user1 PEND normal host1 sleep 1000 Mar 30 15:40 1
241 user1 PEND normal host1 sleep 1000 Mar 30 15:40 2
243 user1 PEND normal host1 sleep 1000 Mar 30 15:40 3
242 user1 PEND normal host1 sleep 1000 Mar 30 15:40 4
240 user1 PEND normal host1 sleep 1000 Mar 30 15:40 5選項
- -h：打印命令使用方法。
- -c：可選，指定操作是集群級別。
- -p
position：可選，可以指定位置參數以指示作業將放置在用戶或集群中的哪個位置。
position 是一個正整數，表示作業從用戶或集群開始的目標位置。
命令示例
- 示例
同時對多個PEND狀態的作業進行置頂排序。
[user1@host1 apps]$ jjobs
JOBID USER STAT QUEUE FROM_HOST EXEC_HOST JOB_NAME SUBMIT_TIME ORDER
237 user1 RUN normal host1 host2 sleep 1000 Mar 30 15:40 -
238 user1 RUN normal host1 host2 sleep 1000 Mar 30 15:40 -
239 user1 PEND normal host1 sleep 1000 Mar 30 15:40 1
240 user1 PEND normal host1 sleep 1000 Mar 30 15:40 2
241 user1 PEND normal host1 sleep 1000 Mar 30 15:40 3
242 user1 PEND normal host1 sleep 1000 Mar 30 15:40 4
243 user1 PEND normal host1 sleep 1000 Mar 30 15:40 5
[user1@host1 apps]$ jctrl top -p 1 241 242 243
Job <241> has been moved to position 1 from top
Job <242> has been moved to position 1 from top
Job <243> has been moved to position 1 from top
[user1@host1 apps]$ jjobs
JOBID USER STAT QUEUE FROM_HOST EXEC_HOST JOB_NAME SUBMIT_TIME ORDER
237 user1 RUN normal host1 host2 sleep 1000 Mar 30 15:40 -
238 user1 RUN normal host1 host2 sleep 1000 Mar 30 15:40 -
243 user1 PEND normal host1 sleep 1000 Mar 30 15:40 1
242 user1 PEND normal host1 sleep 1000 Mar 30 15:40 2
241 user1 PEND normal host1 sleep 1000 Mar 30 15:40 3
239 user1 PEND normal host1 sleep 1000 Mar 30 15:40 4
240 user1 PEND normal host1 sleep 1000 Mar 30 15:40 5概要
jctrl requeue [-h] [-u user_name | -u all] [-J
job_name] [-d][-e] [-r] [-a] [-H]
0 | jobId | jobId[index] [0 | jobId | jobId[index] …]
選項
- -h：打印命令使用方法。
- -u user_name | -u all：對指定用戶或組提交的作業進行操作，如果指定關鍵字all，表示對所有用戶的作業進行操作。
- -J job_name：僅對具有指定名稱的作業進行操作。
- -d：將已完成運行且處于 DONE 作業狀態的作業重新排隊。
- -e：將異常終止的作業重新排隊，并顯示 EXIT 作業狀態。
- -r：對正在運行的作業重新排隊。
- -a：對所有作業重新排隊，包括正在運行的作業、暫停作業以及具有 EXIT 或 DONE 狀態的作業。
- -H：將作業重新排隊到 PSUSP 作業狀態。
命令示例
- 示例1：
掛起用戶user1提交到隊列short上的所有狀態作業。
$jctrl stop -q short -u user1 0- 示例2：
恢復用戶user1提交到所有隊列上的未完成的作業。
$jctrl resume -u user1 0- 示例3：
終止所有用戶提交到隊列short上的所有作業。
$jctrl kill -q short -u all 0- 示例4：
重排隊所有用戶的所有作業。
$jctrl requeue -a -u all 0- 示例5：
指定一個運行作業的主機
$jctrl start -m hostname jobID- 示例6：
指定多個運行作業的主機
$jctrl start -m "hostname1 hostname2" jobID概要
jctrl clean [-h] [-u user_name | -u all]
jobId | jobId[index_list] | 0 [jobId | jobId[index_list] | 0…]
命令示例
- 示例：
刪除用戶user1已經完成的jobId為5、6、7的作業，也可以單獨刪除某個已完成的作業。
$jctrl clean -u user1 0
Job <5> is being cleaned
Job <6> is being cleaned
Job <7> is being cleaned選項
- -h：打印命令使用方法。
- -V：打印景行資源管理與調度軟件發行版本信息。
- -r：遞歸展開節點組信息，在展開列表中只顯示節點名，不包含節點子組名稱，且重復的節點名稱只列出一次。
- -w：以寬格式形式顯示節點組信息。
- group_name：顯示指定節點組的信息。
選項
- -h：打印命令使用方法。
- -V：打印景行資源管理與調度軟件發行版本信息。
- -l：以長格式形式顯示用戶組具體信息。若配置了公平共享調度策略，還能顯示每個用戶的分配份額。
- -r：遞歸展開用戶組信息，在展開列表中只顯示用戶名，不包含子組名稱，且重復的用戶名只列出一次。
- -w：以寬格式形式顯示用戶組信息。
- group_name：僅顯示指定用戶組的信息。
概要
jhist [-h] [-V] [-a] [-d] [-e] [-p] [-r] [-s] [-w
| -l]
[-S time0,time1] [-t] [-f logfile_name | -n 0] [-J job_name]
[-Jd job_desc] [-P project_name] [-q queue_name]
[-app application_name] [-u user_name|all]
[jobId | jobId[index_list] [jobId | jobId[index_list] …]]
選項
- -h：打印命令使用方法。
- -V：打印景行資源管理與調度軟件發行版本信息。
- -a：顯示所有未完成和已完成的作業歷史信息。
- -d：僅顯示已完成或退出作業信息。
- -e：僅顯示未正常完成的作業歷史信息。
- -p：僅顯示等待狀態的作業歷史信息。
- -r：僅顯示運行狀態的作業歷史信息。
- -s：僅顯示已被掛起的作業歷史信息。
- -w：以寬格式形式顯示信息。
- -l：以長格式形式顯示更為詳細的信息。
- -S time0,time1：僅顯示有關在指定時間間隔內提交的作業的信息。
- -t：顯示指定的DJM容器作業事件信息。
- -f logfile_name：搜索指定路徑下的日志文件。
- -n 0：搜索所有事件日志。
- -J job_name：僅顯示特定的作業歷史信息。
- -Jd job_desc：僅顯示指定作業描述的作業歷史信息。
- -P project_name：僅顯示指定項目的作業歷史信息。
- -q queue_name：僅顯示指定隊列的作業歷史信息。
- -app application_name：僅顯示有關提交給指定應用程序的作業的信息。
- -u user_name|all：顯示指定用戶提交的作業信息，如果指定關鍵字all，則顯示所有用戶提交的作業信息。
選項
- -h：打印命令使用方法。
- -V：打印景行資源管理與調度軟件發行版本信息。
- -i index：指定需要添加的信息或者文件的索引。
- -d “description”：指定需要添加的描述信息。
- jobId | “jobId[idxList]”：指定特定的作業或者作業數組。
選項
- -t：指定執行結果的超時時間。
- -m：指定執行節點。
- -e：指定節點的篩選條件。
- -a：異步執行命令
- -l：指定 log 級別。
- -h：打印命令使用方法。
- -V：打印景行資源管理與調度軟件發行版本信息。
- args…：傳遞特定命令的參數。
概要
jlimits [-h] [-V] [-s | -c] [-u
user_name|user_group|all]
[-m host_name|host_group|all] [-q queue_name|all]
[-app application_name|all] [-w]
選項
- -h：打印命令使用方法。
- -V：打印景行資源管理與調度軟件發行版本信息。
- -s：顯示沒有指定隊列、應用和節點配置的用戶或用戶組詳細的作業限制信息。
- -c：顯示用戶的作業限制配置信息。
- -u user_name|user_group|all：顯示集群中用戶和用戶組的相關CPU和作業限制信息。
- -m host_name|host_group|all：顯示集群中主機的相關CPU和作業限制信息。
- -q queue_name|all：顯示集群中隊列的相關CPU和作業限制信息。
- -app application_name|all：顯示集群中應用的相關CPU和作業限制信息。
- -w：寬格式顯示CPU和作業限制信息，不截取字段。
命令示例
- 示例1
顯示集群中user1用戶的相關CPU和作業限制信息。
$jlimits -u user1- 示例2：
顯示集群中所有用戶的相關CPU和作業限制信息。
$jlimits -u all- 示例3：
顯示集群中主機名稱是host2相關的CPU和作業限制信息。
$jlimits -m host2- 示例4：
顯示集群中所有主機的相關CPU和作業限制信息 。
$jlimits -m all- 示例5：
顯示集群中隊列名稱是queue1相關的CPU和作業限制信息。
$jlimits -q queue1- 示例6：
顯示集群中所有隊列的相關CPU和作業限制信息。
$jlimits -q all- 示例7：
顯示集群中應用名稱是app1相關的CPU和作業限制信息。
$jlimits -app app1- 示例8：
顯示集群中所有應用的相關CPU和作業限制信息。
$jlimits -app all可用命令
- completion：為指定的shell生成自動完成腳本。
- help：打印命令使用方法。
- list：顯示配置文件中支持修改和更新的配置項。
- set：修改配置項（jconfig set命令只支持修改MASTER_CANDIDATES、REDIS_PORT和PRIVATE_PORT配置）。
- update：更新配置項。
- version：打印景行資源管理與調度軟件發行版本信息。
命令示例
- 示例1
通過jconfig list jhds.conf命令查看配置文件中的可修改或可更新的配置項：
# jconfig list jhds.conf
cluster_domain=
host=host1
port=6322
max_connections=5
max_connections_candidate=30
timeout=5
jhds_http_port=6324
jhds_port=6325- 示例2
將jhds.conf文件中max_connections的值更新為10，為確保配置生效并同步至遠程nacos中，還需根據輸出的信息，依次執行unischeduler stop 和 unischeduler start命令。
# jconfig list jhds.conf
cluster_domain=
host=host1
port=6322
max_connections=5
max_connections_candidate=30
timeout=5
jhds_http_port=6324
jhds_port=6325- 示例3
將host1 host2
host3通過以下命令設置為候選主節點，并根據提示信息執行相關命令使其生效：
# jconfig set MASTER_CANDIDATES='host1 host2 host3'
to make the configuration effective, please run the following:
jadmin schedreconfig
jadmin jhdsreconfig- 示例4
將redis服務端口通過以下命令設置為9322，并根據提示信息執行相關命令使其生效：
# jconfig set REDIS_PORT=9322
unischeduler stop all
unischeduler start- 示例5
將scheduler.conf文件中CLUSTER_NAME的值更新為jhadmin user1（增加管理員user1，jhadmin是主管理員）：
# jconfig update scheduler.conf CLUSTER_NAME='jhadmin user1'
to make the configuration effective, please run the following:
jadmin schedreconfig選項
- -h：打印命令使用方法。
- -V：打印景行資源管理與調度軟件發行版本信息。
- -all：顯示所有錯誤碼和相應的錯誤碼釋義。
- -e code [code …]：顯示作業錯誤碼和相應的錯誤碼釋義。
- -r code [code …]：顯示gui圖形作業錯誤碼和相應的錯誤碼釋義。
- -p code [code …]：顯示作業掛起原因錯誤碼和相應的錯誤碼釋義。
- -zh：顯示掛起原因的中文釋義。
命令示例
- 示例
# export LANG=zh_CN
# jcode -e 10036
10036: 許可證失敗
# jcode -r 2001 2002 2006 2009
2001: Gui作業失敗次數達到上限
2002: Gui作業信息讀取錯誤
2006: Gui 作業因初始化失敗而退出
2009: Gui 作業申請會話失敗命令示例
- 示例
$ jsub -Is bash
Job <13> is submitted to default queue <normal> and default
application <default>
<<Waiting for dispatch ...>>
<<Starting on host1>>
<< To escape to local shell, press 'Ctrl + q'. The job will keep
running at server side. >>
<< output from stdout >>當前端jsub -Is命令終止，后端作業不退出繼續運行，jjobs查詢作業狀態為RUN時，可通過使用命令jattach加作業ID號，attach作業到終端繼續接受交互式操作。
$ jattach 13
Job <13> is running on host1
<<Waiting for attach ...>>
<<Attaching on zrkhost1>>
<< output from stdout >>