1. PeopleSoftの可観測性および管理スタック・モニタリングの有効化
  2. デプロイメント・プロセスのスタート・ガイド

デプロイメント・プロセスのスタート・ガイド

PeopleSoftアプリケーションの可観測性と管理スタックの監視をデプロイするには、次の3つの主要なステップが必要です。

  1. お客様が選択したエディション、StandardまたはEnterprise、ならびにデプロイメントで使用されるリソースまたはコンパートメントのライセンスを構成します。
  2. デプロイメントで使用されるリソースを検出してプロモートします。
  3. OCIコマンドライン・インタフェース(CLI)を使用して、新しいリソースの検出、スタック・モニタリング・リソース間の必要なアソシエーションの作成、またはトポロジ全体のリフレッシュを行います。

ライセンスを構成します

Stack Monitoringには、StandardとEnterpriseの2つのエディションがあります。Standard Editionは、オンプレミスおよびクラウドにデプロイされたアプリケーションおよびテクノロジ・スタック(WebLogic、Tomcat、Oracle Database、ホストなど)を監視します。Enterprise Editionは、メトリック拡張、パフォーマンス・ベースライン、異常検出、OCIリソース統合などの高度な機能を追加して、監視を強化します。

これらの2つのエディションに加えて、次に説明するように、個々のリソース・レベルまたはコンパートメント・レベルのいずれかでライセンスを構成する必要があります。

ノート:

どちらのレベルでもライセンスを割り当てる手順は、このプレイブックの範囲を超えています。各割り当てレベルに必要な関連手順には、下記の「詳細を見る」から、このプレイブックの他の場所からアクセスできます。

コンパートメント固有の機能のライセンスの構成

コンパートメント内で新しく検出または昇格されたすべてのリソースについて、リソース・ライセンスの自動割当をEnterpriseまたはStandardに設定できます。ライセンス自動割当ての構成は、リソース・インスタンス単位でライセンスを適用するのではなく、自動的にライセンスを割り当てる便利な方法です。また、コンパートメント全体のエンタープライズ拡張性を有効または無効にできます。

コンパートメント固有の機能のライセンスの構成手順は、Oracle Cloud Infrastructureドキュメントのライセンス割当てに関する項で説明されており、「詳細」からアクセスできます。

リソース固有の機能のライセンスの構成

リソース・ライセンス割当は、検出時または検出後にライセンスUIを使用して個々のリソース・レベルで実行できます。コンポジットに適用されるライセンス変更は、すべての子に適用されます。つまり、Enterprise EditionライセンスをWebLogicドメインに適用すると、そのドメインに関連付けられているすべてのWebLogicサーバーもEnterprise Editionを受信します。

検出時に、対応するラジオ・ボタンを選択して、リソースにライセンスを割り当てることができます。ライセンスUIを使用してリソースが検出された後に、リソース・ライセンスを変更することもできます。これらの手順は、Oracle Cloud Infrastructureドキュメントのライセンス割当に関する項で説明されており、「詳細」からアクセスできます。

PeopleSoftのリソースの検出および昇格

スタック・モニタリングを使用してリソースをモニターするには、まずこれらのリソースを検出してプロモートする必要があります。プロモーションでは、リソースに関連する情報が事前移入されます。この情報が正しいことを確認するために、この情報を検証する必要があります。プロモーションの前提条件および入力パラメータは、ユーザーが開始した検出の前提条件および入力パラメータと同じです。

PeopleSoft検出には、3つの必須リソース・ファミリ(アプリケーション・サーバー・ドメイン、プロセス・スケジューラ・ドメイン、およびPeopleSoft Internet Architecture (PIA)とその基礎となるWeblogicドメイン)が含まれます。各リソース・ファミリには、複数のサーバーにまたがる可能性のある1つ以上のリソースを含めることができます。

PeopleSoftアプリケーションのリソースを検出およびプロモートするには、次を実行する必要があります:
  • PeopleSoftデータベースを検出します。
  • PeopleSoftモニタリングのデータベース権限を確立します。
  • PeopleSoft Performance Monitor for Pure Internet Architecture (PIA)を有効にします。
  • アプリケーション・サーバーおよびプロセス・スケジューラ・ドメインの前提条件を満たします。
  • 検出するドメインを特定します。
  • ドメインを手動で追加します。
  • Elasticsearch検出を有効にします。
  • プロセスモニターの検出を有効にします。

ノート:

リソースの検出と昇格のステップは、このプレイブックの範囲外です。各割り当てレベルに必要な関連手順には、下記の「詳細を見る」から、このプレイブックの他の場所からアクセスできます。

