suma 命令

在线编辑

用途

创建一项任务以从修订服务器自动下载 Technology Level 和 service pack。

语法

要创建、编辑或调度 SUMA 任务：

苏木 { { [ -x ] [-w ] } | -s CronSched } [ -a 现场=价值 ]... [ TaskID ]

要列出 SUMA 任务：

suma -l[TaskID]...

要列出或编辑缺省 SUMA 任务：

苏木 -D [ -a 现场=价值 ]...

要列出或编辑 SUMA 全局配置设置：

苏木 -c [ -a 现场=价值 ]...

要取消调度 SUMA 任务：

suma -uTaskID

要删除 SUMA 任务：

suma -dTaskID

描述

suma 命令可以用来执行对 SUMA 任务或策略的以下操作：
  • 创建
  • 编辑
  • 列表
  • 调度
  • 取消调度
  • 删除
将对用唯一任务标识表示的任务执行指定的操作。 对于创建或编辑 SUMA 任务的情况，如果未指定 TaskID，那么将采用创建操作，并且将生成唯一的 TaskID。 对于 -l 标志，如果未指定 TaskID，那么将显示所有 SUMA 任务的列表。 对于 -c 标志，如果未指定 -a 标志，那么将列出 SUMA 全局配置设置。

标志

项 描述
-c 列出或编辑 SUMA 全局配置设置。 -a 标志允许一个或多个配置设置更新为指定值。 如果使用时不带有 -a 标志，那么将列出所有的 SUMA 配置设置。
可以用 -a 标志编辑的配置设置如下：
FIXSERVER_PROTOCOL
与修订服务器进行通信时，它指定传输将使用 https（安全）。 https 协议是唯一受支持的协议，并且不能更改。 缺省值：https 允许值：https。
DOWNLOAD_PROTOCOL
下载文件集时，它指定传输是使用 http 还是 https（安全）。 http 协议将利用多线程性能并使用 Download Director 协议 (ddp)。 https 协议是单线程的。 缺省值：http 允许值：http 和 https。
DL_TIMEOUT_SEC
指定在下载操作过程中等待修订服务器响应的时间（以秒为单位）。 缺省值：180 允许值：大于零的整数。
HTTP_PROXY 和 HTTPS_PROXY
要用于 HTTP 或 HTTPS 传输的代理服务器和端口。 SUMA 命令与 Electronic Service Agent 共享代理连接设置。 HTTP 或 HTTPS 代理服务配置可通过 SMIT 创建/更改服务配置菜单（使用快速路径 smitty srv_conn）来设置，这些菜单允许对服务器进行指定（例如 IP 地址、端口号和可选用户标识及密码）。 SUMA 不再支持 HTTP_PROXY 和 HTTPS_PROXY 参数的设置。 缺省值：空白（禁用） 允许值：空白
-c （续）
SCREEN_VERBOSE
将记录信息的详细级别指定到标准输出和标准错误。 在 suma 命令从命令行或 SMIT 界面运行时使用。 它不适用于从 cron 运行的调度任务。 缺省值：LVL_INFO 允许值：
  • LVL_OFF：不显示或记录信息。
  • LVL_ERROR：显示错误消息和其他非常重要的消息。
  • LVL_WARNING：除 LVL_ERROR 消息之外还显示警告消息。
  • LVL_INFO：除 LVL_WARNING 消息之外还显示参考消息。
  • LVL_VERBOSE：除 LVL_INFO 消息之外还显示详细参考消息。
  • LVL_DEBUG：显示调试输出。 此设置用于调试用途并且不应该用于常规操作。
