Hitachi

JP1 Version 10　JP1/Performance Management 運用ガイド

10.2.3　PFM - Web Consoleのインストールとセットアップ

〈この項の構成〉

(1)　インストールとセットアップの流れ

図10‒13　論理ホスト運用するPFM - Web Consoleのインストールおよびセットアップの流れ

[図データ]

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

ページの先頭へ

(2)　インストール手順[図データ]　[図データ]

実行系ノードおよび待機系ノードに，PFM - Web Consoleを新規インストールします。インストール手順は非クラスタシステムの場合と同じです。

インストール手順については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップ（Windowsの場合）について説明している章を参照してください。

注意

  • インストール先はローカルディスクです。共有ディスクにはインストールしないでください。

  • 実行系ノードと待機系ノードのPFM - Web Consoleは同じパスにインストールしてください。

ページの先頭へ

(3)　セットアップ手順

PFM - Web Consoleを論理ホスト運用する場合，実行系ノードと待機系ノードで環境構成を同じにする必要があります。

(a)　PFM - Web Consoleにエージェント情報を登録する[図データ]　[図データ]　[図データ]

クラスタシステムでPFM - AgentまたはPFM - RMを一元管理するために，実行系ノードおよび待機系ノードのPFM - Web ConsoleにPFM - AgentまたはPFM - RMのエージェント情報を登録します。

PFM - Managerのバージョンが08-50以降の場合，PFM - AgentまたはPFM - RMの登録は自動で行われるため，PFM - AgentまたはPFM - RM情報の追加セットアップは不要です。ただし，PFM - Managerより後でリリースされたPFM - AgentまたはPFM - RMについては手動で登録する必要があります。PFM - Manager，PFM - Agent，およびPFM - RMのそれぞれのリリース時期についてはリリースノートを参照してください。

注意

  • すでにPFM - AgentまたはPFM - RMの情報が登録されているPerformance Managementシステムに，新たに同じプロダクトIDで，同じバージョンのPFM - AgentまたはPFM - RMを追加した場合，PFM - AgentまたはPFM - RMの登録は必要ありません。

  • バージョンが異なる同じプロダクトIDのPFM - AgentまたはPFM - RMを，異なるホストにインストールする場合，最新バージョンのPFM - AgentまたはPFM - RMをセットアップしてください。

PFM - Web Consoleのエージェント情報の追加セットアップは，「図10-13　論理ホスト運用するPFM - Web Consoleのインストールおよびセットアップの流れ」で示す流れで実施します。

PFM - Web Consoleにエージェント情報を登録する手順を次に示します。

  1. セットアップファイルをコピーする。[図データ]　[図データ]

    PFM - AgentまたはPFM - RMのセットアップファイルを，PFM - Web Consoleの実行系ノードおよび待機系ノードの次の場所にコピーします。

    PFM - Web Consoleインストール先フォルダ\setup\

    コピーするセットアップファイルおよび手順は，PFM - Managerに追加セットアップする場合と同じです。詳細については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップ（Windowsの場合）について説明している章を参照してください。

  2. 待機系ノードでセットアップコマンドを実行する。[図データ]

    待機系ノードで，jpcwagtsetupコマンドを実行し，エージェント情報を登録します。

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

    jpcwagtsetup

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

補足

PFM - AgentまたはPFM - RMのエージェント情報をPFM - Web Consoleに登録した場合は，PFM - Web Consoleを再起動する必要があります。ただし，待機系ノードは，フェールオーバー時にPFM - Web Consoleが再起動されるため，手順2のあとの再起動は必要ありません。

(b)　接続先PFM - Managerを設定する[図データ]

PFM - Web Consoleが接続するPFM - ManagerホストのIPアドレスまたはホスト名を，待機系ノードで，初期設定ファイル（config.xml）に設定します。接続するPFM - Managerがクラスタシステムで運用されている場合は，論理IPアドレスまたは論理ホスト名を設定してください。

  1. 初期設定ファイル（config.xml）を開く。

    インストール先フォルダ\conf\config.xmlファイルをテキストエディターやXMLエディターなどで開きます。

  2. 接続するPFM - ManagerホストのIPアドレスまたはホスト名を設定する。

    <vsa>タグ内の<vserver-connection>タグ直後に，次に示すタグを記述します。

    <param name="host" value="IPアドレスまたはホスト名"/>

    例えば，接続するPFM - ManagerホストのIPアドレスが，「10.210.24.56」の場合，次のように設定します。

        <vsa>
        <vserver-connection>
            <param name="host" value="10.210.24.56"/>
            <!-- The host computer name to which PFM View Server uses.
                 Specifiable values: 1024 to 65535
                 Default           : 22286
             -->
            <param name="port" value="22286"/>
        </vserver-connection>

  3. 手順2で編集した初期設定ファイル（config.xml）を保存する。

