Platform LSF Command Reference Chapter 1
Total Page:16
File Type:pdf, Size:1020Kb
Platform LSF Version 9 Release 1.2 Command Reference SC27-5305-02 Platform LSF Version 9 Release 1.2 Command Reference SC27-5305-02 Note Before using this information and the product it supports, read the information in “Notices” on page 459. First edition This edition applies to version 9, release 1 of IBM Platform LSF (product number 5725G82) and to all subsequent releases and modifications until otherwise indicated in new editions. Significant changes or additions to the text and illustrations are indicated by a vertical line (|) to the left of the change. If you find an error in any Platform Computing documentation, or you have a suggestion for improving it, please let us know. Send your suggestions, comments and questions to the following email address: [email protected] Be sure include the publication title and order number, and, if applicable, the specific location of the information about which you have comments (for example, a page number or a browser URL). When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you. © Copyright IBM Corporation 1992, 2013. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Chapter 1. bacct ...........1 Chapter 26. blimits .........153 Chapter 2. badmin ..........15 Chapter 27. blinfo .........157 Chapter 3. bapp ...........31 Chapter 28. blkill ..........163 Chapter 4. bbot ...........37 Chapter 29. blparams ........165 Chapter 5. bchkpnt .........39 Chapter 30. blstat .........167 Chapter 6. bclusters .........41 Chapter 31. bltasks .........177 Chapter 7. bconf ..........45 Chapter 32. blusers .........181 Chapter 8. bdc ...........53 Chapter 33. bmgroup ........185 || Chapter 9. bentags .........61 Chapter 34. bmig ..........187 Chapter 10. bgadd ..........65 Chapter 35. bmod .........189 Chapter 11. bgdel ..........67 Chapter 36. bpost .........201 Chapter 12. bgmod .........69 Chapter 37. bparams ........205 Chapter 13. bgpinfo .........71 Chapter 38. bpeek .........207 Chapter 14. bhist ..........77 Chapter 39. bqueues ........209 Chapter 15. bhosts .........89 Chapter 40. bread .........225 Chapter 16. bhpart .........101 Chapter 41. brequeue ........227 Chapter 17. bjdepinfo ........103 Chapter 42. bresize .........231 Chapter 18. bjgroup ........105 Chapter 43. bresources .......233 Chapter 19. bjobs .........109 Chapter 44. brestart.........237 Chapter 20. bkill ..........135 Chapter 45. bresume ........239 Chapter 21. bladmin ........141 Chapter 46. brlainfo.........241 Chapter 22. blaunch ........145 Chapter 47. brsvadd ........243 Chapter 23. blcollect ........147 Chapter 48. brsvdel .........249 Chapter 24. blcstat .........149 Chapter 49. brsvmod ........251 Chapter 25. blhosts .........151 Chapter 50. brsvs .........257 © Copyright IBM Corp. 1992, 2013 iii Chapter 51. brun ..........259 Chapter 77. lsinfo .........383 Chapter 52. bsla ..........263 Chapter 78. lsload .........385 Chapter 53. bslots .........269 Chapter 79. lsloadadj ........391 Chapter 54. bstatus .........271 Chapter 80. lslogin .........393 Chapter 55. bstop .........273 Chapter 81. lsltasks.........395 Chapter 56. bsub ..........277 Chapter 82. lsmake .........397 Chapter 57. bswitch ........323 Chapter 83. lsmon .........403 Chapter 58. btop ..........327 Chapter 84. lspasswd ........407 Chapter 59. bugroup ........329 Chapter 85. lsplace .........409 Chapter 60. busers .........331 Chapter 86. lsrcp ..........411 Chapter 61. ch ...........333 Chapter 87. lsrtasks ........415 Chapter 62. fmtpasswdfile ......337 Chapter 88. lsrun ..........417 || Chapter 63. gpolicyd ........339 Chapter 89. lstcsh .........421 Chapter 64. lsacct .........341 Chapter 90. pam ..........427 Chapter 65. lsacctmrg........345 Chapter 91. patchinstall .......431 Chapter 66. lsadmin ........347 Chapter 92. pversions (UNIX) ....435 Chapter 67. lsclusters ........355 Chapter 93. pversions (Windows) . 439 Chapter 68. lseligible ........357 Chapter 94. ssacct .........441 Chapter 69. lsfinstall ........359 Chapter 95. ssched .........445 Chapter 70. lsfmon .........363 Chapter 96. taskman ........449 Chapter 71. lsfrestart ........365 Chapter 97. tspeek .........451 Chapter 72. lsfshutdown.......367 Chapter 98. tssub .........453 Chapter 73. lsfstartup ........369 Chapter 99. wgpasswd .......455 Chapter 74. lsgrun .........371 Chapter 100. wguser ........457 Chapter 75. lshosts .........375 Notices ..............459 Trademarks ..............461 Chapter 76. lsid ..........381 Privacy policy considerations ........461 iv Platform LSF Command Reference Chapter 1. bacct Displays accounting statistics about finished jobs. Synopsis bacct [-b | -l[-aff]] [-d][-e][-w][-x][-cname][-app application_profile_name][-C time0,time1][-D time0,time1][-f logfile_name][-Lp ls_project_name ...][-m host_name ...|-M host_list_file][-N host_name | -N host_model | -N cpu_factor][-P project_name ...][-q queue_name ...][-sla service_class_name ...][-S time0,time1][-u user_name ... | -u all][-f logfile_name][job_ID ...][-U resrvation_ID ... | -U all] bacct [-h | -V] Description Displays a summary of accounting statistics for all finished jobs (with a DONE or EXIT status) submitted by the user who invoked the command, on all hosts, projects, and queues in the LSF system. bacct displays statistics for all jobs logged in the current Platform LSF accounting log file: LSB_SHAREDIR/cluster_name/ logdir/lsb.acct. CPU time is not normalized. All times are in seconds. Statistics not reported by bacct but of interest to individual system administrators can be generated by directly using awk or perl to process the lsb.acct file. Throughput calculation The throughput (T) of the LSF system, certain hosts, or certain queues is calculated by the formula: T = N/(ET-BT) where: v N is the total number of jobs for which accounting statistics are reported v BT is the Start time:when the first job was logged v ET is the End time: when the last job was logged You can use the option -C time0,time1 to specify the Start time as time0 and the End time as time1. In this way, you can examine throughput during a specific time period. Jobs involved in the throughput calculation are only those being logged (that is, with a DONE or EXIT status). Jobs that are running, suspended, or that have never been dispatched after submission are not considered, because they are still in the LSF system and not logged in lsb.acct. The total throughput of the LSF system can be calculated by specifying -u all without any of the -m, -q, -S, -D or job_ID options. The throughput of certain hosts © Copyright IBM Corp. 1992, 2013 1 bacct can be calculated by specifying -u all without the -q, -S, -D or job_ID options. The throughput of certain queues can be calculated by specifying -u all without the -m, -S, -D or job_ID options. bacct does not show local pending batch jobs killed using bkill -b. bacct shows MultiCluster jobs and local running jobs even if they are killed using bkill -b. Options -aff Displays information about jobs with CPU and memory affinity resource requirement for each task in the job. A table headed AFFINITY shows detailed memory and CPU binding information for each task in the job, one line for each allocated processor unit. Use only with the -l option. -b Brief format. -d Displays accounting statistics for successfully completed jobs (with a DONE status). -e Displays accounting statistics for exited jobs (with an EXIT status). -l Long format. Displays detailed information for each job in a multiline format. If the job was submitted with bsub -K, the -l option displays Synchronous Execution. -w Wide field format. -x Displays jobs that have triggered a job exception (overrun, underrun, idle, runtime_est_exceeded). Use with the -l option to show the exception status for individual jobs. -cname In LSF Advanced Edition, includes the cluster name for execution cluster hosts and host groups in output. -app application_profile_name Displays accounting information about jobs submitted to the specified application profile. You must specify an existing application profile configured in lsb.applications. -C time0,time1 Displays accounting statistics for jobs that completed or exited during the specified time interval. Reads lsb.acct and all archived log files (lsb.acct.n) unless -f is also used. The time format is the same as in bhist. -D time0,time1 2 Platform LSF Command Reference bacct Displays accounting statistics for jobs dispatched during the specified time interval. Reads lsb.acct and all archived log files (lsb.acct.n) unless -f is also used. The time format is the same as in bhist. -f logfile_name Searches the specified job log file for accounting statistics. Specify either an absolute or relative path. Useful for offline analysis. The specified file path can contain up to 4094 characters for UNIX, or up to 512 characters for Windows. -Lp ls_project_name ... Displays accounting statistics for jobs belonging to the specified License Scheduler projects. If a list of projects is specified, project names must be separated by spaces and enclosed in quotation marks (") or ('). -M host_list_file Displays accounting statistics for jobs dispatched to the hosts listed in a file (host_list_file) containing a list of hosts. The host list file has the following format: v Multiple lines are supported v Each line includes a list of hosts separated by spaces v The length of each line must