LATEST VERSION: 9.0.6 - CHANGELOG
Pivotal GemFire® Native Client v9.0

Installing on Windows

Install the native client by using the Windows installer GUI interface or the command line.

Prerequisites

Before installing the GemFire native client, complete the following prerequisites:

  • Confirm that your system meets the hardware and software requirements described in Windows Support Details.
  • From the Pivotal GemFire download page, select Download.
  • On the Pivotal GemFire product download page, select and download the Pivotal GemFire native client MSI appropriate for your hardware architecture.

Note: If you do not install the native client using the MSI installer or the msiexec command-line, then you will need to manually perform the configuration steps, such as configure your GFCPP and PATH environment variables, and install the Microsoft Visual C++ 2013 Redistributable Package.

Install with the Windows Installer

The native client can be installed on Windows by using the pivotal-gemfire-nativeclient-64bit-XXX.msi Windows installer. XXX represents the version of the product, for example 9.0.0. The installer requires msiexec version 3.0 or higher.

While logged in with administrative privileges, double-click the MSI file to start the installation. Enter the installation location of the native client when prompted.

The MSI installer installs the Microsoft Visual C++ 2013 Redistributable Package for your platform architecture (https://www.microsoft.com/en-us/download/details.aspx?id=40784). This package contains runtime libraries required by the native client.

The MSI installer automatically configures these native client system environment settings:

  • Sets the GFCPP environment variable to product-dir, where product-dir represents the installation location chosen.
  • Adds %GFCPP%\bin to the Windows PATH.

Install from the MSI Command Line

To use the command line for installation, substitute an appropriate value for XXX in a command with syntax:

msiexec /q /i pivotal-gemfire-nativeclient-64bit-XXX.msi ^
DEFAULT_INSTALLDIR=<path>

The following table lists common msiexec command-line options, along with an explanation of their usage. For a list of all command-line options, enter msiexec/?.

Option Explanation
/q Creates a quiet installation with no interface or prompts.
/i Indicates that the product is to be installed or configured.
DEFAULT_INSTALLDIR=<path> Specifies the destination directory, if different from the default.
/x Indicates a product uninstall procedure.

Repair a Windows Installation

If problems occur with your Windows native client installation you can initiate a repair operation to restore any missing elements or registry settings.

  1. Double-click the MSI file, then click Next in the Setup Wizard screen.
  2. In the following screen, click the Repair button.
  3. In the next screen, click the Repair button.