GIM global parameters

Define global parameters for GIM clients using the GIM Global Parameters page or the gim_set_global_param API.

Define parameters using the GIM Global Parameters page

  1. From the Guardium UI, open Manage > Module Installation > GIM Global Parameters.
  2. Select a parameter and click the edit selected parameter icon.
  3. Use the Global Parameter dialog to edit the selected parameter.
  4. Click Save.

Define parameters using the gim_set_global_param API

  1. From the Guardium CLI, run the API command:
    grdapi gim_set_global_param paramName=<parameter name> paramValue=<parameter value>
    Where <parameter name> and <parameter value> are replaced with parameter name and value being defined.

GIM global parameters

Parameter name Value type Description
auto_install_on_db_server_os_upgrade Boolean If enabled, automatically upgrade modules when the client operating system vendor version changes. Valid values:
  • 0: Disabled
  • 1: Enabled
Default = 0

For more information, see Linux®-UNIX: Managing GIM clients when upgrading your database server operating system, and Windows: Managing S-TAP when upgrading your database operating system.
dynamic_alive_enabled Boolean Controls the dynamic alive feature. Valid values:
  • 0: Disabled
  • 1: Enabled
Default = 0

For more information, see GIM dynamic updating.
enable_secure_unauthenticated_communication Boolean If enabled, allow unauthenticated GIM communication over a secure port: communication between the GIM client and server are encrypted with SSL on port 8444, but the communication is handled without using certificates for peer authentication. Valid values:
  • 0: Disabled
  • 1: Enabled
Default = 0

The enable_secure_unauthenticated_communication allows distributing new GIM client certificates when it is time to replace certificates.
gim_auto_certificate_distribution Boolean Controls automatic distribution of certificates to GIM clients. Valid values:
  • 0: disabled
  • 1: enabled
Default = 0

For more information, see Create and manage GIM certificates.
gim_file_upload_token string Define the GIM file upload exchange token.
gim_listener_default_port string Define the GIM listener default port.

Default = 88445

For more information, see Gim server allocation.
gim_listener_default_shared_secret string Define the GIM listener encrypted shared secret.

For more information, see Gim server allocation.
gim_quick_start_enabled Boolean Controls the GIM quick start feature. Valid values:
  • 0: disabled
  • 1: enabled
Default = 0