第10章 insights-client のコマンドオプション

insights-client コマンドとそのオプションを使用して、システムで Insights クライアント操作を制御できます。insights-client.rpm は Insights の個々のコンポーネントよりも頻繁に更新されるため、man ページには insights-client コマンド操作に関する最新情報が含まれていない可能性があります。

root 権限を持つシステム管理者は、クライアントがデータを収集し、insights-client コマンドを入力する度にデータを収集し、Red Hat Insights に送信します。

注記

insights-client --display-name コマンドを使用して表示名を設定すると、即座に適用されますが Insights クライアントは実行されません。

表10.1 insights-client ユーザーコマンドのオプション

オプション説明

--help

-h

ヘルプ情報の表示

--register

/etc/hostname に記載の情報を使用して、ホストを Insights に登録します。--disable-schedule が設定されていない限り、自動的に夜間 cron ジョブを有効にします。

--unregister

Insights からホストの登録を解除します。

--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

コンソールにエラーメッセージのみをログに記録します。

--silent

コンソールに何も記録しません。

--enable-schedule

ジョブスケジュールを有効にします。デフォルトでは、Insights クライアントは毎日、または途中で実行されます。

注記: Client 1.x --register を使用している場合は、オプションを使用してスケジュールを有効にします。

--disable-schedule

ジョブスケジュールを無効にします。

--conf=CONF

-c=CONF

デフォルトの /etc/insights-client/insights-client.conf ファイルの代わりにカスタム設定ファイル CONF を使用します。

--compressor

アーカイブの作成時に使用する圧縮を選択します。利用可能なオプションは gz, bz2, xz, none です。デフォルトは gz です。none オプションを指定すると、圧縮なしで tar ファイルを作成します。

--no-upload

クライアントを実行しますが、Red Hat Insights または CMSfR Web アプリケーションにアーカイブをアップロードしません。アーカイブは /var/tmp/ ディレクトリーに保存されます。insights-client ファイルが完了するとファイル名が表示されます。

--offline

ネットワーク機能を使用せずにクライアントを実行します。--no-upload を意味します。

--logging-file=LOGFILE

ログデータを指定の LOGFILE に出力します。デフォルトのログファイルは /var/log/insights-client/insights-client.log です。

--diagnosis

API から診断情報を取得します。--diagnosis を使用する前に、少なくとも 1 回システムを登録してアップロードする必要があります。

--compliance

システムを OpenSCAP でスキャンし、レポートをアップロードします。

--payload=PAYLOAD

特定のアーカイブの PAYLOAD ファイルを Red Hat Insights にアップロードします。--content-type が必要です。

--content-type=TYPE

PAYLOAD ファイルの content-type を設定します。このタイプは gz、bz2、xz、および none です。TYPE は、--compressor PAYLOAD で使用されるものと同じである必要があります。

--check-results

Red Hat Insights から分析結果を取得します。

--show-results

--check-results で取得した分析結果を表示します。

--output-dir=DIR

アップロードするのではなく、指定したディレクトリーにコレクションを書き込みます。

--output-file=FILE

アップロードするのではなく、指定したアーカイブにコレクションを書き込みます。

insights-client コマンドには、操作のデバッグに役立つ複数のオプションがあります。

表10.2 insights-client デバッグオプション

オプション説明

--version

insights-client クライアントおよびコアのバージョンを出力します。

--test-connection

Red Hat Insights サービスへの接続をテストします。

--force-reregister

Insights でシステムを再登録し、新しい ID を使用します。このアクションは、すでに登録済みのシステムを複製するものです。

--verbose

コンソールへのデバッグ出力をすべてログに記録します。

--no-upload

クライアントを実行しますが、アーカイブをアップロードしません。アーカイブは /var/tmp/ ディレクトリーに保存されます。insights-client ファイルが完了するとファイル名が表示されます。

--keep-archive

アップロード後にアーカイブを保持します。

--support

サポート用の診断ログを生成します。

--status

ホスト登録の状態を表示します。

--net-debug

コンソールへのネットワーク呼び出しをログに記録します。