2.5. Subscription Asset Manager: Satellite 5.6 使用状況レポート
spacewalk-reports) があります。
2.5.1. Satellite 統合レポートについて
2.5.1.1. 強化レポーティングの利点
- システム属性、ホスト/ゲストの関係、およびインストール済みの製品に基づいて実際のサブスクリプションの使用状況を決定します。
- 様々な時点におけるサブスクリプションのステータスに基づいて、サブスクリプションの使用状況の 履歴 を追跡します。
重要
2.5.1.2. サブスクリプションステータスにおける Satellite との違い
2.5.1.3. Satellite 5.6 から Subscription Asset Manager へデータを同期
- ホスト名、ソケット数、ホスト/ゲストの関係、その他の関連する属性を含むシステム情報 (Subscription Asset Manager ではシステムファクトと呼ばれる)
- Satellite の組織および関連するサブスクリプション
- Satellite 管理者および組織管理者などのロールおよび管理者アカウントを含むユーザー情報
- Satellite のクローンされたチャンネルおよび関連するオリジナルのチャンネル
spacewalk-splice-checkin プロセスを使用して、spacewalk-reports レポートとしてインベントリー情報が Satellite から引き出されます。続いて、情報は Subscription Asset Manager サーバーへ送信されます。デフォルトにより、この同期の手順は 4 時間ごとに実行されます。

図25 Satellite 5.6 から Subscription Asset Manager への同期

