HTTP SDK の自動インストール

このトピックでは、HTTP SDK の自動インストールについて説明します。自動 HTTP SDK インストールプログラムを使用することにより、SAP システムのすべてのアクティブなアプリケーション サーバー ノードに HTTP SDK をインストール、更新、および再インストールできます。

はじめる前に

  • GLIBC バージョンが 2.17 以降(Linux OS)または Visual C++ Redistributable バージョンが 2019 以降(Windows OS)の場合は、すべての SAP アプリケーションサーバーの OS レベルを確認して、HTTP SDK の最新ビルドをインストールできるかどうか判断します。詳細については、「サポートされる SAP アプリケーションサーバーのオペレーティングシステム」を参照してください。
    • Windows OS で古い C++ ランタイムが使用されている場合は、HTTP SDK をインストールする前に、すべての SAP アプリケーションサーバーに Visual C++ Redistributable バージョン 2019 以降をインストールします。
    • Linux OS で少なくとも 1 台のサーバーで古い C++ ランタイムが使用可能で、それを更新できない場合は、HTTP SDK のレガシービルドを使用するか、GLIBC バージョン 2.17 以降の専用 Linux サーバーで「HTTP SDK の手動インストール」を実行します。詳細については、「サポートされる SAP アプリケーションサーバーのオペレーティングシステム」を参照してください。
  • すべてのアプリケーション サーバー ノードにターゲットディレクトリを作成します。デフォルトのディレクトリは /opt/appdynamics(Linux)または C:\AppDynamics(Microsoft Windows)です。

    注: 共有フォルダ

    ABAP エージェントバージョン 24.5.0 では、共有ネットワークディレクトリを使用して、すべてのSAPインスタンスから 1 つのフォルダにHTTP SDK をインストールできます。

  • 各アプリケーション サーバー ノードのターゲットディレクトリに対する完全な権限を持つ OS ユーザー、<SID>adm または SAPService<SID を準備します。

  • 最初に ABAP エージェント をインストールまたは更新します。自動インストールに使用される HTTP SDK パッケージが含まれています。

  • HTTP SDK の更新の場合は、トランザクションコード /DVD/APPD_STATUS を使用して、実行中のすべての HTTP SDK インスタンスを停止します。

  • Microsoft Windows OS の場合:

    • 各アプリケーションサーバーに PowerShell をインストールします。

    • 実行ポリシーを RemoteSigned に設定します。管理者として次のコマンドを実行し、Y + Enter で確定します。

      PS C:\> Set-ExecutionPolicy
                      RemoteSigned

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

  1. トランザクションコード /DVD/APPD_SDK を使用して、 AppDynamics HTTP SDK Installation Manager アプリケーションを起動します。または、カスタマイズメニューの [SDK Installation] をクリックしてアプリケーションを起動することもできます。[AppDynamics HTTP SDK Installation Manager] 画面が表示されます。

    注: 最初の SDK のインストールの前に、カスタム インストール ディレクトリを選択するプロンプトが表示されます。選択したディレクトリはすべてのアプリケーションサーバーに使用されます。SAP OS ユーザーが、選択したディレクトリへのフルアクセス権を持ち、ディレクトリが他の SAP アプリケーションサーバーと共有されていないことを確認します。このプロンプトは、メニューの [Edit > Change Directory] からいつでも呼び出すことができます。
  2. [SDK Installation Manager] ページで、 [Install SDK]をクリックします。古いバージョンの C++ ランタイムの場合は、[Install Legacy SDK] をクリックします。

    すべてのインストール要件が満たされると、アプリケーションはすべてのアプリケーションサーバーに HTTP SDK をインストールします。

    注: 24.5.0 リリースから、同じ共有フォルダデプロイメントがサポートされ、同じ共有ネットワークドライブフォルダに複数の HTTP SDK インスタンスをデプロイメントできます。

インストールが成功し、次のインストールのように表示されているかどうかを確認します。

次の表に、フィールドと説明を示します。

フィールド説明
ステータス

特定のノードのインストールのグローバルステータス

  • 緑色は、ノードのインストール準備ができていること、または最新の SDK バージョンがインストールされていることを示します。

  • 黄色は、新しいバージョンが使用可能であるが、HTTP SDK インスタンスがまだ実行中であるため、すべてのインスタンスが停止するまで更新できないことを示します。

  • 赤色は、インストールの事前チェックでエラーがある可能性があることを示します。

