Platform LSF Command Reference Chapter 99
Total Page:16
File Type:pdf, Size:1020Kb
Platform LSF Version 9 Release 1.3 Command Reference SC27-5305-03 Platform LSF Version 9 Release 1.3 Command Reference SC27-5305-03 Note Before using this information and the product it supports, read the information in “Notices” on page 521. First edition This edition applies to version 9, release 1 of IBM Platform LSF (product numbers 5725G82 and 5725L25) 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. In the IBM Knowledge Center, add your comments and feedback to any topic. You can also 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, 2014. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Chapter 1. bacct ...........1 Chapter 23. blcollect ........165 Chapter 2. badmin ..........15 Chapter 24. blcstat .........167 Chapter 3. bapp ...........31 Chapter 25. blhosts .........169 Chapter 4. bbot ...........37 Chapter 26. blimits .........171 Chapter 5. bchkpnt .........39 Chapter 27. blinfo .........175 Chapter 6. bclusters .........41 Chapter 28. blkill ..........181 Chapter 7. bconf ..........45 Chapter 29. blparams ........183 || Chapter 8. bdata ..........53 Chapter 30. blstat .........185 || Synopsis ...............53 || Subcommands .............53 Chapter 31. bltasks .........195 || Help and version options..........63 || See also................63 Chapter 32. blusers .........199 Chapter 9. bdc ...........65 Chapter 33. bmgroup ........203 Chapter 10. bentags .........73 Chapter 34. bmig ..........205 Chapter 11. bgadd ..........77 Chapter 35. bmod .........207 Chapter 12. bgdel ..........79 Chapter 36. bpost .........221 Chapter 13. bgmod .........81 Chapter 37. bparams ........225 Chapter 14. bhist ..........83 Chapter 38. bpeek .........227 Chapter 15. bhosts .........97 Chapter 39. bqueues ........229 Chapter 16. bhpart .........109 Chapter 40. bread .........245 Chapter 17. bjdepinfo ........111 Chapter 41. brequeue ........247 Chapter 18. bjgroup.........113 Chapter 42. bresize .........251 Chapter 19. bjobs..........117 Chapter 43. bresources .......253 Categories ..............117 Options ...............117 Description ..............141 Chapter 44. brestart.........257 Chapter 20. bkill ..........153 Chapter 45. bresume ........259 Chapter 21. bladmin ........159 Chapter 46. brlainfo.........261 Chapter 22. blaunch ........163 Chapter 47. brsvadd ........263 © Copyright IBM Corp. 1992, 2014 iii Chapter 48. brsvdel .........269 Chapter 72. lsfshutdown.......427 Chapter 49. brsvmod ........271 Chapter 73. lsfstartup ........429 Chapter 50. brsvs .........279 Chapter 74. lsgrun .........431 Chapter 51. brun ..........281 Chapter 75. lshosts .........435 Chapter 52. bsla ..........285 Chapter 76. lsid ..........441 Chapter 53. bslots .........291 Chapter 77. lsinfo .........443 || Chapter 54. bstage .........293 Chapter 78. lsload .........445 || bstage in ...............293 || bstage out ..............295 Chapter 79. lsloadadj ........451 || Help and version options .........297 || See also ...............297 Chapter 80. lslogin .........453 Chapter 55. bstatus .........299 Chapter 81. lsltasks.........455 Chapter 56. bstop .........301 Chapter 82. lsmake .........457 Chapter 57. bsub ..........305 Chapter 83. lsmon .........463 Categories ..............305 Options ...............308 Description ..............381 Chapter 84. lspasswd ........467 Chapter 58. bswitch ........385 Chapter 85. lsplace .........469 Chapter 59. btop ..........389 Chapter 86. lsrcp ..........471 Chapter 60. bugroup ........391 Chapter 87. lsrtasks ........475 Chapter 61. busers .........393 Chapter 88. lsrun ..........477 Chapter 62. ch ...........395 Chapter 89. lstcsh .........481 Chapter 63. fmtpasswdfile ......399 Chapter 90. pam ..........487 Chapter 64. lsacct .........401 Chapter 91. patchinstall .......491 Chapter 65. lsacctmrg........405 || Chapter 92. pmr ..........495 Chapter 66. lsadmin ........407 Chapter 93. pversions (UNIX) ....497 Chapter 67. lsclusters ........415 Chapter 94. pversions (Windows) . 501 Chapter 68. lseligible ........417 Chapter 95. ssacct .........503 Chapter 69. lsfinstall ........419 Chapter 96. ssched .........507 Chapter 70. lsfmon .........423 Chapter 97. taskman ........511 Chapter 71. lsfrestart ........425 Chapter 98. tspeek .........513 iv Platform LSF Command Reference Chapter 99. tssub .........515 Notices ..............521 Trademarks ..............523 Chapter 100. wgpasswd .......517 Privacy policy considerations ........523 Chapter 101. wguser ........519 Contents v vi 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, 2014 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 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. 2 Platform LSF Command Reference bacct The specified file path can contain up