IBM Platform LSF--esub变量参数含义

Posted 2022-12-01 一只独角兽

关于esub

一个esub，external submission缩写，是用户所写的执行体（二进制文件或脚本）被用于验证、修改、拒绝作业。这个esub被放置在LSF_SERVERDIR目录下（在lsf.conf中定义）。当有作业被提交、重启动、修改时，LSF检查esub的存在。如果LSF找到了一个esub，LSF运行它。作业是否被提交、修改、拒绝依赖于esub中的逻辑。

任何需要被提供给用户的消息应该被定向至标准错误（stderr）流，而不是标准输出（stdout）流
在这一节中

1. 连接esub和LSF的环境变量
2. 通用esub逻辑
3. 拒绝作业
4. 验证作业提交参数
5. 修改作业提交参数
6. 和mesub一起使用bmod和brestart命令
7. 使用多esub（mesub）
8. master esub如何调用应用程序特定的esub
9. 配置master esub和应用程序特定的esub

连接esub和LSF的环境变量

在esub执行环境中，LSF提供下面的环境变量。
LSB_SUB_PARM_FILE， 这个变量指向一个包含了作业参数的零时文件，当作业被提交时esub读取它。这些提交参数是名－值对集，每行指定一个，格式为“option_name=value”.

支持下面的选项名：

