加载

显示主机的装入信息。

概要

lsload -s [资源名称 ...] [-loc]

lsload [-h | -V]

描述

可以按主机显示装入信息，也可以按资源显示装入信息。

缺省情况下，显示本地集群中所有主机的装入信息。

在启用 IBM® Spectrum LSF 多集群功能的情况下， lsload 命令还会显示等价集群中所有主机的装入信息。

缺省情况下，显示原始负载指数。

缺省情况下，将根据 CPU 和页面调度负载显示资源的负载信息。

选项

-a

仅限动态集群。显示有关所有主机的信息，包括使用 jobvm 资源配置的动态集群虚拟机主机。缺省输出仅包含标准 LSF 主机和使用 dchost 资源配置的动态集群主机。

-gpu

显示基于主机的 GPU 信息。

-加载

显示基于 GPU 的信息。

-json

以 JSON 格式显示定制输出。

使用 -o 选项指定时，以 JSON 格式显示定制输出。

此选项应与 -o 选项配合使用。如果此选项未与 -o 选项配合使用，那么必须定义 lsf.conf 文件或 LSF_LSLOAD_FORMAT 环境变量中的 LSF_LSLOAD_FORMAT 参数。

-l

长格式。显示不截断的装入信息以及 I/O 和外部装入索引的额外字段。

此选项将覆盖使用 -I 选项指定的索引名。

此选项不显示有关 GPU 资源的信息 (即，此选项不显示gpu_<num>n资源)。使用 -gpu 选项可查看基于主机的 GPU 信息，或使用 -gpuload 选项可查看基于 GPU 的信息。

-N

显示规范化 CPU 运行队列长度负载指标。

-E

显示有效的 CPU 运行队列长度负载指标。选项 -N 和 -E 互斥。

-w

以宽格式显示装入信息。显示字段而不截断。

-I load_index [ :load_index ]...

仅显示指定的负载指标。使用冒号分隔多个索引名 (例如，r1m:pg:ut).

指定任何内置装入索引。仅为数字和动态的基于主机的资源指定外部装入索引 (不能为共享资源，字符串资源或布尔资源指定外部装入索引)。

-n 主机数

仅显示所请求的主机数的装入信息。将显示最多可满足资源需求的 num_hosts 主机的信息。

-o

设置定制输出格式。

指定要显示的 lsload 字段，顺序和宽度。
在字段名称中指定星号通配符 (*) 以指定多个外部资源名称。只能指定一个星号，但此星号可以位于字段名称中的任何位置。
例如，运行 lsload -o "gpu_mode*" 将显示如下字段:gpu_mode0,gpu_mode1,gpu_mode2,gpu_model0,gpu_model1和gpu_model2.
仅指定 lsload 字段名称以将其输出设置为无限宽度和左对齐。
指定不带宽度的宽度冒号 (:) 以将输出宽度设置为该字段的建议宽度。
使用宽度指定宽度冒号 (:) ，以设置要为字段显示的最大字符数。当其值超过此宽度时， lsload 将截断结束字符。
指定连字符 (-) 以在 lsload 显示特定字段的输出时设置正确的对齐方式。如果未指定，那么缺省值是在 lsload 显示字段的输出时设置左对齐。
指定带有单位的单位冒号 (:) ，以设置特定字段的输出的单位:
- 指定 S 以对空间或容量 (例如，内存或磁盘空间) 使用内置转换。对于 M (MB) ， G (GB) 和 T (TB) ，将自动缩放值，其中缺省单位为 M (MB)。
  例如，当显示指定宽度为 3 的 mem 字段时，
  - 对于值 30 ，运行 lsload -o "mem:3:S" 命令将显示30.0M.
  - 对于值 4096 ，运行 lsload -o "mem:3:S" 命令将显示4.0G.
  - 对于值 5000000 ，运行 lsload -o "mem:3:S" 命令将显示4.8T.
- 指定 D 以将内置转换用于持续时间或时间，例如内存或磁盘空间。值会自动缩放 s (秒) ， m (分钟) ， h (小时) 和 d (天) ，其中缺省单位为 s (秒)。自动缩放的值将在第一个小数点后向上舍入。
  例如，当显示指定宽度为 5 的外部 mytime 资源字段时，
  - 对于值 30 ，运行 lsload -o "mytime:5:D" 命令将显示30.0s.
  - 对于值 8000 ，运行 lsload -o "mytime:5:D" 命令将显示2.2h.
  - 对于值 5000000 ，运行 lsload -o "mytime:5:D" 命令将显示57.8d.