NOTIFY_VERBOSE
指定以电子邮件通知形式发送的信息的详细级别。 仅适用于从 "cron.Default值运行的计划任务："LVL_INFO允许值： LVL_OFF、'LVL_ERROR'、'LVL_WARNING'、'LVL_INFO'、'LVL_VERBOSE'、'LVL_DEBUG'（有关值说明，请参阅'SCREEN_VERBOSE设置）
LOGFILE_VERBOSE
指定记录到日志文件（/var/adm/ras/suma.log）的信息的详细级别。 注意：LVL_OFF 设置仍会将信息记录到下载日志文件/var/adm/ras/suma_dl.log)。默认值：'LVL_VERBOSE允许值： LVL_OFF、'LVL_ERROR'、'LVL_WARNING、'LVL_INFO、'LVL_VERBOSE'、'LVL_DEBUG（有关值说明，请参阅SCREEN_VERBOSE设置）
MAXLOGSIZE_MB
允许日志文件达到的最大大小（以 MB 为单位）。 缺省值：1 允许值：大于零的整数。
REMOVE_CONFLICTING_UPDATES
指定 lppmgr 是否应该在清理操作过程中运行时除去与基本图像（lppmgr -u 标志）具有相同级别的有冲突的更新。 缺省值：yes 允许值：yes 和 no
REMOVE_DUP_BASE_LEVELS
指定 lppmgr 是否应该在清理操作过程中运行时除去重复基本级别（lppmgr -b 标志）。 缺省值：yes 允许值：yes 和 no
-c （续）
REMOVE_SUPERSEDE
指定 lppmgr 是否应该在清理操作过程中运行时除去被取代的文件集更新（lppmgr -x 标志）。 缺省值：yes 允许值：yes 和 no
TMPDIR
指定存储临时文件的目录。 缺省值：/var/suma/tmp 允许值：当前已存在的任何目录。
-d 删除与给定 TaskID 相关联的 SUMA 任务以及使用 -s 标志创建并用于此任务的所有调度。
-D 列出或编辑缺省的 SUMA 任务。 -a 标志允许缺省任务的一个或多个字段更新为指定值。 如果使用时不带有 -a 标志，将列出缺省 SUMA 任务。
-l 列出 SUMA 任务。 如果使用时不带有 TaskID，将列出所有 SUMA 任务。 TaskID 可用来指定一个或多个要列出的任务标识。
-s CronSched 调度 SUMA 任务。 如果在创建新任务时指定，那么意味着保存（-w 标志功能）。 CronSched 是空格分隔的加引号的五个条目（分钟、小时、日、月和工作日）的列表。 这些条目的有效值如下（有关其他详细信息，请参阅 crontab 联机帮助页）：
  • 分钟：0 - 59
  • 小时：0 - 23
  • 日：1 - 31
  • 月：1 - 12
  • 工作日：0 - 6 （星期日到下星期六）
-U 取消调度 SUMA 任务。 它将除去指定 TaskID 的任何调度信息。
-w 撰写或保存 SUMA 任务。 如果使用时不带有 -s 标志，将保存此任务，同时允许稍后添加调度信息。 如果结合 -x 标志使用，将立即运行此任务，同时还将其保存。
-x 指定是否应该立即运行 SUMA 任务并且不调度它。 如果使用时不带有 -w 标志，将不保存此任务供日后使用。
-a 现场=价值 ... 将指定的值分配到指定的字段。 要对 SUMA 任务进行创建或编辑操作，受支持的字段和值如下。
RqType
如果运行 suma 时带有 Latest 的 RqType，那么 RqType 是唯一的必填字段。 要获取在此情况下将使用的缺省值，请参阅示例 1。 其他 RqType 值（TL、SP、ML 和 PTF）将要求指定其他 Field=Value 信息。
ML
指定下载特定维护或技术级别的请求。 例如，5300-11。
TL
指定下载特定技术级别的请求。 例如，6100-03。
PTF
指定下载 PTF 的请求。 示例是 U813941。 仅某些 PTF 可作为单个文件集下载。 例如，包含 bos.rte.install 和 bos.alt_disk_install.rte 的 PTF 或在 Service Pack 之间出现的 PTF。 否则，必须下载 TL 或 SP。
SP
指定下载特定 service pack 的请求。 例如，6100-02-04。
Latest
指定要下载最新修订的请求。 此 RqType 值将返回 FilterML 中指定的 TL 的最新 service pack。
-a （续）
RqName
所请求项的特定名称（例如，6100-03 或 6100-04-03）。 在 RqType 等于 Latest 时，RqName 字段应该保留为空。
Repeats
指定是否只执行一次该任务且不将其保留在系统上，在找到该项之前重复，还是永久性重复。 Repeats 字段仅适用于从 cron 运行的调度任务（带有 Download、Clean 或 Metadata 的 Action）。 如果从命令行运行，或者如果 Action 为 Preview，那么将忽略此字段，并且不会除去任务。
y
设置重复任务，要求使用-s标志为任务分配CronSched。 当 RqType 等于 TL、SP、PTF 或 ML 时，如果找到该项，那么将立即除去任务。 当 RqType 等于 Latest 时，任务将设置为永久重复。
n
指定是否只执行一次该任务并且不将其保留在系统上。
-a （续）
DisplayName
指示此 SUMA 任务的显示名称（例如，“可用时下载 TL 6100-04）。 在 SMIT 中查看现有的 SUMA 任务时可以使用它。
操作
Preview
指定将执行的下载预览。 不下载文件集。
下载
指定将文件集下载到基于策略的 DLTarget。
Clean
指定将文件集下载到基于策略的 DLTarget，随后执行清理操作。 lppmgr 命令将用来清理 DLTarget 中不需要的文件集。 在 SUMA 全局配置设置中列出的三个可配置的 lppmgr 标志选项如下：
Metadata
指定下载元数据文件而不是文件集更新。 将支持以下 RqType 值：
TL
下载特定技术级别的元数据。
SP
下载特定 service pack 的元数据。
Latest
针对为 FilterML 标志指定的技术级别，下载所有 service pack 的元数据。
DLTarget
包含将存储下载文件的目录位置。 如果未指定该字段，那么为其指定值 /usr/sys/inst.images，并且根据映像类型将文件存储在某个目录中；例如 /usr/sys/inst.images/installp/ppc 或 /usr/sys/inst.images/RPMS/ppc。
NotifyEmail
包含在文件集下载或预览之后将通知电子邮件发送到的一个或多个电子邮件地址（多个地址应该以逗号分隔）。 如果将任务调度为以后执行（已经指定 CronSched），将仅发送通知。
-a （续）
FilterDir
指定要过滤的修订包存储库目录的名称，以便不下载重复的修订包。 它允许过滤目录（DLTarget 除外）。 例如，您可以过滤 NIM lpp_source，而不需要下载到此目录。 如果保留为空，将使用 DLTarget。
FilterML
指定要针对其进行过滤的技术级别，例如 6100-03。 如果未指定，将使用本地系统上的 oslevel -r 返回的值。
MaxDLSize
要通过任何单个策略执行下载的数据的最大允许数量（以 MB 为单位）。 如果确定下载包超出此大小，将不下载。 可以指定“unlimited”或 -1 值来表明要下载的数据数量没有上限。
扩展
指定 y 将自动扩展 DLTarget 所在的文件系统。 如果指定 n 并且需要额外空间进行下载，将不下载。
MaxFSSize
DLTarget 文件系统可扩展到的最大允许大小以 MB 为单位。 如果确定下载包超出此限制，将不下载。 可以指定“unlimited”或 -1 值来表明文件系统大小没有上限（即，可以扩展文件系统，直到物理磁盘空间耗尽）。

