Windows: Installing S-TAP agent using the command line interface

The command-line installer provides a scriptable solution that is especially useful for managing large deployments.

Before you begin

Verify the following before you begin:

Review the Windows S-TAP installation requirements at Windows: Prerequisites: Installing S-TAP.
Verify that your database server and operating system are supported. For more information, see System requirements and the Windows: S-TAP monitoring mechanisms support matrix.
Identify the IP address of the database server where you are installing the S-TAP, including any virtual IP addresses.
Identify the IP address of the Guardium® system that will control the S-TAP.
Verify that the intended S-TAP installation directory is empty or does not exist.
Obtain the S-TAP module from either Fix Central, or from your Guardium representative.

Note: You cannot install or run Windows S-TAP on a domain controller.

Note: Db2 servers. When upgrading an S-TAP from 11.3 or before to 11.4 or later on Db2 servers, the S-TAP cannot continue to capture the Db2 server traffic. Stop and restart your Db2 instances after the S-TAP upgrade to resume capturing Db2 traffic. Subsequent upgrades do not require you to restart the instances.

About this task

If you want to disable auto-discovery, specify NOAUTODISCOVERY during the installation. For more information, see Windows: Auto discovery of database instances during installation and upgrade.

Procedure

Log on to the database server using a system administrator account.
Copy the installer to your database, and using the Windows Command Prompt, navigate to the Windows S-TAP installer directory.
For example,
```
cd c:\Windows-STAP-V10.6.0.0.89
```
You should find a setup.exe executable in the installer directory.
Install the S-TAP using the setup.exe executable with the appropriate parameters.
The required parameters are:
- INSTALLPATH, the default is used if you do not specify
- TAPHOST
- APPLIANCE
All parameters, except INSTALLPATH, can be updated after the installation. A typical install command is:
```
setup.exe -UNATTENDED -APPLIANCE 10.0.147.234 -TAPHOST 10.0.145.41
```
where:
- -UNATTENDED (required) invokes the command-line installer.
- -APPLIANCE specifies the IP address of the Guardium system that will control the S-TAP.
- -TAPHOST (required) specifies the client IP address where the S-TAP is being installed.
For a complete description of the setup.exe executable and its parameters, see Windows: S-TAP command line installation parameters

What to do next

Verify that the S-TAP is communicating with the Guardium system by browsing to Manage > Activity Monitoring > S-TAP Control and reviewing the S-TAPs status and configuration.