3.1.4　Windows版のセットアップ手順

(a)　PFM - RM for Platformのセットアップファイルをコピーする

PFM - RMホストにあるセットアップファイルを，PFM - ManagerとPFM - Web Consoleのインストール先ホストにコピーします。

コピーする手順を次に示します。

1. PFM - Web Consoleを停止する。

   PFM - Web Consoleが起動されている場合は，停止してください。

2. バイナリーモードでセットアップファイルをコピーする。

   PFM - RMホストからPFM - ManagerホストやPFM - Web Consoleホストへファイルをコピーします。

   コピー元のファイル格納先とコピー先について，次の表に示します。

   表3‒6　コピーするセットアップファイル（Windowsの場合）

   項番	コピー元 （PFM - RM for Platformの セットアップファイル）	コピー先
   		プログラム名	OS	コピー先フォルダ
   1	インストール先フォルダ\setup\jpcagt7w.EXE	PFM - Manager	Windows	PFM - Managerのインストール先フォルダ\setup
   2	インストール先フォルダ\setup\jpcagt7u.Z		UNIX	/opt/jp1pc/setup/
   3	インストール先フォルダ\setup\jpcagt7w.EXE	PFM - Web Console	Windows	PFM - Web Consoleのインストール先フォルダ\setup
   4	インストール先フォルダ\setup\jpcagt7u.Z		UNIX	/opt/jp1pcwebcon/setup/

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

PFM - ManagerホストでPFM - RM for Platformのセットアップコマンドを実行します。

実行するコマンドを次に示します。

jpcconf agent setup -key RMPlatform

ここでは，対話形式の実行例を示していますが，jpcconf agent setupコマンドは非対話形式でも実行できます。jpcconf agent setupコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。

コマンド実行時の注意事項

Performance Managementのプログラムやサービスはすべて停止してからコマンドを実行してください。完全に停止していない状態でjpcconf agent setupコマンドを実行した場合，エラーが発生することがあります。エラーが発生した場合は，再度jpcconf agent setupコマンドを実行してください。

PFM - Managerホストでセットアップコマンドを実行したら，PFM - ManagerにコピーしたPFM - RM for Platformのセットアップファイルは，削除しても問題ありません。

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

PFM - Web ConsoleホストでPFM - RM for Platformのセットアップコマンドを実行します。

実行するコマンドを次に示します。

jpcwagtsetup

PFM - Web Consoleホストでセットアップコマンドを実行したら，PFM - Web ConsoleにコピーしたPFM - RM for Platformのセットアップファイルは，削除しても問題ありません。

(a)　インスタンス内の監視対象によって指定が必要または不要となるインスタンス環境の設定項目

指定が必要なインスタンス環境の設定項目は，インスタンス内の監視対象によって異なります。インスタンス内の監視対象ごとに入力が必要となるインスタンス環境の設定項目について，次の表に示します。

(b)　インスタンス環境の設定項目と設定値

インスタンス環境の設定項目と指定する設定値を次の表に示します。操作の開始前に情報をあらかじめ確認してください。

なお，インスタンス環境の設定には，jpcconf inst setupコマンドを使用します。

jpcconf inst setupコマンドの実行手順については「（d）対話形式で実行する場合」と「（e）非対話形式で実行する場合」を参照してください。

jpcconf inst setupコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。

(c)　表示されないインスタンス環境の設定項目について

コマンドを実行して表示されるインスタンス環境の設定項目には，ほかの設定項目の内容などによって表示されないものがあります。インスタンス環境の設定項目が表示されない場合の条件と，その場合の入力値について次に示します。

(d)　対話形式で実行する場合

1. jpcconf inst setupコマンドを実行する。

   インスタンス名を「inst1」とするインスタンス環境を設定する場合のコマンド実行例を次に示します。

   jpcconf inst setup -key RMPlatform -inst inst1

