JP1/Performance Management - Agent Option for Virtual Machine

[目次][用語][索引][前へ][次へ]

2.1.4　PFM - Agent for Virtual Machineのセットアップ手順

ここでは，PFM - Agent for Virtual Machineを運用するための，セットアップについて説明します。

[図データ]は使用する環境によって必要になるセットアップ項目，またはデフォルトの設定を変更する場合のオプションのセットアップ項目を示します。

＜この項の構成＞
(1)　PFM - Agent for Virtual Machineの登録
(2)　インスタンス環境の設定
(3)　証明書の組み込み
(4)　ネットワークの設定
(5)　ログのファイルサイズ変更
(6)　パフォーマンスデータの格納先の変更
(7)　PFM - Agent for Virtual Machineの接続先PFM - Managerの設定
(8)　動作ログ出力の設定

(1)　PFM - Agent for Virtual Machineの登録

PFM - ManagerおよびPFM - Web Consoleを使ってPFM - Agentを一元管理するために，PFM - ManagerおよびPFM - Web ConsoleにPFM - Agent for Virtual Machineを登録する必要があります。

PFM - Agentの登録の流れを次に示します。

図2-3　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をインストールした場合，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をインストールしたホストにコピーします。手順を次に示します。

  1. PFM - Web Consoleが起動されている場合は，停止する。

  2. PFM - Agent のセットアップファイルをバイナリーモードでコピーする。
    ファイルが格納されている場所およびファイルをコピーする場所を次の表に示します。

    表2-3　コピーするセットアップファイル

    PFM - Agent の
    セットアップファイル    		 コピー先
    PFMプログラム名 OS コピー先フォルダ
    インストール先フォルダ\setup\jpcagt5w.EXE PFM - Manager Windows PFM - Managerのインストール先フォルダ\setup\
    インストール先フォルダ\setup\jpcagt5w.EXE PFM - Web Console Windows PFM - Web Consoleのインストール先フォルダ\setup\

(b)　PFM - Managerホストでセットアップコマンドを実行する

PFM - ManagerでPFM - Agent for Virtual Machineをセットアップするための次のコマンドを実行します。

jpcagtsetup agt5
注意
コマンドを実行するローカルホストのPerformance Managementのプログラムおよびサービスが完全に停止していない状態でjpcagtsetupコマンドを実行した場合，エラーが発生することがあります。その場合は，Performance Managementのプログラムおよびサービスが完全に停止したことを確認したあと，再度jpcagtsetupコマンドを実行してください。

PFM - ManagerホストにあるPFM - Agentのセットアップファイルは，この作業が終了したあと削除してもかまいません。

(c)　PFM - Web Consoleホストでセットアップコマンドを実行する

PFM - Web ConsoleでPFM - Agent for Virtual Machineをセットアップするための次のコマンドを実行します。

jpcwagtsetup

PFM - Web ConsoleホストにあるPFM - Agentのセットアップファイルは，この作業が終了したあと削除してもかまいません。

(2)　インスタンス環境の設定

インスタンス環境の設定では，インスタンス情報を設定します。複数のインスタンス環境を設定する場合は，繰り返し実施します。

PFM - Agent for Virtual Machineのインスタンス情報を設定します。インスタンス情報の設定は，PFM - Agentホストで実施します。

設定するインスタンス情報を次の表に示します。セットアップの操作を始める前に，次の情報をあらかじめ確認してください。

表2-4　PFM - Agent for Virtual Machineのインスタンス情報

項目 説明 設定できる値 デフォルト値
VM_Type※1 監視対象となる仮想環境の種類を指定する 8バイト以内の半角文字列。ただし，次の文字は指定できない。
  • タブ
 vmware
VM_Host 監視対象となる仮想環境のホスト名を指定する 256バイト以内の半角文字列。ただし，次の文字は指定できない。
  • タブ
 インスタンス名※2
Security 監視対象となる仮想環境との通信にSSLを使用するかどうかを指定する ｛0｜1｝
0：SSLを使用しない
1：SSLを使用する		 1
Port 監視対象となる仮想環境との通信に使用するポート番号を指定する 0〜65535
0の場合，Securityの設定に応じて次の値を用いる

Security=0（SSLを使用しない）の場合
HTTPのデフォルトポート番号80。

Security=1（SSLを使用する）の場合
HTTPSのデフォルトポート番号443。
 0
UserID 監視対象となる仮想環境に接続するためのユーザーIDを指定する 256バイト以内の半角文字列。ただし，次の文字は指定できない。
  • タブ
 （なし）
Password 監視対象となる仮想環境に接続するためのパスワードを指定する。この項目で入力した文字は，画面に表示されない。また，この項目に値を設定する場合，2度入力を要求される。 256バイト以内の半角文字列。ただし，次の文字は指定できない。
  • タブ
 （パスワードなし）
Log_Size 収集ログの1ファイルの最大サイズを指定する※3 1〜32（MB）
ただし，16以上を推奨する。		 16
Store Version 使用するStoreバージョンを指定する※4 ｛1.0｜2.0｝ 2.0

注※1
jpcinssetupコマンドによる再設定はできません。

注※2
jpcinssetupコマンドの実行時に指定したインスタンス名です。

注※3
収集ログは，1インスタンスにつき最大8ファイルが採取されます。ハードディスクに十分な空き容量がない場合，収集ログが出力エラーとなります。収集ログの詳細については，「7.3　ログ情報」を参照してください。

