Install Windows Agent using the Agent Image Installer Method

We recommend the automated installer script method for installing Windows agents. Use the image installer method if you have a specific reason for using this manual method.

Do not manually deploy an older MSI agent version when an existing agent is already running on the host.

Site-related files that are in the package:

ca.cert—Mandatory—CA certificate for sensor communications.
enforcer.cfg—Mandatory only when installing enforcement sensor—Contains configuration of enforcement endpoints.
sensor_config—Mandatory—Configuration for deep visibility sensor.
sensor_type—Type of the sensor (enforcement or deep visibility).
site.cfg—Mandatory—Global site endpoint configuration.
user.cfg—Mandatory for SaaS—Sensor activation key and proxy configuration.

Prerequisite:

Configure the ACTIVATION_KEY and HTTPS_PROXY in the user.cfg file for SaaS clusters and when you are installing the agent on a non-default tenant of on-premises clusters with multiple tenants. For more information, see (Manual Installations Only) Update the User Configuration File.

To install a Windows agent using the agent image method:

Procedure

Navigate to Agent Installation Methods:

If you are a first-time user, launch the Quick Start wizard and click Install Agents.
From the navigation pane, choose Manage > Agents, and select the Installer tab.

Click Agent Image Installer.

In the Platform field, enter Windows.

Enter the required agent type and the version of the agent, and then from the results, download the required version of the agent.

Copy the tet-win-sensor<version>.win64-<clustername>.zip file to all the Windows hosts for deployment.

Ensure that you have administrative privileges and extract the ZIP file.

In the extracted folder, run the following command to install the agent: msiexec.exe /i TetrationAgentInstaller.msi

Additionally, the following options are available for MSI installer.

Table 1. Available Options for MSI Installer
Options	Description
agenttype=<AgentType>	AgentType should be either sensor or enforcer, depending on whether enforcement is required. By default, the installer checks the content of the sensor_type file in the same folder and uses the content to overwrite the passed parameter. However, if agent is installed in /quiet mode, the option is required.
overwritenpcap=yes	For Windows 2008 R2, by default, the agent does not attempt to upgrade Npcap if Npcap already exists. Pass this parameter to upgrade the existing Npcap. If this option is used, subsequent agent auto-upgrades also upgrade Npcap to newer supported versions.
nostart=yes	Pass this parameter, when installing the agent using a golden image in a VDI environment or VM template, to prevent agent service— CswAgent from starting automatically. On VDI/VM instances created using the golden image and with a different host name, these services, as expected, start automatically.
installfolder=<FullPathCustomFolder>	Use this parameter, at the end of the install command, to install the agent in a custom folder.
serviceuser=<Service UserName>	Use this parameter, at the end of the install command, to configure the service user. The default service user is “LocalSystem”. For local user, serviceuser=.\<Service UserName> For domain user, serviceuser=<domain_name>\<samaccount name> Service user must have local administrative privileges. The Service account must have local administrative or domain admin group privileges.
servicepassword=<Service UserPassword>	Use this parameter, at the end of the install command, to configure the password for the service user. The password must be in plain-text format.
proxy=”<proxy_address>”	Use this parameter to set the HTTPS proxy for accessing the Secure Workload cluster.
activationkey=<activation Key>	Use this parameter to specify the tenant if agent is not being installed under the default tenant.

If activation key and proxy options are used during manual installation, you do not need to manually configure user.cfg.
For Windows OS other than Windows 2008 R2, when you upgrade to version 3.8, the installed Npcap is automatically uninstalled by the Windows agent.
If the agent is already installed on the host, do not reinstall the agent. To upgrade the agent, see Upgrading Software Agents section.

Previous topic Install Windows Agent using the Agent Script Installer Method Next topic Verify Windows Agent Installation