2.1.2　インストールとセットアップの前に

(a)　IPアドレスの設定

PFM - Agentのホストは，ホスト名でIPアドレスを解決できる環境を設定してください。IPアドレスを解決できない環境では，PFM - Agentは起動できません。

PFM - Agent for Oracleでは，IPv4に加えIPv6およびデュアルスタック環境で動作させることができます。IPv6環境で動作させる場合，監視対象のOracleデータベースがIPv6環境をサポートしている必要があります。

監視ホスト名（Performance Managementシステムのホスト名として使用する名前）には，実ホスト名またはエイリアス名を使用できます。

• 監視ホスト名に実ホスト名を使用している場合

  Windowsシステムではhostnameコマンド，UNIXシステムではuname -nコマンドを実行して確認したホスト名で，IPアドレスを解決できるように環境を設定してください。なお，UNIXシステムでは，hostnameコマンドで取得するホスト名を使用することもできます。

• 監視ホスト名にエイリアス名を使用している場合

  設定しているエイリアス名でIPアドレスを解決できるように環境を設定してください。

監視ホスト名の設定については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

ホスト名とIPアドレスは，次のどれかの方法で設定してください。

• Performance Managementのホスト情報設定ファイル（jpchostsファイル）

• hostsファイル

• DNS（Domain Name System）

  重要

  • Performance Managementは，DNS環境でも運用できますが，FQDN形式のホスト名には対応していません。このため，監視ホスト名は，ドメイン名を除いて指定してください。

  • 複数のLAN環境で使用する場合は，jpchostsファイルでIPアドレスを設定してください。詳細は，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

  • Performance Managementは，DHCPによる動的なIPアドレスが割り振られているホスト上では運用できません。Performance Managementを導入するすべてのホストに，固定のIPアドレスを設定してください。

Performance Managementでは，ネットワーク構成がIPv4環境だけでなくIPv6環境にも対応しています。そのため，IPv4環境とIPv6環境が混在するネットワーク構成でも，Performance Managementを運用できます。

PFM - Agent for Oracleでは，PFM - ManagerとIPv6で通信できます。ただし，PFM - Agent for OracleおよびPFM - Managerが導入されているホストのOSが，WindowsまたはLinuxの場合に限ります。

IPv4環境とIPv6環境での通信の適用範囲については，「付録M　IPv4環境とIPv6環境での通信について」を参照してください。

IPv6で通信する場合，PFM - ManagerホストとPFM - AgentホストのそれぞれでIPv6の利用設定を有効にする必要があります。また，PFM - Agent for Oracleをインストールする前に，PFM - AgentホストでIPv6の利用設定を有効にする必要があります。この設定はjpcconf ipv6 enableコマンドで実行しますが，すでに有効になっている場合，この設定は必要ありません。IPv6の利用設定を確認するためには，jpcconf ipv6 displayコマンドを実行します。

jpcconf ipv6 enable，jpcconf ipv6 displayコマンドの詳細については，マニュアル「JP1/Performance Management リファレンス」のコマンドについて説明している章を参照してください。また，jpcconf ipv6 enableコマンドを実行する条件やタイミングについては，マニュアル「JP1/Performance Management 設計・構築ガイド」のIPv6環境が含まれる場合のネットワーク構成例について説明している章を参照してください。

なお，PFM - Agent for OracleとPFM - ManagerをIPv6で通信する場合，名前解決できるホスト名を指定してください。

PFM - Agent for OracleとPFM - Managerとの通信は，解決できるIPアドレスで通信します。また，PFM - Agent for OracleとPFM - Managerとの通信では，IPv4とIPv6が共存した環境の場合，解決できるIPアドレスで通信に失敗したとき，別のIPアドレスで通信することはありません。

例えば，IPv4で接続に失敗した場合，IPv6でリトライすることはありません。また，IPv6で接続に失敗した場合に，IPv4でリトライすることもありません。事前に接続できることを確認してください。

(b)　ポート番号の設定

