# 1.5 LSF 快速上手 本文主要是关于 LSF 命令、守护进程、配置文件、日志文件以及重要的集群配置参数的快速介绍。 ## Unix 及 Linux 系统下的安装目录示意图 ![Sample UNIX and Linux installation directories](https://www.ibm.com/support/knowledgecenter/SSWRJV_10.1.0/lsf_quick_reference/lsf_unix_dirmap.jpg) ## 守护进程的错误日志文件 守护进程的错误日志文件，存储在由 **LSF\_LOGDIR** 变量定义的文件目录下面，该变量值在 lsf.conf 文件中指定。 | LSF base system daemon log files | LSF batch system daemon log files | | -------------------------------- | --------------------------------- | | pim.log.host\_name | mbatchd.log.host\_name | | res.log.host\_name | sbatchd.log.host\_name | | lim.log.host\_name | mbschd.log.host\_name | 如果在 ego.conf 文件中定义了变量 **EGO\_LOGDIR** ，那么 lim.log.host\_name 文件则存储在由变量 EGO\_LOGDIR 指定的文件目录中。 ## 配置文件 lsf.conf, lsf.shared, 和 lsf.cluster.cluster\_name 文件， 位于由 **LSF\_CONFDIR** 变量定义的文件目录下面，该变量值在 lsf.conf 文件中指定。 lsb.params, lsb.queues, lsb.modules, 和 lsb.resources 文件，位于 **LSB\_CONFDIR**/cluster\_name/configdir/ 目录下面。 | 文件 | 描述 | | ------------------------- | ----------------------------------------- | | install.config | LSF 的安装与配置选项 | | lsf.conf | 描述集群配置和操作的通用环境配置文件 | | lsf.shared | 所有群集共享的定义文件。用于定义群集名称、主机类型、主机型号和站点定义的资源 | | lsf.cluster.cluster\_name | 用于定义主机、管理员和站点定义的共享资源的位置的集群配置文件 | | lsb.applications | 定义应用程序配置文件，来指定同类型作业的公共参数 | | lsb.params | 配置 LSF 批处理参数 | | lsb.queues | 批处理队列配置文件 | | lsb.resources | 配置资源分配限制、导出和资源使用限制 | | lsb.serviceclasses | 将LSF集群中的服务级别协议（SLA）定义为服务类，该服务类定义了 SLA 的属性 | | lsb.users | 配置用户组、用户和用户组的分层公平共享，以及用户和用户组的作业槽数限制 | ## lsf.conf 配置文件中的集群配置参数 | 参数 | 描述 | Unix 默认值 | | ---------------------- | --------------------------------------------------------------------- | ----------------------------------------- | | **LSF\_BINDIR** | 包含 LSF 用户命令的目录，由相同类型的所有主机共享 | LSF\_TOP/version/OStype/bin | | **LSF\_CONFDIR** | 所有 LSF 配置文件的目录 | LSF\_TOP/conf | | **LSF\_ENVDIR** | 包含 lsf.conf 文件的目录。必须由root 用户所拥有。 | /etc (if **LSF\_CONFDIR** is not defined) | | **LSF\_INCLUDEDIR** | 包含 LSF API 头文件 lsf.h 和 lsbatch.h的目录 | LSF\_TOP/version/include | | **LSF\_LIBDIR** | LSF 库，由相同类型的所有主机共享 | LSF\_TOP/version/OStype/lib | | **LSF\_LOGDIR** | （可选）LSF 守护程序日志的目录。必须由 root 拥有。 | /tmp | | **LSF\_LOG\_MASK** | 从 LSF 命令记录错误消息的级别 | **LOG\_WARNING** | | **LSF\_MANDIR** | 包含 LSF 手册页的目录 | LSF\_TOP/version/man | | **LSF\_MISC** | 示例C程序和Shell脚本，以及外部LIM（**elim**）的模板 | LSF\_TOP/version/misc | | **LSF\_SERVERDIR** | 由 LSF 守护程序启动的所有服务器二进制文件和 Shell 脚本以及外部可执行文件的目录。必须由root拥有，并由相同类型的所有主机共享 | LSF\_TOP/version/OStype/etc | | **LSF\_TOP** | 顶级安装目录。 LSF\_TOP 的路径必须共享，并且集群中的所有主机都可以访问。它不能是根目录（/）。 | Not definedRequired for installation | | **LSB\_CONFDIR** | LSF批处理配置目录的目录，包含用户和主机列表，操作参数和批处理队列 | LSF\_CONFDIR/lsbatch | | **LSF\_LIVE\_CONFDIR** | LSF 实时重新配置目录的目录，该目录由 **bconf** 命令编写。 | LSB\_SHAREDIR/cluster\_name/live\_confdir | | **LSF\_SHAREDIR** | 每个集群的 LSF 批处理作业历史记录和记帐日志文件的目录，必须由首要的 LSF 管理员拥有 | LSF\_TOP/work | | **LSF\_LIM\_PORT** | 用于与 lim 守护程序进行通信的 TCP 服务端口 | 7879 | | **LSF\_RES\_PORT** | 用于与 **res** 守护程序通信的 TCP 服务端口 | 6878 | | **LSF\_MBD\_PORT** | 用于与 **mbatchd** 守护程序进行通信的 TCP 服务端口 | 6881 | | **LSF\_SBD\_PORT** | 用于与 **sbatchd** 守护程序进行通信的TCP服务端口 | 6882 | ## 管理命令 注：只有 LSF 管理员和 root 用户可以使用这些命令。 | 命令 | 描述 | | --------------- | ------------------------------------------------------------------------------- | | **lsadmin** | LSF 管理员工具，用于控制 LSF 集群中 LIM 和 RES 守护程序的运行，**lsadmin help** 显示所有子命令 | | **lsfinstall** | 使用 install.config 输入文件安装 LSF | | **lsfrestart** | 在本地集群中的所有主机上重新启动 LSF 守护程序 | | **lsfshutdown** | 关闭本地集群中所有主机上的 LSF 守护程序 | | **lsfstartup** | 在本地集群中的所有主机上启动 LSF 守护程序 | | **badmin** | 用于控制 LSF 批处理系统（**sbatchd**，**mbatchd**，主机和队列）的 LSF 管理工具 **badmin help** 显示所有子命令 | | **bconf** | 更改活动内存中的 LSF 配置 | ## 守护进程 | 进程名 | 描述 | | ----------- | ---------------------------------------------------------------------------------------------------------------- | | **lim** | Load Information Manager (LIM): 负载信息管理器：收集有关集群中所有服务器主机的负载和资源信息，并通过 LSLIB 为应用程序提供主机选择服务。 LIM 维护有关静态系统资源和动态负载索引的信息 | | **mbatchd** | Master Batch Daemon (MBD): 主批处理守护程序：接受并保存所有批处理作业。 MBD通过联系 主LIM 定期检查所有服务器主机上的负载索引。 | | **mbschd** | Master Batch Scheduler Daemon：主批处理调度守护程序：执行LSF的调度功能，并将作业调度决策发送到 MBD 以进行调度。 该服务在 LSF 主服务器主机上运行 | | **sbatchd** | Slave Batch Daemon (SBD)：从属批处理守护程序（SBD）：接受来自 MBD 的作业执行请求，并监视作业进度。 控制作业执行，强制执行批处理策略，将作业状态报告给 MBD，然后启动 MBD。 | | **pim** | Process Information Manager (PIM): 进程信息管理器（PIM）：监视提交的作业在运行时所使用的资源。 PIM 用于强制执行资源限制和负载阈值以及公平分配调度。 | | **res** | Remote Execution Server (RES): 远程执行服务器（RES）：接受来自所有负载共享应用程序的远程执行请求，并处理远程主机上的I / O以进行负载共享过程。 | ## 用户命令 ### 查看集群信息的命令 | 命令 | 描述 | | ----------- | ------------------------ | | **bhosts** | 显示主机及其静态和动态资源 | | **blimits** | 显示正在运行的作业的资源分配限制的相关信息 | | **bparams** | 显示可调批次系统参数的相关信息 | | **bqueues** | 显示批处理队列的相关信息 | | **busers** | 显示用户和用户组的相关信息 | | **lshosts** | 显示主机及其静态资源信息 | | **lsid** | 显示当前的 LSF 版本号，集群名称和主控主机名 | | **lsinfo** | 显示负载分担配置信息 | | **lsload** | 显示主机的动态负载索引 | ### 监测作业与任务的命令 | 命令 | 描述 | | ----------- | ----------------------------- | | **bacct** | 报告已完成的 LSF 作业的会计统计数据 | | **bapp** | 显示附加到应用程序配置文件的作业的相关信息 | | **bhist** | 显示作业的相关历史信息 | | **bjobs** | 显示作业的相关信息 | | **bpeek** | 显示未完成作业的标准输出和标准错误 | | **bsla** | 显示服务类配置的相关信息，以用于面向目标的服务级别协议调度 | | **bstatus** | 读取或设置外部作业状态消息和数据文件 | ### 提交与控制作业的命令 | 命令 | 描述 | | ------------ | -------------------- | | **bbot** | 移动正在等待的作业到队列的末尾 | | **bchkpnt** | 检查点可检查的工作 | | **bkill** | 向作业发送信号，一般用于结束作业 | | **bmig** | 迁移可检查点的或可重新运行的作业 | | **bmod** | 修改作业的提交选项 | | **brequeue** | 杀死并重新安排作业 | | **bresize** | 释放槽位并取消挂起的作业调整大小分配请求 | | **brestart** | 重新启动检查点作业 | | **bresume** | 恢复暂停的作业 | | **bstop** | 暂停作业 | | **bsub** | 提交作业 | | **bswitch** | 将未完成的作业从一个队列移至另一队列 | | **btop** | 移动正在等待的作业到队列首部 | ## bsub 命令 **bsub** \[options] command \[arguments] 命令中的部分选项 | 选项 | 描述 | | ---------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | **-ar** | 指定作业可自动调整大小 | | **-H** | 提交时将工作保持在 PSUSP 状态 | | **-I\|-Ip\|-Is** | 提交批处理交互式作业。 **-Ip** 创建伪终端。 **-is** 在shell模式下创建一个伪终端。 | | **-K** | 提交作业并等待作业完成 | | **-r** | 使作业可重新运行 | | **-x** | 排他执行 | | **-app** application\_profile\_name | 将作业提交到指定的应用程序配置文件 | | **-b** begin\_time | 在\[\[month：] day：]：minute 格式的指定日期和时间或之后调度作业 | | **-C** core\_limit | 为属于此作业的所有进程设置每个进程（soft）核心文件的大小限制（KB） | | **-c** cpu\_time\[/host\_name \| /host\_model] | 限制作业可以使用的总CPU时间。 CPU时间的格式为\[hour:]minutes | | **-cwd** "current\_working\_directory" | 指定作业的当前工作目录 | | **-D** data\_limit | 为属于作业的每个进程设置每个进程（soft）数据段的大小限制（KB） | | **-E** "pre\_exec\_command \[arguments]" | 在作业运行之前，在执行主机上运行指定的pre-exec命令 | | **-Ep** "post\_exec\_command \[arguments]" | 作业完成后，在执行主机上运行指定的post-exec命令 | | **-e** error\_file | 将标准错误输出附加到文件 | | **-eo** error\_file | 将作业的标准错误输出覆盖到指定文件 | | **-F** file\_limit | 为属于作业的每个进程设置每个进程（soft）文件大小限制（KB） | | **-f** "local\_file op\[remote\_file]" ... | 在本地（提交）主机和远程（执行）主机之间复制文件。op是>，<，<<，> <，<>之一 | | **-i** input\_file \| **-is** input\_file | 从指定文件获取作业的标准输入 | | **-J** "job\_name\[index\_list]%job\_slot\_limit" | 为作业分配指定的名称。 作业数组 index\_list 的格式 start \[-end \[：step]]，而 ％job\_slot\_limit 是可以同时运行的最大作业数。 | | **-k** "chkpnt\_dir \[chkpnt\_period]\[method=method\_name]" | 使作业可检查，并指定检查点目录，以分钟为单位的时间段和方法 | | **-M** mem\_limit | 设置每个进程（soft）的内存限制（KB） | | **-m** "host\_name \[@cluster\_name]\[\[!] \| +\[pref\_level]] \| host\_group\[\[!] \|+\[pref\_level]] \| compute\_unit\[\[!] \|+\[pref\_level]]..." | 在指定的主机之一上运行作业。 主机或组的名称后的加号（+）表示首选项。 可选地有，正整数表示偏好级别。 数字越高表示偏好越大。 | | **-n** min\_proc\[,max\_proc] | 指定并行作业所需的最小和最大处理器数量 | | **-o** output\_file | 将标准输出附加到文件 | | **-oo** output\_file | 将作业的标准输出覆盖到指定文件 | | **-p** process\_limit | 限制整个作业的进程数量 | | **-q** "queue\_name ..." | 将作业提交到指定的队列之一 | | **-R** "res\_req" \[-R "res\_req" ...] | 指定主机资源要求 | | **-S** stack\_limit | 为属于作业的每个进程设置每个进程（soft）堆栈段大小限制（KB） | | **-sla** service\_class\_name | 指定要在其中运行作业的服务类 | | **-T** thread\_limit | 设置整个作业的并发线程数限制 | | **-t** term\_time | 以 \[\[month：] day：] hour：minute 的形式指定作业终止的截止日期 | | **-v** swap\_limit | 设置整个作业的总进程虚拟内存限制（KB） | | **-W** run\_time\[/host\_name \| /host\_model] | 以\[hour：] minute形式设置作业的运行时限制 | | **-h** | 将命令用法打印到 stderr 并退出 | | **-V** | 将 LSF 发行版本打印到 stderr 并退出 | --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://baiyongan.gitbook.io/lsf-handbook/parti-ru-men-jie-shao-pian/lsf_introduction/lsf_quick_reference.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.