This section describes the properties you can use when writing scripts for silent installations of the Dynatrace Network Analyzer Agent (Windows only). Sample scripts are included.
Properties for New Agent Installation Scripts Use the properties described for fresh installations of agents.
AVUSERNAME, AVPASSWORD
These two parameters specify the login and password used to connect to and operate an agent (initiate/terminate capture, change settings, collect cached packet capture data, etc.). Compare with AVAUTHFILE.
AVAUTHFILE
This parameter is mandatory if you do not specify AVUSERNAME and AVPASSWORD. Instead of specifying AVUSERNAME and AVPASSWORD in the command, you can use AVAUTHFILE to specify the path to a pre-generated file containing an encrypted agent username and an encrypted agent password. The syntax is AVAUTHFILE=filepath. To create the file, you have to use a small standalone application that takes a typed user name and password and writes an encrypted file. For more information, see Creating an Encrypted User Credentials File for Silent Agent Installations [p. 31].
Compare with AVUSERNAME and AVPASSWORD.
TARGETDIR
Mandatory. The destination of an administrative installation.
Default: <Program Files Directory>\Compuware\Transaction Trace Agent NOTE
TARGETDIR instructs the installation where to write the PortCfg.txt and ttagentauth.ppp files. If you want to specify an alternate INSTALLDIR, you must specify both the INSTALLDIR and TARGETDIR Properties with the same value.
INSTALLDIR
Optional. The main product installation directory for an installation.
NOTE
If the installation directory (INSTALLDIR) is changed, the TARGETDIR must be changed to match this value. The INSTALLDIR Property can be left off to use the default, but TARGETDIR cannot. If you want to specify an alternate INSTALLDIR, you must specify both the INSTALLDIR and TARGETDIR Properties with the same value.
PROMISCUOUS
With promiscuous mode on, all traffic seen on that NIC is captured, regardless of whether the traffic was intended for that NIC.
With promiscuous mode off, only the traffic that the NIC is intended to receive is captured. Possible values: 1 (on) or 0 (off).
Default: 1 (on)
DATADIR
Optional. Location of the directory where cached unattended capture data is stored. Default: C:\Documents and Settings\All Users\Application
Data\Compuware\Transaction Trace Agent\
PORT
Optional. Port number Default: 2408
BROWSERDATA
Optional. Indicates whether you want to install the Browser Data Collector Agent or not. Possible values: 1 to turn on the Browser Data Collector Agent; 0 to leave the Browser Data Collector Agent turned off.
IMPORTANT
To silently install the console or agent with BDC, it is necessary to set BROWSERDATA=1
and ADDLOCAL=ALL
Default: 0
ADDLOCAL
Lists the features that are to be installed.
When BROWSERDATA=1 or ALL, all the features are to be installed.
When BROWSERDATA=0, the default installs all features except the Browser Data Collection Agent and ADDLOCAL is not needed.
IMPORTANT
To silently install the console or agent with BDC, it is necessary to set BROWSERDATA=1
and ADDLOCAL=ALL
AVPASSWORD2
Optional. If used, must match AVPASSWORD. Only needed without the silent /qn switch. Otherwise, this password confirmation property should not be included with the script. For Dynatrace Network Analyzer, when running in silent mode (using /qn) you do not need to specify the AVPASSWORD2 property. This property is only used during user
interface processing to confirm that the user entered the same password in both fields of the window.
Samples
Here is an example of a script to install Dynatrace Network Analyzer Agent silently using the mandatory properties and the default settings described above.
msiexec.exe /i "<Drive>\<Path>\Transaction Trace Agent.msi" /qn AVUSERNAME=<username> AVPASSWORD=<password> TARGETDIR="C:\Program Files\Compuware\Transaction Trace Agent\"
Below is a similar example with the optional properties added. Be sure to provide your own meaningful username and password for AVUSERNAME and AVPASSWORD.
msiexec.exe /i "C:\Transaction Trace Analysis Agent\Transaction Trace Agent.msi" /qn INSTALLDIR="C:\Program Files\Compuware\Transaction Trace Agent\"
TARGETDIR="C:\Program Files\Compuware\Transaction Trace Agent\"
AVUSERNAME=adminusername AVPASSWORD=adminpassword PROMISCUOUS=1 DATADIR=C:\AgentData PORT=2409
Creating an Encrypted User Credentials File for Silent
Agent Installations
To use an encrypted user credentials file with the AVAUTHFILE parameter during a silent agent installation, you have to run a small standalone utility included on your software distribution media.
1. On your software distribution media, locate the AVpasswd.zip file.
2. Unzip the file to a local directory.
3. Double-click the AVpasswd file to run the utility.
4. Type a user name and password in the edit boxes.
5. Change the destination folder if necessary.
6. Click the “Generate now” button. What to Do Next
The output file can now be referred to by an AVAUTHFILE parameter in an agent installation command. For more information, see Dynatrace Network Analyzer Agent Installation Command Syntax [p. 60].
To run the AVpasswd utility in batch mode:
1. Open the Windows command prompt.
2. Change the current directory to the folder in which AVpasswd was extracted.
3. Type bin\avpasswd.exe –u<Username> -p<Password> -o"<OutputFolder>" For example:
bin\avpasswd.exe –uAlice –pWhit3R4bbit -o"C:\MyTTAAgentPasswords\Agent007"
4. Wait until a new file ttagentauth.ppp is created at the path provided
Installing a Compuware Certificate
To install the agent remotely or silently, you should first install a Compuware certificate in the Trusted Publishers certificate store.
NOTE
You can distribute the certificate to multiple remote machines using Microsoft Group Policy. The certificate needs to be added to the store Trusted Publishers\Local Computer as follows:
1. In your Windows Explorer, right-click the Compuware.cer file and select Install certificate from the menu.
The certificate file Compuware.cer is located in the Transaction Trace Analysis
Agent Installer folder in the Dynatrace Network Analyzer distribution.
The Certificate Import Wizard will open.
2. On the Certificate Import Wizard screen, click Next. The Certificate Store screen will be displayed.
3. Select Place all certificates in the following store and click Browse.
4. In the Select Certificate Store window, select the Show physical stores check box, expand the Trusted Publishers node, select Local Computer, and click OK.
The Certificate Store screen will be displayed again but with Place all certificates in the
following store selected and Trusted Publishers\Local Computer specified in the
Certificate store field. 5. Click Next.
The Completing the Certificate Import Wizard screen will display a summary of the intended import.
6. If the summary is correct, click Finish.
The certificate will be added to Trusted Publishers\Local Computer and a window will display “The import was successful.”