Performance Managementプログラムのサービスは，デフォルトで次の表に示すポート番号が割り当てられています。これ以外のサービスまたはプログラムに対しては，サービスを起動するたびに，そのときシステムで使用されていないポート番号が自動的に割り当てられます。また，ファイアウォール環境で，Performance Managementを使用するときは，ポート番号を固定してください。ポート番号の固定の手順は，マニュアル「JP1/Performance Management 設計・構築ガイド」の，インストールとセットアップについて説明している章を参照してください。

表2‒1　デフォルトのポート番号とPerformance Managementプログラムのサービス（Windowsの場合）

機能	サービス名	パラメーター	ポート番号	備考
サービス構成情報管理機能	Name Server	jp1pcnsvr	22285	PFM - ManagerのName Serverサービスで使用されるポート番号。Performance Managementのすべてのホストで設定される。
サービス状態管理機能	Status Server	jp1pcstatsvr	22350	PFM - ManagerおよびPFM - BaseのStatus Serverサービスで使用されるポート番号。 PFM - ManagerおよびPFM - Baseがインストールされているホストで設定される。
監視コンソール通信機能	View Server	jp1pcvsvr	22286	PFM - ManagerのView Serverサービスで使用されているポート番号。 PFM - Managerがインストールされているホストで設定される。
Webサービス機能	Web Service	−	20358	PFM - Web ConsoleのWeb Serviceサービスで使用されているポート番号。
Webコンテナ機能	Web Console	−	20359 20360	PFM - Web ConsoleのWeb Consoleサービスで使用されているポート番号。
JP1/SLM連携機能	JP1/ITSLM	−	20905	JP1/SLMで設定されるポート番号です。

これらのPFM - Agentが使用するポート番号で通信できるように，ネットワークを設定してください。

(a)　監視対象プログラム

PFM - Agent for Oracleの監視対象プログラムを次に示します。

• Oracle Database Standard Edition

• Oracle Database Standard Edition One

• Oracle Database Standard Edition 2

• Oracle Database Enterprise Edition

これらの監視対象プログラムは，PFM - Agent for Oracleと同一ホストにインストールする必要があります。また，仮想化OS上で監視対象プログラムを監視する場合，監視対象プログラムが仮想化OS上で保障している機能だけが監視対象となります。

(b)　Performance Managementプログラム

監視エージェントには，PFM - AgentとPFM - Baseをインストールします。PFM - BaseはPFM - Agentの前提プログラムです。同一ホストに複数のPFM - Agentをインストールする場合でも，PFM - Baseは1つだけでかまいません。ただし，PFM - ManagerとPFM - Agentを同一ホストにインストールする場合，PFM - Baseは不要です。

また，PFM - Agent for Oracleを使ってOracleの稼働監視を行うためには，PFM - ManagerおよびPFM - Web Consoleが必要です。

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

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

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

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

• 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 - Web Console以外のすべてのPerformance ManagementプログラムをアンインストールしたあとにPFM - Manager，PFM - Agentの順でインストールしてください。また，PFM - Manager とPFM - AgentがインストールされているホストにPFM - Baseをインストールする場合も同様に，PFM - Web Console以外のすべてのPerformance ManagementプログラムをアンインストールしたあとにPFM - Base，PFM - Agentの順でインストールしてください。

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

• PFM - AgentがインストールされているホストにPFM - Managerをインストールすると，PFM - Agentの接続先PFM - Managerは自ホスト名に設定し直されます。共通メッセージログに設定結果が出力されています。結果を確認してください。

• PFM - Web Consoleがインストールされているホストに，PFM - Agentをインストールする場合は，Webブラウザの画面をすべて閉じてからインストールを実施してください。

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

  ヒント

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

(c)　バージョンアップの注意事項

バージョンアップインストールを行う前に，「2.2.2 (1)(b)Oracle Databaseへ登録したオブジェクトを削除する」を実行し，バージョンアップインストールが完了した後，「2.1.4 (3)(b)Oracle Databaseへオブジェクトを登録する」を実行する必要があります。

