.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
```

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

Winston 要素

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

必須エレメント：<winston>

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

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

Windows Server 2008 以降：%ProgramData%\AppDynamics\DotNetAgent\Config\config.xml

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

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

ログファイルフォルダのアクセス権限は、Winston要素の子要素です。defaultAccountsEnabled 属性を false に設定しない限り、Spllunk 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" />

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

Splunk 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">