Cloud and Hybrid TUTORIAL

Configuring On-Premise Connector for Hybrid Data Pipeline on AWS

Updated: 26 Feb 2021

Introduction

Progress DataDirect Hybrid Data Pipeline is an innovative data access service for enterprises and cloud ISVs that is designed to simplify and streamline data integration between cloud, mobile, and on-premises sources through a secure, firewall-friendly integration. One of the main features that we talk about and that many customers love is how Hybrid Data Pipeline connects your on-premise data sources even though they are behind a firewall.

In order to do that, you will have to install an On-Premise connector behind your firewall that allows secure and real-time access to in-network data sources from anywhere. To learn more about the On-Premise connector, you can watch this video.

As you can deploy Hybrid Data Pipeline, anywhere in the world and if you have deployed it on AWS EC2, this tutorial will help you to configure the On-premise connector to work properly with the Hybrid Data Pipeline installation on AWS EC2.

Before You Begin

  1. We assume that you have deployed Hybrid Data Pipeline on AWS EC2 by following this tutorial and now you are trying to install and configure On-premise connector in your environment.
  2. If you don’t have the installer for Hybrid Data Pipeline’s On-premise connector, you can download it by visiting this page and filling out your details.
  3. Before running the installer, you would have to copy the files in the path /path/to/Progress/DataDirect/Hybrid_Data_Pipeline/Hybrid_Server/redist/ from Hybrid Data Pipeline installation directory to the directory of the On-premise connector installer.

Installing On-Premise Connector

  1. Double click the installer to start the installation. Click next on the Introduction window.

     

    On Premise Connector Introduction

    Fig: Hybrid Data Pipeline – On Premise Connector Introduction

     

  2. On the next screen you would be asked to choose installation directory. You can either keep it as a default or choose your own location.

     

    On Premise Connector Install Location

    Fig: Hybrid Data Pipeline – On Premise Connector Install Location

     

  3. On the next screen, choose standard installation if you don’t need any customization. If you need to enable support for Microsoft Dynamics CRM or you would need a proxy to access public internet, choose advanced installation and click Next.

     

    On Premise Connector Installation Type

    Fig: Hybrid Data Pipeline – On Premise Connector Installation Type

     

  4. On the next screen, you would have to provide the credentials that you use to authenticate with Hybrid Data Pipeline and a unique connector label and click on Next.

     

    On Premise Connector Services Information

    Fig: Hybrid Data Pipeline – On Premise Connector Services Information

     

  5. Your credentials will be verified at this point and if it’s success authenticated, you will be shown Pre-installation summary. Click on Install to start the installation.

     

    On Premise Connector Pre Install Summary

     Fig: Hybrid Data Pipeline – On Premise Connector Pre Install Summary

     

  6. Click on Done, after the installation is complete to close the installer.

Configuring On-Premise Installer

  1. Open the Hybrid Data Pipeline On-Premise configuration tool from Start Menu and go to status tab and click on Test connection. You will see that On Premise connector fails to connect to couple of services as shown below.

     

    Before Status

    Fig: Hybrid Data Pipeline – Before Status

     

  2. This is because we didn’t configure the firewall and this EC2 instance inbound security rules to accept connections on the ports that these services are listening on.
  3. The default ports for On-Premise Access service is 40501 and Notification service is 11280 and 11443 where one doesn’t use SSL and other uses SSL. If you have configured these ports while installing, you should be able to find the values in the configuration file names Onpremise.properties that you copied from redist folder to install On-premise connector.
  4. To open the ports on the VM where Hybrid Data pipeline is installed, open the terminal and run the following commands.

     

    sudo iptables -I INPUT -p tcp -m tcp --dport 40501 -j ACCEPT

    sudo iptables -I INPUT -p tcp -m tcp --dport 11280 -j ACCEPT

    sudo iptables -I INPUT -p tcp -m tcp --dport 11443 -j ACCEPT

    sudo service iptables save

     

  5. Now go to AWS EC2 dashboard and on the left navigation pane, expand Network & Security and open Security groups.  Locate the security group for this instance and click on that row, you should see a bottom pane like below, where you can configure a new rule.

     

    EC2 Inbound Security Rules

    Fig: Hybrid Data Pipeline – EC2 Inbound Security Rules

     

  6. Add security rules to accept incoming TCP connections on the above ports. Please find below the screenshot of the settings for your reference.

     

    EC2 Inbound Security Rules

    Fig: Hybrid Data Pipeline – EC2 Inbound Security Rules

     

  7. Now open the Hybrid Data Pipeline On-premise configuration tool and test it again. This time connection to all services should be successful as shown below.

 

After Configuration

Fig: Hybrid Data Pipeline – After Configuration

Next Steps

Now that you have configured the On-Premise connector to work properly with your Hybrid Data Pipeline installation on AWS EC2 instance, feel free to connect your On-Premise data sources to access them in a fast, secure and easiest way than ever that you have ever accessed your data. If you have any questions or have any trouble with the configuration, feel free to leave comments below or contact support.

Connect any application to any data source anywhere

Explore all DataDirect Connectors

Need additional help with your product?

Get Customer Support