PeopleSoftデータベースの検出

PeopleSoftアプリケーションを検出する前に、PeopleSoftスキーマを含むOracle Databaseを検出する必要があります。

最初にデータベースを検出すると、PeopleSoftリソース検出が完了すると、そのデータベースは自動的にPeopleSoftアプリケーションに関連付けられます。データベースが検出される前にPeopleSoftアプリケーション検出を実行する場合は、手動でアソシエーションを作成する必要があります。詳細は、アプリケーション・トポロジを参照してください。Oracleデータベースを検出するには、「Oracle Database」を参照してください。このデータベースには、このプレイブックの他の場所からアクセスできます。

PeopleSoftモニタリングのデータベース付与権限の確立

PeopleSoftを監視するには、PeopleSoftデータベース・スキーマにアクセスするための特定の権限が必要です。設定は、PeopleSoftデータストアとして使用されるデータベースのタイプ(非コンテナ・データベースとコンテナ・データベースおよびプラガブル・データベース)によって異なります。

PeopleSoftスタック・モニタリングを検出する場合、PeopleSoftスキーマ所有者(通常はSYSADM)をデータベース資格証明として使用できます。PeopleSoftアプリケーションの監視に必要な権限のみを持つモニタリング・ユーザーを作成する必要があります。PeopleSoftスキーマとPeopleSoftアプリケーションを含むOracleデータベースの両方を監視するには、同じデータベース・ユーザーを使用します。

データベース監視ユーザーを作成するには、MOSノート: 2857604.1を参照してください。詳細は、OCIドキュメントの「PeopleSoftモニタリングのDB権限付与」も参照してください。この両方のドキュメントには、このプレイブックの他の場所にある「詳細を見る」からアクセスできます。

PeopleSoft Performance Monitor for Pure Internet Architecture (PIA)の有効化

これはオプションのプロシージャであり、PeopleSoftの検出およびリフレッシュにのみ必要です。ただし、通常の監視およびメトリック収集では、PeopleSoft Performance Monitorエージェントは必要ありません。なんらかの理由でPPMエージェントを有効にしない場合は、次のいずれかの方法を使用します。
  • 検出またはリフレッシュが終了するまでPPMエージェントを有効化し、無効化してドメインを再起動します。
  • すべてのPeopleSoftドメイン情報を手動でINSERT/DELETEします。これにより、「PPMエージェントの有効化」を有効にする必要がなくなります。
PPM for PIAを有効にする必要がある場合は、次の手順を実行します。
  1. PeopleToolsに移動し、「Webプロファイル」に移動して「Webプロファイル構成」をクリックし、使用中のプロファイル(PRODなど)を検索します。
  2. まだ選択されていない場合は、「PPMエージェントの有効化」を選択します。
  3. すべてのPIAドメインを再起動します。

アプリケーション・サーバーおよびProcess Schedulerドメインの前提条件の確認

次に、各アプリケーション・サーバーおよびプロセス・スケジューラ・ドメインの前提条件を満たす必要があります。PeopleSoft検出では、JMXアクセスのリモート管理ユーザーID/パスワードがすべてのアプリケーション・サーバー・ドメインおよびすべてのプロセス・スケジューラ・ドメインで同じであるとみなされます。

完了する必要がある前提条件は次のとおりです。
  • PeopleSoft Performance Monitorエージェントを有効にします。
  • JMXエージェントを有効にします。
  • パフォーマンス・コレータ・プロパティを有効にします。

次の各項では、これらのタスクを完了するためのステップの概要を説明します。詳細な手順については、スタック・モニタリングOCIドキュメントの「アプリケーション・サーバーおよびProcess Schedulerドメインの前提条件」を参照してください。このドキュメントには、このプレイブックの他の場所からアクセスできます。

PeopleSoft Performance Monitorエージェントの有効化

PeopleSoft Performance Monitorエージェントを有効にするには、次を実行します。

  1. ドメイン構成ファイルを編集モードで開きます。PSADMINコマンドライン・インタフェースから、「アプリケーション・サーバー(オプション1)」または「Process Scheduler(オプション2)」を選択し、「ドメインの管理(オプション1)」、「ドメインの選択」、「構成/ログ・ファイルの編集」メニュー(オプション6)、「ドメイン構成ファイルの編集(オプション1)」の順に選択します。
  2. 「PSTOOLS」セクションで、EnablePPMエージェントの値を確認します。
  3. PPMエージェントを有効にし、値を1に設定してファイルを保存します。
JMXエージェントの有効化