ノード名アプリケーション サーバー ノードの名前
HTTP SDK folderHTTP SDK をインストールする SAP アプリケーションサーバー上のローカルディレクトリ
Directory Exists
  • 緑色は、ターゲットディレクトリがアプリケーション サーバー ノードに存在することを示します。

  • 赤色は、アプリケーション サーバー ノードにターゲットディレクトリがないことを示します。

Write Access
  • 緑色は、<SID>adm または SAPService<SID> ユーザーがターゲットディレクトリに対する書き込みアクセス権を持っていることを示します。

  • 赤色は、<SID>adm または SAPService<SID> ユーザーにターゲットディレクトリへの書き込みアクセス権がないことを示します。

SDK Installed
  • グレーは、ターゲットディレクトリで HTTP SDK バージョンが検出されなかったことを示します。

  • 緑色は、最新の HTTP SDK バージョンがターゲットディレクトリにインストールされていることを示します。

  • 黄色は、より新しい HTTP SDK バージョンが使用可能であることを示します。

SDK Stopped
  • 緑色は、特定のアプリケーション サーバー ノードで HTTP SDK インスタンスが実行されていないことを示します。

  • 黄色は、アプリケーション サーバー ノードにアクティブな HTTP SDK インスタンスが存在することを示します。HTTP SDK の更新または再インストールに進む前に、すべての HTTP SDK インスタンスを停止してください。

現在アプリケーションサーバーに現在インストールされている HTTP SDK のバージョンを表示します。
新規作成(New)最新の ABAP エージェントトランスポート要求で提供される HTTP SDK の最新バージョンを表示します。

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

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

  1. Web ブラウザを使用して、コントローラに移動します。
  2. SSL 証明書を.crt 形式でダウンロードし、custom.crt として保存します。
  3. トランザクションコード /DVD/APPD_SDK に移動します

  4. メニューから [Edit > Upload Cust SSL file] を選択します。

  5. 証明書ファイルを選択し、[Open] をクリックします。

  6. トランザクションコード /DVD/APPD_STATUS に移動し、すべての HTTP SDK インスタンスを再起動します。

トラブルシューティング

  • /opt/appdynamics フォルダへの書き込みアクセスなし

    • OS ユーザー <SID>adm にこのフォルダに対するフル権限があることを確認します。

    • または、/tmp/appdynamics などの別のフォルダを使用します。

  • 書き込みアクセス権が指定されていても、「ディレクトリを作成できない」

    • HTTP SDK をインストールするには、サブディレクトリを作成する必要があります。ユーザーがトップディレクトリだけでなく、サブディレクトリを作成および変更する権限も持っていることを確認します(Linux のパラメータ -R)。

  • HTTP SDK の新しいバージョンへの更新が失敗する

    • 古い HTTP SDK インスタンスが停止していることを確認します(/DVD/APPD_STATUS で停止しているように見える場合は、OS レベルで手動で確認してください)。

  • すべてのインスタンスが開始された後、1 つのHTTP SDK インスタンスのみが実行される

    • インストールディレクトリが複数の SAP アプリケーションサーバー間で共有されていないことを確認します。

    • 共有ネットワークディレクトリの場合は、そのディレクトリをすべての SAP アプリケーションサーバーで一意のローカルディレクトリに変更し、HTTP SDK を再インストールして、すべてのインスタンスを再起動します。

  • HTTP SDK / C++ SDK がコントローラへの接続を初期化できない
    • 正しいコントローラ設定が維持されていることを確認します。「SAP ABAP エージェントのセットアップ」を参照してください。
    • 特定の接続エラーに関する詳細については、/DVD/APPD_STATUS → ログで C++ SDK ログを確認してください。
    • C++ SDK ログに WINHTTP_CALLBACK_STATUS_FLAG_CERT_REV_FAILED エラーが含まれている場合は、エキスパートの設定 「HTTP_SDK_CONT_IGNORE_CRL」 を使用して、証明書失効のチェックを抑制できます。「エキスパート設定」を参照してください。