Tuning Manager - Agents

4.3.3 インストールの前に必ずお読みください

HTM - Agent for NASをインストールする前に確認する必要があるインストールおよびセットアップ時の注意事項を説明します。

この項の構成

(1) インストール時のPerformanceデータベースの選択について

(2) 環境変数に関する注意事項

(3) 同一ホストにPerformance Managementプログラムを複数インストール，セットアップするときの注意事項

(4) バージョンアップ時の注意事項（Hybrid Storeで運用している場合）

(5) バージョンアップ時の注意事項（Storeデータベースで運用している場合）

(6) その他の注意事項

(1) インストール時のPerformanceデータベースの選択について

HTM - Agent for NASでは，インストール時にPerformanceデータベースとしてHybrid StoreまたはStoreデータベースを選択できます。

注意

Storeデータベースで運用しているHTM - Agent for RAIDが同一ホストにインストールされている環境では，HTM - Agent for NASはStoreデータベースしか選択できません。HTM - Agent for NASをHybrid Storeで運用したい場合は，先にHTM - Agent for RAIDをHybrid Storeでの運用に移行する必要があります。

HTM - Agent for NASとしては，新しいPerformanceデータベースであるHybrid Storeを推奨します。

Hybrid Storeには，次のような特長があります。

Tuning Manager APIを利用して，パフォーマンスデータが取得できる。

監視対象リソース数が多い場合，一部のパフォーマンスデータをTuning Manager APIで取得するときの取得性能が，Storeデータベースと比べて大幅に向上する。

Storeデータベースでの運用時と同一のサイクルで監視する場合，より多くのリソースを1台のAgentホストで監視できる。

なお，Hybrid Storeを選択すると，Tuning Manager APIの利用が有効化されます。

Storeデータベースは，次に示す場合のユーザーに向けて，引き続き提供しています。

Hybrid Storeで運用するために必要なメモリーやディスク容量を確保できない場合。

v8.2.1より前と同じ運用方法でPerformanceデータベースを運用したい場合。

クラスタ環境でHTM - Agent for NASをインスタンスごとに異なる論理ホストに分けて運用したい場合。

参考

Hybrid StoreおよびStoreデータベースで運用するために必要なメモリーやディスク容量は，「付録A. システム見積もり（Hybrid Storeで運用する場合）」および「付録C. システム見積もり（Storeデータベースで運用する場合）」を参照してください。

(2) 環境変数に関する注意事項

Performance Managementが使用しているため，JPC_HOSTNAMEを環境変数として設定しないでください。設定した場合は，Performance Managementが正しく動作しません。

(3) 同一ホストにPerformance Managementプログラムを複数インストール，セットアップするときの注意事項

Performance Managementは，同一ホストにPFM - ManagerとPFM - Agentをインストールすることもできます。その場合の注意事項を次に示します。

参考

システムの性能や信頼性を向上させるため，PFM - ManagerとPFM - Agentをそれぞれ別のホストで運用することをお勧めします。

Performance Managementのプログラムをインストールするときは，ローカルホストのPerformance Managementのプログラムおよびサービスをすべて停止しておいてください。なお，停止するサービスは物理ホスト上および論理ホスト上のすべてのサービスです。サービスの停止方法については，マニュアル「JP1/Performance Management 運用ガイド」の，Performance Managementの起動と停止について説明している章を参照してください。

PFM - ManagerとPFM - Agentを同一ホストにインストールする場合，PFM - Baseは不要です。この場合，PFM - Agentの前提プログラムはPFM - Managerになるため，PFM - Managerをインストールしてから PFM - Agentをインストールしてください。

PFM - BaseとPFM - Managerは同一ホストにインストールできません。PFM - BaseとPFM - AgentがインストールされているホストにPFM - Managerをインストールする場合は，PFM - BaseとPFM - AgentをアンインストールしたあとにPFM - Manager，PFM - Agentの順でインストールしてください。また，PFM - Manager とPFM - AgentがインストールされているホストにPFM - Baseをインストールする場合も同様に，PFM - ManagerとPFM - AgentをアンインストールしたあとにPFM - Base，PFM - Agentの順でインストールしてください。

