9.3.7 エージェントのプロパティを一括配布する
エージェントのプロパティは,同一プロダクト名とデータモデルバージョンのサービスに対して一括配布できます。これによって,次のような利点があります。
- 同じ種類のエージェントを管理するとき,同じ設定を一括で定義できます。
- 新しいエージェントを追加するとき,ほかのエージェントと同じ設定ができます。
次の表に示すノードのプロパティを一括配布できます。
表9-5 プロパティの一括配布で参照・選択可能なノード一覧
サービス | ノード名 | 説明 |
---|
Agent Collector | Detail Records | パフォーマンスデータの記録方法を設定するプロパティのノードです。詳細については,「10. 稼働監視データの管理」を参照してください。 |
Interval Records |
Log Records |
Restart Configurations | PFMサービス自動再起動の設定をするプロパティです。PFMサービス自動再起動については,「19.4 PFMサービス自動再起動機能によるPFMサービスの再起動」を参照してください。 |
ノード数が増減するプロパティ※1 | ノード数が増減するプロパティのノードです。エージェントによって一括配布できるプロパティは異なります。詳細については,各PFM - Agentのマニュアルの付録を参照してください。 |
Agent Store※2 | Retention | パフォーマンスデータの保存方法を設定するプロパティのノードです。詳細については,「10. 稼働監視データの管理」を参照してください。 |
RetentionEx |
Disk Usage |
Configuration |
- 注※1
- ノード数が増減するプロパティの一括配布は,PFM - ManagerおよびPFM - Web Consoleが08-11以降である必要があります。
- 注※2
- Agent Storeのプロパティは,プロパティの配布元と配布先のAgent StoreのバージョンとStoreデータベースのStoreバージョンによって配布可否が異なります。詳細については,「(2) Agent Storeのバージョンによるプロパティの配布可否」を参照してください。
- <この項の構成>
- (1) エージェントのプロパティの配布手順
- (2) Agent Storeのバージョンによるプロパティの配布可否
- (3) ノード数が増減するプロパティの一括配布
(1) エージェントのプロパティの配布手順
エージェントのプロパティを一括配布する手順を次に示します。
- 監視コンソールのブラウザーからPFM - Web Consoleにログインする。
管理ユーザー権限を持つユーザーアカウントでログインします。
PFM - Web Consoleの[メイン]画面が表示されます。[サービス階層]画面での操作には,管理ユーザー権限が必要です。
- [メイン]画面のナビゲーションフレームで,[サービス階層]タブを選択する。
[サービス階層]画面が表示されます。
- [サービス階層]画面のナビゲーションフレームで,「Machines」フォルダの下位の階層を展開する。
Performance Managementのサービスがインストールされているホストの名前が付いたフォルダが表示されます。また,ホスト名が付いたフォルダを展開すると,そのホストにインストールされているサービスが表示されます。各サービスの名前は,サービスIDで表示されます。
- 配布元とするAgent StoreサービスまたはAgent Collectorサービスが動作するホストのフォルダの下位にある階層を展開し,配布元とするAgent StoreサービスまたはAgent Collectorサービスを選択する。
Agent Storeサービスは,先頭文字が「P」以外で2文字目が「S」であるサービスを選択します(「PS」で始まるサービスIDはMaster Storeサービスを示します)。Agent Collectorサービスは,先頭文字が「P」以外で2文字目が「A」であるサービスを選択します。
サービスIDの詳細については,「付録B.1 (1) サービスID」および各PFM - Agentのマニュアルに記載されている識別子一覧を参照してください。
選択したAgent StoreサービスまたはAgent Collectorサービスにチェックマークが表示されます。
- メソッドフレームの[プロパティの配布]メソッドを選択する。
サービス選択画面に遷移し,配布先として選択できるサービスが表示されます。配布先サービスには配布元サービスと同じプロダクト,かつ同じデータモデルバージョンのサービスが一覧表示されます。
- 配布先サービスを選択する。
配布先サービスの選択例を次に示します。
図9-10 配布先サービスの選択例
![[図データ]](figure/zu110145.gif)
- [次へ]ボタンをクリックする。
[プロパティ選択]画面が表示され,配布先へ配布できるプロパティ一覧と選択するためのチェックボックスが表示されます。
- 配布対象のプロパティを選択する。
ツリーでノードを選択すると,インフォメーションフレームの下部に選択できるプロパティが表示されます。
[全選択]ボタンをクリックすると,すべてのプロパティを選択できます。また,[全解除]ボタンをクリックすると,選択されているプロパティをすべて解除できます。
配布先サービスを選択し直したいときは,[プロパティ選択]画面の[戻る]ボタンをクリックしてください。手順6.の[サービス選択]画面に戻ります。
プロパティの配布の設定例を次に示します。
図9-11 プロパティの配布の設定例
![[図データ]](figure/zu110141.gif)
- [完了]ボタンをクリックする。
一括配布の処理が開始し,[プロパティの配布 > 進捗表示]画面に遷移します。
一括配布が完了したサービスの「プロパティ配布」欄には「OK」が表示されます。
すべてのサービスの一括配布が完了すると,[OK]ボタンが活性化します。
- [OK]ボタンをクリックする。
インフォメーションフレームがクリアされます。
- 参考
- 手順8.で配布対象のプロパティを選択するたびに[完了]ボタンをクリックしなくても,配布対象のプロパティは複数回選択できます。必要に応じて,ツリーでノードを選択し,配布したいプロパティを選択する操作を繰り返し行ったあと,[完了]ボタンをクリックしてください。
(2) Agent Storeのバージョンによるプロパティの配布可否
プロパティの配布元と配布先のAgent StoreのバージョンとStoreデータベースのStoreバージョンによって配布可否が異なります。Agent Storeのバージョンによるプロパティの配布可否を次の表に示します。
表9-6 Agent Storeのバージョンによるプロパティの配布可否
配布元Agent Store | 配布先Agent 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) ノード数が増減するプロパティの一括配布による運用
ノード数が増減するプロパティの一括配布を利用することで,次のような運用ができます。
- 新規システム構築時,全エージェントを同じ設定にする
- システム運用中,全エージェントを同じ設定にする
- システム運用中,複数のエージェントで特定のプロパティを更新する
- システム運用中,複数のエージェントでノードを追加する
- システム運用中,複数のエージェントでノードを削除する
一つのエージェントで,ノードを追加,削除したり,プロパティを設定したりしたあと,そのエージェントを配布元としてプロパティの一括配布を行うことで,ツリー構造を含めたプロパティの設定を配布元と配布先で一致させます。
ここでは,プロパティを一括配布するときの設定例について説明します。
なお,一つのエージェントについて,ノードを追加したり削除したりする操作については,各PFM - Agentのマニュアルを参照してください。また,一括配布の手順については,「(b) ノード数が増減するプロパティの一括配布手順」を参照してください。
- 新規システム構築時,全エージェントを同じ設定にする
- プロパティの一括配布で,次の図のように,すべてのノードに対して「追加」の操作を選択します。
![[図データ]](figure/zu093702.gif)
- 配布先エージェントにノードが追加され,ツリー構造が配布元エージェントと同じになります。また,プロパティの値はすべて配布元エージェントの設定値と同じになります。
- システム運用中,全エージェントを同じ設定にする
- プロパティの一括配布で,次の図のように,すべてのノードに対して「追加」の操作を選択します。また,「配布先にのみ存在するノードは削除する」チェックボックスを選択します。
![[図データ]](figure/zu093704.gif)
- 配布先エージェントに存在しなかったノードは追加されます。追加されたノードのプロパティはすべて配布元エージェントの設定値と同じになります。配布先エージェントに存在していたノードは,プロパティがすべて配布元エージェントの設定値と同じになります。配布先エージェントだけに存在するノードは削除されます。
- このため,配布先エージェントのツリー構造が配布元エージェントと同じになります。
- システム運用中,複数のエージェントで特定のプロパティの値を更新する
- プロパティの一括配布で,次の図のように,更新するプロパティがあるノードに対して「更新」の操作を選択します。
![[図データ]](figure/zu093706.gif)
- また,更新するプロパティで「適用」を選択します。
![[図データ]](figure/zu093708.gif)
- 「更新」の操作では,「適用」チェックボックスを選択したプロパティの値だけが更新されます。
- システム運用中,複数のエージェントでノードを追加する
- プロパティの一括配布で,次の図のように,追加するノードに対して「追加」の操作を選択します。
![[図データ]](figure/zu093710.gif)
- 配布先エージェントにノードが追加され,ツリー構造が配布元エージェントと同じになります。また,追加されたノードのプロパティはすべて配布元エージェントの設定値と同じになります。
- なお,配布先エージェントに存在するノードに対して「追加」の操作を選択して一括配布を行った場合,そのノードのプロパティの値は,「適用」チェックボックスの状態に関係なくすべて上書きされます。
- システム運用中,複数のエージェントでノードを削除する
- プロパティの一括配布で,次の図のように,削除するノードに対して「削除」の操作を選択します。
![[図データ]](figure/zu093712.gif)
- 「削除」を選択したノードが配布先エージェントに存在する場合,そのノードは削除されます。
- ポイント
- 「削除」の操作では配布元エージェントのノードは削除されません。このため,一括配布後は配布元エージェントと配布先エージェントでツリーの構造が異なります。
(b) ノード数が増減するプロパティの一括配布手順
ノード数が増減するプロパティを一括配布する手順を次に示します。ここでは,PFM - Agent for Platformのバージョン08-10以降で使用できるApplication monitoring setting配下のツリーの構造を配布する例を取り上げます。なお,この例では,配布元エージェントのプロパティの設定が完了しているものとして説明します。
- 監視コンソールのブラウザーからPFM - Web Consoleにログインする。
管理ユーザー権限を持つユーザーアカウントでログインします。
PFM - Web Consoleの[メイン]画面が表示されます。[サービス階層]画面での操作には,管理ユーザー権限が必要です。
- [メイン]画面のナビゲーションフレームで,[サービス階層]タブを選択する。
[サービス階層]画面が表示されます。
- [サービス階層]画面のナビゲーションフレームで,「Machines」フォルダの下位の階層を展開する。
Performance Managementのサービスがインストールされているホストの名前が付いたフォルダが表示されます。また,ホスト名が付いたフォルダを展開すると,そのホストにインストールされているサービスが表示されます。各サービスの名前は,サービスIDで表示されます。
- 配布元とするAgent StoreサービスまたはAgent Collectorサービスが動作するホストのフォルダの下位にある階層を展開し,配布元とするAgent StoreサービスまたはAgent Collectorサービスを選択する。
ここでは,PFM - Agent for PlatformのApplication monitoring settingを配布するため,「TA」から始まるAgent Collectorサービスを選択します。
サービスIDの詳細については,「付録B.1 (1) サービスID」および各PFM - Agentのマニュアルに記載されている識別子一覧を参照してください。
選択したAgent Collectorサービスにチェックマークが表示されます。
- メソッドフレームの[プロパティの配布]メソッドを選択する。
サービス選択画面に遷移し,配布先として選択できるサービスが表示されます。配布先サービスには配布元サービスと同じプロダクト,かつ同じデータモデルバージョンのサービスが一覧表示されます。
- 配布先サービスを選択し,[次へ]ボタンをクリックする。
[プロパティ選択]画面が表示されます。
- インフォメーションフレームのツリーで「Application monitoring setting」を選択する。
インフォメーションフレームの下部にApplication monitoring setting配下のノード一覧が表示されます。
- 各ノードに対して「更新」,「追加」または「削除」を選択する。
「更新」を選択した場合に対象になるノードを次に示します。
![[図データ]](figure/zu093714.gif)
「更新」の操作では,手順10.で「適用」チェックボックスを選択したプロパティの値だけが更新されます。
「追加」を選択した場合に対象になるノードを次に示します。
![[図データ]](figure/zu093716.gif)
配布先エージェントに存在するノードに対して「追加」の操作を選択して一括配布を行った場合,そのノードのプロパティの値は,「適用」チェックボックスの状態に関係なくすべて上書きされます。
「削除」を選択した場合に削除対象となるノードを次に示します。
![[図データ]](figure/zu093718.gif)
- ポイント
- 「削除」の操作では配布元エージェントのノードは削除されません。このため,一括配布後は配布元エージェントと配布先エージェントでツリーの構造が異なります。
- 配布先エージェントにだけ存在し,配布元エージェントに存在しないノードを削除する場合,「配布先にのみ存在するノードを削除する」チェックボックスを選択する。
「配布先にのみ存在するノードを削除する」チェックボックスを選択した場合に削除対象となるノードを次に示します。
![[図データ]](figure/zu093720.gif)
- 手順8で「更新」を選択したノードについて,値を更新するプロパティを選択する。
ノードをツリーで選択すると,プロパティの一覧が表示されます。
「更新」を選択したノードのプロパティは,一覧にある「適用」チェックボックスでの設定状態に応じて一括配布されます。
[全選択]ボタンをクリックすると,すべてのプロパティを選択できます。また,[全解除]ボタンをクリックすると,選択されているプロパティをすべて解除できます。
- [完了]ボタンをクリックする。
配布するノード,プロパティを選択したあと,[完了]ボタンをクリックすることで,一括配布の処理が開始し,[プロパティの配布 > 進捗表示]画面に遷移します。
一括配布が完了したサービスの「プロパティ配布」欄には「OK」が表示されます。
すべてのサービスの一括配布が完了すると,[OK]ボタンが活性化します。
- [OK]ボタンをクリックする。
インフォメーションフレームがクリアされます。