HTTP SDK の手動インストール

このトピックでは、リモート Linux 64 ビットゲートウェイサーバー（リモートサーバー）への HTTP SDK の手動インストールについて説明します。この方法を使用する場合は、手動で HTTP SDK をインストール、更新、または再インストールする必要があります。

はじめる前に

  • SAP システムの 1 つ以上のアプリケーションサーバーがサポート対象外の OS で実行されている場合、または SAP システムに OS タイプが混在するアプリケーションサーバーがある場合（Linux と Microsoft Windows など）、この方法を使用します。「サポートされている OS」を参照してください。
  • リモートサーバーにターゲットディレクトリを作成します。デフォルトの推奨ディレクトリは /opt/appdynamics です。
  • GLIBC バージョンが 2.17 以降の場合は、リモート Linux サーバーの OS レベルを確認して、HTTP SDK の最新ビルドをインストールできるかどうかを判断します。

  • SDK Manager の TLS1.3 サポートにより、リモートシステムにJava （JRE または JDK）の最小バージョン 1.8_401（Java 8）が含まれていることを確認します。

  • ターゲットディレクトリに対するフルアクセス権（読み取り、書き込み、実行）を提供します。
  • HTTP SDK 更新の場合：
    • t-code / DVD/APPD_STATUS に移動し、このリモートサーバーを使用するすべての SAP システム上のすべての HTTP SDK インスタンスを停止します。
    • SDK Manager インスタンスを停止します。

HTTP SDK の手動インストールまたは更新

  1. 次の ABAP エージェント zip ファイルを解凍します。APPD-SAP-<version>.zip
  2. SapAgent-<version> ディレクトリの appdhttpsdk-latest または appdhttpsdk-legacy サブディレクトリ（GLIBC バージョンチェックに基づく）の内容を、リモートサーバー上の対象ディレクトリにある appdhttpsdk サブディレクトリにコピーします。
    1. 新しい HTTP SDK バージョンに更新する場合、既存のファイルを上書きします。
  3. HTTP SDK ディレクトリ（ およびそのすべてのファイルとサブディレクトリなど）に対するフルアクセス権（読み取り、書き込み、および実行）を提供し、SDK Manager を起動する任意のユーザーによる HTTP SDK の設定と制御を有効にします。

SDK Manager

リモートシステムで SDK Manager を起動して、HTTP SDK インスタンスのリモート制御とライフサイクル管理を有効にします。SDK Manager は HTTP SDK とともにインストールされます。

SDK Manager アプリケーションを起動するには、次のコマンドを実行します（別のターゲットディレクトリを使用する場合はコマンドパスを調整してください）。

/opt/appdynamics/appdhttpsdk/runSDKManager

オプション パラメータ：

  • -p <port number>：このパラメータを使用して、デフォルトの SDK Manager ポートである 7999 をオーバーライドします。

  • -j <path to java>：SDK Manager の JAVA_HOME 変数の設定に使用します。

  • -c：このパラメータを使用すると、SDK Manager は以前実行していた HTTP SDK インスタンスを再起動しません。

SDK Manager のスタートアップスクリプトを OS レベルのスタートアップスクリプトに追加することをお勧めします。これにより、リモートサーバーの HTTP SDK 自動再起動機能が有効になります。このシナリオでは、-c パラメータを使用しないでください。

SDK Manager インスタンスに接続するすべての SAP アプリケーション サーバー ホストの SDK Manager ポート（デフォルトは 7999）を開きます。このポートにより、HTTP SDK インスタンスの制御とログへのアクセスが可能になります。ABAP エージェントとリモート HTTP SDK インスタンス間の通信を有効にするには、SAP アプリケーションサーバーごとに追加のポートを開く必要があります。厳密なファイアウォールルールを使用している場合は、関連するホスト間のすべての関連ポートを開きます。

  • SDK Manager が 1 人のユーザーまたは 1 つのユーザーグループによって実行されていることを確認します。HTTP SDK プロキシ設定とログファイル認証は、SDK Manager を起動したユーザーとユーザーグループに制限されます。
  • SDK Manager は IPv4 プロトコルのみをサポートします。

リモート HTTP SDK のカスタムコントローラ証明書のインストール

リモート HTTP SDK のカスタムコントローラ SSL 証明書は、HTTP SDK とオンプレミスコントローラ間で SSL 通信を使用する場合にのみインストールする必要があります。

  1. Web ブラウザを使用して、コントローラに移動します。
  2. SSL 証明書を .crt 形式でダウンロードし、custom.crt として保存します。
  3. リモートサーバーで、HTTP SDK ディレクトリ（/opt/appdynamics/appdhttpsdk/ など）に移動します。
  4. ダウンロードした証明書をこのディレクトリにコピーします。
  5. トランザクションコード /DVD/APPD_CUST に移動します。
  6. 編集モードに切り替えます。
  7. カスタム証明書ファイル名（custom.crt など）を Custom SSL file (optional) フィールドに入力します。 
    Custom SSL file (optional)

  8. 設定を保存します。
  9. t-code /DVD/APPD_STATUS に移動し、すべての HTTP SDK インスタンスを再起動します。

トラブルシューティング

  • 「SDK マネージャーの起動に失敗しました。ログを確認してください」

    • SDK Manager をバインドしようとしているポートがブロックされておらず、開いていることを確認します。スクリプト「runSDKManager」を使用する場合、ポートはデフォルトで 7999 です。パラメータ「-p」を使用する場合は、使用するポートを確認します。ポートが未使用かどうかを確認するコマンドは次のとおりです。

      • Linux：netstat -tulpn | grep <port_number> - アクション「LISTEN」付きのレコードがある場合、ポートはすでに使用されています。

      • Windows：netstat -ano | Select-String <port_number> - アクション「LISTENING」付きのレコードがある場合、ポートはすでに使用されています。