LATEST VERSION: 9.2 - RELEASE NOTES
Pivotal GemFire® Client v9.2

GemFire Native Client Supported Configurations

The Pivotal GemFire native client provides access for C++ and Microsoft® .NET™ clients to the GemFire distributed system. It operates on platforms running Microsoft Windows, Linux (Intel), and Sun Solaris.

Native Client version 9.2 works with Pivotal GemFire versions 9.0.0 and later.

Operating system requirements are listed in the chart below:

Operating System Processor and Architecture
Solaris 11 (deprecated) x86-64
RHEL 6 (deprecated) x86-64
RHEL 7 x86-64
SLES 11** (deprecated) x86-64
SLES 12** x86-64
Windows 2012 (deprecated) x86-64
Windows Server 2012 R2 (deprecated) x86-64
Windows Server 2016 x86-64
Windows 8.1 (deprecated) x86-64
Windows 10 x86-64

**Indicates operating systems that have not been fully tested but are still supported.

Host Machine Requirements

Each machine that runs a native client must meet the following requirements:

  • A system clock set to the correct time and a time synchronization service such as Network Time Protocol (NTP). Correct time stamps permit the following activities:
    • Logs that are useful for troubleshooting. Synchronized time stamps ensure that log messages from different hosts can be merged to reproduce an accurate chronological history of a distributed run.
    • Aggregate product-level and application-level time statistics.
    • Accurate monitoring of the system with scripts and other tools that read the system statistics and log files.
  • The host name and host files are properly configured for the machine.
  • Many default Linux installations use SYN cookies to protect the system against malicious attacks that flood TCP SYN packets. The use of SYN cookies dramatically reduces network bandwidth, and can be triggered by a running GemFire distributed system.

    To disable SYN cookies permanently:

    1. Edit the /etc/sysctl.conf file to include the following line:

      net.ipv4.tcp_syncookies = 0
      

      Setting this value to zero disables SYN cookies.

    2. Reload sysctl.conf:

      sysctl -p
      

Windows Support Details

Runtime Library Requirements

The client requires the Microsoft Visual C++ 2013 Redistributable Package. This package contains runtime libraries needed by the client; install it for your platform architecture on all machines that will run the client.

.NET Framework Version Support

The Pivotal GemFire native client is supported with Microsoft .NET Framework 4.5.2.

A Microsoft .NET Framework must be installed to support the C++/CLI (Common Language Infrastructure) library for the native client.

The client supports .NET 4.5.2 and Visual Studio 2013 (for compiling C++ applications on Windows). For more information on the features of .NET and Visual Studio Community Edition 2013 Update 5, see the Visual Studio 2013 web page.

Linux

For Linux, you can verify that you meet the native client dependencies at the library level by using the ldd tool and entering this command:

prompt> ldd $client-installdir/lib/libgfcppcache.so

where client-installdir is the location in which you have installed the client.

The following libraries are external dependencies of the native library, libgfcppcache.so. Verify that the ldd tool output includes all of these:

  • libdl.so.2
  • libm.so.6
  • libpthread.so.0
  • libc.so.6
  • libz.so.1

Software Requirements for Using SSL

If you plan on using SSL in your GemFire native client and server deployment, you will need to download and install OpenSSL.

The GemFire native client requires OpenSSL version 1.0.2. For Windows platforms, you can use either the regular or the OpenSSL “Light” version.

In addition, make sure that your system environment variables have been configured to include OpenSSL.

See SSL Client/Server Communication for instructions.