.NETの無人インストール

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

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

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

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

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

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

コマンドラインから Splunk 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"

構成ウィザードの手順を完了。構成ユーティリティが、セットアップ構成ファイルを指定したパスに保存。

注: 構成ユーティリティは、ISSアプリケーションのインストルメンテーションのみを構成します。
（オプション）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）

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

完全な管理者権限で、高度なコマンドプロンプトを起動。「管理者としてコマンドプロンプトを起動」を参照してください。管理者グループのメンバーとしてWindowsにログインしても、インストーラーを実行するための十分な権限が付与されません。
高度なコマンドプロンプトからエージェントMSIインストーラーパッケージを実行。AD_SetupFile パラメータを使用して、絶対ファイルパスをセットアップ構成ファイルに渡します。トラブルシューティングには、次のコマンドを使用することもできます。
```
msiexec /i dotNetAgentSetup64.msi /q /norestart /lv %TEMP%\AgentInstaller.log AD_SetupFile=<absolute path to setup config.xml>
```
1. （オプション）INSTALLDIR を設定して、.NET エージェントの実行ファイルとサポートファイルをインストールするディレクトリを指定します。
2. （オプション）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 に書き込みます。
AppDynamics.Agent.Coordinator プロセスを起動します。
```
net start AppDynamics.Agent.Coordinator
```
インストゥルメント化を行ったアプリケーション（IIS サービス、Windows サービスおよびスタンドアロンアプリケーション）を再起動。例えば、IISを再起動するには
```
iisreset
```

Setup Configuration File Properties

Winston Element

The Winston element is the root element of the configuration file.

Required element: <winston>

Log File Directory Element

The Log File Directory element is a child element of the Winston element. Use the directory attribute to specify the log directory. If you omit the logFileDirectory element, Splunk AppDynamics uses the default directory:

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

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

Log File Folder Access Permissions Element

The Log File Folder Access Permissions is a child element of the Winston element. Unless you set the defaultAccountsEnabled attribute to false, Splunk AppDynamics grants write access to the Logs folder for the default accounts:

LOCAL SERVICE
SYSTEM
NETWORK SERVICE
ApplicationPool Identity

Optional element: <logFileFolderAccessPermissions defaultAccountsEnabled="false">

Account Element

The Account element is a child element of the Log File Folder Access Permissions element. Create an Account element for the Windows account you use to run your application.

Set the name attribute to the name of the account you use to run your application, that is the account for the application pool for IIS or the Windows service account.

The display name attribute is a user-friendly name you choose for the account. The display name shows up in log entries about assigning permissions for the account.

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

For example, if you run a Windows service under a domain account:

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

Splunk AppDynamics Agent Element

The Splunk AppDynamics Agent element is a child of the Winston element. It follows the same format as the config.xml file to define the agent configuration for all your .NET applications. See .NET Agent Configuration Properties.

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