3.4.8　エージェントのプロパティを一括配布する

エージェントのプロパティは，同一プロダクト名とデータモデルバージョンのサービスに対して一括配布できます。これによって，次のような利点があります。

同じ種類のエージェントを管理するとき，同じ設定を一括で定義できます。
新しいエージェントを追加するとき，ほかのエージェントと同じ設定ができます。

次の表に示すノードのプロパティを一括配布できます。

表3‒10　プロパティの一括配布で参照・選択できるノード一覧
サービス	ノード名	説明
Agent CollectorおよびRemote Monitor Collector	JP1 Event Configurations	JP1イベントの発行条件を設定するプロパティのノードです。詳細については，「12.　統合管理製品（JP1/IM）と連携した稼働監視」を参照してください。
	Detail Records	パフォーマンスデータの記録方法を設定するプロパティのノードです。詳細については，「4.　稼働監視データの管理」を参照してください。
	Interval Records
	Log Records
	Restart Configurations	PFMサービス自動再起動を設定するプロパティです。PFMサービス自動再起動については，「16.4　PFMサービス自動再起動機能によるPFMサービスの再起動」を参照してください。
	ノード数が増減するプロパティ^※1	ノード数が増減するプロパティのノードです。エージェントによって一括配布できるプロパティは異なります。詳細については，各PFM - AgentまたはPFM - RMマニュアルの付録を参照してください。
Agent StoreおよびRemote Monitor Store^※2	Retention	パフォーマンスデータの保存方法を設定するプロパティのノードです。詳細については，「4.　稼働監視データの管理」を参照してください。
	RetentionEx
	Disk Usage
	Configuration
リモートエージェントおよびグループエージェント	Detail Records^※3	パフォーマンスデータの記録方法を設定するプロパティのノードです。詳細については，「4.　稼働監視データの管理」を参照してください。
	Interval Records^※3
	Log Records^※3

注※1: ノード数が増減するプロパティの一括配布は，PFM - ManagerおよびPFM - Web Consoleが08-11以降である必要があります。
注※2: Agent StoreおよびRemote Monitor Storeのプロパティは，プロパティの配布元と配布先のAgent StoreおよびRemote Monitor StoreのバージョンとStoreデータベースのStoreバージョンによって配布可否が異なります。詳細については，「3.4.8(2)　Agent StoreおよびRemote Monitor Storeのバージョンによるプロパティの配布可否」を参照してください。
注※3: 「Log」プロパティだけ配布できます。

なお，Remote Monitor Collectorサービスと，リモートエージェントおよびグループエージェントとの間ではプロパティを配布できません。

〈この項の構成〉

(1)　エージェントのプロパティの配布手順
(2)　Agent StoreおよびRemote Monitor Storeのバージョンによるプロパティの配布可否
(3)　ノード数が増減するプロパティの一括配布

(1)　エージェントのプロパティの配布手順

監視コンソールのWebブラウザからPFM - Web Consoleにログインする。

管理ユーザー権限を持つユーザーアカウントでログインします。［サービス階層］画面での操作には，管理ユーザー権限が必要です。
［メイン］画面のナビゲーションフレームで，［サービス階層］タブを選択する。
［サービス階層］画面のナビゲーションフレームで，「Machines」フォルダの下位の階層を展開する。

Performance Managementのサービスがインストールされているホストの名前が付いたフォルダが表示されます。また，ホスト名が付いたフォルダを展開すると，そのホストにインストールされているサービスが表示されます。

各サービスの名前は，サービスIDで表示されます。サービスIDの詳細については，マニュアル「JP1/Performance Management 設計・構築ガイド」の付録の，サービスの命名規則について説明している個所，および各PFM - AgentまたはPFM - RMマニュアルに記載されている識別子一覧を参照してください。

サービスIDの形式は，プロダクト名表示機能が有効か無効かによって異なります。プロダクト名表示機能の詳細については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，Performance Managementの機能について説明している章を参照してください。
配布元とするエージェントのノードを選択する。

