Related pages:

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

AppDynamics Azure サイト拡張を使用する場合は、「.NET 用の AppDynamics Azure サイト拡張のインストール」を参照してください。

要件

  • 開始する前に、リリース ノートを確認します。 
  • AppDynamicsは、シングルテナントコントローラアカウントへのエージェント接続にアカウントアクセスキーを要求します。4.1 以前の AppDynamics は、マルチテナント コントローラ アカウントのアカウントアクセスキーのみを要求します。
    シングルテナント コントローラのお客様は、[Settings ] >[ License ] >[ Account] でコントローラにアカウントアクセスキーが表示されます。ライセンス表示レベルのアカウント権限を持つロールのメンバーである必要があります。「カスタムロールの作成と管理」を参照してください。

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

    • 3.9 以降

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

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

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

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

  1. インストゥルメント化された IIS アプリケーションの w3wp プロセスを停止。インストゥルメント化されたWindowsサービスまたはスタンドアロンアプリケーションを停止。
  2. 次のページから MSI インストーラパッケージをダウンロード。AppDynamics ダウンロード 
  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 に手動で追加できます。「アカウントエレメント」を参照してください。

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

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

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

  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 に手動で追加できます。「アカウントエレメント」を参照してください。

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

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

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

  • ティアの手動命名と割り当てを使用している場合、インストーラーパッケージは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 に手動で追加できます。「アカウントエレメント」を参照してください。

  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 構成。
    • 環境変数：
      • AppDynamicsAgent_IgnoreCLREnv
      • AppDynamicsAgent_CallGraphOptions
      • AppDynamicsAgent_EnableInProcesses
      • AppDynamicsAgent_DisableAppPools
      • AppDynamicsAgent_Profiler_Classes

モニターリングの再開

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