注意事項

初期設定ファイル（config.xml）は，指定された以外の個所を変更すると，PFM - Web Consoleが正常に動作しない場合がありますので，注意してください。

(c)　PFM - Web Consoleの論理ホストを設定する[図データ]

PFM - Web Consoleホストの論理IPアドレスまたは論理ホスト名を，待機系ノードで，初期設定ファイル（config.xml）に設定します。

  1. 初期設定ファイル（config.xml）を開く。

    インストール先フォルダ\conf\config.xmlファイルをテキストエディターやXMLエディターなどで開きます。

  2. PFM - Web Consoleホストの論理IPアドレスまたは論理ホスト名を設定する。

    <vsa>タグ内の<vserver-connection>タグ内に，次に示すタグを記述します。

    <param name="ownHost" value="論理IPアドレスまたは論理ホスト名"/>

    例えば，PFM - Web Consoleホストの論理IPアドレスが，「10.210.26.18」の場合，次のように設定します。

        <vsa>
        <vserver-connection>
            <param name="host" value="10.210.24.56"/>
            <!-- The host computer name to which PFM View Server uses.
                 Specifiable values: 1024 to 65535
                 Default           : 22286
            -->
            <param name="port" value="22286"/>
            <param name="ownHost" value="10.210.26.18"/>
 
       </vserver-connection>

  3. 手順2で編集した初期設定ファイル（config.xml）を保存する。

注意事項

  • 初期設定ファイル（config.xml）は，指定された以外の個所を変更すると，PFM - Web Consoleが正常に動作しない場合がありますので，注意してください。

  • <!-- <param name="ownHost" value=""/> -->というように，パラメーターのXMLタグ自身は<!-- -->でコメントアウトされています。タグのコメントアウトを解除した上で値を指定してください。

(d)　ブックマーク定義情報の格納先を設定する[図データ]

ブックマークの定義情報を格納するフォルダを，待機系ノードで，初期設定ファイル（config.xml）に設定します。格納先のフォルダは，フェールオーバー時にブックマークの定義情報を引き継がせるため，共有ディスク上のフォルダを指定します。

  1. 初期設定ファイル（config.xml）を開く。

    インストール先フォルダ\conf\config.xmlファイルをテキストエディターやXMLエディターなどで開きます。

  2. ブックマークの定義情報を格納するフォルダを設定する。

    初期設定ファイル（config.xml）の<vsa>タグ内にある<format>タグ直後の<bookmark>タグに，格納先フォルダを設定します。

    設定した格納先フォルダは，PFM - Web Consoleサービスの起動時に，自動的に作成されます。

    例えば，「環境ディレクトリ\jp1pcWebCon\common\bookmarks」を格納先フォルダにしたいとき，次のように設定します。 

    </format>
 
<bookmark>
<!-- The directory where bookmark repository is stored. Default : <install directory>\bookmarks -->
<param name="bookmarkRepository" value="環境ディレクトリ\jp1pcWebCon\common\bookmarks"/>
</bookmark>
 
</vsa>

  3. 手順2で編集した初期設定ファイル（config.xml）を保存する。

注意事項

  • 初期設定ファイル（config.xml）は，指定された以外の個所を変更すると，PFM - Web Consoleが正常に動作しない場合がありますので，注意してください。

  • <!-- <param name="bookmarkRepository" value=""/> -->というように，パラメーターのXMLタグ自身は<!-- -->でコメントアウトされています。タグのコメントアウトを解除した上で値を指定してください。

(e)　プロセス監視定義テンプレートの格納先を設定する[図データ]