- 指定 1-3 字符的任何其他字符串，并按字段值中的方式使用这些字符。第一个字符必须是字母 (大写或小写)。第二个和第三个字符必须是字母数字字符。
  例如，当显示宽度为 3 的外部 gpu_temp 资源时，运行值为 30 的 lsload -o "gpu_temp:3:C" 命令将显示30C
使用 delimiter= 来设置要在不同标题和字段之间显示的定界字符。此定界符必须是单个字符。缺省情况下，定界符是空格。

输出定制仅适用于某些 lsload 选项的输出:

LSF_LSLOAD_FORMAT 和都适用于不带任何选项的命令的输出，以及带有过滤信息的简短输出的选项，包括以下选项： - lsload -o lsload lsload a、 -E、 -N、 -n、 -R。
LSF_LSLOAD_FORMAT 和 lsload -o 不适用于使用修改格式的 lsload 选项的输出，包括以下选项: -I， -l， -w和 -s。

lsload -o 选项覆盖 LSF_LSLOAD_FORMAT 环境变量，这将覆盖 lsf.conf中的 LSF_LSLOAD_FORMAT 设置。

缺省情况下， lsload 命令显示内置资源索引。您还可以指定外部资源的名称。以下是用于指定要显示的 lsload 字段，建议的宽度和所显示字段的计量单位的内置资源索引的字段名称:

表 1. lsload 的输出字段
字段名称	宽度	单位
HOST_NAME	20
状态	15 日
r15s	6
r1m	6
r15m	6
UT	6
pg	6
ls	6
它	6
io	6
tmp	10	lsf.conf 中的 LSF_UNIT_FOR_LIMITS (缺省情况下为 KB)
斯普	10	lsf.conf 中的 LSF_UNIT_FOR_LIMITS (缺省情况下为 KB)
mem	10	lsf.conf 中的 LSF_UNIT_FOR_LIMITS (缺省情况下为 KB)
gpu_status * 例如， gpu_status0 和 gpu_status1 (如果有两个 GPU)。	10
gpu_error * 例如， gpu_error0 和 gpu_error1 (如果有两个 GPU)。	20

字段名称区分大小写。输出宽度的有效值为任何正整数 1-4096。

例如，

lsload -o "HOST_NAME status: r15s:- r1m:7 r15m:-8 tmp:S swp::S mem:9:S delimiter='^'"

此命令显示以下字段:

HOST_NAME ，具有无限的宽度和左对齐。
status ，最大宽度为 15 个字符 (建议的宽度) 且左对齐。
r15s ，最大宽度为 6 个字符 (建议的宽度) 并向右对齐。
r1m ，最大宽度为 7 个字符，左对齐。
r15m ，最大宽度为 8 个字符并向右对齐。
tmp ，具有无限的宽度，左对齐和自动缩放的空间或容量 (MB ， GB 和 TB)。
swp ，最大宽度为 10 个字符 (建议的宽度) ，左对齐，并自动缩放空间或容量 (MB ， GB 和 TB)
mem ，最大宽度为 9 个字符，左对齐，并自动缩放空间或容量 (MB ， GB 和 TB)
该^字符显示在不同的标题和字段之间。

-R 资源请求

仅显示满足指定资源需求的主机的装入信息。

主机的装入信息根据指定资源上的装入进行排序。

如果 res_req 包含特殊资源名称，那么仅显示提供这些资源的主机的装入信息 (运行 lshosts 以了解每个主机上可用的资源)。

如果指定了一个或多个主机名，那么仅显示有关满足资源需求的主机的装入信息。

通过 IBM Spectrum LSF 多集群功能，在指定集群名称时，显示指定集群中满足资源需求的主机的负载信息。

host_name...| host_group...| cluster_name...

仅显示指定主机，主机组或组合; 或集群的装入信息。

要显示主机组信息，必须在文件中指定 LSF_HOSTGROUP_INFO=Y 设置必须在 lsf.conf 文件中指定。

通过 IBM Spectrum LSF 多集群功能，仅显示指定集群中主机的装入信息。

-s [ 资源名称... ] [-loc]

显示有关集群中配置的所有动态资源的信息，或者仅显示有关指定资源的信息。指定动态资源 (共享或基于主机)。

如果 lsf.cluster.clustername 文件中的 LOCATION 参数设置为 all 以指示资源由集群中的所有主机共享，那么LOCATIONlsload -s 命令输出中的字段也会显示ALL. 要在 lsload -s 命令输出中显示集群中所有主机的各个名称，请指定 -loc 选项和 -s 选项。

-h

将命令用法打印到 stderr 并退出。

-V

