Related pages:

新しいバージョンの AppDynamics .NET エージェント用 MSI インストーラパッケージは、更新されたエージェントファイルをインストールし、従来の構成を維持します。3.9 より前のバージョンの .NET エージェントをアップグレードする場合は、最初に既存の .NET エージェントをアンインストールする必要があります。

AppDynamics Azure サイト拡張を使用する場合は、「Install the AppDynamics Azure Site Extension」を参照してください。

要件

  • はじめに、環境に影響を与える変更点についてリリースノートを確認してください。

  • AppDynamicsは、シングルテナントコントローラアカウントへのエージェント接続にアカウントアクセスキーを要求します。AppDynamicsの4.1以前のバージョンは、マルチテナントコントローラアカウントのアカウントアクセスキーを要求します。


    シングルテナント コントローラのお客様は、Settings > License > Account をクリックするとコントローラにアカウントのアクセスキーが表示されます。ライセンス表示レベルのアカウント権限を持つロールのメンバーである必要があります。「Roles and Permissions」を参照してください。


    .NETエージェントは、以下のバージョンのインプレースアップグレードのみをサポートしています。

    • 3.9以降
    • 現在インストールされているバージョン以降のメジャーおよびマイナーリリース。パッチリリースについては、アップグレード前に既存のエージェントのアンインストールが必要。

    例えば、パッチリリース4.1.0.1または4.1.0.0.をインストールするには、アップグレード前に既存のエージェントをアンインストールしてください。

バージョン 3.9 以降からの .NET Agent のアップグレード

現在のバージョンへのパッチを除いて、最初に古いエージェントをアンインストールする必要がないのは、.NET Agentバージョン 3.9 以降からアップグレードする場合です。

  1. インストゥルメント化された IIS アプリケーションの w3wp プロセスを停止。インストゥルメント化されたWindowsサービスまたはスタンドアロンアプリケーションを停止。
  2. AppDynamics ダウンロードセンターから MSI インストーラパッケージをダウンロードする。
  3. 完全な管理者権限で、高度なコマンドプロンプトを起動。「管理者としてコマンドプロンプトを起動」を参照してください。管理者グループのメンバーとして Windows にログインしても、インストーラを実行するための十分な権限が付与されません。
  4. シングルテナント コントローラ アカウントを使用している場合は、コントローラで Settings > License > Account をクリックしてアクセスキーを表示。

  5. コマンドラインエージェントのインストールを実行。シングルテナント コントローラ アカウントの場合、AD_CONTROLLER_ACCOUNT_ACCESS_KEY パラメータを使用してアカウントアクセスキーを指定。例：

    msiexec /i "%USERPROFILE%\Downloads\dotNetAgentSetup.msi" /l log.txt /q AD_CONTROLLER_ACCOUNT_ACCESS_KEY=changeme

    インストールがバックグラウンドで静かに実行。

    シングルテナント コントローラ アカウント用のアカウントアクセスキーを追加し忘れた場合、エージェント構成ユーティリティを実行するか、後から config.xml に手動で追加できます。「.NETエージェントの構成プロパティ」の「アカウントエレメント」を参照してください。

  6. IISを再起動。
    • AppDynamics エージェント構成ユーティリティを起動し、Configuration Summary ウィンドウで Restart IIS をクリック。
      または
    • コマンドラインから iisreset を実行。
    Windowsサービスとスタンドアロンアプリケーションを再起動。

バージョン 3.7.8 ～ 3.8.6 からの .NET Agent のアップグレード

古いバージョンのエージェントのアンインストール

  1. IIS、インストゥルメント化されたWindowsサービス、インストゥルメント化されたスタンドアロンアプリケーションを停止。

    IISをシャットダウンしてもアクティブなIISワーカープロセスが引き続き表示される場合は、IISマネージャーでアプリケーションプールペインを確認し、開始されたアプリケーションプールを停止します。

    マシンを再起動する必要があるのは、.NET Agentをアンインストールする前にインストゥルメント化されたアプリケーションの停止に失敗した場合です。

  2. AppDynamics.Agent.Coordinator サービスを停止。

  3. コントロールパネルで、プログラムの追加/削除を選択。AppDynamics .NET Agent を削除。

    一部の事例では、他のプロセスが profiler.dll をロックすることで .NET エージェントのアンインストールプロセスに干渉することがあります。アンインストールに失敗した場合は、Process Explorer などのユーティリティを使用して、プロセスが profiler.dll を使用しているかどうかを確認してください。使用している場合は、そのプロセスを終了します。それ以外の場合は、マシンを再起動してみてください。その後にアンインストールを再試行します。

