GUI mode installation
- Last Updated: August 29, 2025
- 4 minute read
- Hybrid Data Pipeline
- Version 5.0
- Documentation
- Copy the product file to a temporary directory.
- Install a compatible JVM and define it on your system path. See Product requirements for details on JVM prerequisites.
After copying the downloaded product file to a temporary directory, take the following steps to install the Hybrid Data Pipeline server with the installer in GUI mode.
-
From a command-line prompt, navigate to the directory where
you saved the product file. Alternatively, place the product file directory on
your path before proceeding to the next step.
The product file has the format PROGRESS_DATADIRECT_HDP_SERVER_nn_LINUX_64_INSTALL.bin, where nn is the version of the product.
-
Make the file an executable using the chmod command. Then, press ENTER. For example:
chmod +x ./PROGRESS_DATADIRECT_HDP_SERVER_nn_LINUX_64_INSTALL.bin
-
Run the executable by entering the product file path and
pressing ENTER.
-
Type the file name and path of the product file. For
example:
./PROGRESS_DATADIRECT_HDP_SERVER_nn_LINUX_64_INSTALL.bin
- Press ENTER.
- The Introduction window appears. Click Next to continue.
Note: If the installer cannot continue with a GUI installation, a message is displayed and the installation continues in console mode. -
Type the file name and path of the product file. For
example:
-
Choose the destination directory for the installation. Click
Next to accept the default
installation directory, or select Choose... to browse to a different directory, then click
Next.
The default installation directory is:
/opt/Progress/DataDirect/Hybrid_Data_Pipeline/Hybrid_Server
If you do not have /opt directory permissions, the installer program installs the drivers to your home directory by default. For example:
/home/users/<username>/Progress/DataDirect/Hybrid_Data_Pipeline/Hybrid_Server
-
Choose the JVM you want to use for the runtime operation of the server.
Note: By default, the JVM used to run the installer is selected. However, you may choose a different JVM by clicking Choose Java Executable and navigating to the Java executable of your preferred JVM. See Product requirements for details on JVM prerequisites.
-
Choose whether you want to install an evaluation or licensed
version of the product. Licensed installations require a valid License
Key.
- Evaluation. Select this option to install an evaluation version that is fully functional for 30 days. Then, click Next.
- Licensed. Select this option if you purchased a licensed version of the product. Type the license key, including any dashes, and then click Next.
-
Accept or enter the fully qualified hostname for the Hybrid
Data Pipeline server. By default, the installer suggests the name of the current
machine. Then, click Next.
Note:
- For non-load balancer deployments where the server is receiving queries directly, the hostname should be tied to the DNS for public access. This allows you to update IP addresses in the DNS without having to run an upgrade installation to reconfigure your deployment.
- If the installer is unable to validate the hostname, you are prompted to reenter the hostname or skip validation. Skipping validation is often desired when performing a silent installation or upgrade.
-
Select the installation type.
- To accept the default values for the remaining options, select Typical (use existing settings) and click Next. Continue at Step 9.
- To modify installation options, select Custom (choose configuration values) and click Next. Then, skip to Step 10.
You will need to complete a custom installation if you plan to do any of the following:
- Specify the key location. The key location serves as a location for shared files used in the installation and operation of the server. The key location should be secured on a system separate from the system that stores encrypted data, or encrypts or decrypts data.
- Enable FIPS
- Use a load balancer
- Change an SSL configuration
- Use MySQL Community Edition as a data store
- Store system information in an external MySQL Community Edition, Oracle, or SQL Server database
- Specify non-default values for ports used by the Hybrid Data Pipeline service
- Use On-Premises Connectors for secure access to on-premises data sources from the cloud
-
Specify passwords for the d2cadmin and
d2cuser user accounts. Continue at Step 14 in "Non-load balancer installation (GUI mode)".
Best practices recommend that you follow the Hybrid Data Pipeline default password policy when specifying these account passwords. When initially logging in to the Web UI or using the API, you must authenticate as one of these users.
-
Specify the key location. The key location serves as a
location for shared files used in the installation and operation of the server.
The key location should be secured on a system separate from the system that
stores encrypted data, or encrypts or decrypts data.
- Select Use default location to use the default location for a non-load balancer installation. This option cannot be used for a load balancer installation. The default location is install_dir/ddcloud/keystore.
- Select Specify location to specify a location other than the default for either a non-load balancer installation or a load balancer installation. (Note that you must specify a location for a load balancer installation.) Click Next and continue to the next step.
-
Specify passwords for the d2cadmin and
d2cuser user accounts.
Best practices recommend that you follow the Hybrid Data Pipeline default password policy when specifying these account passwords. When initially logging in to the Web UI or using the API, you must authenticate as one of these users.
-
Select whether you want to enable FIPS on the Hybrid Data
Pipeline server.
Important: To implement FIPS, your hardware must support secure random, or you must have a secure random daemon installed.
-
Specify if you are planning to use a load balancer.
- Select Not using Load Balancer if you do not plan to use a load balancer. For next steps, proceed to Non-load balancer installation (GUI mode).
- Select Network Load Balancer if you plan to use a network load balancer such as HAProxy. For next steps, proceed to Load balancer installation (GUI mode).
- Select Cloud Load Balancer if you plan to use a cloud load balancer such as AWS Application Load Balancer. For next steps, proceed to Load balancer installation (GUI mode).