注※4
Storeバージョンについては，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。
注意
インスタンス環境で指定する接続先環境への設定が不正の場合でも，インスタンス環境の生成コマンドは正常に終了します。しかし，そのインスタンス環境で，レコードの収集を開始すると，パフォーマンスデータが収集されません。この場合の対策については，「7.2.4(3)　PFM - Agentを起動してもパフォーマンスデータが収集されない」を参照してください。

インスタンス環境を構築するには，jpcinssetupコマンドを使用します。インスタンス環境の構築手順を次に示します。なお，インスタンス環境の設定例については，「付録L　インスタンス環境の設定例」を参照してください。

  1. jpcinssetupコマンドを実行する。
    PFM - Agent for Virtual Machineでは，インスタンス名として監視対象の物理サーバ名を指定することを推奨します。例えば，物理サーバ名がvm-hostであるインスタンス環境を構築する場合，次のように指定してコマンドを実行します。
    jpcinssetup agt5 -inst vm-host
    jpcinssetupコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」の，コマンドについて説明している章を参照してください。

  2. PFM - Agent for Virtual Machineのインスタンス情報を設定する。
    表2-4に示した項目を，コマンドの指示に従って入力してください。各項目とも省略はできません。デフォルトで表示されている値を，項目の入力とする場合はリターンキーだけを押してください。

すべての入力が終了すると，インスタンス環境が構築されます。構築時に入力したインスタンス情報を変更したい場合は，再度jpcinssetupコマンドを実行し，インスタンス環境を更新してください。インスタンス環境の更新については，「2.4.2　インスタンス環境の更新の設定」を参照してください。設定した一部の情報に関しては，PFM - Web Consoleのプロパティ編集によって変更できます。設定できる情報の詳細については，「付録E.2　Agent Collectorサービスのプロパティ一覧」を参照してください。

構築されるインスタンス環境を次に示します。

注※
インスタンス環境を構築した時点の設定値に戻したいときに使用します。

(3)　証明書の組み込み[図データ]

仮想環境との通信にSSLを用いる場合，証明書を組み込む必要があります。詳細については，「付録K　証明書の組み込み手順」を参照してください。

注意事項
仮想環境との通信にSSLを用いる場合で，証明書を組み込んでいないときには，次の問題が生じることがあります。
  • パフォーマンスデータの収集に時間がかかる
  • パフォーマンスデータの収集に失敗する
  • PFM - Web Consoleから，サービスプロパティの表示など，PFM - Agent for Virtual MachineのAgent Collectorサービスへの問い合わせが発生する操作を行ったときに，エラーが発生する

(4)　ネットワークの設定[図データ]

Performance Managementを使用するネットワーク構成に応じて，変更する場合にだけ必要な設定です。

ネットワークの設定では次の二つの項目を設定できます。

(5)　ログのファイルサイズ変更[図データ]

Performance Managementの稼働状況を，Performance Management独自のログファイルに出力します。このログファイルを「共通メッセージログ」と呼びます。共通メッセージログは，デフォルトで2,048キロバイトのファイルが2ファイル使用されます。このファイルサイズを変更したい場合にだけ，必要な設定です。

詳細については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，インストールとセットアップについて説明している章を参照してください。

(6)　パフォーマンスデータの格納先の変更[図データ]

PFM - Agent for Virtual Machineで管理されるパフォーマンスデータを格納するデータベースの保存先，バックアップ先またはエクスポート先のフォルダを変更したい場合にだけ，必要な設定です。

パフォーマンスデータは，デフォルトで，次の場所に保存されます。

詳細については，「2.4.1　パフォーマンスデータの格納先の変更」を参照してください。

(7)　PFM - Agent for Virtual Machineの接続先PFM - Managerの設定

PFM - Agentがインストールされているホストで，そのPFM - Agentを管理するPFM - Managerを設定します。接続先のPFM - Managerを設定するには，jpcnshostnameコマンドを使用します。

注意
  • 同一ホスト上に，複数のPFM - Agentがインストールされている場合でも，接続先に指定できるPFM - Managerは，一つだけです。PFM - Agentごとに異なるPFM - Managerを接続先に設定することはできません。
  • PFM - AgentとPFM - Managerが同じホストにインストールされている場合，接続先PFM - ManagerはローカルホストのPFM - Managerとなります。この場合，接続先のPFM - ManagerをほかのPFM - Managerに変更できません。

手順を次に示します。

  1. Performance Managementのプログラムおよびサービスを停止する。
    セットアップを実施する前に，ローカルホストでPerformance Managementのプログラムおよびサービスが起動されている場合は，すべて停止してください。サービスの停止方法については，マニュアル「JP1/Performance Management システム構築・運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。
    jpcnshostnameコマンド実行時に，Performance Managementのプログラムおよびサービスが起動されている場合は，停止を問い合わせるメッセージが表示されます。

  2. 接続先のPFM - Managerホストのホスト名を指定して，jpcnshostnameコマンドを実行する。
    例えば，接続先のPFM - Managerがホストhost01上にある場合，次のように指定します。
    jpcnshostname -s host01

(8)　動作ログ出力の設定[図データ]

PFMサービスの起動・停止時や，PFM - Managerとの接続状態の変更時に動作ログを出力したい場合に必要な設定です。動作ログとは，システム負荷などのしきい値オーバーに関するアラーム機能と連動して出力される履歴情報です。

設定方法については，「付録I　動作ログの出力」を参照してください。

[目次][前へ][次へ]

[他社商品名称に関する表示]

All Rights Reserved. Copyright (C) 2008, Hitachi, Ltd.