PFM - ManagerがインストールされているホストにPFM - Agentをインストールすると，接続先PFM - ManagerはローカルホストのPFM - Managerとなります。この場合，PFM - Agentの接続先PFM - ManagerをリモートホストのPFM - Managerに変更できません。リモートホストのPFM - Managerに接続したい場合は，インストールするホストにPFM - Managerがインストールされていないことを確認してください。

Tuning Manager serverがインストールされているホストに，Performance Managementプログラムをインストールする場合は，ブラウザーの画面をすべて閉じてからインストールを実施してください。

Performance Managementプログラムを新規にインストールした場合は，ステータス管理機能がデフォルトで有効になります。ただし，バージョンアップインストールした場合は，ステータス管理機能の設定状態はバージョンアップ前のままとなります。ステータス管理機能の設定を変更する場合は，マニュアル「JP1/Performance Management 運用ガイド」のPerformance Managementの障害検知について説明している章を参照してください。

(4) バージョンアップ時の注意事項（Hybrid Storeで運用している場合）

古いバージョンのHTM - Agentsからバージョンアップする場合の注意事項を次に示します。

HTM - Agent for NASをv8.4以前からv8.4.1以降にバージョンアップする場合，バージョンアップ前にOracle JDKへ切り替えているときは，バージョンアップ後にhtmchgjdkコマンドを使用してOracle JDKへ切り替えてください。
v8.4以前からv8.4.1以降へのバージョンアップ後にはagtn.propertiesファイルのJavaのインストールパスの設定が無効になるため，コマンドでの切り替えが必要になります。
Oracle JDKへの切り替え手順の詳細については，「7.1.10 Oracle JDKへの切り替え」を参照してください。

HTM - Agent for NASをバージョンアップする場合，HTM - Agent for NASを上書きインストールしてください。古いバージョンのHTM - Agent for NASをアンインストールすると，古いバージョンで作成したパフォーマンスデータなども一緒に削除されてしまうため，新しいバージョンで使用できなくなります。アップグレードまたは上書きインストールを実施すると，Agentのインスタンス環境および設定ファイルが自動的に更新されます。

アップグレードインストールを実施すると，Agentのインスタンス環境および設定ファイルに新しい設定項目が追加される場合があります。その場合，新しい設定項目にはデフォルト値が設定されるため，必要に応じて再度設定してください。

バージョンアップのためにHTM - Agent for NASを上書きインストールする場合，インストールを開始する前に，必ず既存のデータベースのバックアップを取得してください。

v8.4.1より前のHTM - Agent for NASからバージョンアップインストールすると，agtn.propertiesのタイムアウト値に関する次のデフォルト値がバージョンアップ前の値から変更されます。

smu.ver.timeout
バージョンアップ前の値が30から，60になります。

smu.conf.timeout
バージョンアップ前の値が360から，370になります。

smu.perf.timeout
バージョンアップ前の値が40から，170になります。

バージョンアップインストール前に設定していた値は，バージョンアップインストールした後にも引き継がれます。ただし，デフォルト値よりも小さい値を設定していた場合には，デフォルト値で動作します。必要に応じてタイムアウト値を再設定してください。

(5) バージョンアップ時の注意事項（Storeデータベースで運用している場合）

古いバージョンのPFM - Agentからバージョンアップする場合の注意事項を次に示します。

HTM - Agent for NASをv8.4以前からv8.4.1以降にバージョンアップする場合，バージョンアップ前にOracle JDKへ切り替えているときは，バージョンアップ後にhtmchgjdkコマンドを使用してOracle JDKへ切り替えてください。
v8.4以前からv8.4.1以降へのバージョンアップ後にはagtn.propertiesファイルのJavaのインストールパスの設定が無効になるため，コマンドでの切り替えが必要になります。
Oracle JDKへの切り替え手順の詳細については，「7.1.10 Oracle JDKへの切り替え」を参照してください。

