gim_set_global_param

Use this API to set global parameters for GIM clients.

This API is available in Guardium V9.5 and later.

GuardAPI syntax

gim_set_global_param parameter=value

Parameters

Parameter Value type Description
paramName String Required. Name of the parameter to set, listed in the following table.
paramValue String Required. The value for the paramName.
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 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

Examples

Set the value of gim_listener_default_port.

grdapi gim_set_global_param paramName=gim_listener_default_port paramValue=8445