この前提条件により、スタック・モニタリングはPeopleSoftアプリケーションの可用性およびパフォーマンス・データを収集できます。主なステップは次のとおりです:

  1. PSADMINコマンドライン・インタフェースからドメイン構成ファイルを編集モードで開きます。「アプリケーション・サーバー(オプション1)」または「Process Scheduler(オプション2)」を選択し、「ドメインの管理(オプション1)」、「ドメインの選択」、「構成/ログ・ファイルの編集メニュー(オプション6)」、「ドメイン構成ファイルの編集(オプション1)」の順に選択します。
  2. 「PSTOOLS」セクションの設定を見つけて、次を実行します。
    1. 使用するリモート管理ポートがホスト上の他のプロセスによって使用されていないことを確認します。
    2. テキスト形式でユーザーIDを設定します。すべてのアプリケーションサーバードメインおよびプロセススケジューラドメインに同じユーザーIDおよびパスワードを使用します。
    3. PSCipherユーティリティを使用してパスワードを暗号化します。
    4. パフォーマンス・コレータ・プロパティの変更を構成した後(次のトピックを参照)、アプリケーション・サーバーを再起動し、スケジューラ・ドメインを処理します。
  3. リモート管理ポートおよびRMIポートの値を設定します。
    • PeopleSoftバージョン8.59以前を使用している場合は、リモート管理ポートのみを設定する必要があります。RMIポート値は、リモート管理ポートの値を1ずつ増やすことで自動的に設定されます。
    • PSFTバージョン8.60以降では、RMIポートは構成ファイル内の1つの追加パラメータによって制御されます。値が明示的に設定されていることを確認します。パフォーマンス・コレータ・プロパティを構成した後、アプリケーション・サーバーおよびProcess Schedulerドメインを再起動します。
  4. 保存した設定が構成ファイルに正しく表示されることを確認します。
詳細な手順は、OCIドキュメントの「JMXエージェントの有効化」を参照してください。このドキュメントには、このプレイブックの他の場所からアクセスできます。
パフォーマンス・コレータ・プロパティの有効化

パフォーマンス・コレータ・プロパティを有効にする前に、ドメイン・テンプレート・ファイルpsprcsrv.ubx (プロセス・スケジューラ)および$PS_CFG_HOMEにあるpsappsrv.ubx (アプリケーション・サーバー)でパフォーマンス・コレータの現在の値を確認します。

パフォーマンス・コレータが有効になっている場合は、次のエントリが表示されます。 
{PPM} Do you want Performance Collators configured (PSPPMSRV) (y/n)? [y]:
パフォーマンス・コレータが無効になっている場合は、次のエントリが表示されます。 
{PPM} Do you want Performance Collators configured (PSPPMSRV) (y/n)? [n]:
パフォーマンス・コレータがすでに有効化されており、変更がEnablePPMエージェントまたはJMX値に実装されている場合は、すべてのドメインを再起動できます。パフォーマンス・コレータがまだ有効になっていない場合は、次の手順を実行します。
  1. PSADMINコマンドライン・インタフェースから、Application Server (Option 1)またはProcess Scheduler (Option 2)、Administer a domain (Option 1)、select domain、Configure this domain (Option 4) の順に選択します。
  2. 質問Do you want to continue (y/n)にyと入力します。このオプションはドメインを停止します。
  3. パフォーマンス・コレータ・プロパティの値を確認してください。
    • 値が「はい」に設定されている場合、コレータはすでに使用可能であり、処理は必要ありません。 
      Load config as shown
      「アプリケーション・サーバー」にオプション14、「Process Scheduler」にオプション7を選択できます。
    • 値を「いいえ」に設定した場合は、「アプリケーション・サーバー」にオプション10、「Process Scheduler」にオプション3を入力して値を「はい」に切り替えます。
  4. パフォーマンス・コレータが「はい」に設定されていることを確認した後、Load config as shown (アプリケーション・スケジューラの場合はオプション14、Process Schedulerの場合はオプション7)を選択します。
  5. 最後に、Boot this domain Option 1を選択してドメインを起動します。

検出するドメインの識別

スタック・モニタリングでは、Oracle Database内に格納されている情報を利用して、検出またはリフレッシュするドメインを識別します。

現在のドメインのリストを検証するには、次の問合せを使用します。
SELECT * FROM PSPMAGENT;
PeopleSoftアプリケーションを検出またはリフレッシュする前に、問合せによって返された、存在しなくなったドメインを削除する必要があります。

ノート:

リストされていないドメインを追加する必要がある場合は、次のトピック「ドメインを手動で追加する」を参照してください。
失効したドメインを削除するには、SYSADMまたは同等のユーザーとしてログインし、次のSQL問合せを実行します。失効しているドメインをすべて削除するまで、問合せを繰り返します。次の考慮事項に注意してください:
  • 変更を行う前に、PSPMAGENT表をバックアップします。 
    create table PSPMAGENT_BKP_DATE as select * from PSPMAGENT;

    ここで、DATEと現在のタイムスタンプ

  • 作成したバックアップ表に親表と同じコンテンツがあることを確認します。 
    select * from PSPMAGENT 
MINUS 
select * from PSPMAGENT_BKP_DATE;
PSPMAGENTの行数がPSPMAGENT_BKP_DATEと一致する場合は、失効したドメインの削除を続行します。 
delete from PSPMAGENT WHERE PM_AGENTID='&enter_agent_id_of_stale_domain'; 
Commit;

ドメインの手動追加

次に、すべての有効なドメインがPSPMAGENTテーブルから表示されるかどうかを確認します。有効なドメインが表示されない場合は、次のトピックの問合せを使用します。エージェント・ホストは、PSPMAGENT表に格納されているPM_HOST_PORT列のホスト名を使用して他のすべてのホストにアクセスできる必要があります。

手動で追加する必要があるドメインは次のとおりです。
  • Process Schedulerドメイン
  • アプリケーション・サーバー・ドメイン
  • PIAサーバー
続行する前に、次を実行してPSPMAGENT表をバックアップします。
  1. 変更を行う前に、システム管理者または同等のユーザーとしてログインし、テーブルをバックアップします。 
    create table PSPMAGENT_BKP_DATE as select * from PSPMAGENT;
    ここで、DATEは現在のタイムスタンプです。
  2. 作成したバックアップ表に親表と同じコンテンツがあることを確認します。PSPMAGENTの行数は、PSPMAGENT_BKP_DATEの行数と一致する必要があります。
    select * from PSPMAGENT 
MINUS 
select * from PSPMAGENT_BKP_DATE;
    ここで、DATEは現在のタイムスタンプです。
ドメインを追加するには、次のコマンドを使用します。
  • Process Schedulerドメイン
    INSERT INTO  PSPMAGENT values
('&AGENT_ID','&PM_JMX_RMI_PORT','PSMONITORSRV','&DOMAIN_NAME','04','&DOMAIN_DIR','Y','&HOST_PORT:','1','1','N');
  • アプリケーション・サーバー・ドメイン
    INSERT INTO  PSPMAGENT values
('&unique_agent_id','&JMX_RMI_PORT','PSMONITORSRV','&DOMAIN_NAME','01','&DOMAIN_DIR','Y','&host_name:&jolt_port','1','1','N');
  • PIAサーバー
    INSERT INTO  PSPMAGENT values
('&unique_agent_id','-1','WEBRESOURCE','&DOMAIN_NAME','02','&DOMAIN_DIR','Y','&host_name:&http_port:&https_port','1','1','N');

Elasticsearch検出の有効化

Elasticsearchの検出はオプションです。Elasticsearchがすでに統合されている場合は、初期検出に含めることができます。将来Elasticsearchを統合するには、PeopleSoft CLI refreshコマンドを使用し、Elasticsearchデータベース権限をモニタリング・ユーザーに追加します。 権限の詳細は、前述の「PeopleSoftモニタリングのデータベース付与権限の確立」を参照し、CLIリフレッシュ・コマンドの詳細は、このプレイブックの他の場所にある「PeopleSoftインスタンスのリフレッシュ」を参照してください。
次の前提条件を完了すると、PeopleSoftでElasticsearch統合が有効になります:
  • Stack Monitoringは、SSLで構成されたElasticsearchの監視のみをサポートします。エンドポイントはHTTPSである必要があります。Elasticsearchの設定の詳細は、このプレイブックの他の場所にある「詳細を見る」からアクセスできるPeopleSoftとElasticsearchの間のSSLの構成を参照してください。
  • Elasticsearchを検出する前に、モニタリング・エージェント・ホストにJKSトラストストア(JKSのみがサポートされているトラスト・ストア)を作成し、Elasticsearchからの証明書を格納します。このトラストストアの場所とパスワードは、CLIによる検出を試行する際の検出UIまたは検出JSONの必須パラメータです。また、エージェント・ホストでトラスト・ストアの場所にアクセスできる必要があります。
    たとえば次のようにします。 
    keytool -keystore truststore.jks -alias ALIAS -import -file ELASTICSEARCH_CERTIFICATE

プロセス・モニター検出の有効化

