附录 A. insights-client的命令选项

作为具有 root 特权的系统管理员,您可以使用 insights-client 命令及其选项来控制系统上的 Insights 客户端操作。因为 insights-client.rpm 的更新频率比 Insights for Red Hat Enterprise Linux 中的独立组件更新,所以手册页可能不包括 insights-client 的最新信息。

每次输入 insights-client 命令时,客户端都会收集数据并将其发送到 Insights for Red Hat Enterprise Linux。

注意

使用 insights-client --display-name 命令设置显示名称可立即生效,但不运行 Insights 客户端。

A.1. Insights 客户端的选项

表 A.1. insights-client user 命令选项

选项描述

--help

-h

显示帮助信息

--register

使用 /etc/hostname 中的信息,将主机注册到 Red Hat Enterprise Linux。将自动启用每日 cron 任务,除非设置了 --disable-schedule

--unregister

从 Insights for Red Hat Enterprise Linux 中取消注册主机。

--display-name=DISPLAY_NAME

在 GUI 中设置或更改主机显示名称。如果您希望一个与 /etc/hostname 不同的名称不同,则与 --register 一起使用在注册主机时设置 display_name。

--group=GROUP

在注册期间将主机添加到 GROUP。组名称在 /etc/insights-client/tags.yaml中定义

--retry=RETRIES

设置重试上传的次数。默认值为 1。重试间隔为 180 秒,这是 Insights 客户端在重试上传前等待的时间。

注意:在调度程序中,重试次数为 3。

--validate

验证 /etc/insights-client/remove.conf 文件的结构。

--quiet

仅将错误消息记录到 console。

--silent

不记录控制台。

--enable-schedule

启用作业调度。默认情况下,Insights 客户端每天、或接近午夜运行。

注意:如果您使用 Client 1.x,请使用 --register 选项启用调度。

--disable-schedule

禁用每日作业调度。

--conf=CONF

-c=CONF

使用自定义配置文件 CONF,而不是默认的 /etc/insights-client/insights-client.conf 文件。

--compressor

选择创建存档时使用的压缩器。可用选项包括 gz、bz2、xz、none。默认为 gznone 选项会创建一个没有压缩的 tar 文件。

--no-upload

运行客户端,但不会将存档上传到 Red Hat Insights for Red Hat Enterprise Linux 或 CMSfR web 应用程序。归档存储在 /var/tmp/ 目录中。insights-client 完成后会显示文件名。

--offline

在不使用网络功能的情况下运行客户端。表示 --no-upload

--logging-file=LOGFILE

将日志数据输出到指定的 LOGFILE。默认日志文件为 /var/log/insights-client/insights-client.log

--diagnosis

从 API 获取诊断信息。在使用 --diagnosis 之前,必须注册并至少上传一次系统。

--compliance

使用 OpenSCAP 扫描系统并上传报告。

--payload=PAYLOAD

将特定的存档 PAYLOAD 文件上传到 Red Hat Insights for Red Hat Enterprise Linux。需要 --content-type

--content-type=TYPE

为 PAYLOAD 文件设置 content-type。type 可以是 gz、bz2、xz 和 none。TYPE 必须与用于 PAYLOAD 的 --compressor 匹配。

--check-results

从 Red Hat Insights for Red Hat Enterprise Linux 检索分析结果。

--show-results

显示 --check-results 获取的分析结果。

--output-dir=DIR

将集合写入指定的目录,而不是上传。

--output-file=FILE

将集合写入指定的存档,而不是上传。

insights-client 命令有几个在调试其操作时有用的选项。

表 A.2. insights-client 调试选项

选项描述

--version

输出 insights-client 客户端和 Core 的版本。

--test-connection

测试到 Red Hat Insights for Red Hat Enterprise Linux 服务的连接。

--force-reregister

这个选项已弃用。要重新注册您的系统,请参阅使用 Red Hat Insights 重新注册您的系统

--verbose

将所有调试输出记录到控制台。

--no-upload

运行客户端,但不会上传存档。归档存储在 /var/tmp/ 目录中。insights-client 完成后会显示文件名。

--keep-archive

上传后保留存档。

--support

为支持生成诊断日志。

--status

显示主机注册状态。

--net-debug

记录对控制台的网络调用。