Related pages:

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

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

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

作成者は、.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. （オプション）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>

無人インストール

無人インストールを実行する前に、次の要件を確認してください。

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

無人インストールを実行するには、次の手順を実行します。

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

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

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

    次のオプションパラメータを設定できます。

    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エレメントは構成ファイルのルートエレメントです。

必須エレメント： <winston>

ログファイルディレクトリ要素

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

Windowsサーバー2008以降：%ProgramData%\AppDynamics\DotNetAgent\Logs

任意のエレメント： <logFileDirectory directory="C:\ProgramData\AppDynamics\DotNetAgent\Logs" />

ログ ファイル フォルダ アクセス権限要素

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

  • LOCAL SERVICE
  • SYSTEM
  • NETWORK SERVICE
  • ApplicationPool Identity

任意のエレメント： <logFileFolderAccessPermissions defaultAccountsEnabled="false">

アカウントエレメント

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

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

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

任意のエレメント： <account name="MyAppPoolIdentity" displayName="Custom ApplicationPool Identity" />

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

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

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

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

必須エレメント： <appdynamics-agent xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">