2. PFM - RM for Platformのインスタンス環境を設定する。

   コマンドの指示に従ってPFM - RM for Platformのインスタンス環境の各設定項目を入力します。インスタンス環境の各設定項目については，「表3-9」を参照してください。各設定項目を入力したら，リターンキーを押して設定してください。デフォルトで表示されている値をそのまま入力内容とする場合は，リターンキーだけを押してください。

   インスタンス内にUNIXの監視対象が含まれる場合の設定例を次に示します。

   C:\Program Files\Hitachi\jp1pc\tools>jpcconf inst setup -key RMPlatform -inst inst1
    UseCommonAccount     [N]                  :<Enter>
    Interval             [300]                :<Enter>
    Std_Category         [Y]                  :<Enter>
    Disk_Category        [Y]                  :<Enter>
    Network_Category     [Y]                  :<Enter>
    Ps_Category          [Y]                  :<Enter>
    RMHost_User※1                             :rmuser<Enter>
    RMHost_Password※1                         :rmpass※2<Enter>
    Re-enter※1                                :rmpass※2<Enter>
    RMHost_Domain※1      []                   :<Enter>
    SSH_Type             [putty]              :<Enter>
    SSH_Client           [] :C:\Program Files\PuTTY\plink.exe※3<Enter>
    Perl_Module          [] :C:\Perl\bin\perl.exe※3<Enter>
    Log_Size (MB)        [3]                  :<Enter>
   KAVE05080-I インスタンス環境を作成しています (servicekey※4=RMPlatform, inst=inst1)
   KAVE05081-I インスタンス環境が作成されました (servicekey※4=RMPlatform, inst=inst1)

   注※1

   UseCommonAccountに「Y」を指定した場合，この項目は表示されません。

   注※2

   パスワードは再入力を要求されます。入力したパスワードは画面には表示されません。

   注※3

   インスタンス内にUNIXの監視対象が含まれる場合に入力します。インスタンス内の監視対象のOSがWindowsだけの場合は，指定する必要はありません。

   注※4

   PFM - Managerのプロダクト名表示機能が無効の場合，「servicekey」は「agt7」と表示されます。

(e)　非対話形式で実行する場合

1. jpcconf inst setupコマンドで，定義ファイルのテンプレートを作成する。

   次のようにコマンドを実行します。

   jpcconf inst setup -key RMPlatform -noquery -template 定義ファイル名

   インスタンス環境の設定項目に対応するセクションおよびラベルが定義ファイルに出力されます。なお，[Instance Definitions]セクションのラベルに対応する値は，空白のままです。

2. 手順1で作成した定義ファイルのテンプレートを編集する。

   インスタンス環境に合わせてテンプレートの設定値を編集します。

   定義ファイルで指定するプロダクト固有のラベルについては，「表3-9」を参照してください。

   インスタンス内にUNIXの監視対象が含まれる場合のインスタンス環境での定義ファイルの記述例を次に示します。インスタンス環境に応じて，[Instance Definitions]セクションのラベルに対応する値を記述してください。

   [Common Definitions]
   Definition File Version=0001
    
   [Product Information]
   Product ID=7
    
   [Instance Definitions]
   UseCommonAccount=
   Interval=
   Std_Category=
   Disk_Category=
   Network_Category=
   Ps_Category=
   RMHost_User※1=rmuser
   RMHost_Password※1=rmpass
   RMHost_Domain※1=
   SSH_Type=putty
   SSH_Client= C:\Program Files\PuTTY\plink.exe※2
   Perl_Module= C:\Perl\bin\perl.exe※2
   Log_Size=

   注※1

   UseCommonAccountに「Y」を指定した場合，これらに値を指定する必要はありません。

   注※2

   インスタンス内にUNIXの監視対象が含まれる場合に入力します。インスタンス内の監視対象のOSがWindowsだけの場合は，指定する必要はありません。

3. jpcconf inst setupコマンドで，PFM - RM for Platformのインスタンス環境を設定する。

   インスタンス名を「inst1」とするインスタンス環境を設定する場合のコマンド実行例を次に示します。-inputオプションには，手順2で編集した定義ファイルを指定します。

   jpcconf inst setup -key RMPlatform -inst inst1 -noquery -input 定義ファイル名