新しいバージョンのエージェントのインストール

  1. インストゥルメント化された IIS アプリケーションの w3wp プロセスを停止。インストゥルメント化されたWindowsサービスまたはスタンドアロンアプリケーションを停止。
  2. AppDynamics ダウンロードセンターから MSI インストーラパッケージをダウンロードします。
  3. 完全な管理者権限で、高度なコマンドプロンプトを起動。「管理者としてコマンドプロンプトを起動」を参照してください。管理者グループのメンバーとして Windows にログインしても、インストーラを実行するための十分な権限が付与されません。
  4. シングルテナント コントローラ アカウントを使用している場合は、コントローラで Settings > License > Account をクリックしてアクセスキーを表示。

  5. コマンドラインエージェントのインストールを実行。シングルテナント コントローラ アカウントの場合、AD_CONTROLLER_ACCOUNT_ACCESS_KEY パラメータを使用してアカウントアクセスキーを指定。例：

    msiexec /i "%USERPROFILE%\Downloads\dotNetAgentSetup.msi" /l log.txt /q AD_CONTROLLER_ACCOUNT_ACCESS_KEY=changeme

    インストールがバックグラウンドで静かに実行。

    シングルテナント コントローラ アカウント用のアカウントアクセスキーを追加し忘れた場合、エージェント構成ユーティリティを実行するか、後から config.xml に手動で追加できます。「.NETエージェントの構成プロパティ」の「アカウントエレメント」を参照してください。

  6. IISを再起動。
    • AppDynamics エージェント構成ユーティリティを起動し、Configuration Summary ウィンドウで Restart IIS をクリック。
      または
    • コマンドラインから iisreset を実行。
    Windowsサービスとスタンドアロンアプリケーションを再起動。

バージョン 3.7.7 以降からの .NET Agent のアップグレード

ティアの命名と割り当て（手動または自動）メソッドおよびインストゥルメント化するアプリケーションのタイプに基づいて、正しいアップグレードパスを特定します。

  • ティアの手動命名と割り当てを使用している場合、インストーラーパッケージはIISアプリケーションとWindowsサービス用の構成をアップグレード。
  • ティアの自動命名と割り当てを使用している場合、構成ユーティリティを実行して構成を更新。
  • 3.7.7 以前のバージョンでスタンドアロン アプリケーションを使用している場合、「 Windowsサービスとスタンドアロンアプリケーションの.NETエージェントの構成」でスタンドアロン アプリケーションの手順を参照してください。

インストール後、構成をアップグレードしてオプションでレガシー構成を削除するには、構成ユーティリティを実行する必要がある場合があります。

次のエージェントの古いバージョンのアンインストール.NET Agent

  1. IISおよびインストゥルメント化されたWindowsサービスを停止。

     IISをシャットダウンしてもアクティブなIISワーカープロセスが引き続き表示される場合は、IISマネージャーでアプリケーションプールペインを確認し、開始されたアプリケーションプールを停止します。

    マシンを再起動する必要があるのは、.NET Agent をアンインストールする前にインストゥルメント化されたアプリケーションの停止に失敗した場合です。

  2. AppDynamics.Agent.Coordinator サービスを停止。

  3. コントロールパネルで、プログラムの追加/削除を選択。AppDynamics .NET Agent を削除。

    一部の事例では、他のプロセスが profiler.dll をロックすることで .NET エージェントのアンインストールプロセスに干渉することがあります。アンインストールに失敗した場合は、Process Explorer などのユーティリティを使用して、プロセスが profiler.dll を使用しているかどうかを確認してください。使用している場合は、そのプロセスを終了します。それ以外の場合は、マシンを再起動してみてください。その後にアンインストールを再試行します。

