Installing the GIM client on a Windows server

Learn how to install the GIM client for Windows using either an interactive installer or a silent installation. Instructions are also provided for uninstalling the GIM client.

About this task

There are currently two types of installers for the GIM client based on your GIM client version. Version 10.1.2 and earlier use build numbers through r89755, while version 10.1.3 and beyond uses build numbers starting from 10.2.30.5. Please pay attention to your GIM client version and build numbers as you go through these instructions.

Installing the GIM client using an interactive installer: GIM client version 10.1.2 or older

A wizard is provided to help you install the GIM client on each database server.

Procedure

  1. Place the GIM client installer on the database server, in any folder.
  2. Run the setup.exe file to start the wizard that installs the GIM client. The setup.exe file is located in the Windows_GimClient folder.
  3. Follow and answer the questions in the installation wizard.

What to do next

You can view the results of the installation in the log file at c:\guardiumstaplog.txt.

Installing the GIM client using an interactive installer: GIM client version 10.1.3 and newer

A wizard is provided to help you install the GIM client on each database server.

Procedure

  1. Place the GIM client installer on the database server, in any folder.
  2. Run the setup.exe file to start the wizard that installs the GIM client. The setup.exe file is located in the GIM-Installer-10.2* folder.
  3. Follow and answer the questions in the installation wizard.

What to do next

You can view the results of the installation in the log file at C:\IBM Windows GIM.ctl..

Installing the GIM client using silent installation: GIM client version 10.1.2 or older

If you prefer, you can install the GIM client from the command line instead of using the wizard.

About this task

Procedure

  1. Place the GIM client installer on the database server, in any folder.
  2. Open a command prompt and navigate to the Windows_GimClient folder under the folder where you placed the installer.
  3. Enter this command, with no linebreak. setup.exe /s /z" --host=g10.guardium.com --path=c:\\program files (x86)\\guardium\\GIM --perl=c:\\perl\\bin --localip=192.168.1.100" Include all the spaces and quotes exactly as in this example. Removing or adding spaces causes the installer to fail. The --perl= parameter indicates where Perl is installed on this computer. This parameter is optional. If you do not specify it, the installer installs a Perl instance.
    Attention:
    • Omit the --host parameter to install the client in GIM listener mode. Listener mode makes the GIM client available for remote registration from a Guardium system. Example of how to install as listener: setup.exe /s /z"--path=c:\program files (x86)\guardium\GIM --host=GIM_HOST" For more information, see GIM Remote Activation and Create a GIM Auto-discovery Process.
    • When cloning database servers and establishing large deployments, use --auto_assign_ip=1 to allocate a random IP address from one of the valid IP addresses of a database server. Do not specify both auto_assign_ip and localip when installing the GIM client. When updating the GIM_AUTO_SET_CLIENT_IP parameter using Manage > Module Installation > Set up by Client or Set up by Module, you must restart the GIM client service for the new setting to take effect.

What to do next

You can view the results of the installation in the log file at c:\guardiumstaplog.txt.

Installing the GIM client using silent installation: GIM client version 10.1.3 or newer

If you prefer, you can install the GIM client from the command line instead of using the wizard.

Procedure

  1. Place the GIM client installer on the database server, in any folder.
  2. Open a command prompt and navigate to the GIM_Installer* folder under the folder where you placed the installer.
  3. Enter this command, with no linebreak. setup.exe -UNATTENDED -INSTALLPATH "c:\Program Files(x86)\Guardium Installation Manager" -LOCALIP 10.9.876.543
    Attention:
      • The UNATTENDED and LOCALIP parameters are required. APPLIANCE is optional and if not supplied, will trigger Listener Mode. If using parameter AUTO_ASSIGN_IP, LOCALIP is not required.
      • Omit the -APPLIANCE parameter to install the client in GIM listener mode. Listener mode makes the GIM client available for remote registration from a Guardium system. Example of how to install as listener: setup.exe -UNATTENDED -INSTALLPATH C:\program files (x86)\guardium\GIM -LOCALIP 10.9.876.543. For more information, see GIM Remote Activation and Create a GIM Auto-discovery Process.
      • When cloning database servers and establishing large deployments, use --auto_assign_ip=1 to allocate a random IP address from one of the valid IP addresses of a database server. Do not specify both auto_assign_ip and localip when installing the GIM client. When updating the GIM_AUTO_SET_CLIENT_IP parameter using Manage > Module Installation > Set up by Client or Set up by Module, you must restart the GIM client service for the new setting to take effect.
    • Windows GIM command line installation reference
    Parameters applicable to all .NET installers
    Parameter Description
    -UNATTENDED Install silently. A value is not required
    -UNINSTALL Uninstall. A value is not required.
    -INSTALLPATH This is the install directory. Default install path is "C:\Program Files (x86)\Guardium\Guardium Installation Manager"
    -CUSTOMER To change customer name
    -COMPANY To change company name
    -SERVICEUSER To specify a user to run the service under
    -SERVICEPASSWORD The password for the user
    Parameters specific to GIM .NET installers
    Parameter Description
    -APPLIANCE To set the appliance address that GIM connects to. Absence of this parameter will result in GIM installation using Listener Mode.
    -LOCALIP This is the IP of the server where GIM is being installed.
    -KEY_FILE To set the key file to non-default file
    -CERT_FILE To set the certificate file to non-default file
    -CA_FILE To set the CA file to non-default file
    -SHARED_SECRET To set shared secret for registration with appliance if not specified using -APPLIANCE parameter
    -LISTENER_PORT Set listener port for registration with appliance if not using the -APPLIANCE parameter. Default value is 8445.
    -AUTO_ASSIGN_IP When value set to 1, a local IP is automatically assigned and should NOT be specified using -LOCALIP. Default value is 0.

What to do next

You can view the results of the installation in the log file at C:\IBM Windows GIM.ctl.

Uninstalling the GIM client: GIM client version 10.1.2 or older

Procedure

  1. Open a command prompt and navigate to the Windows_GimClient* folder under the folder where you installed the client.
  2. Enter this command: For Installshield, use
     setup.exe /s /z"--host=g10.guardium.com --remove=true"
    The --host= parameter is optional.

Uninstalling the GIM client: GIM client version 10.1.3 and newer

Procedure

  1. Open a command prompt and navigate to the GIM_Installer* folder under the folder where you installed the client.
  2. Enter this command:
     setup.exe -UNINSTALL