プロセス監視の定義テンプレートを格納するフォルダを，待機系ノードで，初期設定ファイル（config.xml）に設定します。格納先のフォルダは，フェールオーバー時にプロセス監視の定義テンプレートを引き継がせるため，共有ディスク上のフォルダを指定します。

  1. 初期設定ファイル（config.xml）を開く。

    インストール先フォルダ\conf\config.xmlファイルをテキストエディターやXMLエディターなどで開きます。

  2. プロセス監視の定義テンプレートを格納するフォルダを設定する。

    初期設定ファイル（config.xml）の<vsa>タグ内にある<process-monitoring>タグに，格納先フォルダを設定します。

    設定した格納先フォルダは，PFM - Web Consoleサービスの起動時に，自動的に作成されます。

    例えば，「環境ディレクトリ\jp1pcWebCon\processMonitoringTemplates」を格納先フォルダにしたいとき，次のように設定します。 

    <process-monitoring>
<!-- The directory where templates of process monitoring are stored. Default : <install directory>\processMonitoringTemplates -->
<param name="processMonitoringTemplatesRepository" value="環境ディレクトリ\jp1pcWebCon\processMonitoringTemplates"/>
</process-monitoring>
 
</vsa>

  3. 手順2で編集した初期設定ファイル（config.xml）を保存する。

注意事項

  • 初期設定ファイル（config.xml）は，指定された以外の個所を変更すると，PFM - Web Consoleが正常に動作しない場合がありますので，注意してください。

  • <!-- <param name="processMonitoringTemplatesRepository" value=""/> -->というように，パラメーターのXMLタグ自身は<!-- -->でコメントアウトされています。タグのコメントアウトを解除した上で値を指定してください。

(f)　usrconfig.cfgを設定する[図データ]

システムロケールとusrconf.cfgファイルの言語設定が異なる場合，待機系ノードでusrconf.cfgファイルの設定を変更します。

  1. テキストエディターなどでusrconf.cfgファイルを開く

    usrconf.cfgファイルは，次のフォルダに格納されています。 

    インストール先フォルダ\CPSB\CC\web\containers\PFMWebConsole\usrconf

  2. usrconf.cfgファイルを編集する

    例えば，システムロケールが日本語でusrconf.cfgファイルの言語設定が英語の場合，日本語に設定を変更したいときはusrconf.cfgファイルを次のように設定します。 

    #for PFM WebConsole
 
add.jvm.arg=-Duser.language=ja
add.jvm.arg=-Duser.country=JP

    usrconf.cfgファイルの設定の変更方法については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，言語環境の設定について説明している章を参照してください。

(g)　設定ファイルの実行系ノードへのコピー[図データ]　[図データ]

(b)，(c)，(d)，および(e)で編集した初期設定ファイル（config.xml）を，実行系ノードにコピーします。実行系ノードの次の場所にコピーしてください。

インストール先フォルダ\conf

(f)で待機系ノードのusrconf.cfgファイルの設定を変更した場合は，実行系ノードにコピーします。実行系ノードの次の場所にコピーしてください。

インストール先フォルダ\CPSB\CC\web\containers\PFMWebConsole\usrconf

(h)　共有ディスクのオンライン確認[図データ]

実行系ノードで共有ディスクがオンラインになっていることを確認します。共有ディスクがオンラインになっていない場合は，クラスタソフトからの操作やボリュームマネージャーの操作などで，共有ディスクをオンラインにしてください。

(i)　PFM - AgentまたはPFM - RM情報を追加セットアップする[図データ]　[図データ]

実行系ノードで(a)でコピーしたセットアップファイルを使い，PFM - AgentまたはPFM - RMのエージェント情報を追加セットアップします。

  1. 実行系ノードで，PFM - Web Consoleサービスを停止する。

    クラスタソフトへの登録前の場合，jpcwstopコマンドでサービスを停止させてください。

    クラスタソフトへの登録後，PFM - AgentまたはPFM - RMの追加など構成を変更する場合，クラスタソフトからサービスを停止させてください。なお，構成変更の詳細については，「10.3　クラスタシステムでの構成変更（Windowsの場合）」を参照してください。

  2. 実行系ノードでセットアップコマンドを実行する。

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

    jpcwagtsetup

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

  3. 実行系ノードで，PFM - Web Consoleサービスを起動する。

    手順1で停止させていたPFM - Web Consoleサービスを起動します。

