Related pages:

The .NET Agentは、複数のサーバーに同じ AppDynamics 構成が必要な場合に無人インストールのコマンドライン手順を提供します。無人インストールを利用すると、一度構成を行うだけで、そのコマンドラインスクリプトを使用して複数のサーバーでのインストールやインストゥルメンテーションを自動化できます。

エージェントを手動でインストールおよび構成する方法については、「Windows 用 .NET エージェントのインストール」を参照してください。

セットアップ構成ファイルの作成

The .NET Agentの MSI インストーラパッケージにより、セットアップ構成ファイルへのパスを指定して無人インストールを実行できます。セットアップ構成ファイルには、.NETアプリケーションのインストゥルメンテーションの有効化に必要となるすべてのプロパティが含まれています。

AppDynamics エージェント構成ユーティリティを使用してセットアップ構成ファイルを作成するには、1 台のマシンで .NET エージェントの MSI インストーラパッケージを実行する必要があります。「Windows 用 .NET エージェントのインストール」を参照してください。

以前のバージョンのAppDynamicsエージェント構成ユーティリティで作成されたセットアップ構成ファイルは、4.0インストーラーで動作します。

  1. コマンドラインからAppDynamicsエージェント構成ユーティリティを起動。-s パラメータを使用して、セットアップ構成ファイルの宛先を指定。

    %ProgramFiles%\AppDynamics\AppDynamics .NET Agent\AppDynamics.Agent.Winston.exe -s <path to setup configuration file>

    例：

    %ProgramFiles%\AppDynamics\AppDynamics .NET Agent\AppDynamics.Agent.Winston.exe -s "c:\temp\configurationSavedSetupConfiguration.xml"
  2. 構成ウィザードを通常通りに実行。

    構成ユーティリティが、セットアップ構成ファイルを指定したパスに保存。

    構成ユーティリティは、ISSアプリケーションのインストゥルメンテーションのみを構成します。

  3. オンプレミスの場合、HTTPのデフォルトは8090、HTTPSのデフォルトは8181です。Windowsサービスまたはスタンドアロンアプリケーションの無人インストールを実行するには、セットアップ構成ファイルを手動で編集する必要がある。詳細については、Windowsサービスとスタンドアロンアプリケーションの.NETエージェントの構成を参照してください。

セットアップ構成ファイルのサンプル

次の例では、2 つの IIS アプリケーション（MainBC および SampleHTTPService）、Windows サービス（MyWindowsService.exe）、スタンドアロン アプリケーション（MyStandaloneApp.exe）のインストゥルメント化を行うセットアップ構成ファイルを示しています。

構成ファイルはログディレクトリを C:\ProgramData\AppDynamics\DotNetAgent\Logs に設定し、4 つのアカウントに書き込み権限を付与します。

<winston>
  <logFileDirectory directory="C:\ProgramData\AppDynamics\DotNetAgent\Logs"/>
  <logFileFolderAccessPermissions defaultAccountsEnabled="false">
    <account name="NT AUTHORITY\LOCAL SERVICE" displayName="LOCAL SERVICE"/>
    <account name="NT AUTHORITY\SYSTEM" displayName="SYSTEM"/>
    <account name="NT AUTHORITY\NETWORK SERVICE" displayName="NETWORK SERVICE"/>
    <account name="IIS_IUSRS" displayName="ApplicationPool Identity"/>
  </logFileFolderAccessPermissions>
  <appdynamics-agent xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <controller host="mycontroller.mycompany.com" port="8090" ssl="false">
      <application name="My Business Application"/>
      <account name="customer1" password="changeme"/>
    </controller>
    <machine-agent/>
    <app-agents>
      <IIS>
        <applications>
          <application path="/" site="MainBC">
            <tier name="Main Site"/>
          </application>
          <application path="/" site="SampleHTTPService">
            <tier name="HTTP Services"/>
          </application>
        </applications>
      </IIS>
      <standalone-applications>
         <standalone-application executable="MyStandaloneApp.exe">
            <tier name="Standalone App"/>
         </standalone-application>
         <standalone-application executable="MyWindowsService.exe">
            <tier name="Windows Service"/>
         </standalone-application>
      </standalone-applications>
    </app-agents>
  </appdynamics-agent>
</winston>

無人インストール