注意

定義ファイルにパスワードなどの秘匿情報が含まれる場合，定義ファイルはセキュリティを確保した安全な場所に保存し，使用後は削除するようにしてください。また，定義ファイルをホスト間で転送したいときには，SFTP（SSHトンネル経由のFTP）など，盗聴のおそれがない安全な方法を使用することをお勧めします。

すべての設定が完了すると，インスタンス環境が構築されます。インスタンス環境のフォルダ構成を次の表に示します。

インスタンス環境を変更したい場合は，再度jpcconf inst setupコマンドを実行し，インスタンス環境の各設定項目を更新してください。インスタンス環境の各設定項目を更新する詳細については，「3.6.2　インスタンス環境の更新」を参照してください。

設定した一部の情報は，PFM - Web Consoleのプロパティ編集で変更できます。プロパティ編集で変更できる情報の詳細については，「付録F.1　Remote Monitor Storeサービスのプロパティ一覧」を参照してください。

なお，インスタンス環境でのサービスIDとWindowsのサービス名は次のようになります。

インスタンス環境でのサービスID

• Remote Monitor Collectorサービスの場合

  7Aインスタンス番号 インスタンス名[ホスト名]

• Remote Monitor Storeサービスの場合

  7Sインスタンス番号 インスタンス名[ホスト名]

• Group Agentサービスの場合

  7Aインスタンス番号 インスタンス名[All@ホスト名]

PFM - RM for Platformの場合，インスタンス名にはjpcconf inst setupコマンドで指定したインスタンス名が表示されます。

PFM - RMホストのホスト名が「host1」，インスタンス名に「inst1」を指定した場合，サービスIDは次のようになります。

• Remote Monitor Collectorサービスの場合

  7A1inst1[host1]

• Remote Monitor Storeサービスの場合

  7S1inst1[host1]

• Group Agentサービスの場合

  7A1inst1[All@host1]

サービスIDの詳細については，マニュアル「JP1/Performance Management 設計・構築ガイド」の付録に記載されている命名規則を参照してください。

インスタンス環境でのWindowsのサービス名

• Remote Monitor Collectorサービスの場合

  PFM - RM for Platform インスタンス名

• Remote Monitor Storeサービスの場合

  PFM - RM Store for Platform インスタンス名

インスタンス名に「inst1」を指定した場合，サービス名は次のようになります。

• Remote Monitor Collectorサービスの場合

  PFM - RM for Platform inst1

• Remote Monitor Storeサービスの場合

  PFM - RM Store for Platform inst1

Windowsのサービス名については，マニュアル「JP1/Performance Management 設計・構築ガイド」の付録に記載されている命名規則を参照してください。また，論理ホストで運用する場合のWindowsのサービス名については，マニュアル「JP1/Performance Management 運用ガイド」のクラスタシステムでの構築と運用について説明している章を参照してください。

なお，PFM - Web Consoleのエージェント固有プロパティの配布機能によるインスタンス環境の設定はできません。

(f)　パフォーマンスデータの収集を開始するオフセット値の設定

インスタンスごとに監視対象からパフォーマンスデータの収集を開始するオフセット値（単位：秒）を設定できます。パフォーマンスデータの収集を開始するタイミングをインスタンスごとに変えることにより，同時に収集処理を行う監視対象数を減らす場合は，オフセット値の設定で調整してください。

オフセット値の設定手順については，「8. 定義ファイル」の「Remote Monitor Collectorサービス起動情報ファイル（jpcagt.ini）」について説明している章を参照してください。

(a)　監視対象によって指定が必要または不要となる監視対象の設定項目

指定が必要な監視対象の設定項目は，監視対象によって異なります。監視対象ごとに入力が必要となる監視対象の設定項目について，次の表に示します。

(b)　監視対象の設定項目と設定値

監視対象の設定項目と設定値を次の表に示します。操作の開始前に情報をあらかじめ確認してください。

なお，監視対象の設定には，jpcconf target setupコマンドを使用します。