次のエージェントの新しいバージョンのインストール.NET Agent

  1. インストゥルメント化された IIS アプリケーションの w3wp プロセスを停止。インストゥルメント化されたWindowsサービスまたはスタンドアロンアプリケーションを停止。
  2. AppDynamics ダウンロードセンターから MSI インストーラパッケージをダウンロードします。
  3. 完全な管理者権限で、高度なコマンドプロンプトを起動。「管理者としてコマンドプロンプトを起動」を参照してください。管理者グループのメンバーとして Windows にログインしても、インストーラを実行するための十分な権限が付与されません。
  4. オプション。シングルテナント コントローラ アカウントを使用している場合は、コントローラで Settings > License > Account をクリックしてアクセスキーを表示。

  5. コマンドラインエージェントのインストールを実行。シングルテナント コントローラ アカウントの場合、AD_CONTROLLER_ACCOUNT_ACCESS_KEY パラメータを使用してアカウントアクセスキーを指定。例：

    msiexec /i "%USERPROFILE%\Downloads\dotNetAgentSetup.msi" /l log.txt /q AD_CONTROLLER_ACCOUNT_ACCESS_KEY=changeme

    インストールがバックグラウンドで静かに実行。

    シングルテナント コントローラ アカウント用のアカウントアクセスキーを追加し忘れた場合、エージェント構成ユーティリティを実行するか、後から config.xml に手動で追加できます。「.NETエージェントの構成プロパティ」の「アカウントエレメント」を参照してください。

  6. IISを再起動。
    • AppDynamics エージェント構成ユーティリティを起動し、Configuration Summary ウィンドウで Restart IIS をクリック。
    • コマンドラインから iisreset を実行。
    Windowsサービスを再起動。

以前のバージョンで次の環境変数を使用している場合、MSIインストーラによりその構成は新しい構成ファイルに移行されます。

  • AppDynamicsAgent_CallGraphOptions
  • AppDynamicsAgent_DisableAppPools
  • AppDynamicsAgent_EnableInProcesses
  • AppDynamicsAgent_IgnoreCLREnv
  • AppDynamicsAgent_Profiler_Classes

次のエージェントの構成.NET Agent

ティア生成と割り当てのメソッド（自動または手動）に基づいてエージェントを構成します。

 .NET Agent構成ユーティリティは、1 台のサーバにつき 1 つのコントローラの構成のみをサポートしています。複数のビジネスアプリケーションを構成する場合は、「.NETの複数ビジネスアプリケーションサポートの構成」を参照してください。

自動ティア生成と割り当てを使用したエージェントの構成

次のように構成ユーティリティを実行してエージェントを構成するのは、.NET Agentの以前のバージョンで自動構成を使用した場合です。

  1. .NET エージェント構成ユーティリティを使用してIISアプリケーションのインストゥルメンテーションを再構成。ティアの生成と割り当ての方法に Automatic を選択。詳細については、.NETエージェントの構成を参照してください。
  2. Windows サービスのインストゥルメンテーションを手動で構成。「Windowsサービスとスタンドアロンアプリケーションの.NETエージェントの構成」を参照してください。

手動ティア生成と割り当てを使用したエージェントの構成

ティアの手動命名と割り当てを使用しているエージェントの場合、インストーラーパッケージはIISアプリケーションとWindowsサービスの構成をconfig.xmlに移行します。この段階で、IISアプリケーションとWindowsサービスの構成は完了です。

レガシー構成のクリーンアップ

AppDynamicsエージェント構成ユーティリティを起動することで、レガシー構成をクリーンアップできます。ユーティリティが以前のバージョンのエージェント設定を検出すると、クリーンアップのオプションが提供されます。

クリーンアップの手順により、web.configファイルが修正されIISが再起動します。

  1. AppDynamicsエージェント構成ユーティリティを起動します。
  2. Yes を選択し、古い AppDynamics 構成をクリーンアップ。
  3. 通常通りウィザードに従い続行。
    • ログディレクトリを検証またはアップデートして、書き込み権限を付与。
    • コントローラ接続情報を確認。
    • ティアの手動割り当てを検証または更新。

ユーティリティが次の構成を削除。

    • IIS アプリケーションの web.config ファイルと Windows サービスの application.config ファイルの AppDynamics configSections。
    • 環境変数：
      • AppDynamicsAgent_IgnoreCLREnv
      • AppDynamicsAgent_CallGraphOptions
      • AppDynamicsAgent_EnableInProcesses
      • AppDynamicsAgent_DisableAppPools
      • AppDynamicsAgent_Profiler_Classes

モニタリングの再開

IIS とインストゥルメント化された Windows サービスを起動します。