Linux and UNIX systems: Installing S-TAP agent with GIM (v10.1-10.1.3)

The Guardium Installation Manager (GIM) is the recommended method for installing S-TAPs on your database servers. GIM enables you to install, upgrade, and manage agents on individual servers or groups of servers. This includes monitoring processes that were installed under its control, modifying agent parameters, and performing other management tasks.

1. Verify that the GIM client is installed on the database server. See Installing the GIM client on a UNIX server.
2. Upload the relevant S-TAP module to the Guardium Installation Manager appliance.
   1. On the Guardium system, navigate 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 will be 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 will be imported and made available for installation. After the module is imported, the Upload Modules page will be reset and the Import Uploaded Modules table will be empty.
3. Select client systems where you want to install an S-TAP.
   1. Navigate to Manage > Module Installation > Setup by Client.
   2. On the Client Search Criteria screen, specify search criteria for the clients where you want to install the S-TAP, then click Search to continue. Search for clients using any combination of the following search criteria:
      • Select a client group.
      • Search by client hostname, IP address, or operating system.
      • Leave all search criteria fields empty to return a list of all available clients.
   3. On the Clients screen, click the check box next to the clients where you want to install the S-TAP, then click Next to continue.
4. Select and configure the S-TAP module before installing to client systems.
   1. From the Modules table on the Common Modules screen, select the S-TAP module for installation, then click Next to continue.
      • Use the Display Latest Versions and Display Bundles Only check boxes to filter the list of available modules.
      • Use the Module Status table to review information about the selected module on the target clients.
   2. From the Client Module Parameters screen, specify installation parameters for the S-TAP. These parameters are mandatory:
      • STAP_TAP_IP: the IP address or FQDN of the database server or node on which the STAP is being installed (equivalent to the -taphost command line parameter). If not specified, the GIM_CLIENT_IP value is used.
      • STAP_SQLGUARD_IP: the IP address or FQDN of the primary collector with which this STAP communicates (equivalent to the -appliance command line parameter). If not specified, then, the GIM_URL value is used.
      Attention: See the enterprise load balancing parameters in Linux and UNIX systems: S-TAP GIM installation parameters.
      • To apply the same parameters to multiple clients, specify installation parameters in the Common Module Parameters fields, click the check box next to clients listed in the Client Module Parameters tables, and then click Apply to Selected.
      • To apply unique parameters to individual clients, specify installation parameters directly in the Client Module Parameters table.
   3. Once you have specified installation parameters for the S-TAP, apply those parameters to the selected clients by clicking Apply to Client.
5. Install the S-TAP to the selected clients.
   1. From the Client Module Parameters screen, click Install/Update.
   2. On the Schedule Date dialog, provide a date or time to begin the installation, then click Apply. To begin the installation immediately, use a value of now in the Schedule Date field.