将 LSF 发行版打印到 stderr 并退出。

基于主机的缺省输出

内置负载指标包括r15s,r1m,r15m,ut,pg,io,ls,it,swp,mem和tmp. 外部装入索引在文件 lsf.cluster.cluster_name中进行配置。资源需求的选择和排序部分控制显示哪些主机以及信息的排序方式。

此屏幕包含以下字段:

HOST_NAME

LSF使用的标准主机名，通常是具有两个组件的因特网域名。

状态

主机的状态。减号 (-) 可以在状态之前，指示 RES 未在主机上运行。

将显示以下状态:

确定: 主机处于正常状态，可以接受远程作业。该ok状态指示装入信息管理器 (LIM) 已解锁，并且 LIM 和远程执行服务器 (RES) 都在运行。
-好吧: 主机上的 LIM 正在运行，但 RES 不可访问。
繁忙: 主机超负荷，因为某些负载指标超过了配置的阈值。导致主机忙碌的装入索引值前面有一个星号 (*).
lockW: 主机被其运行窗口锁定。主机的运行窗口在 lsf.conf 配置文件中指定，并且可以通过 lshosts 命令显示。锁定的主机不接受来自其他主机的 LSF 作业。
lockU: 主机由 LSF 管理员或 root锁定。
无用: 主机已关闭或主机上的 LIM 未运行。

r15s

15 秒成倍平均 CPU 运行队列长度。

r1m

1 分钟成倍平均 CPU 运行队列长度。

r15m

15 分钟的指数平均 CPU 运行队列长度。

UT

过去 1 分钟内成倍平均的 CPU 利用率， 0-1。

io

By default,io未显示。

如果指定了 -l 选项，那么显示过去一分钟内的平均磁盘 I/O 速率 (以 KB/ 秒为单位)。

pg

在过去一分钟内成倍平均的内存页面调度速率 (以每秒页面数为单位)。

ls

当前登录用户数。

它

在 UNIX 上，主机的空闲时间 (未在所有已登录会话上触摸键盘) (以分钟为单位)。

在 Windows 上，it索引基于屏幕保护程序在特定主机上处于活动状态的时间。

tmp

可用空间量/tmp，以 MB 为单位。

斯普

可用交换空间量。

缺省情况下，以 KB 为单位显示金额。根据实际的系统交换空间，此数量可能以 MB 为单位。使用 lsf.conf 文件中的 LSF_UNIT_FOR_LIMITS 参数为限制 (GB ， TB ， PB 或 EB) 指定更大的单元。

mem

可用 RAM 量。

缺省情况下，以 KB 为单位显示金额。根据实际系统内存的不同，此数量可能以 MB 为单位。使用 lsf.conf 文件中的 LSF_UNIT_FOR_LIMITS 参数为限制 (GB ， TB ， PB 或 EB) 指定更大的单元。

外部索引

缺省情况下，不会显示外部负载指标。

如果指定了 -l 选项，那么将显示主机上可用的所有动态定制资源 (包括共享资源，字符串资源和布尔资源) 的索引。

如果指定了 -I load_index 选项，那么仅显示指定的非共享 (基于主机的) 动态数字定制资源的索引。

使用 lsload 基于资源的输出 -s

显示有关共享和基于主机的动态资源的信息。每行给出资源实例的值和关联的主机。

显示的信息由以下字段组成:

RESOURCE: 资源的名称。
值: 资源实例的值。
位置: 与资源实例关联的主机。

示例

以下命令显示具有至少 20 MB 交换空间的 ALPHA 主机的负载，以及小于 0.5的 1 分钟运行队列长度。

lsload -R "select[r1m<=0.5 && swp>=20 && type==ALPHA]"

以下命令以受限格式指定相同的资源需求:

lsload -R r1m=0.5:swp=20:type=ALPHA

以下命令显示交换空间利用率低于 75% 的主机的负载。生成的主机按调页速率排序。

lsload -R "select[(1-swp/maxswp)<0.75] order[pg]"

以下命令显示集群中所有主机的 1 分钟 CPU 原始运行队列长度， CPU 利用率，磁盘 I/O 和调页速率。

lsload -I r1m:ut:io:pg

以下命令显示所有主机的装入，按以下顺序排序:r15s:pg. CPU 运行队列长度是有效运行队列长度。

lsload -E

诊断

对于 LSF 问题或无效的资源名称，退出状态为 -10。

如果指定的选项无效，则退出状态为 -1 。

lsload 命令的正常退出状态为 0。

另请参阅

lim, lsf.cluster, lsplace, lshosts, lsinfo, lslockhost, ls_load.