Requirements

  • Microsoft 分散トランザクション コーディネータ（MSDTC）：MSDTC は「NT Authority\NetworkServices」アカウントで実行される必要があります。「.NET エージェントの問題のトラブルシューティング」の「MSDTC の確認」を参照してください。
  • Windows Management Instrumentation (WMI)

Perform unattended installation

  1. 完全な管理者権限で、高度なコマンドプロンプトを起動。「管理者としてコマンドプロンプトを起動」を参照してください。管理者グループのメンバーとして Windows にログインしても、インストーラを実行するための十分な権限が付与されません。

  2. 高度なコマンドプロンプトからエージェントMSIインストーラーパッケージを実行。AD_SetupFile パラメータを使用して、絶対ファイルパスをセットアップ構成ファイルに指定。

    msiexec /i dotNetAgentSetup64.msi /q /norestart /lv %TEMP%\AgentInstaller.log AD_SetupFile=<absolute path to setup config.xml>

    Optional Parameters

    INSTALLDIR：.NET エージェントの実行可能ファイルとサポートファイルをインストールするディレクトリを指定。

    DOTNETAGENTFOLDER：エージェント構成ファイルやログファイルなどのローカルデータ用親ディレクトリを指定。 

    例：

    msiexec /i dotNetAgentSetup64.msi /q /norestart /lv %TEMP%\AgentInstaller.log AD_SetupFile=C:\temp\SetupConfig.xml INSTALLDIR=D:\AppDynamics DOTNETAGENTFOLDER=D:\AppDynamicsData

    コマンドラインの DOTNETAGENTFOLDER とセットアップ構成ファイルの logFileDirectory を指定する場合、エージェントは DOTNETAGENTFOLDER に構成およびデータフォルダを作成しますが、ログファイルはセットアップ構成ファイルで指定された logFileDirectory に書き込みます。

  3. AppDynamics.Agent.Coordinator プロセスを起動。

    net start AppDynamics.Agent.Coordinator
  4. インストゥルメント化を行ったアプリケーション（IIS サービス、Windows サービスおよびスタンドアロン アプリケーション）を再起動。

    例えば、IISを再起動するには

    iisreset

セットアップ構成ファイルのプロパティ

Winstonエレメント

Winstonエレメントは構成ファイルのルートエレメントです。

Required element: <winston>

ログファイルディレクトリエレメント

ログファイルディレクトリ要素は、Winston要素の子要素です。directory 属性を使用してログディレクトリを指定します。logFileDirectory要素を省略する場合は、AppDynamicsはデフォルトのディレクトリを使用します。

Windows Server 2008 and later： %ProgramData%\AppDynamics\DotNetAgent\Logs

Optional element： <logFileDirectory directory="C:\ProgramData\AppDynamics\DotNetAgent\Logs" />

ログファイルフォルダアクセス権限エレメント

ログファイルフォルダのアクセス権限は、Winston要素の子要素です。defaultAccountsEnabled 属性を false に設定しない限り、AppDynamics はデフォルトアカウントのログフォルダに書き込み権限を付与します。

  • LOCAL SERVICE
  • SYSTEM
  • NETWORK SERVICE
  • ApplicationPool Identity

Optional element: <logFileFolderAccessPermissions defaultAccountsEnabled="false">

アカウントエレメント

アカウント要素は、ログファイルフォルダアクセス権限要素の子要素です。アプリケーションを実行する Windows アカウントの Account エレメントを作成します。

name 属性を、アプリケーションの実行に使用するアカウント（IIS のアプリケーションプールのアカウントまたは Windows サービスアカウント）の名前に設定します。

display name 属性は、アカウント用にわかりやすい名前にします。表示名は、アカウントの割り当て権限に関するログエントリに表示されます。

Optional element: <account name="MyAppPoolIdentity" displayName="Custom ApplicationPool Identity" />

例えば、ドメインアカウントでWindowsサービスを実行する場合

<account name="MYDOMAIN\service_acct" displayName="Domain Service Account" />

AppDynamicsエージェントエレメント

AppDynamicsエージェントのエレメントは、Winstonエレメントの子エレメントです。config.xml ファイルと同じ形式で、ご使用の .NET アプリケーションすべてのエージェント構成を定義します。「.NETエージェントの構成プロパティ」を参照してください。

Required element: <appdynamics-agent xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">