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

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

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

CONTENTS

Changes for Release 4.2.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.2.1

Tomcat upgrade
--------------
The Hybrid Data Pipeline server and On-Premises Connector have been upgraded to
install and use Tomcat 8.5.23.


     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.

FIPS Compliance
---------------
The On-Premises Connector is not currently FIPS compliant. Therefore, any
connections made to an on-premises data source through an On-Premises Connector
will not be fully FIPS compliant.

No support for external authentication
--------------------------------------
External authentication services are not currently supported when connecting to
data sources using 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. Note that
upgrading an existing installation of the On-Premises Connector maintains the
Connector ID.


     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

November 2017
~~~~~~~~~~~~~
End of README