図26 Subscription Asset Manager からレポーティングサーバーへの同期
2.5.1.4. Satellite 5.6 および Subscription Asset Manager のユーザー
注記
2.5.2. 前提条件
- Satellite レポーティングに特定した専用の Subscription Asset Manager インスタンス
警告
強化レポーティングに使用される Subscription Asset Manager インスタンスは、Satellite のレポーティングサーバーとして のみ 使用できます。システムを管理する通常の Subscription Asset Manager インスタンスとして使用することはできず、使用するとデータが失われることがあります。 crondサービスが実行中であること- レポーティングデータベースジャーナル用として、追加の 4 GB ディスク領域が利用可能であること
- レポーティングサーバーの追加パッケージ
- Splice
- ruby193-rubygem-splice_reports
- spacewalk-splice-tool
2.5.3. レポーティングの設定
- 追加パッケージを含む Subscription Asset Manager をインストールします。
- ホストシステムを登録します。
--autoattachオプションを使用して、オペレーティングシステムに必要なサブスクリプションを直ちにアタッチします。[root@server ~]# subscription-manager register --autoattach Username: jsmith@example.com Password:
- 更新したコンテンツリポジトリーをシステム設定に追加するには数分かかります。
[rhel-6-server-sam-rpms]リポジトリーを有効にします。[root@server ~]# yum-config-manager --enable rhel-6-server-sam-rpms Loaded plugins: product-id, refresh-packagekit ========================= repo: rhel-6-server-sam-rpms ========================= [rhel-6-server-sam-rpms] bandwidth = 0 base_persistdir = /var/lib/yum/repos/x86_64/6Server baseurl = https://cdn.redhat.com/content/dist/rhel/server/6/6Server/x86_64/subscription-asset-manager/1/os cache = 0 cachedir = /var/cache/yum/x86_64/6Server/rhel-6-server-sam-rpms cost = 1000 enabled = 1 enablegroups = True exclude = failovermethod = priority ...
yum installを使用してkatello-headpin-allパッケージをインストールします。[root@server ~]# yum install -y katello-headpin-all splice ruby193-rubygem-splice_reports spacewalk-splice-tool
--enhanced_reportingオプションを使用することで、ISO イメージからインストールする際にも実行できます。[root@server cdrom]# ./install_packages --enhanced_reporting
- レポーティングのデータベースは MongoDB データベースです。自動的に起動するようにシステム上で Mongo サービスを設定し、続いてサービスを起動します。
[root@sam-server ~]# chkconfig mongod on [root@sam-server ~]# service mongod start
- 設定スクリプトを実行し、Subscription Asset Manager サーバー、デフォルトの管理者ユーザー、および最初の組織を設定します。
[root@server ~]# katello-configure --deployment=sam --org=Example_Org --user-name=samadmin --user-pass=secret
Subscription Asset Manager 管理者ユーザーと Satellite 5.6 管理者ユーザーは、同一ではありません。 - Subscription Asset Manager マシン上で SSH キーを作成し、Satellite 5.6 マシンの認証用に使用します。
[root@sam-server ~]# su - splice -s /bin/sh -c 'ssh-keygen -t rsa -f /var/lib/splice/id_rsa-sat -N ""' Generating public/private rsa key pair. Your identification has been saved in /var/lib/splice/id_rsa-sat. Your public key has been saved in /var/lib/splice/id_rsa-sat.pub. The key fingerprint is: 78:fa:c9:68:71:a2:a7:c1:ec:35:e3:43:ce:27:b7:d8 splice@dhcp129-162.rdu.redhat.com The key's randomart image is: +--[ RSA 1024]----+ | | | | | | | . | | . S | | o +o. | | +==+ | | ..+BOo. | | o++=E. | +-----------------+
- Satellite 5.6 マシンへ切り替えます。
- 必須の Satellite レポートを実行し、Subscription Asset Manager サーバーに送信できる新規ユーザーを作成します。
[root@sat-server ~]# useradd swreport
- Subscription Asset Manager マシン上で作成されたキーファイルを、Satellite 5.6 マシン上の
swreportユーザー向けにauthorized_keysファイルに追加します。command=オプションにより、swreportユーザーは、システム上で Satellite レポートのみを実行するよう限定されます。[root@sat-server ~]# vim /home/swreport/.ssh/authorized_keys command="/usr/bin/spacewalk-report $SSH_ORIGINAL_COMMAND" \ ssh-rsa key_hash swreport@sat-server
commandディレクティブはすべて、キーファイルの 1 つの行になければなりません。 .sshディレクトリーおよびauthorized_keysファイルで、適切なパーミッションを設定します。[root@sat-server ~]# chown -R swreport:swreport /home/swreport/.ssh [root@sat-server ~]# chmod 700 /home/swreport/.ssh [root@sat-server ~]# chmod 600 /home/swreport/.ssh/authorized_keys
- データベースに接続できるように、
swreportsユーザーをapacheシステムグループに追加します。[root@sat-server ~]# gpasswd -a swreport apache
- Subscription Asset Manager マシンへ戻ります。
- レポーティングサービスユーザー (
splice) に切り替え、ユーザーがswreportキーを使用して Satellite マシンに SSH 接続できるかテストします。[root@sam-server ~]# su - splice -s /bin/bash [splice@sam-server ~]$ ssh -i /var/lib/splice/id_rsa-sat swreport@sat-server.example.com splice-export
プロンプトが表示されたら、キーフィンガープリントを受け入れます。 - Satellite 5.6 サーバーを認識するように、レポーティング設定を編集します。
[root@sam-server ~]# vim /etc/splice/checkin.conf [spacewalk] host=sat-server.example.com ssh_key_path=/var/lib/splice/id_rsa-sat login=swreport
- Subscription Asset Manager のセットアップ時に設定された Subscription Asset Manager の管理者パスワードを使用するよう、レポーティング設定を編集します。
admin-pass=secret
- Subscription Asset Manager サーバー上で、Satellite 5.6 のデータを Subscription Asset Manager のデータベースに取り込むよう、同期ユーティリティーを実行します。
[root@sam-server ~]# su - splice -s /bin/bash [splice@sam-server ~]$ spacewalk-splice-checkin
注記
初回の同期操作での実行には、長時間かかる可能性があります。ツールのパフォーマンスを改善するには、spacewalk-splice-toolプロセスで使用するスレッド数を設定します。使用頻度の少ないシステムでは、コア数 2 つに対してスレッド 1 つ、使用頻度の多いシステムでは、コア数 3 つに対してスレッド 1 つでなければなりません。以下に例を示します。[root@sam-server]# /etc/splice/checkin.conf num-threads=3
- カスタマーポータルで Satellite 5.6 マニフェストを取得します。
- カスタマーポータルにログインします。
- サブスクリプション タブを展開し、サブスクリプション管理 > サブスクリプション管理アプリケーション 項目を選択します。

- Satellite タブを開きます。
- ポータルエントリーがまだない場合は、Satellite 5.6 エントリーを作成し、必要なサブスクリプションをアタッチします。
- Satellite タブで Satellite の登録 リンクをクリックします。

- Satellite 5.6 インスタンスについて以下の必要な情報を入力します。
- Satellite サーバーエントリーの名前
- Satellite インスタンスのバージョンは 5.6 であること

- 登録 ボタンをクリックします。
- Satellite 5.6 サーバーの サブスクリプション タブで、追加するサブスクリプションを 利用可能なサブスクリプション エリアから選択します。
選択した製品ごとに適切なサブスクリプション数を設定してください。数量は、子組織が利用できる、そのタイプのサブスクリプションの合計数です。 - 下にスクロールして、ウィンドウ下部にある をクリックします。サブスクリプションをアタッチすると、自動的に子組織のマニフェストが更新されます。
- Satellite 5.6 サーバーのエントリーページで、 ボタンをクリックし、アーカイブファイルを保存します。