jpcconf target setupコマンドの実行手順については「（d）対話形式で実行する場合」と「（e）非対話形式で実行する場合」を参照してください。

jpcconf target setupコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。

（凡例）

−：デフォルトは設定されていません

注※1

jpcconf target setupコマンドを非対話形式で実行するときは，定義ファイル中で，この項目名をプロダクト固有のラベルとして使用します。非対話形式のコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。

注※2

ヘルスチェック監視の場合，ICMPプロトコル（pingでの通信）に対応しているホストやハードウェア機器も指定できます。

注※3

稼働性能情報の収集とヘルスチェックを実施するためには，少なくとも，PFM - RMホストで名前解決できるようにする必要があります。

また，JP1/IM連携機能を使用する場合はJP1/IMホストで名前解決できるようにする必要があります。

注※4

ヘルスチェック監視の場合，稼働性能情報は収集されません。

注※5

「All」はグループエージェント用の予約語のため使用できません。

注※6

指定を省略した場合は，PFM - RMホストのホスト名が仮定されます。

注※7

監視対象のOSがWindowsの場合，指定するユーザーは，監視対象のAdministratorsグループ，Performance Log Usersグループ，またはPerformance Monitor Usersグループのうち，どれかのメンバーである必要があります。

Windowsのセキュリティの監査などの操作をする場合は，ほかに操作を実行できる権限が必要になります。

アカウントの種類によって，収集できるレコードが異なります。アカウントの種類ごとのレコードの収集可否については，「3.1.1(5)(a)　ユーザーアカウントの設定」を参照してください。

監視対象のOSがWindowsの場合，次に示すユーザーのプロパティの［全般］タブの項目がチェックされていない必要があります。

・ユーザーは次回ログオン時にパスワードの変更が必要

・アカウントを無効にする

また，監視対象がActive Directory環境でドメインユーザーを指定する場合，そのユーザーの［アカウント］タブの［ログオン先］ボタンで表示される「ログオンできるワークステーション」が「すべてのコンピュータ」となっているか，［次のコンピュータ］となっていて，監視対象のホスト名が登録されている必要があります。

監視対象がワークグループ環境の場合は，gpedit.mscコマンドで表示される「ローカル コンピューター ポリシー」の［コンピューターの構成］−［Windowsの設定］−［セキュリティの設定］−［ローカル ポリシー］−［セキュリティ オプション］の「ネットワーク アクセス：ローカル アカウントの共有とセキュリティ モデル」が「クラシック - ローカル ユーザーがローカル ユーザーとして認証する」となっている必要があります。

これらの注意事項は，共通アカウント情報（wmi）のUserを使用している場合も同様です。

注※8

監視対象のOSがUNIXの場合，指定するユーザーのログインシェルは，「bash」，「bsh」または「ksh」のどれかを使用してください。

共通アカウント情報（ssh）のUserを使用している場合も同様です。

注※9

監視対象のOSがWindowsの場合は必ず指定してください。

共通アカウント情報（wmi）のPasswordを使用している場合も同様です。

注※10

自ホストを監視する場合，次のすべての条件に該当するときは，自ホスト名を設定してください。

• PFM - RMホストがドメインに参加している

• 監視対象に接続するユーザーとして，PFM - RMホストのユーザーを使用する

共通アカウント情報（wmi）のDomainを使用している場合も同様です。共通アカウント情報を使用している場合は，共通アカウント情報（wmi）のDomainに対して自ホスト名を設定してください。

注※11

監視対象のOSがUNIXの場合は必ず指定してください。

また，クラスタシステムでPFM - RM for Platformを運用するときは，実行系および待機系の両方からアクセスできるファイルパスで指定してください。

共通アカウント情報（ssh）のPrivate_Key_Fileを使用している場合も同様です。

(c)　表示されない監視対象の設定項目について

コマンドを実行して表示される監視対象の設定項目には，ほかの設定項目の内容などによって表示されないものがあります。監視対象の設定項目が表示されない場合の条件と，その場合の入力値について次に示します。

(d)　対話形式で実行する場合