参数

项 描述
TaskID 指定与任务相关的唯一数字标识。 创建任务时将指定此标志。

退出状态

项 描述
重大安全事件数量 命令成功完成。
>0 发生错误。

示例

  1. 要列出 SUMA 全局配置设置，请输入以下内容：
    suma -c
    显示类似于以下内容的输出：
    FIXSERVER_PROTOCOL=https
DOWNLOAD_PROTOCOL=http
DL_TIMEOUT_SEC=180
DL_RETRY=1
HTTP_PROXY=
HTTPS_PROXY=
SCREEN_VERBOSE=LVL_INFO
NOTIFY_VERBOSE=LVL_INFO
LOGFILE_VERBOSE=LVL_VERBOSE
MAXLOGSIZE_MB=1
REMOVE_CONFLICTING_UPDATES=yes
REMOVE_DUP_BASE_LEVELS=yes
REMOVE_SUPERSEDE=yes
TMPDIR=/var/suma/tmp
  2. 要编辑 SUMA 全局配置设置以将日志文件的最大大小更改为 2 MB，请输入以下内容：
    suma -c -a MAXLOGSIZE_MB=2
  3. 要列出 SUMA 任务缺省值，请输入以下内容：
    suma -D
    显示类似于以下内容的输出：
    DisplayName=
Action=Download
RqType=Latest
RqName=
Repeats=y
DLTarget=/usr/sys/inst.images
NotifyEmail=root
FilterDir=/usr/sys/inst.images
FilterML=7200-02
MaxDLSize=-1
Extend=y
MaxFSSize=-1
  4. 要创建并安排每月下载最新修复程序的任务（例如，每月 15 日 2:30 a.m、） 输入以下内容：
    suma -s "30 2 15 * *" -a RqType=Latest \
-a DisplayName="Latest fixes - 15th Monthly"
    注: 将为此新创建的任务返回任务标识。 此示例假定将利用某些 SUMA 任务缺省值（如 suma -D 示例中所示）。 例如，当任务缺省值为 DLTarget=/usr/sys/inst.images 时，installp 图像将下载到 /usr/sys/inst.images/installp/ppc 目录。
  5. 要查看通过运行 suma -s CronSched 命令设置的 SUMA 调度信息，请输入以下内容：
    crontab -l root
  6. 创建并安排任务，每周检查一次特定 TL（例如，每周四a.m 3 点）、 在可用时下载，并向远程系统上的用户发送电子邮件通知，请键入以下内容：
    suma -s "0 3 * * 4" -a RqType=TL -a RqName=6100-04 \
