================================================================================
LSF bsub 命令详解 (Load Sharing Facility)
================================================================================
1. 命令概述
--------------------------------------------------------------------------------
* 命令名称:bsub (Batch Submit)
* 用途:向 LSF 集群提交作业(Job)。
* 适用场景:高性能计算 (HPC)、电子设计自动化 (EDA)、大规模数据处理。
* 基本语法:
bsub [选项] 命令 [参数]
2. 常用选项参数
--------------------------------------------------------------------------------
A. 资源请求类
-n <num> : 请求指定数量的 CPU 核心(槽位 slots)。
-R "<string>" : 资源需求字符串,用于指定更复杂的硬件或软件要求。
常见子句:
* span[hosts=1] : 强制所有核心在同一台物理机上。
* select[type==xxx] : 选择特定类型的节点(如操作系统、架构)。
* rusage[mem=MB] : 请求每个槽位的内存大小(单位 MB)。
-W <hh:mm> : 设置作业的最大运行时间(Wall Clock Limit)。超时会被杀死。
B. 队列与优先级类
-q <queue_name> : 指定提交到哪个队列(Queue)。不同队列有不同的优先级和资源限制。
-sp <priority> : 设置作业的静态优先级(数值越大优先级越高)。
C. 输出与控制类
-o <file> : 将标准输出 (stdout) 重定向到指定文件。
-e <file> : 将标准错误 (stderr) 重定向到指定文件。
-J <job_name> : 给作业起一个名字,方便后续使用 bjobs 查看。
-Is : 交互式模式 (Interactive + Shell)。提交后等待分配资源,并直接登录到计算节点。
-I : 仅交互式输入输出,不启动 Shell(较少用)。
D. 依赖与环境类
-d <cwd> : 设置作业的执行目录。
-L <shell> : 指定作业使用的 Shell(如 /bin/bash, /bin/tcsh)。
-env "all" : 继承当前环境的所有变量。
3. 典型使用示例
--------------------------------------------------------------------------------
示例 1:提交一个简单的后台批处理作业
bsub -q normal -n 4 -W 2:00 -o output.log -e error.log ./run_simulation.sh
示例 2:提交交互式作业(用于调试或运行 GUI 工具)
bsub -Is -q interactive -n 8 -R "span[hosts=1]" bash
示例 3:提交需要大内存和特定操作系统的作业
bsub -q long -n 16 -R "select[type==rhel7] rusage[mem=50000]" ./heavy_calculation
示例 4:提交作业并命名
bsub -J "MySim_v1" -o sim_%J.out ./simulator
4. 相关管理命令
--------------------------------------------------------------------------------
* bjobs : 查看当前用户的作业状态(Pending, Running, Done, Exit)。
* bkill <job_ID> : 杀死指定的作业。
* bpeek <job_ID> : 查看正在运行作业的输出内容。
* bhosts : 查看集群中主机节点的状态和资源情况。
* bqueues : 查看队列的状态和配置。
5. 注意事项
--------------------------------------------------------------------------------
* 内存单位:在 rusage[mem=X] 中,X 通常指 **每个槽位 (per slot)** 的 MB 数。如果请求 -n 8 和 rusage[mem=1000],则总共需要 8GB 内存。
* 路径问题:作业在执行时,默认工作目录可能是用户的主目录。建议使用绝对路径或在脚本中 cd 到指定目录。
* 环境变量:默认情况下,bsub 不会继承所有本地环境变量。如果需要,请使用 -env "all" 或在脚本中手动 export。
* 退出代码:作业正常结束应返回退出代码 0。非零退出代码通常被视为失败,可能会影响作业依赖链。
6. 总结
--------------------------------------------------------------------------------
bsub 是 LSF 集群管理的核心入口。熟练掌握 -n, -R, -q 和 -W 参数,能够帮助你高效地利用集群资源,避免作业因资源不足或超时而失败。对于 EDA 工具(如 Innovus, PrimeTime),通常需要使用 -R "span[hosts=1]" 以确保多线程并行效率。