1. jpcconf target setupコマンドを実行する。

   PFM - RM for Platformでは，監視対象の名前として監視対象ホストのホスト名を指定することを推奨します。

   インスタンス名inst1の監視対象ホストtargethost1を監視対象として設定する場合のコマンド実行例を次に示します。

   jpcconf target setup -key RMPlatform -inst inst1 -target targethost1

2. PFM - RM for Platformの監視対象を設定する。

   コマンドの指示に従って監視対象の設定項目を入力します。監視対象の設定項目については，「表3-16」を参照してください。各設定項目を入力したら，リターンキーを押して設定してください。デフォルトで表示されている値をそのまま入力内容とする場合は，リターンキーだけを押してください。

   監視対象のOSがWindowsの場合の設定例を次に示します。

   設定する監視対象の条件

   ・ホスト名：targethost1

   ・ユーザー：user1

   ・パスワード：pass1

   ・ドメイン：domain1

   C:\Program Files\Hitachi\jp1pc\tools>jpcconf target setup -key RMPlatform -inst inst1 -target targethost1
    Target Host          []                   :targethost1<Enter>
    UseCommonAccount     [N]                  :<Enter>
    TargetType           [wmi]                :<Enter>
    User※1                                    :user1<Enter>
    Password※1                                :pass1※2<Enter>
    Re-enter※1                                :pass1※2<Enter>
    Domain※1             []                   :domain1<Enter>
   KAVE05361-I 監視対象を追加しています (servicekey※3=RMPlatform, inst=inst1, target=targethost1)
   KAVE05362-I 監視対象が追加されました (servicekey※3=RMPlatform, inst=inst1, target=targethost1)

   注※1

   UseCommonAccountに「Y」を指定した場合，この項目は表示されません。

   注※2

   パスワードは再入力を要求されます。入力したパスワードは画面には表示されません。

   注※3

   PFM - Managerのプロダクト名表示機能が無効の場合，「servicekey」は「agt7」と表示されます。

   監視対象のOSがUNIXの場合の設定例を次に示します。

   設定する監視対象の条件

   ・ホスト名：targethost2

   ・ユーザー：ssh-user

   C:\Program Files\Hitachi\jp1pc\tools>jpcconf target setup -key RMPlatform -inst inst1 -target targethost2
    Target Host          []                   :targethost2<Enter>
    UseCommonAccount     [N]                  :<Enter>
    TargetType           [wmi]                :ssh<Enter>
    User※1                                    :ssh-user<Enter>
    Private_Key_File     [] :C:\Program Files\PuTTY\agt7.ppk<Enter>
    Port                 [22]                 :<Enter>
   KAVE05361-I 監視対象を追加しています (servicekey※2=RMPlatform, inst=inst1, target=targethost2)
   KAVE05362-I 監視対象が追加されました (servicekey※2=RMPlatform, inst=inst1, target=targethost2)

   注※1

   UseCommonAccountに「Y」を指定した場合，この項目は表示されません。

   注※2

   PFM - Managerのプロダクト名表示機能が無効の場合，「servicekey」は「agt7」と表示されます。

   ヘルスチェック監視の場合の設定例を次に示します。

   設定する監視対象の条件

   ・ホスト名：targethost3

   C:\Program Files\Hitachi\jp1pc\tools>jpcconf target setup -key RMPlatform -inst inst1 -target targethost3
    Target Host          []                   :targethost3<Enter>
    UseCommonAccount     [N]                  :<Enter>
    TargetType           [wmi]                :icmp<Enter>
   KAVE05361-I 監視対象を追加しています (servicekey※=RMPlatform, inst=inst1, target=targethost3)
   KAVE05362-I 監視対象が追加されました (servicekey※=RMPlatform, inst=inst1, target=targethost3)

   注※

   PFM - Managerのプロダクト名表示機能が無効の場合，「servicekey」は「agt7」と表示されます。

(e)　非対話形式で実行する場合

