このページでは、モニタリング ソリューションをアップグレードまたはアンインストールする方法について説明します。

アップグレードの手順

次の手順では、モニタリングソリューションをアップグレードする方法について説明します。

トラフィックと負荷が最小のときに、SAP トランスポート要求を実稼働システムにインポートします。営業時間外または週末に SAP トランスポート要求をインポートすることをお勧めします。ABAP エージェントは、標準オブジェクトに配置された複数の拡張機能を利用します。拡張機能はインポート時にこれらのオブジェクトの再コンパイルをトリガーします。これは、SAP 標準 HTTP クライアント、HTTP サーバー、SOAP ハンドラ、BSP コントローラ、UI5 アプリケーション、WebDynpro ページ、WebGUI ページ、SAP ゲートウェイ/バックエンド、ST05 トレース、アプリケーションログ、および読み取りアクセスログに影響します。

ABAP エージェントサービスの停止

アップグレードの前に、すべてのサービスを停止するには、次の手順を実行します。

  1. 次のトランザクションのインストゥルメンテーションを非アクティブ化します。/DVD/APPD_CUST.

    SAP システムのアップグレード手順

    アップグレード手順中に SAP 標準レポート BTCTRNS1(リリースされたバックグラウンドジョブを中断)を使用する場合は、このレポートを実行する前に ABAP エージェント統合を非アクティブ化します。ステータスコード Z の中断ジョブがテーブル TBTCO に存在する場合は、これらのレコードの削除を避けるために、ABAP エージェント統合を非アクティブ化しないでください。

    ステータスコード Z の中断ジョブがテーブル TBTCO に存在する場合は、SAP 標準レポート BTCTRNS2(中断バックグラウンドジョブをリリース)を実行した後に ABAP エージェント統合を非アクティブ化します。リリースバージョン 21.2.0 には、この推奨アップグレード手順に従わない場合に中断されたジョブが削除される可能性のある重大なバグ ASM-585 の影響を受けるすべてのリリースのホットフィックス トランスポート要求が含まれています。バージョン 4.5.1902.0 からバージョン 20.11.0 までの ABAP エージェントを使用している場合は、アップグレード アクティビティの前にホットフィックス トランスポート要求をインポートする必要があります。このホットフィックスを適用する場合、ダウンタイムと ABAP エージェントの非アクティブ化は必要ありません。「リリースノートバージョン 21.2.0」を参照してください。

  2. 次のトランザクションのすべてのパフォーマンス メトリック コレクタを停止します。/DVD/APPD_DI_CON.

  3. 次のトランザクションの HTTP SDK インスタンスを停止します。 /DVD/APPD_STATUS.

  4. HTTP SDK インスタンスに別の Linux マシンを使用する場合は、SDK Manager を停止します。 

    1 つの Linux マシンと SDK Manager インスタンスを複数の SAP システムで共有できます。同じ SDK Manager インスタンスを使用するすべての SAP システムに対して、手順 1 ~ 3 を他のすべての手順とともに実装してください。

ABAP エージェントの更新

すべてのトランスポート要求を次の順序でインポートする必要があります。

  1. SNP 再利用ライブラリ
  2. SNP CrystalBridge® Monitoring
  3. AppDynamics ABAP エージェント

ABAP エージェントがインポートされたら、トランザクション PFCG  ですべての /DVD/APPD* 権限ロールのプロファイルを再生成します。

他の Datavard または SNP 製品を使用している場合は、すべてのコンポーネントを同じバージョンにすることをお勧めします。新しいバージョンの再利用ライブラリがすでにシステムにインストールされている場合は、古いバージョンで上書きしないようにしてください。再利用ライブラリは下位互換性を念頭に置いて開発されているため、古いバージョンの SNP CrystalBridge® Monitoring(旧称 Datavard Insights)と ABAP エージェントは、新しいバージョンの再利用ライブラリでも正常に動作します。

互換性の問題やバージョンの競合が発生した場合は、AppDynamics サポートにお問い合わせください。

他の SNP 製品を使用している場合は、すべてのコンポーネントを同じバージョンにすることをお勧めします。再利用ライブラリまたは CrystalBridge® Monitoring(旧称 Datavard Insights)の新しいバージョンがシステムにすでにインストールされている場合は、古いバージョンで上書きしないようにしてください。ABAP エージェントは、新しいバージョンの再利用ライブラリと CrystalBridge® Monitoring でも正常に動作します。現在インストールされているバージョンを確認する方法の詳細については、「Check Reuse Library Version」を参照してください。

互換性の問題やバージョンの競合が発生した場合は、AppDynamics サポートにお問い合わせください。

Update the HTTP SDK

HTTP SDK を更新するには、次の手順を実行します。

  1. HTTP SDK インスタンスが SAP アプリケーションサーバーで直接実行されている場合、次の手順を実行します。
    1. ABAP エージェントを更新します。
    2. AppDynamics HTTP SDK Installation Manager を使用して HTTP SDK を更新します。「HTTP SDK の自動インストール 」を参照してください。
  2. HTTP SDK インスタンスと SDK Manager が別の Linux マシンで実行されている場合、次の手順を実行します。
    1. ダウンロードされたファイルのコンテンツを解凍します。
    2. HTTP SDK を手動で更新します。「HTTP SDK の手動インストール」を参照してください。

すべての ABAP エージェントサービスの開始

ABAP エージェントサービスを開始するには、次の手順を実行します。

  1. HTTP SDK インスタンスに別の Linux マシンを使用する場合は、SDK Manager を開始します。
  2. 次のトランザクションで HTTP SDK インスタンスを開始します。/DVD/APPD_STATUS.
  3. 次のトランザクションでインストゥルメンテーションをアクティブにします。/DVD/APPD_CUST.
  4. 次のトランザクションですべてのパフォーマンス メトリック コレクタを開始します。 /DVD/APPD_DI_CON.