v8.2.1以降のHTM - Agent for NASにバージョンアップする場合，Hybrid Storeでの運用に移行するためのダイアログが表示されます。Hybrid Storeについては，「(1) インストール時のPerformanceデータベースの選択について」を参照してください。
なお，Storeデータベースで運用しているHTM - Agent for RAIDが同一ホストにインストールされている環境では，HTM - Agent for NASはStoreデータベースしか選択できません。HTM - Agent for NASをHybrid Storeで運用したい場合は，先にHTM - Agent for RAIDをHybrid Storeでの運用に移行する必要があります。
StoreデータベースからHybrid Storeへ移行する場合，インストールを始める前に「13.1.1 StoreデータベースからHybrid Storeへ移行する前に必ずお読みください」を必ずご確認ください。

HTM - Agent for NASをバージョンアップする場合，既存のStoreデータベースが自動的にバージョンアップされるため，一時的にStoreデータベースの格納先のディスクに，Storeデータベースのサイズの2倍の空き容量を必要とします。HTM - Agent for NASをバージョンアップする前に，Storeデータベースの格納先のディスクに十分な空き容量があるかどうかを確認してください。
なお，PIレコードタイプの分単位データの保存期間をデフォルト値から変更している場合，Storeデータベースのサイズが非常に大きくなるときがあるため注意が必要です。
必要な空き容量は，現在のStoreデータベースの合計サイズを基準に考慮してください。例えば，現在のStoreデータベースの合計サイズが100GBの場合，バージョンアップに必要なディスクの空き容量は200GB以上です。Storeデータベースの格納先ディスクを変更している場合は，変更後のディスク容量に対して必要な空き容量を考慮してください。

HTM - Agent for NASのバージョンアップ時にHybrid Storeでの運用へ移行しない場合，バージョンアップ前後でデータモデルが変更されているときは，バージョンアップインストール時に既存のStoreデータベースをバージョンアップする処理が行われます。その際，データモデルのコンバート処理が必要な場合に蓄積されたデータ量によって，多くの時間を要します。目安としてStoreデータベースのサイズが100GBの場合，インストール処理が3～4時間掛かるときがあります。
なお，Storeデータベースのサイズが増大する要因の一つとして，PIレコードタイプの分単位データの保存期間の変更があります。ディスク占有量を見積もった上で保存期間を変更してください。

HTM - Agent for NASをバージョンアップする場合，HTM - Agent for NASを上書きインストールしてください。古いバージョンのHTM - Agent for NASをアンインストールすると，古いバージョンで作成したパフォーマンスデータなども一緒に削除されてしまうため，新しいバージョンで使用できなくなります。アップグレードまたは上書きインストールを実施すると，次の項目が自動的に更新されます。

Agent StoreのStoreデータベースファイル

iniファイル

Agentのインスタンス環境

アップグレードインストールを実施すると，iniファイルおよびAgentのインスタンス環境に新しい設定項目が追加される場合があります。その場合，新しい設定項目にはデフォルト値が設定されるため，必要に応じて再度設定してください。

バージョンアップのためにHTM - Agent for NASを上書きインストールする場合，インストールを開始する前に，必ず既存のデータベースのバックアップを取得してください。

HTM - Agent for NASのバージョンアップインストールでは，インポートしたStoreデータベースのデータモデルのバージョンアップが行われないため，インストール後にHTM - Agent for NASのサービスを起動するとAgent Storeサービスの起動時にKAVE00229-Eが出力され，サービスが起動されない現象が発生します。この現象を回避するために，次に示すどちらかの対処を実施してください。

バージョンアップインストール前にjpctool db import（jpcdbctrl import）コマンドで-clearオプションを指定し，インポートしたStoreデータベースを削除する。

バージョンアップインストール後にjpctool db dmconvert（jpcdbctrl dmconvert）コマンドでimportディレクトリのStoreデータベースのデータモデルをバージョンアップする。

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

v8.4.1より前のHTM - Agent for NASからバージョンアップインストールすると，agtn.propertiesのタイムアウト値に関する次のデフォルト値がバージョンアップ前の値から変更されます。

smu.ver.timeout
バージョンアップ前の値が30から，60になります。

smu.conf.timeout
バージョンアップ前の値が360から，370になります。

smu.perf.timeout
バージョンアップ前の値が40から，170になります。

バージョンアップインストール前に設定していた値は，バージョンアップインストールした後にも引き継がれます。ただし，デフォルト値よりも小さい値を設定していた場合には，デフォルト値で動作します。必要に応じてタイムアウト値を再設定してください。

