HDPOPCREADME.TXT
     Progress(R) DataDirect(R) Hybrid Data Pipeline
     Hybrid Data Pipeline On-Premises Connector
     Release 4.1
     April 2017     

***********************************************************************
Copyright (c) 1990-2017 Progress Software Corporation and/or its 
subsidiaries or affiliates. All Rights Reserved.

***********************************************************************

CONTENTS

Changes for Release 4.1
Product Features
Requirements
Installation Directory
Notes, Known Problems, and Restrictions
Documentation
Installed Files for the On-Premise Connector
Third-Party Acknowledgments

     Changes for Release 4.1

MySQL CE
--------
Support for MySQL Community Edition has been added to Hybrid Data Pipeline.
During installation of the Hybrid Data Pipeline server and the On-Premises
Connector, you provide the location of the MySQL Connector/J driver. After
installation, you may then configure data sources that connect to a MySQL CE
data store and execute queries with ODBC, JDBC, and OData applications.

Security Vulnerability
----------------------
The On-Premises Connector has been enhanced to resolve a security vulnerability.
We strongly recommend upgrading to the latest version to take advantage of this
fix.

OpenSSL
-------
The default OpenSSL library has been updated to 1.0.2k, which fixes the
following security vulnerabilities.

* Truncated packet could crash via OOB read (CVE-2017-3731)

* BN_mod_exp may produce incorrect results on x86_64 (CVE-2017-3732)

* Montgomery multiplication may produce incorrect results (CVE-2016-7055)

OpenSSL 1.0.2k addresses vulnerabilities resolved by earlier versions of the
library. For more information on OpenSSL vulnerabilities resolved by this
upgrade, refer to OpenSSL announcements:
https://www.openssl.org/news/openssl-1.0.2-notes.html

Tomcat Upgrade
--------------
The On-Premises Connector has been upgraded to use Tomcat 8.0.41.

Java SE Upgrade
---------------
The On-Premises Connector has been upgraded to use Java SE 8.

Windows Server 2003 Deprecation
-------------------------------
Support for Windows Server 2003 has been deprecated.


     Product Features

Progress DataDirect Hybrid Data Pipeline is a data access platform that provides
simple, secure access to cloud and on-premises data sources, such as RDBMS, Big
Data, and NoSQL. The On-Premises Connector is one of four primary components of
the Hybrid Data Pipeline. The On-Premises Connector enables the Hybrid Data
Pipeline to establish a secure connection from the cloud to an on-premises data
source.

* Supports HTTP Basic and NTLM proxy authentication.

* Java SE 8 is installed with and used by the On-Premises Connector. 


     Requirements

The On-Premises Connector must be installed on a 32-bit or 64-bit Windows
machine with any of the following operating systems:

* Windows 7, 8, or 10

* Windows Server 2008 or Server 2012 (Windows 64-bit only for both)


     Installation Directory

The default installation directory is:

C:\Program Files\Progress\DataDirect\Hybrid_Data_Pipeline_OnPremise_Connector

  
     Notes, Known Problems, and Restrictions

The following are notes, known problems, and restrictions with the On-Premises
Connector.

On-Premises Connector Configuration Tool
----------------------------------------
If User Account Control is enabled on your Windows machine and you installed the
On-Premises Connector in a system folder (such as Windows or Program Files), you
must run the On-Premises Connector Configuration Tool in administrator mode.

Microsoft Dynamics Kerberos
---------------------------
The JRE installed with the On-Premises Connector must be configured to run with
Kerberos. Take the following steps to configure the JRE.
- Download a zip file containing new version of the Java Cryptography 
  Extension (JCE) Unlimited Strength Jurisdiction Policy Files for 
  JDK/JRE 7 at
  http://www.oracle.com/technetwork/java/javase/downloads/jce-7-download-432124.html.
- Unzip the file into the \jre\lib\security directory to update 
  the Java security policy files to support 256-bit encryption: 
  -  C:\<installdir>\jre\lib\security\local_policy.jar
  -  C:\<installdir>\jre\lib\security\US_export_policy.jar

Re-installing the On-Premises Connector
---------------------------------------
Uninstalling and re-installing the On-Premises Connector causes the Connector
ID of the On-Premise Connector to change. Any Hybrid Data Pipeline data
sources using the old Connector ID must be updated to use the new Connector
ID. Installing to a new directory allows both the old and new On-Premise
Connector to exist side-by-side. However, you must update the Connector ID
option in previously-defined Hybrid Data Pipeline data sources to point to the
new On-Premise Connector.
In addition, you must update Connector ID wherever it was used, such as the
definitions of Group Connectors and Authorized Users.


     Documentation