选项	描述
LSB_SUB_ADDITIONAL	字符串格式参数，包含bsub的-a选项的值。-a的值被传递给bsub，但是它不直接影响其他bsub参数或行为。-a的值必须与某个实际的esub文件对应。例如，为了使用bsub -a fluent，LSF_SERVERDIR目录下必须存在文件esub.fluent。LSB_SUB_ADDITIONAL不能在LSB_SUB_MODIFY_FILE被改变或添加至LSB_SUB_MODIFY_FILE。
LSB_SUB_BEGIN_TIME	开始时间，单位为秒，起始于00:00:00 GMT, Jan. 1, 1970。
LSB_SUB_CHKPNT_DIR	检查点目录。检查点目录的文件路径在UNIX和Linux下能最多包含4000个字符，或Windows下255个字符（包括目录和文件名）。
LSB_SUB_COMMAND_LINE	bsub作业命令参数。必须在lsf.conf中设置LSB_SUB_COMMANDNAME以使得esub能使用这个变量。
LSB_SUB_CHKPNT_PERIOD	检查点周期，单位为秒。
LSB_SUB_DEPEND_COND	依赖情形。
LSB_SUB_ERR_FILE	标准错误文件名。
LSB_SUB_EXCEPTION	例外情形。
LSB_SUB_EXCLUSIVE	“Y”指定独占地执行。
LSB_SUB_EXTSCHED_PARAM	验证或修改bsub –extsched选项。
LSB_SUB_HOLD	保持作业（bsub –H 选项）。
LSB_SUB_HOSTS	执行机器名列表。
LSB_SUB_HOST_SPEC	机器指定。
LSB_SUB_IN_FILE	“Y”指定一个交互式作业。
LSB_SUB_LOGIN_SHELL	登录shell
LSB_SUB_JOB_NAME	作业名
LSB_SUB_JOB_WARNING_ACTION	bsub –wa指定的作业警告动作。
LSB_SUB_JOB_ACTION_WARNING_TIME	bsub –wt指定的作业警告时间周期。
LSB_SUB_MAIL_USER	LSF用于发送作业邮件的email地址。
LSB_SUB_MAX_NUM_PROCESSORS	需要的最大处理器数。
LSB_SUB_MODIFY	“Y”指定一个修改请求
LSB_SUB_MODIFY_ONCE	“Y”指定一个仅一次修改请求。
LSB_SUB_NOTIFY_BEGIN	“Y”指定当作业开始时email通知。
LSB_SUB_NOTIFY_END	“Y”指定当作业结束时email通知。
LSB_SUB_NUM_PROCESSORS	需要的最小处理器数。
LSB_SUB_OTHER_FILES	这个值是SUB_RESET，如果定义了SUB_RESET以指示一个正在被执行重置被传输文件的数量的bmod。这个文件路径在UNIX和Linux下能最多包含4000个字符，或Windows下255个字符（包括目录和文件名）。
LSB_SUB_OTHER_FILES_number	number是一个索引数，指示特殊文件传输值是这个特定文件传输表达式。例如，对于bsub -f “a > b” -f “c < d”，下面的将被定义：LSB_SUB_OTHER_FILES_0=“a > b” LSB_SUB_OTHER_FILES_1=“c < d”
LSB_SUB_OUT_FILE	标准输出文件名。
LSB_SUB_PRE_EXEC	先执行命令。这个命令路径在UNIX和Linux下能最多包含4000个字符，或Windows下255个字符（包括目录和文件名）。
LSB_SUB_PROJECT_NAME	工程名。
LSB_SUB_PTY	“Y”指定一个具有PTY支持的交互式作业。
LSB_SUB_PTY_SHELL	“Y”指定一个具有PTY shell支持的交互式作业。
LSB_SUB_QUEUE	提交队列名。
LSB_SUB_RERUNNABLE	“Y”指定一个可重运行的作业。“N”指定一个不可重运行的作业（bsub –rn指定）。这个作业是不可重运行的，即时它被提交至一个可重运行的队列、或应用程序profile。对于bsub –rn，这个值是SUB_RESET。
LSB_SUB_RES_REQ	资源需求串――不支持多资源请求串。
LSB_SUB_RESTART	“Y”指定一个重启动作业。
LSB_SUB_RESTART_FORCE	“Y”指定一个强制重启动作业。
LSB_SUB_RLIMIT_CORE	Core文件大小限制。
LSB_SUB_RLIMIT_CPU	CPU限制。
LSB_SUB_RLIMIT_DATA	数据大小限制。
LSB_SUB_RLIMIT_FSIZE	文件大小限制。
LSB_SUB_RLIMIT_PROCESS	进程限制。
LSB_SUB_RLIMIT_RSS	常驻大小限制。
LSB_SUB_RLIMIT_RUN	时钟运行限制。
LSB_SUB_RLIMIT_STACK	堆大小限制
LSB_SUB_RLIMIT_SWAP	虚拟内存限制（交换空间）
LSB_SUB_RLIMIT_THREAD	线程限制。
LSB_SUB_TERM_TIME	终止时间，单位为秒，从00:00:00 GMT, Jan. 1, 1970开始计算。
LSB_SUB_TIME_EVENT	时间事件表达式。
LSB_SUB_USER_GROUP	用户组名。
LSB_SUB_WINDOW_SIG	窗口信号量数字。
LSB_SUB2_JOB_GROUP	bsub –g指定的选项。
LSB_SUB2_LICENSE_PROJECT	Bsub –Lp指定的LSF License Scheduler工程名。
LSB_SUB2_IN_FILE_SPOOL	Spooled输入文件（bsub –is）。
LSB_SUB2_JOB_CMD_SPOOL	Spooled作业命令文件（bsub –Zs）。
LSB_SUB2_JOB_PRIORITY	作业的优先级（bsub –sp和bmod –sp）。对于bmod –spn，值是SUB_RESET。
LSB_SUB2_SLA	SLA调度选项。
LSB_SUB2_USE_RSV	bsub –U指定的高级预留ID。
LSB_SUB3_ABSOLUTE_PRIORITY	对于bmod –aps，值等于bmod –aps中的APS字符串。对于bmod –apsn，值等于SUB_RESET。
LSB_SUB3_APP	bsub- app和bmod –app指定的选项。对于bmod –appn，值是SUB_RESET。
LSB_SUB3_AUTO_RESIZABLE	定义作业自动重大小的属性。如果bsub –ar或bmod -ar 被指定了，LSB_SUB3_AUTO_RESIZABLE=Y。如果bmod –arn被使用了，LSB_SUB3_AUTO_RESIABLE=SUB_RESET。
LSB_SUB3_RESIZE_NOTIFY_CMD	定义作业重大小通知命令。如果bsub -rnc or bmod –rnc被指定了，LSB_SUB3_RESIZE_NOTIFY_CMD=。如果bmod –arn被使用了，LSB_SUB3_RESIZE_NOTIFY_CMD =SUB_RESET。
LSB_SUB3_JOB_REQUEUE	字符串格式参数，包含bsub -Q选项的值。对于bmod –Qn，值是SUB_RESET。
LSB_SUB3_CWD	在命令行使用bsub –cwd指定的当前工作目录。
LSB_SUB_INTERACTIVE LSB_SUB3_INTERACTIVE_SSH	如果两个都被指定为“Y”，交互式作业的会话被SSH加密。bsub -IS bsub -ISs
LSB_SUB_INTERACTIVE LSB_SUB_PTY LSB_SUB3_INTERACTIVE_SS	如果LSB_SUB_INTERACTIVE被指定为“Y”，LSB_SUB_PTY被指定为“Y”，LSB_SUB3_INTERACTIVE_SS被指定为“Y”，有PTY支持的交互式作业将被SSH加密。bsub –ISp
LSB_SUB_INTERACTIVE LSB_SUB_PTY LSB_SUB_PTY_SHELL LSB_SUB3_INTERACTIVE_SSH	如果LSB_SUB_INTERACTIVE被指定为“Y”，LSB_SUB_PTY被指定为“Y”，LSB_SUB_PTY_SHELL被指定为“Y”，并且LSB_SUB3_INTERACTIVE_SS被指定为“Y”，有PTY shell支持的交互式作业将被SSH加密。bsub –ISs
LSB_SUB3_POST_EXEC	在作业完成后在执行机器上运行这个指定的后执行命令。由bsub –Ep指定。这个命令路径在UNIX和Linux下能最多包含4000个字符，或Windows下255个字符（包括目录和文件名）。
LSB_SUB3_RUNTIME_ESTIMATION	bsub –We指定的运行事件估计。
LSB_SUB3_USER_SHELL_LIMITS	传递用户shell限制给执行机器。由bsub –ul指定。
LSB_SUB_INTERACTIVE LSB_SUB3_XJOB_SSH	如果两者都被指定为“Y”，X-client和X-server之间的会话与执行机器和作业提交机器之间的会话一样。