Greenplum ODBC 8.0.2 UNIX
- Last Updated: May 8, 2026
- 12 minute read
- OpenAccess SDK
- Documentation
README
Progress(R) DataDirect(R)
Progress(R) DataDirect(R) for ODBC for
Progress Greenplum(TM) Wire Protocol Driver
UNIX and Linux Platforms (32- and 64-bit)
Release 8.0.2
April 2026
***********************************************************************
Copyright (C) 2026 Progress Software Corporation and/or its
subsidiaries or affiliates. All Rights Reserved.
***********************************************************************
This README file contains information for Progress(R) DataDirect(R)
for ODBC for Greenplum(TM) Wire Protocol Driver.
This README file contains information not included in the PROGRESS
DATADIRECT FOR ODBC FOR GREENPLUM WIRE PROTOCOL DRIVER USER'S GUIDE.
CONTENTS
Post-GA Product Announcements
Requirements
Installation Directory
Data Source and Platform Support
Third-party Components Compatibility Matrix
Changes for 8.0.2 Release
Configuring Data Sources
Driver WorkAround Options
Documentation
Notes, Known Problems, and Restrictions
Installed Files for 32-bit Drivers
Installed Files for 64-bit Drivers
Post-GA Product Announcements
The readme files will no longer be updated with product announcements and new
features after the General Availability (GA) of the product. For the latest
updates and enhancements, please refer to the release notes
(https://www.progress.com/datadirect-connectors/whats-new).
Requirements
* The installer program requires a JVM that is Java SE 11 or higher, including
Oracle JDK, OpenJDK, and IBM SDK (Java) distributions.
* The driver requires the following runtime libraries:
- AIX: C/C++ runtime libraries version 16.1 or higher
- Linux: C/C++ runtime libraries version GCC 2.12 or higher
- Solaris: C/C++ runtime libraries version 12.6 or higher
Installation Directory
* The default installation directory for the 32-bit driver is:
/opt/Progress/DataDirect/ODBC_32Bit
* The default installation directory for the 64-bit driver is:
/opt/Progress/DataDirect/ODBC_64Bit
Data Source and Platform Support
For the latest data source and platform support information, refer to the
Product Compatibility Guide:
https://docs.progress.com/bundle/datadirect-product-compatibility/resource/
datadirect-product-compatibility.pdf
Third-party Components Compatibility Matrix
For information about the third-party components that are installed with the
product, refer to the ODBC Third-party Components Compatibility Matrix on the
DataDirect Product Life Cycle page:
https://docs.progress.com/bundle/datadirect-product-life-cycle/page/topics/
datadirect_life_cycle/datadirect-product-life-cycle.html
Changes for 8.0.2 Release
Debugging Symbols
------------------
The driver binaries now include debugging symbols that can be used for
diagnosing and debugging issues in the driver.
ICU Library Upgrade (74.1)
--------------------------
The ICU library files that are installed with the product have been upgraded
to version 74.1. As a part of this upgrade, the following platforms and their
file names have been updated:
* AIX platforms
- 32-bit product package: From libivicu28.a to libivicu.a
- 64-bit product package: From libddicu28.a to libddicu.a
Note - This upgrade is available starting in build 08.02.1072 of the ICU
library files.
* Linux platforms
- 32-bit product package: From libivicu28.so to libivicu.so
- 64-bit product package: From libddicu28.so to libddicu.so
Note - This upgrade is available starting in build 08.02.0965 of the ICU
library files.
* Solaris platforms (Sparc and Solaris X)
- 32-bit product package: From libivicu28.so to libivicu.so
- 64-bit product package: From libddicu28.so to libddicu.so
Note - This upgrade is available starting in build 08.02.1799 of the ICU
library files.
As part of the ICU 74.1 upgrade, the complier and runtime versions for the
driver have been changed to the following:
* For AIX platforms, the compiler version has been upgraded to xlclang++ 16.1.
As a result, you must have C/C++ runtime libraries of 16.1 or higher
on your machine.
* For Linux platforms, the compiler version has been upgraded to GCC 7.3.1.
As a result, you must have C/C++ runtime libraries of GCC 2.12 or higher
on your machine.
* For Solaris platforms, the compiler version has been upgraded to Oracle
Developer Studio 12.6. As a result, you must have C/C++ runtime libraries
of 12.6 or higher on your machine.
SCRAM-SHA-256 Support
---------------------
The driver has been enhanced to support the SCRAM-SHA-256 password hashing
mechanism for user ID/password authentication. The SCRAM-SHA-256 mechanism
is supported with Greenplum server v6.21 and higher.
Available starting: Driver version 08.02.0369 (B3149, U3111)
JRE Requirement for the Installer
---------------------------------
The installer program now requires you to install a JRE that is Java SE 11 or
higher before running the installer. In earlier versions, the JRE used by the
installer program was included in the product. However, to avoid potential
security vulnerabilities, the installer program no longer includes a JRE.
Instead, the installer program uses the JRE in your environment to allow for
the most secure version of a JRE to be used.
Notes:
* This change does not affect the JVM requirements for the driver. For the latest
driver requirements, refer to the Product Compatibility Guide:
https://docs.progress.com/bundle/datadirect-product-compatibility/resource/
datadirect-product-compatibility.pdf
* The installer program cannot remove the already installed JRE files from the
install directory automatically. Remove them manually.
TLSv1.3 Support
---------------
The driver has been enhanced to support the TLSv1.3 cryptographic protocol for
TLS encryption. You can configure the cryptographic protocols used by the
driver with the Crypto Protocol Version (CryptoProtocolVersion) option.
End of Support for TLSv1.1 and TLSv1.0
--------------------------------------
The TLSv1.1 and TLSv1.0 cryptographic protocols are now disabled by default.
These protocols are no longer considered secure and, therefore, are no
longer recommended for use. However, the driver still supports them for
legacy servers that do not support more secure protocols.
End of Support for HP-UX PA-RISC
--------------------------------
The HP-UX PA-RISC platform is no longer supported.
Proxy Server Support
--------------------
The driver has been enhanced to support connecting to a proxy server through an
HTTP connection. HTTP proxy support is configurable with five new connection
options: Proxy Host (ProxyHost), Proxy Mode (ProxyMode), Proxy Password
(ProxyPassword), Proxy Port (ProxyPort), and Proxy User (ProxyUser). Refer to
the user's guide for details.
Default Value for Batch Mechanism
----------------------------------
The default value for the Batch Mechanism (BatchMechanism) connection option has
been changed to 3 (Copy).
Default Values for Unbounded Numeric Precision and Unbounded Numeric Scale
--------------------------------------------------------------------------
The default values for the Unbounded Numeric Precision (UnboundedNumericPrecision)
and Unbounded Numeric Scale (UnboundedNumericScale) options have been changed to
-1.
SSL Enhancement (3.0.9)
-----------------------
Note: OpenSSL library 3.0.9 has been replaced with a later version. For
the latest information about the third-party components that are installed
with the product, refer to the ODBC Third-party Components Compatibility
Matrix on the DataDirect Product Life Cycle page:
https://docs.progress.com/bundle/datadirect-product-life-cycle/page/topics/
datadirect_life_cycle/datadirect-product-life-cycle.html.
The default version of the OpenSSL library has been upgraded to version
3.0.9, which fixes the security vulnerabilities listed on the following
page: https://www.openssl.org/news/vulnerabilities-3.0.html
This upgrade is available in build 08.02.0595 of the following OpenSSL
library files:
- On AIX: libivopenssl30.a (32-bit) and libddopenssl30.a (64-bit)
- On other platforms: ivopenssl30.so [.sl] (32-bit) and ddopenssl30.so (64-bit)
Notes:
* The driver supports the following OpenSSL 3.0 providers: Default and
FIPS.
* The FIPS provider is supported only on the following platforms:
Windows 64-bit, Linux 64-bit, and AIX 64-bit.
* The following connection options have been added to configure the
driver to use OpenSSL 3.0: Enable FIPS (EnableFIPS), OpenSSL Config File
(OpenSSLConfigFile), and OpenSSL Provider Path (OpenSSLProviderPath).
For more information on the new connection options and how to configure
the driver to use OpenSSL 3.0, refer to the user's guide.
* When installing a new version of the product, the installer program will
automatically replace the OpenSSL 1.1.1 library files with the OpenSSL 3.0
library files in the install directory, which will impact all the DataDirect
ODBC drivers installed on a machine. Therefore:
- If you are using multiple 8.0 drivers, upgrade all your drivers to the latest
version.
- If you are using both 8.0 and 7.1 versions of the driver, copy the xxtls27.dll
file to a different location before installing a new version of the 8.0 driver.
Copy it back to the install directory once the installation is complete.
Password Encryption Tool
------------------------
A Password Encryption Tool, called ddencpwd, is now included with the product
package. It encrypts passwords for secure handling in connection strings and
odbc.ini files. At connection, the driver decrypts these passwords and passes
them to the data source as required.
Support for TLS/SSL Server Authentication in a Serverless Environment
---------------------------------------------------------------------
The driver has been enhanced to support TLS/SSL server authentication for the
applications deployed in a server-less environment. The driver stores the
TLS/SSL certificates in memory and lets applications use TLS/SSL server
authentication without storing the truststore file on the disk. To use this
enhancement, specify the content of the certificate in the updated Trust Store
(Truststore) connection option or the new SQL_COPT_INMEMORY_TRUSTSTORECERT
pre-connection attribute.
Timestamp Logging in Packet Logs
--------------------------------
The driver has been enhanced to include timestamp in the internal packet logs
by default. If you want to disable the timestamp logging in packet logs, set
PacketLoggingOptions=1. The internal packet logging is not enabled by
default. To enable it, set EnablePacketLogging=1.
Setting Unicode Encoding Type for Connections
---------------------------------------------
The Driver Manager for UNIX/Linux has been enhanced to support setting the
Unicode encoding type for applications on a per connection basis. By passing
a value for the SQL_ATTR_APP_UNICODE_TYPE attribute using SQLSetConnectAttr,
your application can specify the encoding at connection. This allows your
application to pass both UTF-8 and UTF-16 encoded strings with a single
environment handle.
The valid values for the SQL_ATTR_APP_UNICODE_TYPE attribute are
SQL_DD_CP_UTF8 and SQL_DD_CP_UTF16. The default value is SQL_DD_CP_UTF8.
ODBC Cursor Library
-------------------
The product package no longer includes the ODBC Cursor library file
(odbccurs.so) because it has some known security vulnerabilities that
could potentially expose you to security risks.
Note: The installer program cannot remove the ODBC Cursor library file
automatically while installing a new version of the driver. Remove it
manually.
Deprecation of the Allowed OpenSSL Versions Connection Option
-------------------------------------------------------------
The Allowed OpenSSL Versions (AllowedOpenSSLVersions) connection option has
been deprecated as the driver currently supports only version 3.0 of the
OpenSSL library.
BatchMechanism Connection Option
--------------------------------
The driver has been enhanced with the new BatchMechanism connection option,
which specifies the preferred mechanism for executing batch insert
operations. By setting Batch Mechanism to 2 (MultiRowInsert) or 3 (Copy), the
driver can achieve substantial performance gains when performing batch
inserts. The default setting is BatchMechanism=3 (Copy).
Citext, Float, and Tinyint Data Types
-------------------------------------
The driver has been enhanced to support the following data types: Citext,
Float, and Tinyint.
Notes, Known Problems, and Restrictions
Specifying values for the same connection option multiple times
---------------------------------------------------------------
The driver does not support specifying values for the same connection
option multiple times in a connection string or DSN. If a value is
specified using the same attribute multiple times or using both
long and short attributes, the connection may fail or the driver may
not behave as intended.
For SSL Users
-------------
When trying to connect to a database using SSL encryption, you may
receive an error message similar to: "PRNG not seeded". This is because
certain versions of some operating systems do not generate truly random
numbers necessary for encryption. For more information about this error
and available patches, please refer to the Web site:
http://www.openssl.org/support/faq.html#USER1
On SUSE Linux Enterprise Server 10.0, attempts by the drivers to
connect using SSL Encryption will not succeed due to a problem loading
the SSL libraries.
ODBC Development on UNIX and Linux Platforms
--------------------------------------------
All of the Release 8.0 Core Components (header files, etc.) needed for
development of ODBC applications on UNIX and Linux are installed into
the /include directory created by the product installer.
Please read the notices file in the installation directory for
licensing information regarding the ODBC Core Components. Contact your
Progress DataDirect representative if you have any questions.
Developers using programming languages other than C++:
The DataDirect ODBC Driver Manager is a C++ shared library. The ODBC
Driver Manager can be used with any language that supports loading a
C++ shared library; however, if you are using a programming language
other than C++, you must take additional steps to ensure that the C++
libraries are initialized properly when loaded. If you are not using
C++, consult your compiler documentation for instructions on using C++
shared libraries with your application.
LANG Environment Setting on UNIX and Linux Platforms
----------------------------------------------------
A default installation of the product on UNIX and Linux assumes that
the value of the LANG environment setting is en_US. If your locale is
not set to en_US, the drivers may not return error messages properly.
In this case, you must create a symbolic link in the
<Install_Dir>/locale directory that has the same value as the LANG
environment setting. This link must point to the
<Install_Dir>/locale/en_US directory.
SQLColAttribute(s)
------------------
The column attributes 1001 and 1002, which were assigned as DataDirect-
specific attributes, were inadvertently used as system attributes by
the Microsoft 3.0 ODBC implementation. Applications using those
attributes must now use 1901 and 1902, respectively.
SQL_C_NUMERIC
-------------
Because of inconsistencies in the ODBC specification, users attempting
to use SQL_C_NUMERIC parameters must set the precision and scale values
of the corresponding structure and the descriptor fields in the
Application Parameter Descriptor.
For Developers Using IIS
------------------------
One of the most common connectivity issues encountered while using IIS
(Microsoft's Internet Information Server) concerns the use and settings
of the account permissions. If you encounter problems using DataDirect
drivers with an IIS server, refer to KnowledgeBase document number 4274
on the Progress DataDirect web site:
http://knowledgebase.datadirect.com.
Configuring Data Sources
Data sources are stored in the system information file (typically,
odbc.ini). For details on configuring this file, see the PROGRESS
DATADIRECT FOR ODBC FOR GREENPLUM WIRE PROTOCOL DRIVER USER'S GUIDE.
Driver WorkAround Options
Progress DataDirect has included non-standard connection options (workarounds)
for the driver that enable you to take full advantage of packaged ODBC-enabled
applications requiring non-standard or extended behavior. Refer to the chapter
"WorkAround options" in THE PROGRESS DATADIRECT FOR ODBC DRIVERS REFERENCE for a
description of these options.
Documentation
PROGRESS DATADIRECT FOR ODBC FOR GREENPLUM WIRE PROTOCOL DRIVER
DOCUMENTATION SET
---------------------------------------------------------------
The user's guide is available as an HTML help system on the DataDirect
documentation web page:
https://docs.progress.com/category/datadirect-greenplum
You can access the online help system directly via the HTML redirect in the
installation Help directory.
Installed Files for the 32-bit Driver
This file list assumes a full installation of the 32-bit driver and
documentation.
The installer copies the following files and subdirectories to the
product installation directory, by default:
/opt/Progress/DataDirect/ODBC_32bit:
/<install_dir>/:
----------------
DataDirect Documentation
- Progress Internet shortcut to documentation website
odbc.csh Setup script for C shell
odbc.ini Sample odbc.ini file
odbcinst.ini Sample odbcinst.ini file
odbc.sh Setup script for Bourne shell
IVODBC.LIC DataDirect license file
license.txt End User License Agreement
/bin/:
------
ivtestlib Test application to check that required
libraries are present and loadable
/FIXES/:
--------
fixes8.0.txt List of fixes since last release
/help/:
-------
*.html HTML redirects to driver help systems
/include/:
----------
odbcinst.h Include files
qesqlext.h
sql.h
sqlext.h
sqltypes.h
sqlucode.h
sqlunx.h
/install/:
---------
*.* Files associated with the installer program
/lib/:
------
ivgplm28.so Greenplum Wire Protocol driver
ivopenssl30.so TLS/SSL support file (OpenSSL library
version 3.0) [libivopenssl30.a on AIX]
ivopenssl.so TLS/SSL support file (OpenSSL library
version 3.5) [libivopenssl.a on AIX]
ivtrc28.so DataDirect trace library
libivcurl28.so Library used for HTTP connections
libivicu.a Unicode conversion tables for AIX platforms
libivicu.so Unicode conversion tables for Linux and
Solaris platforms
libodbc.so ODBC Driver Manager
libodbcinst.so ODBC Installer
/locale/en_US/LC_MESSAGES/:
--------------------------
ivgplm28.mo Greenplum Wire Protocol driver message
file
ivgplm28.po Greenplum Wire Protocol driver message
file source
odbc.m ODBC Driver Manager message file
odbc.po ODBC Driver Manager message source
/NOTICES/:
----------
ODBC for Greenplum
v8.0 notices.txt Third-party vendor license agreements
/READMES/:
----------
ODBC for Greenplum
v8.0 readme.txt This file
/samples/bulk/:
---------------
bulk Bulk application
bulk.c Bulk example source
bulk.mak Bulk example make file
bulk.txt Bulk load example readme
ddlogging.properties Log configuration file for the
Greenplum Wire Protocol driver
/samples/bulkstrm/:
------------------
bulkstrm Bulk streaming example application
bulk.cpp Bulk streaming example source
bulk.hpp Bulk streaming example header
bulkstrm.txt Bulk streaming description
ddlogging.properties Log configuration file for the
Greenplum Wire Protocol driver
main.cpp Bulk streaming example source file
msgprintf.hpp Bulk streaming example header file
streambulk.mak Bulk streaming example make file
/samples/example/:
------------------
example Example application
example.c Example source
example.h Example header
example.mak Example make file
ddlogging.properties Log configuration file for the
Greenplum Wire Protocol driver
/tools/:
--------
ddencpwd Password Encryption Tool
ddextu License Extender utility
ddprocinfo Processor Information utility
/uninstall/:
------------
*.* Files used to uninstall the product
Installed Files for the 64-bit Driver
This file list assumes a full installation of the 64-bit driver and
documentation.
The installer copies the following files and subdirectories to the
product installation directory, by default:
/opt/Progress/DataDirect/ODBC_64bit:
/<install_dir>/:
-------------
DataDirect Documentation
- Progress Internet shortcut to documentation website
odbc.csh Setup script for C shell
odbc.ini Sample odbc.ini file
odbcinst.ini Sample odbcinst.ini file
odbc.sh Setup script for Bourne shell
DDODBC.LIC DataDirect license file
license.txt End User License Agreement
/bin/:
------
ddtestlib Test application to check that required
libraries are present and loadable
/FIXES/:
--------
fixes8.0.txt List of fixes since last release
/help/:
-------
*.html HTML redirects to driver help systems
/include/:
----------
odbcinst.h Include files
qesqlext.h
sql.h
sqlext.h
sqltypes.h
sqlucode.h
sqlunx.h
/install/:
---------
*.* Files associated with the installer program
/lib/:
------
ddgplm28.so Greenplum Wire Protocol driver
ddopenssl30.so TLS/SSL support file (OpenSSL library
version 3.0) [libddopenssl30.a on AIX]
ddopenssl.so TLS/SSL support file (OpenSSL library
version 3.5) [libddopenssl.a on AIX]
ddtrc28.so DataDirect trace library
fips.so Support file for FIPS provider
libddcurl28.so Library used for HTTP connections
libddicu.a Unicode conversion tables for AIX platforms
libddicu.so Unicode conversion tables for Linux and Solaris
platforms
libodbc.so ODBC Driver Manager [.a on AIX]
libodbcinst.so ODBC Installer [.a on AIX]
openssl.cnf Configuration file for FIPS provider
/locale/en_US/LC_MESSAGES/:
---------------------------
ddogplm28.mo Greenplum Wire Protocol driver message
file
ddgplm28.po Greenplum Wire Protocol driver message
file source
odbc.m ODBC Driver Manager message file
odbc.po ODBC Driver Manager message source
/NOTICES/:
----------
ODBC for Greenplum
v8.0 notices.txt Third-party vendor license agreements
/READMES/:
----------
ODBC Greenplum
v8.0 readme.txt This file
/samples/bulk/:
---------------
bulk Bulk application
bulk.c Bulk example source
bulk.mak Bulk example make file
bulk.txt Bulk load example readme
ddlogging.properties Log configuration file for the
Greenplum Wire Protocol driver
/samples/bulkstrm/:
------------------
bulkstrm Bulk streaming example application
bulk.cpp Bulk streaming example source
bulk.hpp Bulk streaming example header
bulkstrm.txt Bulk streaming description
ddlogging.properties Log configuration file for the
Greenplum Wire Protocol driver
main.cpp Bulk streaming example source file
msgprintf.hpp Bulk streaming example header file
streambulk.mak Bulk streaming example make file
/samples/example/:
------------------
example Example application
example.c Example source
example.h Example header
example.mak Example make file
ddlogging.properties Log configuration file for the
Greenplum Wire Protocol driver
/tools/:
--------
ddencpwd Password Encryption Tool
ddextu License Extender utility
ddprocinfo Processor Information utility
/uninstall/:
------------
*.* Files used to uninstall the product
~~~~~~~~~~~~~~
April 2026
End of README.TXT