配布元ノードとして選択できるサービスを次に示します。
- Agent CollectorおよびRemote Monitor Collectorサービス
- Agent StoreおよびRemote Monitor Storeサービス
- リモートエージェント
- グループエージェント
選択したノードにチェックマークが表示されます。
メソッドフレームの［プロパティの配布］メソッドを選択する。

［プロパティの配布 > サービス選択］画面に遷移し，配布先として選択できるサービスが表示されます。配布先サービスには配布元サービスと同じプロダクト，かつ同じデータモデルバージョンのサービスが一覧表示されます。
配布先サービスを選択する。

業務グループによるアクセスコントロール機能が有効な場合，配布先サービスを業務グループ単位で絞り込むことができます。

ポイント

サービスを検索する場合は，検索文字列をテキストボックスに入力して［絞込］ボタンをクリックします。
［次へ］ボタンをクリックする。

［プロパティの配布 > プロパティ選択］画面が表示され，配布先のサービスへ配布できるプロパティ一覧と選択するためのチェックボックスが表示されます。
配布対象のプロパティを選択する。

ツリーでノードを選択すると，インフォメーションフレームの下部に選択できるプロパティが表示されます。

［全選択］ボタンをクリックすると，すべてのプロパティを選択できます。また，［全解除］ボタンをクリックすると，すべての選択を解除できます。

配布先サービスを選択し直したいときは，［プロパティの配布 > プロパティ選択］画面の［戻る］ボタンをクリックしてください。手順6の［プロパティの配布 > サービス選択］画面に戻ります。
［完了］ボタンをクリックする。

一括配布の処理が開始し，［プロパティの配布＞進捗表示］画面に遷移します。

一括配布が完了したサービスの［プロパティ配布］欄には「OK」が表示されます。

すべてのサービスの一括配布が完了すると，［OK］ボタンが活性化します。

参考

手順8で配布対象のプロパティを選択するたびに［完了］ボタンをクリックしなくても，配布対象のプロパティは複数回選択できます。必要に応じて，ツリーでノードを選択し，配布したいプロパティを選択する操作を繰り返したあと，［完了］ボタンをクリックしてください。
［OK］ボタンをクリックする。

インフォメーションフレームがクリアされます。

ページの先頭へ

(2)　Agent StoreおよびRemote Monitor Storeのバージョンによるプロパティの配布可否

プロパティの配布元と配布先のAgent StoreおよびRemote Monitor StoreのバージョンとStoreデータベースのStoreバージョンによって配布可否が異なります。

表3‒11　Agent StoreおよびRemote Monitor Storeのバージョンによるプロパティの配布可否
配布元Agent StoreおよびRemote Monitor Store	配布先Agent StoreおよびRemote Monitor Store
配布元Agent StoreおよびRemote Monitor Store	08-00以前	08-10以降かつStoreバージョン2.0	08-10以降かつStoreバージョン1.0
08-00以前	○	×	○
08-10以降かつStoreバージョン2.0	×	○	×
08-10以降かつStoreバージョン1.0	○	×	○

（凡例）

○：配布できる

×：配布できない

ページの先頭へ

(3)　ノード数が増減するプロパティの一括配布

ノード数が増減するプロパティには，上位のノードを追加，削除してツリーの構造を変更できるものがあります。例えば，PFM - Agent for PlatformのApplication monitoring setting配下のノードは，追加，削除してツリーの構造を変更できます。

プロパティの一括配布では，このようなノード数が増減するプロパティについて，配布元エージェントと配布先エージェントでツリーの構造が異なる場合でも，プロパティを配布できます。また，配布先エージェントのツリーの構造を配布元エージェントに合わせることもできます。なお，ノード数が増減するプロパティの一括配布は，PFM - ManagerおよびPFM - Web Consoleが08-11以降である必要があります。