なお，バージョンアップについての詳細は，マニュアル「JP1/Performance Management 設計・構築ガイド」の付録を参照してください。

(6) その他の注意事項

インストール先ディレクトリにリンクを張りHTM - Agent for NASをインストールすることはできません。また，インストールパスにはシンボリックリンクを含まないようにしてください。

/opt/jp1pc/setupディレクトリにHTM - Agent for NASのセットアップファイルがある場合，新規HTM - Agent for NASの追加セットアップが実行されます。HTM - Agent for NASの追加セットアップが成功した場合の実行結果は共通メッセージログに「KAVE05908-I エージェント追加セットアップは正常に終了しました」と出力されます。確認してください。

HTM - Agent for NASがインストールされているホストからNASシステムへのアクセスにはLAN接続を使用します。HTM - Agent for NASは，LANでNASシステムに接続されたホストにインストールする必要があります。

Tuning Manager Agent REST APIコンポーネントでOracle JDK 7を使用している場合，v8.2.1以降のHTM - Agent for NASをインストールするとHTM - Agent for NASを使用できなくなります。HTM - Agent for NASに同梱されたJDKかHTM - Agent for NASがサポートしているOracle JDKに切り替えてください。
Tuning Manager Agent REST APIコンポーネントでのOracle JDKへの切り替え手順については，「7.1.10 Oracle JDKへの切り替え」を参照してください。HTM - Agent for NASがサポートしているOracle JDKについては「ソフトウェア添付資料」を参照してください。

Performance Management製品がインストールされているホストのOSをアップグレードする場合，アップグレード前にPerformance Management製品をすべてアンインストールしてください。OSのアップグレード後，アップグレード後のOSに対応するPerformance Management製品をインストールしてください。

Hybrid Storeのデータを流用する

Performance Management製品がインストールされているホストのOSをアップグレードする場合，移行元ホストのバックアップを移行先ホストへリストアすることで，アップグレード後にデータを流用できます。

Hybrid Storeのデータを流用する手順を次に示します。なお，OSのアップグレード前後で，インストールするHTM - Agent for NASのバージョンおよびリビジョンを一致させてください。バックアップおよびリストアの手順の詳細については，「9.1 Hybrid Storeで運用しているHTM - Agentsのバックアップとリストア」を参照してください。

OSのアップグレード前にhtmhsbackupコマンドでHybrid Storeのバックアップを取得する。

アップグレードしたOSにHTM - Agent for NASをインストールする。

htmhsrestoreコマンドで，a.で取得したバックアップをHybrid Storeにリストアする。

Storeデータベースのデータを流用する

次の条件を満たす場合，OSのアップグレード前に定義ファイルやPerformanceデータベースなどのバックアップデータを取得しておくと，アップグレード後にデータを流用できます。

・OSのアップグレード後もホスト名に変更がない

・Performanceデータベースのバックアップデータのデータモデルバージョンが，OSアップグレード後のデータモデルバージョンよりも古いか，同一^※

注※ StoreデータベースのStoreバージョンが1.0の場合は，データモデルバージョンがOSアップグレード後と同一の場合だけ，データを流用できます。

Storeデータベースのデータを流用する手順の例を次に示します。

OSのアップグレード前にjpctool db backup（jpcctrl backup）コマンドでStoreデータベースのバックアップを取得する。

アップグレードしたOSにHTM - Agent for NASをインストールする。

jpctool db dmconvert（jpcdbctrl dmconvert）コマンドで，バックアップデータのデータモデルを新しいHTM - Agent for NASのデータモデルにコンバートする。
この操作は，StoreデータベースのStoreバージョンが2.0で，バックアップのデータモデルバージョンがOSアップグレード後のデータモデルバージョンより古い場合だけ必要な操作です。
jpctool db dmconvert（jpcdbctrl dmconvert）コマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」のコマンドの章を参照してください。

jpctool db restore（jpcresto）コマンドで，バックアップを取得したStoreデータベースをリストアする。

インストール先のディレクトリ属性が製品に設定したディレクトリ属性に変更される場合があります。

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

[マニュアル発行元]