ページの先頭へ

(4)　クラスタソフトの設定手順

クラスタソフトにPFM - Web Consoleを設定します。実行系ノードと待機系ノードでそれぞれに設定します。

(a)　クラスタソフトでのPFM - Web Consoleの登録[図データ]　[図データ]

PFM - Web Consoleを論理ホスト環境で運用する場合は，クラスタソフトに登録して，クラスタソフトからの制御でPFM - Web Consoleを起動したり停止したりするように環境設定します。

PFM - Web Consoleをクラスタソフトに登録するときの設定内容を，WindowsのMSCSに登録する項目を例として説明します。PFM - Web Consoleの場合，次の表のサービスを，PFM - Managerと同じクラスタグループに追加登録します。

表10‒4　クラスタソフトに登録するPFM - Web Consoleのサービス

項番

名前

サービス名

依存関係

1

PFM - Web Console

PFM-WebConsole

IPアドレスリソース

物理ディスクリソース※

2

PFM - Web Service

PFM-WebService

#1-1のクラスタリソース

（PFM - Web Console）

注※　(3)の(d)と(e)で設定した論理ホスト環境ディレクトリがある共有ディスクドライブ。

MSCSの場合は，これらのサービスをMSCSのリソースとして登録します。各リソースの設定は次のようにします。下記では，MSCSの設定項目を「［　］」で囲んで示しています。

  • ［リソースの種類］は「汎用サービス」として登録する。

  • ［名前］，［サービス名］および［依存関係］を「表 10-4　クラスタソフトに登録するPFM - Web Consoleのサービス」のとおりに設定する。

    なお，名前はサービスを表示するときの名称で，サービス名はMSCSから制御するサービスを指定するときの名称です。

  • ［レジストリ複製］は設定しない。

  • プロパティの［詳細設定］タブは，［再開する］をチェックする。再起動試行回数の［しきい値］は，3回を目安に設定する。

    注意事項

    • クラスタに登録するサービスは，クラスタソフトから起動および停止を制御します。このため，実行系ノードと待機系ノードの両方で，OS起動時に自動起動しないよう［スタートアップの種類］を［手動］に設定してください。

    • WSFCの設定では，MSCSの設定例に対して，次の手順を追加する必要があります。手順では，クラスタ管理ソフトウェアの「フェールオーバー クラスタ管理」およびclusterコマンドを使用します。これらの詳細については，Microsoft社のドキュメントを参照してください。

      1.　PFM - Web Serviceのクラスタ化されたサービスを作成する。

      ［スタート］メニューから「フェールオーバー クラスタ管理」を使用してクラスタソフトを起動し，PFM - Web Serviceのクラスタ化されたサービスを作成します。クラスタ化されたサービスに属する汎用サービス（PFM - Web Serviceのサービス），クライアントアクセスポイント（名前，IPアドレス），記憶域など，フェールオーバー時にノード間を移動するリソース類を追加します。各項目のプロパティを表示し，リソースの依存関係やそのほかのクラスタに関する設定を実施します。

      2.　clusterコマンドを実行する。

      管理者として実行したコマンドプロンプトを開き，次のコマンドを実行します。

      cluster△res△"リソース名"△/priv△StartupParameters=""

      △は半角スペースを表しています。リソース名には，PFM - Web Serviceの汎用サービスのリソース名を指定します。PFM - Web Serviceの汎用サービスのリソース名は「フェールオーバー クラスタ管理」から確認してください。

      3.　「セットアップ パラメータ※」の値を確認する。

      「フェールオーバー クラスタ管理」から，PFM - Web Serviceの汎用サービスのプロパティを開き，「セットアップ パラメータ」の値が空白になっていることを確認します。

    注※

    Windows Server 2008 R2，Windows Server 2012およびWindows Server 2012 R2の場合は，［スタートアップ パラメータ］です。

(b)　クラスタソフトからの起動と停止の確認[図データ]　[図データ]

クラスタソフトからの操作で，PFM - Web Consoleの起動および停止を各ノードで実行し，正常に動作することを確認してください。

ページの先頭へ

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

All Rights Reserved. Copyright (C) 2012, 2014, Hitachi, Ltd.

(C)opyright 2000-2009, by Object Refinery Limited and Contributors.