アンインストール手順

モニタリング ソリューションをアンインストールするには、次の手順を実行します。

ABAP エージェントサービスの停止

アンインストールの前に、すべてのサービスを停止します。

  1. 次のトランザクションのインストゥルメンテーションを非アクティブ化します。/DVD/APPD_CUST.
  2. 次のトランザクションのすべてのパフォーマンス メトリック コレクタを停止します。/DVD/APPD_DI_CON.
  3. トランザクション内のすべての HTTP SDK インスタンスを停止します。/DVD/APPD_STATUS.

ABAP エージェントと SNP CrystalBridge® Monitoring のアンインストール

アンインストールするには、deletion transport requests SAP システムに次の順序でインポートします。

  1. AppDynamics ABAP エージェントのトランスポートのアンインストール。
  2. SNP CrystalBridge® Monitoring と再利用ライブラリのトランスポートのアンインストール。
  • 削除トランスポート要求は、削除フラグが設定されたリポジトリオブジェクトのリストを含む通常の SAP トランスポート要求(ワークベンチ要求)です。これらのトランスポート要求をインポートすると、データベーステーブル内のデータを含め、リストのオブジェクトがシステムから削除されます。これらのトランスポート要求は、元のインストール要求(同じオブジェクトのリスト)に基づいて作成され、アンインストールの際はインストールトランスポートとは逆の順序でインポートする必要があります。
  • 他の Datavard または SNP 製品を使用している場合は、すべての Datavard または SNP 製品を SAP システムからアンインストールする予定がない限り、手順 2 に従って SNP CrystalBridge® Monitoring と再利用ライブラリ(以前の Datavard Insights と再利用ライブラリ)のトランスポートをアンインストールしないでください。再利用ライブラリは、ほとんどの Datavard 製品コンポーネントと一部の SNP 製品コンポーネントで使用されます。アンインストールすると、SAP システムにインストールされているすべての Datavard 製品と一部の SNP 製品に直接影響する可能性があります。
  • それでも ABAP エージェントと SNP CrystalBridge® Monitoring の両方をアンインストールする場合は、AppDynamics サポートにお問い合わせください。


HTTP SDK のアンインストール

HTTP SDK インスタンスに別の Linux マシンを使用している場合は、このシステムを使用している SAP システムが他にないことを確認し、SDK Manager を停止します。

HTTP SDK をアンインストールするには、<appdynamics>/appdhttpsdk フォルダを削除します。 

デフォルトのパスは、/opt/appdynamics/appdhttpsdk(Linux の場合)および C:\AppDynamics\appdhttpsdk(Microsoft Windows の場合)です。

マシンエージェントのアンインストール

マシンエージェントを停止するには、「マシンエージェントの起動と停止」を参照してください。

エージェントをアンインストールするには、インストールディレクトリを削除します。

システムリフレッシュ手順

リリース 20.11.0 では、新しい ABAP エージェントの t-code が使用できます。t-code /DVD/APPD_REF_EXPORT  は、SAP システムリフレッシュ前にすべての ABAP エージェントの設定をバックアップするために使用されます。「ZIP ファイルにエクスポート」の方式が使用された場合、すべての ABAP エージェントの設定を復元するために t-code /DVD/APPD_REF_IMPORT  が使用されます。「システム更新後の設定の復元」を参照してください。  

拡張機能の無効化と有効化

リリース 20.11.0 以降、リリースの zip ファイルの X-Enhancements-<version> サブフォルダに新しいトランスポート要求が含まれています。トランスポート要求の正確な名前については、zip ファイルに含まれている readme.txt ファイルを確認してください。

  • Uninstall transport: AppDynamics ABAP agent enh <version>:ABAP エージェントのトランスポート要求によってインストールされたすべての拡張機能を削除することを目的としています。
  • 拡張機能の再インストールのトランスポート要求は、コンポーネント固有です。
    • AppDynamics ABAP agent CORE <version> enhancements :「ABAP agent CORE <version>」トランスポート要求に含まれるすべての拡張機能を再インストールするために使用されます。
    • AppDynamics ABAP agent BEP <version> enhancements:「ABAP agent BEP <version>」トランスポート要求に含まれるすべての拡張機能を再インストールするために使用されます。
    • AppDynamics ABAP agent RAL <version> enhancements:「ABAP agent RAL <version>」トランスポート要求に含まれるすべての拡張機能を再インストールするために使用されます。
    • AppDynamics ABAP agent 740 <version> enhancements:「ABAP agent 740 <version>」トランスポート要求に含まれるすべての拡張機能を再インストールするために使用されます。
    • AppDynamics ABAP agent <version> all enhancements :拡張機能のアンインストールのトランスポート要求によって削除された後に、すべての拡張機能を再インストールするために使用されます。このトランスポート要求は、ABAP エージェント 740 + IS-U がシステムにインストールされている場合に使用できます。

この方法は、次のシナリオで使用します。

  • ABAP エージェントの拡張機能(/DVD/APPD* または /DVD/MON*)が SAP システムのアップグレードの SPAU_ENH ステップをブロックしている。
  • これらの拡張機能が存在するため、SAP サポートがサポートアクティビティを続行できない。

インポートする前(ABAP エージェントサービスを停止)、およびこれらのトランスポート要求をインポートした後に(ABAP エージェントサービスを開始)、アップグレード手順のステップを実行します。「アップグレード手順」を参照してください。