1. jpcconf target setupコマンドで，定義ファイルのテンプレートを作成する。

   次のようにコマンドを実行します。

   jpcconf target setup -key RMPlatform -noquery -template 定義ファイル名

   監視対象の設定項目に対応するセクションおよびラベルが定義ファイルに出力されます。なお，[Target Definitions]セクションのラベルに対応する値は，空白のままです。

2. 手順1で作成した定義ファイルのテンプレートを編集する。

   監視対象に合わせてテンプレートの設定値を編集します。

   定義ファイルで指定するプロダクト固有のラベルについては，「表3-16」を参照してください。

   監視対象のOSがWindowsの場合の定義ファイルの記述例を次に示します。監視対象に応じて，[Target Definitions]セクションのラベルに対応する値を記述してください。

   [Common Definitions]
   Definition File Version=0001
    
   [Product Information]
   Product ID=7
    
   [Target Definitions]
   Target Host=targethost1
   UseCommonAccount=
   TargetType=
   User※=user1
   Password※=pass1
   Domain※=domain1
   Private_Key_File=
   Port=

   注※

   UseCommonAccountに「Y」を指定した場合，この項目に値を指定する必要はありません。

   監視対象のOSがUNIXの場合の定義ファイルの記述例を次に示します。監視対象に応じて，[Target Definitions]セクションのラベルに対応する値を記述してください。

   [Common Definitions]
   Definition File Version=0001
    
   [Product Information]
   Product ID=7
    
   [Target Definitions]
   Target Host=targethost2
   UseCommonAccount=
   TargetType=ssh
   User※=ssh-user
   Password=
   Domain=
   Private_Key_File※= C:\Program Files\PuTTY\agt7.ppk
   Port=

   注※

   UseCommonAccountに「Y」を指定した場合，この項目に値を設定する必要はありません。

   ヘルスチェック監視の場合の定義ファイルの記述例を次に示します。監視対象に応じて，[Target Definitions]セクションのラベルに対応する値を記述してください。

   [Common Definitions]
   Definition File Version=0001
    
   [Product Information]
   Product ID=7
    
   [Target Definitions]
   Target Host=targethost3
   UseCommonAccount=
   TargetType=icmp
   User=
   Password=
   Domain=
   Private_Key_File=
   Port=

3. jpcconf target setupコマンドで，PFM - RM for Platformの監視対象を設定する。

   インスタンス名を「inst1」，監視対象ホストを「targethost1」とする監視対象を設定する場合のコマンド実行例を次に示します。-inputオプションには，手順2で編集した定義ファイルを指定します。

   jpcconf target setup -key RMPlatform -inst inst1 -target targethost1 -input 定義ファイル名 -noquery

注意

定義ファイルにパスワードなどの秘匿情報が含まれる場合，定義ファイルはセキュリティを確保した安全な場所に保存し，使用後は削除するようにしてください。また，定義ファイルをホスト間で転送したいときには，SFTP（SSHトンネル経由のFTP）など，盗聴のおそれがない安全な方法を使用することをお勧めします。

すべての設定が完了すると，監視対象の環境が構築されます。監視対象の環境のフォルダ構成を次の表に示します。

なお，監視対象の設定で追加されるサービスIDは次のようになります。

追加されるサービスID

• Remote Agentサービス

  7Aインスタンス番号 インスタンス名[監視対象名@ホスト名]

  インスタンス名と監視対象名はjpcconf target setupコマンドで指定した値になります。

  PFM - RMホストのホスト名がhost1でインスタンス名にinst1，監視対象名にtargethost1を指定した場合，サービスIDは次のようになります。

  7A1inst1[targethost1@host1]

サービスIDの詳細については，マニュアル「JP1/Performance Management 設計・構築ガイド」の付録に記載されている命名規則を参照してください。

監視対象の情報を変更したい場合は，再度jpcconf target setupコマンドを実行し，監視対象の情報を更新してください。監視対象の更新の詳細については，「3.6.3　監視対象の更新」を参照してください。

設定した一部の情報は，PFM - Web Consoleのプロパティ編集で変更できます。プロパティ編集で変更できる情報の詳細については，「付録F.3　リモートエージェントとグループエージェントのプロパティ一覧」を参照してください。