Performance Managementプログラムをバージョンアップする場合の注意事項については，マニュアル「JP1/Performance Management 設計・構築ガイド」のインストールとセットアップの章にある，バージョンアップの注意事項について説明している個所を参照してください。

PFM - Agent for Oracleをバージョンアップする場合の注意事項については，「付録H 移行手順と移行時の注意事項」を参照してください。

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

バージョンアップインストールを行った後に，「2.2.2 (1)(b)Oracle Databaseへ登録したオブジェクトを削除する」を実行した場合，メッセージ「ORA-04043：object LSC_13_PDDB2 does not exist」，「ORA-04043：object LSC_13_PIDB2 does not exist」，「ORA-04043：objectLSC_13_PIDB3 does not exist」が出力される場合がありますが，問題ありません。この場合も，「2.1.4 (3)(b)Oracle Databaseへオブジェクトを登録する」を，そのまま実行してください。

(d)　その他の注意事項

• Oracle Database 12c Release 1を監視する場合，CDB環境を監視することはできません。非CDB環境だけ監視できます。

• Oracle Database 12c Release 2以降を監視する場合，従来の非CDB環境に加え，CDB環境のPDB，およびルート・コンテナ（CDB$ROOT）を監視することができます。アプリケーション・コンテナ（アプリケーション・ルート，およびアプリケーションPDB）の監視をすることはできません。

• Performance Managementのプログラムが1つもインストールされていない環境に新規インストールする場合は，インストール先フォルダにファイルやフォルダがないことを確認してください。

• Performance Managementのプログラムおよびサービスや，Performance Managementのファイルを参照するような他プログラム（例えばWindowsのイベントビューアーなど）を起動したままインストールした場合，システムの再起動を促すメッセージが表示されることがあります。この場合は，メッセージに従ってシステムを再起動し，インストールを完了させてください。

• Performance Managementのプログラムおよびサービスや，Performance Managementのファイルを参照するような他プログラム（例えばWindowsのイベントビューアーなど）を起動したままの状態，ディスク容量が不足している状態，またはフォルダ権限がない状態でインストールした場合，ファイルの展開に失敗することがあります。Performance Managementのプログラムおよびサービスや，Performance Managementのファイルを参照するような他プログラムが起動している場合はすべて停止してからインストールし直してください。ディスク容量不足やフォルダ権限不足が問題である場合は，問題を解決したあとでインストールし直してください。

• Performance Managementのプログラムをインストールする場合，次に示すセキュリティ関連プログラムがインストールされていないかどうか確認してください。インストールされている場合，次の説明に従って対処してください。

  • セキュリティ監視プログラム

    セキュリティ監視プログラムを停止するかまたは設定を変更して，Performance Managementのプログラムのインストールを妨げないようにしてください。

  • ウィルス検出プログラム

    ウィルス検出プログラムを停止してからPerformance Managementのプログラムをインストールしてください。

    Performance Managementのプログラムのインストール中にウィルス検出プログラムが稼働している場合，インストールの速度が低下したり，インストールが実行できなかったり，または正しくインストールできなかったりすることがあります。

  • プロセス監視プログラム

    プロセス監視プログラムを停止するかまたは設定を変更して，Performance Managementのサービスまたはプロセス，および共通コンポーネントのサービスまたはプロセスを監視しないようにしてください。

    Performance Managementのプログラムのインストール中に，プロセス監視プログラムによって，これらのサービスまたはプロセスが起動されたり停止されたりすると，インストールに失敗することがあります。

• インストール先フォルダには，次のパスは指定しないでください。インストールに失敗することがあります。

  システムドライブ\Program files

• PFM - Agent for Oracleは，JP1/ServerConductor/Deployment Managerのディスク複製インストール，および仮想化プラットフォームが提供するイメージファイル化による複製機能に対応した日立プログラムプロダクトです。

  ディスク複製インストールについては，マニュアル「JP1/Performance Management 設計・構築ガイド」のディスク複製インストール時の注意事項について説明している章を確認してください。