(a)　ノード数が増減するプロパティの一括配布による運用

ノード数が増減するプロパティの一括配布を利用することで，次のような運用ができます。

新規システム構築時，全エージェントを同じ設定にする
システム運用中，全エージェントを同じ設定にする
システム運用中，複数のエージェントで特定のプロパティを更新する
システム運用中，複数のエージェントでノードを追加する
システム運用中，複数のエージェントでノードを削除する

1つのエージェントで，ノードを追加，削除したり，プロパティを設定したりしたあと，そのエージェントを配布元としてプロパティの一括配布することで，ツリー構造を含めたプロパティの設定を配布元と配布先で一致させます。

ここでは，プロパティを一括配布するときの設定例について説明します。

なお，1つのエージェントについて，ノードを追加したり削除したりする操作については，各PFM - AgentまたはPFM - RMマニュアルを参照してください。また，一括配布の手順については，「3.4.8(3)(b)　ノード数が増減するプロパティの一括配布手順」を参照してください。

新規システム構築時，全エージェントを同じ設定にする

［プロパティの配布 > プロパティ選択］画面のプロパティ一覧エリアの［操作］で，すべてのノードの［追加］を選択します。

配布先エージェントにノードが追加され，ツリー構造が配布元エージェントと同じになります。また，プロパティの値はすべて配布元エージェントの設定値と同じになります。

システム運用中，全エージェントを同じ設定にする

［プロパティの配布 > プロパティ選択］画面のプロパティ一覧エリアの［操作］で，すべてのノードの［追加］を選択します。また，［配布先にのみ存在するノードは削除する］をチェックします。

配布先エージェントに存在しなかったノードは追加されます。追加されたノードのプロパティはすべて配布元エージェントの設定値と同じになります。配布先エージェントに存在していたノードは，プロパティがすべて配布元エージェントの設定値と同じになります。配布先エージェントだけに存在するノードは削除されます。

このため，配布先エージェントのツリー構造が配布元エージェントと同じになります。

システム運用中，複数のエージェントで特定のプロパティの値を更新する

［プロパティの配布 > プロパティ選択］画面のプロパティ一覧エリアの［操作］で，更新するプロパティがあるノードの［更新］を選択します。

また，更新するプロパティで［適用］を選択します。更新操作では，［適用］をチェックしたプロパティの値だけが更新されます。

システム運用中，複数のエージェントでノードを追加する

［プロパティの配布 > プロパティ選択］画面のプロパティ一覧エリアの［操作］で，追加するノードの［追加］を選択します。

配布先エージェントにノードが追加され，ツリー構造が配布元エージェントと同じになります。また，追加されたノードのプロパティはすべて配布元エージェントの設定値と同じになります。

なお，配布先エージェントに存在するノードに対して［追加］を選択して一括配布をした場合，そのノードのプロパティの値は，［適用］の状態に関係なくすべて上書きされます。

システム運用中，複数のエージェントでノードを削除する

［プロパティの配布 > プロパティ選択］画面のプロパティ一覧エリアの［操作］で，削除するノードの［削除］を選択します。

［削除］を選択したノードが配布先エージェントに存在する場合，そのノードは削除されます。

ポイント: 削除操作では配布元エージェントのノードは削除されません。このため，一括配布後は配布元エージェントと配布先エージェントでツリーの構造が異なります。

(b)　ノード数が増減するプロパティの一括配布手順

ノード数が増減するプロパティを一括配布する手順を次に示します。ここでは，PFM - Agent for Platformのバージョン08-10以降で使用できるApplication monitoring setting配下のツリーの構造を配布する例を取り上げます。なお，この例では，配布元エージェントのプロパティの設定が完了しているものとして説明します。

監視コンソールのWebブラウザからPFM - Web Consoleにログインする。

管理ユーザー権限を持つユーザーアカウントでログインします。

