3.2.4　UNIX版のセットアップ手順

(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‒21　コピーするセットアップファイル（UNIXの場合）

   項番	コピー元 （PFM - RM for Platformの セットアップファイル）	コピー先
   		プログラム名	OS	コピー先フォルダ
   1	/opt/jp1pc/setup/jpcagt7w.EXE	PFM - Manager	Windows	PFM - Managerのインストール先フォルダ\setup
   2	/opt/jp1pc/setup/jpcagt7u.Z		UNIX	/opt/jp1pc/setup/
   3	/opt/jp1pc/setup/jpcagt7w.EXE	PFM - Web Console	Windows	PFM - Web Consoleのインストール先フォルダ\setup
   4	/opt/jp1pc/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コマンドを実行した場合，エラーが発生することがあります。エラーが発生した場合は，Performance Managementのプログラムやサービスが完全に停止したことを確認したあと，再度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コマンドの実行手順については「（c）対話形式で実行する場合」と「（d）非対話形式で実行する場合」を参照してください。

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

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

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

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

   jpcconf inst setup -key RMPlatform -inst inst1

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

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

   インスタンス環境の各設定項目をすべてデフォルトの値にする場合の設定例を次に示します。

   /opt/jp1pc/tools>jpcconf inst setup -key RMPlatform -inst inst1
    Interval                 [300]                :<Enter>
    Std_Category             [Y]                  :<Enter>
    Disk_Category            [Y]                  :<Enter>
    Network_Category         [Y]                  :<Enter>
    Ps_Category              [Y]                  :<Enter>
    Log_Size (MB)            [3]                  :<Enter>
   KAVE05080-I インスタンス環境を作成しています (servicekey※=RMPlatform, inst=inst1)
   KAVE05081-I インスタンス環境が作成されました (servicekey※=RMPlatform, inst=inst1)

   注※

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

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

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

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

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

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

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

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

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

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

   [Common Definitions]
   Definition File Version=0001
    
   [Product Information]
   Product ID=7
    
   [Instance Definitions]
   Interval=300
   Std_Category=Y
   Disk_Category=Y
   Network_Category=Y
   Ps_Category=Y
   Log_Size=3

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.2　Remote Monitor Collectorサービスのプロパティ一覧」を参照してください。

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

インスタンス環境でのサービス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 設計・構築ガイド」の付録に記載されている命名規則を参照してください。

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

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

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

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

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

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

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

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

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

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

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

(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-27」を参照してください。各設定項目を入力したら，リターンキーを押して設定してください。デフォルトで表示されている値をそのまま入力内容とする場合は，リターンキーだけを押してください。

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

   設定するPFM - RMホストの条件

   ・SSHクライアントプログラム「/usr/bin/ssh」

   ・秘密鍵「/opt/jp1pc/agt7/.ssh/agt7」

   設定する監視対象の条件

   ・ホスト名targethost1

   ・ユーザーssh-user

   ・SSHのポート番号「22」

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

   注※1

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

   注※2

   SSHで使用するポート番号が「22」でない場合，SSHで使用しているポート番号に「Port」の値を変更してください。

   注※3

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

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

   設定する監視対象の条件

   ・ホスト名：targethost2

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

   注※

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

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

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

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

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

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

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

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

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

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

   [Common Definitions]
   Definition File Version=0001
    
   [Product Information]
   Product ID=7
    
   [Target Definitions]
   Target Host=targethost1
   UseCommonAccount=
   TargetType=ssh
   User※=user1
   Private_Key_File※=/opt/jp1pc/agt7/.ssh/agt7
   Port=22

   注※

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

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

   [Common Definitions]
   Definition File Version=0001
    
   [Product Information]
   Product ID=7
    
   [Target Definitions]
   Target Host=targethost2
   UseCommonAccount=
   TargetType=icmp
   User=
   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　リモートエージェントとグループエージェントのプロパティ一覧」を参照してください。