Windows: Upgrading S-TAP agent with GIM Setup by Client

Before you begin

Verify the following before you begin:
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.
Important: When you upgrade Windows S-TAP from 10.x to 11.x (or newer) using GIM, the FIREWALL properties are reset to the default values. Set WINSTAP_FIREWALL_INSTALLED=1 during the upgrade if you are using the firewall (S-GATE).

Procedure

  1. Upload the Windows S-TAP module for upgrade.
    1. On the Guardium® system, go to Manage > Module Installation > Upload Modules.
    2. Click Choose File and select the S-TAP module you want to install.
    3. Click Upload to upload the module to the Guardium system.
      After uploading, the module is listed in the Import Uploaded Modules table.
    4. In the Import Uploaded Modules table, click the check box next to the S-TAP module you want to install.
      The module is imported and made available for upgrade. After the module is imported, the Upload Modules page is reset and the Import Uploaded Modules table is empty.
  2. Go to Manage > Module Installation > Set up by Client.
  3. In the Choose clients section, select the database servers where you want to update software. Select individual clients using check boxes in the table, or use the Select client group menu to select a group of clients.
    Click Next to continue.
  4. In the Choose bundle section, use the Select a bundle menu to identify your upgrade version. Click Next to continue.
  5. If you are upgrading from 10.x to 11.0 (or newer), and you use the firewall: In the Choose parameters section, set WINSTAP_FIREWALL_INSTALLED to 1.
  6. Click Install to begin the software upgrade. Or use the date picker icon to schedule the installation, then click OK to continue.
  7. To create the Guardium API syntax for the current configuration in the Setup by Client, click Generate GuardAPI. If enough information is available, it generates API commands for multiple clients in the GuardAPI commands dialog. If there isn't enough information, it shows a default template.

What to do next

In the Success popup, click Show Status to open the Status window to monitor the software install/upgrade. Click Refresh icon to refresh the results. If an upgrade has a failed status, click Uninstall if you see the button, otherwise, click Reset connection. You can also view the status of the module installation by reviewing the report at Manage > Reports > Install Management > GIM Clients Status.

If you see a Failed installation status for a bundle or module, open the Choose bundle section, select the client, click Uninstall, and use the Refresh icon icon to monitor the installation status. If Uninstall is not available, open the Choose clients panel, select the affected client, and click Reset connection. Use the Refresh icon icon to monitor the client list as the connection is reset.

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.