- Satellite の管理者として Subscription Asset Manager UI (
https://sam-hostname/sam) にログインし、適切な Satellite 5.6 の組織に切り替えます。 - サブスクリプション > サブスクリプション タブを開き、マニフェストのインポート リンクをクリックします。

- インポートタブの中央にあるブラウズをクリックし、保存したマニフェストファイルへ移動します。
- ボタンをクリックします。
2.5.4. レポートの実行および結果
- レポートの確認が必要な組織
- 含む必要があるサブスクリプションステータス
- 確認が必要な日付範囲。日付範囲は、特定範囲内 にステータスがあったシステムを探します。これは、必ずしもシステムの現在のステータスとは限りません。
注記
2.5.4.1. レポートフィルターの作成
- 管理メニューの レポート 項目をクリックします。

- 左側の列で 新規フィルター リンクをクリックします。
- 組織、ステータス、日付範囲、およびアクティブな状態など、レポートに必要な情報を入力します。

- ボタンをクリックします。
2.5.4.2. レポートの実行
- 管理メニューの レポート 項目をクリックします。
- 左側の列で、レポートフィルターの名前をクリックして実行します。
- レポートページの下部にスクロールし、 ボタンをクリックします。
別の方法として、レポートの結果を CSV ファイルにエクスポートすることができます。データをエクスポートするには、 ボタンをクリックします。データは CSV ファイルにエクスポートされます。オプションで、システムの詳細を含む JSON ファイルにもエクスポートされます。これらのファイルは、report-YEAR-MONTH-DAY-TIMESTAMPZ.zipという名称の ZIP アーカイブに格納されます。注記
暗号化エクスポート のチェックボックスを選択すると、エクスポートされた CSV および JSON ファイルが暗号化され、アクセスできるのは Red Hat サポートが使用するプライベートキーだけとなります。
2.5.4.3. Subscription Asset Manager レポートの結果およびデータ

図27 レポートの結果

図28 レポートの結果: システムの詳細
注記
_id, record, CHECK-IN TIME, STATUS, DB ID, SATELLITE SERVER, HOSTNAME, ORGANIZATION, LIFECYCLE STATE,
{"ident"=>"072c8bdd-ca00-43d4-a000-0887c75b90c8"}, 522e0970af5d242094000002, 2013-09-09T14:23:27Z, "Current", "072c8bdd-ca00-43d4-a000-0887c75b90c8", "sam-server.example.com", "server.example.com", "ACME_Corporation", "Active",[{"_id":{"$oid":"522e0970af5d242094000002"},"_types":["MarketingProductUsage"],"instance_identifier":"072c8bdd-ca00-43d4-a000-0887c75b90c8","updated":"2013-09-09T17:46:24Z","splice_server":"sam13-dlackey-demo","name":"server.example.com","facts":{"memory_dot_memtotal":"3780964", ...2.5.5. 強化レポートのトラブルシューティング
2.5.5.1. 強化レポーティングのログ
デフォルトにより、強化レポーティングはシステム上で最大 200 MB の追加的なログ領域を必要とします。ログ領域は、システムごとに毎月約 750 KB 増加します。
/etc/splice/logging/basic.cfg のログ設定ファイルで編集できます。
同期ツールのエラー、メッセージ、および操作はすべて、特定のツールログで /var/log/splice/spacewalk_splice_tool.log に記録されます。
2.5.5.2. 一般的な問題
- 問: レポートにシステムが表示されないのはなぜですか?
- 問: すべてのシステムが無効としてマークされるのはなぜですか?
- 問: Subscription Asset Manager で、システムまたは Satellite サーバーのサブスクリプションを更新しましたが、その変更がレポートに反映されません。
- 問: レポート結果の Satellite 5.6 UI へのリンクが、HTTP 404 エラーを返します。
- Satellite サーバーから情報を取得できていない。
- Subscription Asset Manager からレポーティングデータベースへの情報送信が適切に行われていない。
- 情報がデータベースに適切に保存されていない。
- Subscription Asset Manager に保存されている情報が古い。
/var/log/splice/spacewalk_splice_tool.log) の履歴で、同期スクリプトが実行していることを確認します。
[root@sam-server ~]# service mongod status [root@sam-server ~]# telnet localhost 27017
[root@sam-server ~]# mongo checkin_service --eval "printjson(db.marketing_product_usage.count())"
[root@sam-server ~]# /usr/bin/splice-debug
/tmp ディレクトリー名 splice-debug-YYYY-MM-DD-TIME のファイル (例: /tmp/splice-debug-2013-06-14-T15-22-19) にデータをエクスポートします。
[root@sam-server ~]# su - splice -s /bin/bash [splice@sam-server ~]$ spacewalk-splice-checkin
rhn-search プロセスが実行していることを確認します。
2.5.5.3. その他の既知の問題
強化レポーティングに使用される Subscription Asset Manager インスタンスに Satellite 以外の組織が追加された場合は、その組織が、同期プロセス時に Subscription Asset Manager データベースで上書きまたは削除される場合があります。
警告

Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.