-a NotifyEmail="bob.smith@host2,ann@host2"
    注意：要使该任务每周检查一次 TL，需要将 "重复"字段设置为"y"。 在这种情况下，找到 TL 后，将删除该任务。 如果 Repeats=n，那么删除此任务之前只检查一次。
  7. 创建并计划每月检查关键修复的任务（例如，每月 20 日 4:30 a.m、） 输入以下内容：
    suma -s "30 4 20 * *" -a RqType=Latest -a RqName= \
-a RqLevel=latest -a Repeats=y
    注意：设置Repeats=y 后，该任务将 "永远重复"，下载成功后不会删除。
  8. 要创建并安排一项任务，在周一p.m 11:00 将整个AIX® 7.1版和 5300-11 推荐维护软件包下载到/lppsrc/5311目录中、 并在下载操作后运行lppmgr清理操作以删除任何被取代的更新、重复的基本级别和冲突的更新，请键入以下内容：
    suma -s "0 23 * * 1" -a Action=Clean -a RqType=ML -a RqName=5300-11 \
-a DLTarget=/lppsrc/5311
    注意：在运行指定Action=Clean 的任务之前，可以运行suma-c验证运行lppmgr命令时使用的 SUMA 全局配置设置。 在这种情况下，将 REMOVE_SUPERSEDE、REMOVE_DUP_BASE_LEVELS 和 REMOVE_CONFLICTING_UPDATES 全部设置为 yes 将产生上述操作。
  9. 要创建并安排一项任务，在周一p.m 11:00 将整个AIX 7.1版和 5300-11 建议维护软件包下载到/tmp/lppsrc/5311目录中、 过滤任何已包含在/lppsrc 中的更新，键入以下内容：
    suma -s "0 23 * * 1" -a RqType=ML -a RqName=5300-11 \
-a DLTarget=/tmp/lppsrc/5311 -a FilterDir=/lppsrc -a FilterSysFile=/dev/null
    注意：任务成功完成后，该任务将被删除，因为RqType=TL是一项 "重复直至找到 "任务。 但是，如果 Repeats=n，那么将只检查 5300-03 TL 一次，并且如果在修订服务器上找不到 TL，那么将删除该任务，因为它已经设置为不重复。
  10. 要立即执行一个任务（此任务将执行预览来检查 SP 是否存在于修订服务器上，如果 SP 尚不存在，那么创建并保存此任务以便日后调用），请输入以下内容：
    suma -x -w -a Action=Preview -a RqType=SP -a RqName=6100-04-02
    注: 将为此新创建的任务返回任务标识。
  11. 要立即执行以上示例的新建任务（假定已返回任务标识 23），尝试下载 SP 并保存任务标识 23 的 Action=Download 设置，请输入以下内容：
    suma -x -w -a Action=Download 23
    注意：由于该任务是通过命令行运行的，而不是通过 cron 计划的，因此无论是否找到 SP，重复次数字段都会被忽略，该任务也不会被删除。
  12. 安排任务 ID 23 每周重复检查一次特定 SP（例如，每周四a.m 3 点）、 并在其可用时下载，请键入以下内容：
    suma -s "0 3 * * 4" -a Repeats=y 23
    注: 找到 SP 时，将删除此任务。
  13. 要取消任务安排（此操作将从 /var/spool/cron/crontabs 目录中的 crontab 文件除去其调度信息），请输入以下内容：
    suma -u 23
  14. 要删除一个任务（如果存在其调度信息，此操作还将除去此信息），请输入以下内容：
    suma -d 23
  15. 要列出多个 SUMA 任务，其中 4 和 23 表示任务标识，请输入以下内容：
    suma -l 4 23
  16. 要列出所有 SUMA 任务，请输入以下内容：
    suma -l
  17. 创建并计划每月检查的任务（例如，每月 15 日 2:30 a.m。） 查找指定 FilterML 上的最新服务包，并下载任何尚未在 /tmp/latest 版本库中尚未下载的服务包，键入以下内容：
    suma -s "30 2 15 * *" -a RqType=Latest -a FilterML=6100-02 \
-a DLTarget=/tmp/latest -a FilterDir=/tmp/latest
    注: 将为此新创建的任务返回任务标识。

位置

/usr/suma/bin/suma

文件

项 描述
/usr/suma/bin/suma 包含 suma 命令。
/usr/sbin/suma 链接到 /usr/suma/bin/suma。
/var/adm/ras/suma.log 包含运行 suma 命令的详细结果。
/var/adm/ras/suma_dl.log 包含已下载文件的列表。
/var/spool/cron/crontabs 包含要调度的 crontab 文件的目录。