プロセス・モニターは、PeopleSoftとともに検出され、PeopleSoftアプリケーションの検出時にデフォルトで有効になります。「プロセス・モニターの検出」セクションで「いいえ」を選択すると、PeopleSoft検出からプロセス・モニターが除外されます。

プロセス モニターの検出はオプションです。プロセス・モニターがすでに有効になっている場合は、初期検出に含めることができます。今後、プロセス・モニターを統合するには、PeopleSoft CLI refreshコマンドを使用し、プロセス・モニターDB権限をモニタリング・ユーザーに追加します。権限の詳細は、前述の「PeopleSoftモニタリングのデータベース付与権限の確立」を参照し、CLIリフレッシュ・コマンドの詳細は、このプレイブックの他の場所にある「PeopleSoftインスタンスのリフレッシュ」を参照してください。

プロセス・モニターの検出に必要なプロパティはありません。

プロセス・モニターの検出は、デフォルトで含まれています。オプトアウトするには、「リソース内のプロセス・モニターの検出」検出パネルで「いいえ」を選択します。

詳細は、このプレイブックの他の場所にある「詳細を見る」からアクセスできる「PeopleSoftのプロセス・モニター検出の有効化」を参照してください。

アプリケーション・トポロジの更新

OCI CLIを使用して、新しいリソースの検出、スタック・モニタリング・リソース間の必要なアソシエーションの作成、またはトポロジ全体のリフレッシュを行うことができます。具体的には、CLIを使用して、データベースとPeopleSoft間のアソシエーションを作成できます。

PeopleSoftの場合、アプリケーション・トポロジの更新には、次のタスクが必要です。
  • PeopleSoftドメインを管理します。
  • PeopleSoftインスタンスをリフレッシュします。

PeopleSoftドメインの管理

スタック・モニタリングでは、PSPMAGENT表に含まれるドメイン情報を検出に利用します。PeopleSoftドメインがない場合は、このプレイブックの他の場所にある「ドメインを手動で追加」で説明されているステップに従って、必要なドメイン情報を手動で作成できます。

PeopleSoftインスタンスのリフレッシュ

次のスタック・モニタリング・リソース・タイプのPeopleSoftアプリケーション・リフレッシュ:

oracle_psft
oracle_psft_appserv
oracle_psft_prcs
oracle_psft_pia
weblogic_domain (including members)

リフレッシュでは、リフレッシュ・プロセス中に見つかった新規ドメインの資格証明は検証されません。検出プロセス中に障害が発生したドメインが検出された場合、これらは古いドメインである可能性があり、エージェントからのJMX接続、またはその他の理由でアクセスできない可能性があります。基礎となる問題が解決したら、エージェント・ホストからJMX接続を介して検証し、リフレッシュ操作を実行して、追加する新規ドメインごとに共通資格証明が有効であることを確認します。リフレッシュに成功すると、新しいドメインが追加されます。これらのドメインは、事前に検出されたドメインが構成されているものと同じ共通資格証明を使用します。

リフレッシュによって、既存の関連付けられたWebLogicドメインとそのメンバーもリフレッシュされます。

新しいPIAインスタンスが追加されると、PeopleSoftリフレッシュを実行すると、新しく追加されたPIAリソースが検出されますが、基礎となる新しいWebLogicドメインは検出されません。CLIを使用してWebLogicドメインを手動で検出し、その新しいWebLogicドメインを新しく検出されたPIAに関連付ける必要があります。

PeopleSoftインスタンスは、UIから、またはCLIを使用してリフレッシュできます。
  • UIからリフレッシュするには、リソースのホーム・ページから、リソース名の下にある「リフレッシュ」をクリックします。確認メッセージで、「OK」をクリックして、リソース検出パネルを新しいタブで開きます。送信済リフレッシュ・ジョブのステータスはここで追跡できます。
  • CLIを使用してリフレッシュするには、discovery-job createを実行する必要があります。このオプションにはJSONファイルが含まれます。リフレッシュ操作中にリソースの削除を許可するには、allow_delete_resourcesプロパティをresource_id propertyおよびモニタリング・エージェントIDプロパティとともにペイロードに追加する必要があります。resource_idは、リフレッシュする必要があるPeopleSoftリソースのIDです。
    CLIを使用してPeopleSoftインスタンスをリフレッシュするには、次のコマンドを使用します:
    oci stack-monitoring discovery-job create --compartment-id "Compartment_OCID" --discovery-type REFRESH --discovery-details file:///tmp/psft_refresh_dev.json

PeopleSoftインスタンスのリフレッシュの詳細は、OCIドキュメントのPeopleSoftリフレッシュに関する項を参照してください。このドキュメントには、このプレイブックの他の場所にある「詳細」からアクセスできます。