［サービス階層］画面での操作には，管理ユーザー権限が必要です。
［メイン］画面のナビゲーションフレームで，［サービス階層］タブを選択する。
［サービス階層］画面のナビゲーションフレームで，「Machines」フォルダの下位の階層を展開する。

Performance Managementのサービスがインストールされているホストの名前が付いたフォルダが表示されます。また，ホスト名が付いたフォルダを展開すると，そのホストにインストールされているサービスが表示されます。各サービスの名前は，サービスIDで表示されます。
配布元とするエージェントのノードを選択する。

PFM - Agentホストの場合

配布元とするAgent StoreサービスまたはAgent Collectorサービスが動作するホストのフォルダの下位にある階層を展開し，配布元とするAgent StoreサービスまたはAgent Collectorサービスを選択します。

PFM - RM ホストの場合

配布元とするRemote MonitorStoreサービスまたはRemote Monitor Collectorサービスが動作するホストのフォルダの下位にある階層を展開し，配布元とするRemote Monitor StoreサービスまたはRemote Monitor Collectorサービスを選択します。

ここでは，PFM - Agent for PlatformのApplication monitoring settingを配布するため，「TA」から始まるAgent Collectorサービスを選択します。

サービスIDの詳細については，マニュアル「JP1/Performance Management 設計・構築ガイド」の付録の，サービスの命名規則について説明している個所，および各PFM - AgentまたはPFM - RMマニュアルに記載されている識別子一覧を参照してください。

選択したAgent Collectorサービスにチェックマークが表示されます。
メソッドフレームの［プロパティの配布］メソッドを選択する。

［プロパティの配布 > サービス選択］画面に遷移し，配布先として選択できるサービスが表示されます。配布先サービスには配布元サービスと同じプロダクト，かつ同じデータモデルバージョンのサービスが一覧表示されます。
配布先サービスを選択し，［次へ］ボタンをクリックする。
［プロパティの配布 > プロパティ選択］画面でインフォメーションフレームのツリーから「Application monitoring setting」を選択する。
各インフォメーションフレーム下部のプロパティ一覧エリアにApplication monitoring setting配下のノードに対して［更新］，［追加］または［削除］を選択する。

［更新］を選択した場合に対象になるノードを次に示します。

更新操作では，手順10で［適用］を選択したプロパティの値だけが更新されます。

［追加］を選択した場合に対象になるノードを次に示します。

配布先エージェントに存在するノードに対して［追加］を選択して一括配布をした場合，そのノードのプロパティの値は，［適用］の状態に関係なくすべて上書きされます。

［削除］を選択した場合に削除対象となるノードを次に示します。

ポイント

削除操作では配布元エージェントのノードは削除されません。このため，一括配布後は配布元エージェントと配布先エージェントでツリーの構造が異なります。
配布先エージェントにだけあり，配布元エージェントにないノードを削除する場合，［配布先にのみ存在するノードを削除する］をチェックする。

［配布先にのみ存在するノードを削除する］をチェックした場合に削除対象となるノードを次に示します。
手順8で［更新］を選択したノードについて，値を更新するプロパティを選択する。

ノードをツリーで選択すると，プロパティの一覧が表示されます。

［更新］を選択したノードのプロパティは，一覧にある［適用］の設定状態に応じて一括配布されます。

［全選択］ボタンをクリックすると，すべてのプロパティを選択できます。また，［全解除］ボタンをクリックすると，選択されているプロパティをすべて解除できます。
［完了］ボタンをクリックする。

配布するノード，プロパティを選択したあと，［完了］ボタンをクリックすることで，一括配布の処理が開始し，［プロパティの配布＞進捗表示］画面に遷移します。

一括配布が完了したサービスの［プロパティ配布］欄には「OK」が表示されます。

すべてのサービスの一括配布が完了すると，［OK］ボタンが活性化します。
［OK］ボタンをクリックする。

インフォメーションフレームがクリアされます。