Hybrid Data Pipeline documentation consists of the following guides and readmes.

* PROGRESS DATADIRECT HYBRID DATA PIPELINE INSTALLATION GUIDE
  Available online at
  https://documentation.progress.com/output/DataDirect/hybridpipeinstall

* PROGRESS DATADIRECT HYBRID DATA PIPELINE QUICK START
  Available online at
  https://documentation.progress.com/output/DataDirect/hybridpipestart

* PROGRESS DATADIRECT HYBRID DATA PIPELINE USER'S GUIDE
  Available online at
  https://documentation.progress.com/output/DataDirect/hybridpipeline

* The Hybrid Data Pipeline readme file: hdpreadme.txt
  Installed file and available online at
  https://documentation.progress.com/output/DataDirect/hdpreadmes/hdpreadme.htm

* The On-Premise Connector readme file: hdpopcreadme.txt
  Installed file and available online at
  https://documentation.progress.com/output/DataDirect/hdpreadmes/hdpopcreadme.htm

* The JDBC Driver readme file: hdpjdbcreadme.txt
  Installed file and available online at
  https://documentation.progress.com/output/DataDirect/hdpreadmes/hdpjdbcreadme.htm

* The ODBC Driver readme file: hdpodbcreadme.txt
  Installed file and available online at
  https://documentation.progress.com/output/DataDirect/hdpreadmes/hdpodbcreadme.htm

* The OpenAccess Server readme file: hdpoaserverreadme.txt
  Installed file and available online at
  https://documentation.progress.com/output/DataDirect/hdpreadmes/hdpoaserverreadme.htm


     Installed Files for the On-Premise Connector

The installer creates the following directories and files in the 
product installation directory represented by INSTALL_DIR.

64-bit: 

INSTALL_DIR:
HDPOPCREADME.TXT        This file
NOTICES.txt             Third-party vendor license agreements

INSTALL_DIR\install:
installed.properties
services.bat
wait_state.bat

INSTALL_DIR\install\logs:
*.*                     Installation log files

INSTALL_DIR\jre:
*.*                    A Java Runtime Environment used by the installer        
                       and uninstaller

INSTALL_DIR\OPDAS\config:
authentication.xml
datastore-profiles.xml
environment.xml
build.properties
urlrewrite.xml

INSTALL_DIR\OPDAS\server:
LICENSE.txt          
NOTICE.txt              Third-party vendor license agreements
RELEASE-NOTES           Apache Tomcat Release Notes
RUNNING.txt
\apps
\bin
\conf
\lib
\logs
\temp
\webapps
\work

INSTALL_DIR\OPDH:
\bin
\config
\logs

INSTALL_DIR\uninstall:
\resource
.com.zerog.registry.xml
InstallScript.iap_xml
installvariables.properties
uninstall_Progress_DataDirect_Hybrid_DataPipeline_On-Premise_-_64_bit.exe
uninstall_Progress_DataDirect_Hybrid_DataPipeline_On-Premise_-_64_bit.lax
uninstaller.jar

32-bit: 

INSTALL_DIR:
ddcloudopreadme.txt     This file
NOTICES.txt             Third-party vendor license agreements

INSTALL_DIR\install:
installed.properties
services.bat
wait_state.bat

INSTALL_DIR\install\logs:
*.*                     Installation log files

INSTALL_DIR\jre:
*.*                     A Java Runtime Environment used by the installer        
                        and uninstaller

INSTALL_DIR\OPDAS\config:
authentication.xml
datastore-profiles.xml
environment.xml

INSTALL_DIR\OPDAS\server:
LICENSE.txt          
NOTICES.txt             Third-party vendor license agreements
RELEASE-NOTES           Apache Tomcat Release Notes
RUNNING.txt
\bin
\conf
\lib
\logs
\temp
\webapps
\work

INSTALL_DIR\OPDH:
\bin
\config

INSTALL_DIR\uninstall:
\resource
.com.zerog.registry.xml
InstallScript.iap_xml
installvariables.properties
uninstall_Progress_DataDirect_Hybrid_DataPipeline_On-Premise_-_32_bit.exe
uninstall_Progress_DataDirect_Hybrid_DataPipeline_On-Premise_-_32_bit.lax
uninstaller.jar


     Third-Party Acknowledgments

Refer to the following Web page:
https://www.progress.com/legal/hybridpipe-third-party

April 2017
~~~~~~~~~~
End of README