JP1/Performance Management - Agent Option for Virtual Machine
ここでは,PFM - Agent for Virtual Machineを運用するための,セットアップについて説明します。なお,セットアップ手順は,監視対象の仮想環境ごとに異なります。仮想環境ごとに必要となるセットアップ項目について次の表に示します。
表2-3 仮想環境ごとに必要となるセットアップ項目
セットアップ項目 VMware Hyper-V Virtage (1) Virtageの設定 × × ○ (2) PFM - Agentの登録 ○ ○ ○ (3) インスタンス環境の設定 ○ ○ ○ (4) 証明書の組み込み ○ × × (5) ネットワークの設定 ○ ○ ○ (6) ログのファイルサイズ変更 ○ ○ ○ (7) パフォーマンスデータの格納先の変更 ○ ○ ○ (8) PFM - Agent for Virtual Machineの接続先PFM - Managerの設定 ○ ○ ○ (9) 動作ログ出力の設定 ○ ○ ○ (10) WMIの設定 × ○ ×
- (凡例)
- ○:セットアップ作業が必要です。
- ×:セットアップ作業は不要です。
,,,は,仮想環境ごとに必要となるセットアップ項目を示します。
また,は使用する環境によって必要になるセットアップ項目,またはデフォルトの設定を変更する場合のオプションのセットアップ項目を示します。
- <この項の構成>
- (1) Virtageの設定
- (2) PFM - Agentの登録
- (3) インスタンス環境の設定
- (4) 証明書の組み込み
- (5) ネットワークの設定
- (6) ログのファイルサイズ変更
- (7) パフォーマンスデータの格納先の変更
- (8) PFM - Agent for Virtual Machineの接続先PFM - Managerの設定
- (9) 動作ログ出力の設定
- (10) WMIの設定
(1) Virtageの設定
監視対象の仮想環境がVirtageの場合,監視エージェントをインストールしたホストとVirtage環境の両方で設定が必要になります。設定手順を次に示します。
- Virtageに同梱されているVirtage管理ツールのHvmShコマンド(HvmSh.exe)を,PFM - Agentホストの次のフォルダ配下にコピーする。
インストール先フォルダ\agt5\plugin\jpcagt5virtage.d\- 監視対象となるVirtage環境で,監視エージェントをインストールしたマシンのIPアドレスを設定する。
詳細については,「2.5.3 Virtageの場合」を参照してください。
PFM - ManagerおよびPFM - Web Consoleを使ってPFM - Agentを一元管理するために,PFM - ManagerおよびPFM - Web ConsoleにPFM - Agent for Virtual Machineを登録する必要があります。
PFM - Agentの登録の流れを次に示します。
図2-4 PFM - Agentの登録の流れ
- 注意
- PFM - Agentの登録は,インスタンス環境を設定する前に実施してください。
- すでにPFM - Agent for Virtual Machineの情報が登録されているPerformance Managementシステムに,新たに同じバージョンのPFM - Agent for Virtual Machineを追加した場合,PFM - Agentの登録は必要ありません。
- バージョンが異なるPFM - Agent for Virtual Machineを,異なるホストにインストールする場合,古いバージョン,新しいバージョンの順でセットアップしてください。
- PFM - Managerと同じホストにPFM - Agentをインストールした場合,jpcconf agent setup(jpcagtsetup)コマンドが自動的に実行されます。共通メッセージログに「KAVE05908-I エージェント追加セットアップは正常に終了しました」と出力されるので,結果を確認してください。コマンドが正しく実行されていない場合は,コマンドを実行し直してください。コマンドの実行方法については,マニュアル「JP1/Performance Management リファレンス」のコマンドの章を参照してください。
- PFM - Agent for Virtual Machineの情報を登録する作業では,PFM - Web Consoleの[レポート階層]タブおよび[アラーム階層]タブに「VirtualMachine」という名前のフォルダが作成されます。[レポート階層]タブで,すでに独自に「VirtualMachine」という名前のフォルダまたはファイルを作成していた場合には,名前を変更してから作業を始めてください。
(a) PFM - Agent for Virtual Machineのセットアップファイルをコピーする
PFM - Agent for Virtual MachineをインストールしたホストにあるセットアップファイルをPFM - ManagerおよびPFM - Web Consoleをインストールしたホストにコピーします。手順を次に示します。
- PFM - Web Consoleが起動されている場合は,停止する。
- PFM - Agent のセットアップファイルをバイナリーモードでコピーする。
ファイルが格納されている場所およびファイルをコピーする場所を次の表に示します。
表2-4 コピーするセットアップファイル
PFM - Agent の
セットアップファイルコピー先 PFMプログラム名 OS コピー先フォルダ インストール先フォルダ\setup\jpcagt5w.EXE PFM - Manager Windows PFM - Managerのインストール先フォルダ\setup\ インストール先フォルダ\setup\jpcagt5u.Z UNIX /opt/jp1pc/setup/ インストール先フォルダ\setup\jpcagt5w.EXE PFM - Web Console Windows PFM - Web Consoleのインストール先フォルダ\setup\ インストール先フォルダ\setup\jpcagt5u.Z UNIX /opt/jp1pcwebcon/setup/ (b) PFM - Managerホストでセットアップコマンドを実行する
PFM - ManagerでPFM - Agent for Virtual Machineをセットアップするための次のコマンドを実行します。
jpcconf agent setup -key VM(jpcagtsetup agt5)
- 注意
- コマンドを実行するローカルホストのPerformance Managementのプログラムおよびサービスが完全に停止していない状態でjpcconf agent setup(jpcagtsetup)コマンドを実行した場合,エラーが発生することがあります。その場合は,Performance Managementのプログラムおよびサービスが完全に停止したことを確認したあと,再度jpcconf agent setup(jpcagtsetup)コマンドを実行してください。
PFM - ManagerホストにあるPFM - Agentのセットアップファイルは,この作業が終了したあと削除してもかまいません。
(c) PFM - Web Consoleホストでセットアップコマンドを実行する
PFM - Web ConsoleでPFM - Agent for Virtual Machineをセットアップするための次のコマンドを実行します。
jpcwagtsetupPFM - Web ConsoleホストにあるPFM - Agentのセットアップファイルは,この作業が終了したあと削除してもかまいません。
インスタンス環境の設定では,インスタンス情報を設定します。複数のインスタンス環境を設定する場合は,繰り返し実施します。
PFM - Agent for Virtual Machineのインスタンス情報を設定します。インスタンス情報の設定は,PFM - Agentホストで実施します。
設定するインスタンス情報を次の表に示します。セットアップの操作を始める前に,次の情報をあらかじめ確認してください。
表2-5 PFM - Agent for Virtual Machineのインスタンス情報
項目 説明 設定できる値 デフォルト値 VM_Type※1 監視対象となる仮想環境の種類を指定する 8バイト以内の半角文字列。
監視対象に応じて次の値を指定する。
- VMwareの場合:vmware
- Hyper-Vの場合:hyperv
- Virtageの場合:virtage
vmware VM_Host 監視対象となる仮想環境のホスト名を指定する。
Virtageの場合,IPアドレスも指定できる。256バイト以内の半角文字列。ただし,次の文字は指定できない。
VirtageホストのIPアドレスを指定する場合,次の形式で指定する。
- タブ
xxx.xxx.xxx.xxx
例)192.168.41.1インスタンス名※2 Security※6 監視対象となる仮想環境との通信にSSLを使用するかどうかを指定する {0|1}
0:SSLを使用しない
1:SSLを使用する
Hyper-VおよびVirtageの場合,SSLは使用できないため,1を指定した場合も0として設定される。1 Port 監視対象となる仮想環境との通信に使用するポート番号を指定する 0〜65535
0の場合,Securityの設定に応じて次の値を用いる。
- Security=0(SSLを使用しない)の場合
- HTTPのデフォルトポート番号80。
Virtageの場合,使用するポート番号は623で固定のため,任意に指定できない。ポート番号に623以外を指定した場合も,623として設定される。
- Security=1(SSLを使用する)の場合
- HTTPSのデフォルトポート番号443。
0 UserID※3 監視対象となる仮想環境に接続するためのユーザーIDを指定する 256バイト以内の半角文字列。ただし,次の文字は指定できない。
- タブ
(なし) Password※7 監視対象となる仮想環境に接続するためのパスワードを指定する。この項目で入力した文字は,画面に表示されない。また,この項目に値を設定する場合,2度入力を要求される。監視対象がVMwareの場合で,特殊文字をパスワードに含むときは,サニタイジング処理した文字列を入力する 256バイト以内の半角文字列。ただし,次の文字は指定できない。
- タブ
(パスワードなし) Domain 監視対象となる仮想環境への接続で使用するドメイン名を指定する 256バイト以内の半角文字列。ただし,次の文字は指定できない。
なお,ドメインに参加していない場合(ワークグループで動作している場合など)は空欄にする。
- タブ
(なし) HostUserID※8 PFM - AgentホストのユーザーIDを指定する 256バイト以内の半角文字列。ただし,次の文字は指定できない。
- タブ
(なし) HostPassword HostUserIDに指定したユーザーIDのパスワードを指定する。この項目で入力した文字は,画面に表示されない。また,この項目に値を設定する場合,2度入力を要求される。 256バイト以内の半角文字列。ただし,次の文字は指定できない。
- タブ
(パスワードなし) HostDomain PFM - Agentホストのドメイン名を指定する 256バイト以内の半角文字列。ただし,次の文字は指定できない。
なお,ドメインに参加していない場合(ワークグループで動作している場合など)は空欄にする。
- タブ
(なし) Log_Size 収集ログの1ファイルの最大サイズを指定する※4 1〜32(メガバイト)
ただし,16以上を設定する。16 Store Version※1 使用するStoreバージョンを指定する※5 {1.0|2.0} 2.0
- 注※1
- jpcconf inst setup(jpcinssetup)コマンドによる再設定はできません。
- 注※2
- jpcconf inst setup(jpcinssetup)コマンドの実行時に指定したインスタンス名です。
- VMware ESXやHyper-Vのホスト名を指定してください。仮想マシンやゲストOSのホスト名を指定しないでください。
- 注※3
- 監視対象の仮想環境がVMwareの場合,指定するアカウントにはVMwareのロールの「読み取り専用」以上の権限が必要です。権限の設定方法については,VMwareのマニュアルを参照してください。
- 注※4
- 収集ログは,1インスタンスにつき最大8ファイルが採取されます。ハードディスクに十分な空き容量がない場合,収集ログが出力エラーとなります。収集ログの詳細については,「7.3 ログ情報」を参照してください。
- 注※5
- Storeバージョンについては,マニュアル「JP1/Performance Management 設計・構築ガイド」の,インストールとセットアップについて説明している章を参照してください。
- 注※6
- Securityを1にする場合は,VMware ESX側で/sdkに対してHTTPSを許可する必要があります。また,Securityを0にする場合は,VMware ESX側で/sdkに対してHTTPを許可する必要があります。設定方法については,次のVMwareのドキュメントをご確認ください。
VMware ESX 4.0 ESX 構成ガイド Web プロキシ サービスのセキュリティ設定の変更 VMware ESX 4.1 ESX 構成ガイド Web プロキシ サービスのセキュリティ設定の変更 VMware ESX 5 vSphere 5 Documentation Center - vSphere セキュリティ Web プロキシ サービスのセキュリティ設定の変更
- 注※7
- VMwareを監視する場合に,VMware側のパスワードに次の記号文字を使用している場合,インスタンス設定のPassword項目を設定する際に次のとおり変換した文字列を入力してください。
記号 %変換後の文字列 < < > > & & ' ' " " - たとえば,Passwordに「abc<def>xyz」と指定したい場合は,「abc<def>xyz」と入力してください。
- 注※8
- JP1/PFM - Agent for VMは,HostUserIDに指定されたユーザーアカウントを使用して収集プロセスを起動します。ユーザーアカウントのプロファイルが存在しない場合,パフォーマンスデータの取得に失敗することがあります。
- ユーザーアカウントのプロファイル情報は,初回ログオン時に作成されます。
- JP1/PFM - Agent for VMのインスタンス環境を追加や変更する際に,新しいユーザーアカウントを作成してHostUserIDに指定する場合,新規作成したユーザーアカウントのプロファイルがまだ存在していないことがあります。このような場合は,新規作成したユーザーアカウントで一度Windowsにログオンしてください。
- 注意
- インスタンス環境で指定する接続先環境への設定が不正の場合でも,インスタンス環境の生成コマンドは正常に終了します。しかし,そのインスタンス環境で,レコードの収集を開始すると,パフォーマンスデータが収集されません。この場合の対策については,「7.2.5(3) PFM - Agentを起動してもパフォーマンスデータが収集されない」を参照してください。
インスタンス環境の設定で入力が必要な項目は,監視対象の仮想環境によって異なります。仮想環境ごとの入力要否を次の表に示します。
表2-6 各仮想環境のインスタンス情報入力要否
項目 仮想環境 VMware Hyper-V Virtage VM_Type × ○ ○ VM_Host △ △ △ Security △ × × Port △ × × UserID ○ ○ × Password ○ ○ × Domain × ○ × HostUserID ○ ○ × HostPassword ○ ○ × HostDomain ○ ○ × Log_Size △ △ △ Store Version △ △ △
- (凡例)
- ○:入力が必要です。
- △:デフォルト値から変更する場合は入力してください。
- ×:入力は不要です。
インスタンス環境を構築するには,jpcconf inst setup(jpcinssetup)コマンドを使用します。インスタンス環境の構築手順を次に示します。なお,インスタンス環境の設定例については,「2.6 インスタンス環境の設定例」を参照してください。
- jpcconf inst setup(jpcinssetup)コマンドを実行する。
インスタンス名には任意の名称を指定できますが,PFM - Agent for Virtual Machineでは管理を容易にするために,インスタンス名として監視対象となる仮想環境の物理サーバ名(VMWareの場合はVMware自身のホスト名)を指定することを推奨します。例えば,物理サーバ名がvmhostであるインスタンス環境を構築する場合,次のように指定してコマンドを実行します。
なお,インスタンス名は半角英数字である必要があります。詳細については,マニュアル「JP1/Performance Management リファレンス」を参照してください。
jpcconf inst setup -key VM -inst vmhost (jpcinssetup agt5 -inst vmhost)
jpcconf inst setup(jpcinssetup)コマンドの詳細については,マニュアル「JP1/Performance Management リファレンス」の,コマンドについて説明している章を参照してください。
- PFM - Agent for Virtual Machineのインスタンス情報を設定する。
表2-6に示した項目を,コマンドの指示に従って入力してください。各項目とも省略はできません。デフォルトで表示されている値を,項目の入力とする場合はリターンキーだけを押してください。
すべての入力が終了すると,インスタンス環境が構築されます。構築時に入力したインスタンス情報を変更したい場合は,再度jpcconf inst setup(jpcinssetup)コマンドを実行し,インスタンス環境を更新してください。インスタンス環境の更新については,「2.4.2 インスタンス環境の更新の設定」を参照してください。設定した一部の情報に関しては,PFM - Web Consoleのプロパティ編集によって変更できます。設定できる情報の詳細については,「付録E.2 Agent Collectorサービスのプロパティ一覧」を参照してください。
構築されるインスタンス環境を次に示します。
- インスタンス環境のフォルダ構成
次のフォルダ下にインスタンス環境が構築されます。
物理ホストの場合:インストール先フォルダ\agt5
論理ホストの場合:環境フォルダ※\jp1pc\agt5
構築されるインスタンス環境のフォルダ構成を次に示します。
- 注※
- 環境フォルダとは,論理ホスト作成時に指定した共有ディスク上のフォルダです。
表2-7 インスタンス環境のフォルダ構成
フォルダ名,ファイル名 説明 agent インスタンス名 jpcagt.ini Agent Collectorサービス起動情報ファイル jpcagt.ini.model※ Agent Collectorサービス起動情報ファイルのモデルファイル log ログファイル格納フォルダ work ワークフォルダ inssetup.bat PFM - Agent for Virtual Machine用jpcconf inst setup(jpcinssetup)コマンド拡張処理 plugin.ini 仮想環境接続定義ファイル store インスタンス名 jpcsto.ini Agent Storeサービス起動情報ファイル jpcsto.ini.model※ Agent Storeサービス起動情報ファイルのモデルファイル *.DAT データモデル定義ファイル dump エクスポート先フォルダ backup バックアップ先フォルダ partial 部分バックアップ用フォルダ import インポート用フォルダ log ログファイル格納フォルダ
- 注※
- インスタンス環境を構築した時点の設定値に戻したいときに使用します。
- インスタンス環境のサービスID
インスタンス環境のサービスIDは次のようになります。
PFM - Agent for Virtual Machineの場合,インスタンス名にはjpcconf inst setup(jpcinssetup)コマンドで指定したインスタンス名が表示されます。サービスIDについては,マニュアル「JP1/Performance Management 設計・構築ガイド」の,付録に記載されている命名規則を参照してください。また,プロダクト名表示機能の詳細については,マニュアル「JP1/Performance Management 設計・構築ガイド」の,Performance Managementの機能について説明している章を参照してください。
- プロダクト名表示機能が有効な場合
- インスタンス名[ホスト名]<VirtualMachine>
- インスタンス環境のWindowsのサービス名
インスタンス環境のWindowsのサービス名は次のようになります。
Windowsのサービス名については,マニュアル「JP1/Performance Management 設計・構築ガイド」の,付録に記載されている命名規則を参照してください。
- Agent Collectorサービス:PFM - Agent for Virtual Machineインスタンス名[論理ホスト名]
- Agent Storeサービス:PFM - Agent Store for Virtual Machineインスタンス名[論理ホスト名]
また,論理ホストで運用する場合のWindowsのサービス名については,マニュアル「JP1/Performance Management 運用ガイド」の,クラスタシステムでの構築と運用について説明している章を参照してください。
VMwareとの通信にSSLを用いる場合,証明書を組み込む必要があります。詳細については,「2.5.1 VMwareの場合」を参照してください。
- 注意
- VMwareとの通信にSSLを用いる場合で,証明書を組み込んでいないときには,次の問題が生じることがあります。
- パフォーマンスデータ収集時に,接続先VMwareからの応答に時間が掛かる
- パフォーマンスデータ収集時に,接続先VMwareからの応答に時間が掛かることによって,収集間隔内でパフォーマンスデータ取得が完了しないで,収集失敗となることがある
- PFM - Web Consoleから,サービスプロパティの表示などのPFM - Agent for Virtual MachineのAgent Collectorサービスへの問い合わせが発生する操作を行ったときに,エラーが発生する
Performance Managementを使用するネットワーク構成に応じて,変更する場合にだけ必要な設定です。
ネットワークの設定では次の二つの項目を設定できます。
- IPアドレスを設定する
Performance Managementを複数のLANに接続されたネットワークで使用するときに設定します。複数のIPアドレスを設定するには,jpchostsファイルにホスト名とIPアドレスを定義します。設定したjpchostsファイルはPerformance Managementシステム全体で統一させてください。
IPアドレスの設定の詳細については,マニュアル「JP1/Performance Management 設計・構築ガイド」の,インストールとセットアップについて説明している章を参照してください。
- ポート番号を設定する
Performance Managementが使用するポート番号を設定できます。運用での混乱を避けるため,ポート番号とサービス名は,Performance Managementシステム全体で統一させてください。
ポート番号の設定の詳細については,マニュアル「JP1/Performance Management 設計・構築ガイド」の,インストールとセットアップについて説明している章を参照してください。
Performance Managementの稼働状況を,Performance Management独自のログファイルに出力します。このログファイルを「共通メッセージログ」と呼びます。共通メッセージログは,デフォルトで2,048キロバイトのファイルが2ファイル使用されます。このファイルサイズを変更したい場合にだけ,必要な設定です。
詳細については,マニュアル「JP1/Performance Management 設計・構築ガイド」の,インストールとセットアップについて説明している章を参照してください。
PFM - Agent for Virtual Machineで管理されるパフォーマンスデータを格納するデータベースの保存先,バックアップ先またはエクスポート先のフォルダを変更したい場合にだけ,必要な設定です。
パフォーマンスデータは,デフォルトで,次の場所に保存されます。
- 保存先:インストール先フォルダ\agt5\store\インスタンス名\
- バックアップ先:インストール先フォルダ\agt5\store\インスタンス名\backup\
- 部分バックアップ先:インストール先フォルダ\agt5\store\インスタンス名\partial\
- エクスポート先:インストール先フォルダ\agt5\store\インスタンス名\dump\
- インポート先:インストール先フォルダ\agt5\store\インスタンス名\import\
- 注意
- 論理ホストで運用する場合のデフォルトの保存先については,「インストール先フォルダ」を「環境フォルダ\jp1pc」に読み替えてください。
詳細については,「2.4.1 パフォーマンスデータの格納先の変更」を参照してください。
(8) PFM - Agent for Virtual Machineの接続先PFM - Managerの設定
PFM - Agentがインストールされているホストで,そのPFM - Agentを管理するPFM - Managerを設定します。接続先のPFM - Managerを設定するには,jpcconf mgrhost define(jpcnshostname)コマンドを使用します。
- 注意
- 同一ホスト上に,複数のPFM - Agentがインストールされている場合でも,接続先に指定できるPFM - Managerは,一つだけです。PFM - Agentごとに異なるPFM - Managerを接続先に設定することはできません。
- PFM - AgentとPFM - Managerが同じホストにインストールされている場合,接続先PFM - ManagerはローカルホストのPFM - Managerとなります。この場合,接続先のPFM - ManagerをほかのPFM - Managerに変更できません。
手順を次に示します。
- Performance Managementのプログラムおよびサービスを停止する。
セットアップを実施する前に,ローカルホストでPerformance Managementのプログラムおよびサービスが起動されている場合は,すべて停止してください。サービスの停止方法については,マニュアル「JP1/Performance Management 運用ガイド」の,Performance Managementの起動と停止について説明している章を参照してください。
jpcconf mgrhost define(jpcnshostname)コマンド実行時に,Performance Managementのプログラムおよびサービスが起動されている場合は,停止を問い合わせるメッセージが表示されます。
- 接続先のPFM - Managerホストのホスト名を指定して,jpcconf mgrhost define(jpcnshostname)コマンドを実行する。
例えば,接続先のPFM - Managerがホストhost01上にある場合,次のように指定します。
jpcconf mgrhost define -host host01 (jpcnshostname -s host01)
PFMサービスの起動・停止時や,PFM - Managerとの接続状態の変更時に動作ログを出力したい場合に必要な設定です。動作ログとは,システム負荷などのしきい値オーバーに関するアラーム機能と連動して出力される履歴情報です。
設定方法については,「付録I 動作ログの出力」を参照してください。
WMIの設定の詳細については,「2.5.2 Hyper-Vの場合」を参照してください。
All Rights Reserved. Copyright (C) 2009, 2012, Hitachi, Ltd.