Console mode installation
- Last Updated: April 28, 2025
- 5 minute read
- Hybrid Data Pipeline
- Version 4.6
- Documentation
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 console 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 -i console
- Press ENTER.
- The Introduction step appears. Press ENTER to continue.
-
Type the file name and path of the product file. For
example:
-
The License Agreement appears. Press ENTER multiple times to advance through the
license agreement. Make sure that you read and understand the license
agreement.
- To accept the terms in the License Agreement and continue with the installation, type Y.
- To end the installation, type N and press ENTER.
Note: You can exit the installation program at any time by typing Quit. -
You are prompted for the installation directory.
- Press ENTER to accept the default installation directory.
- Type the absolute path to the installation directory for the installation, and press ENTER.
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
If the directory contains an existing Hybrid Data Pipeline deployment, you are prompted to specify a different directory or upgrade the existing installation.
-
Choose whether you want to install an evaluation or licensed
version of the product. Licensed installations require a valid License
Key.
- Evaluation. Type 1 to proceed with installing an evaluation version of the product (functional for 30 days). Then, press ENTER to continue with the installation.
- Licensed. Type 2 if you purchased a licensed version of the product. Then, press ENTER. Type the license key, including any dashes, and then press ENTER.
-
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, press ENTER.
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, type 1 and press ENTER for a typical installation. Continue at Step 9.
- To customize installation options, type 2 and press ENTER. 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.
- Change the Java configuration to use an external JRE
- 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 15 in "Non-load balancer installation (console 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.
- Type 1 if you want to specify a location other than the default. You must specify a location for a load balancer installation. Press ENTER and continue to the next step.
- Type 2 and press ENTER if you want to use the default location for a non-load balancer installation. This option cannot be used for a load balancer. The default location is install_dir/ddcloud/keystore.
-
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.
-
Specify the desired Java configuration.
Note: Further steps may be required to integrate an external JRE. See JRE support and integration for details.
- Type 1 if you will be using an external JRE (a JRE not installed with the server).
- Type 2 if you will be using the embedded JRE installed with the server.
- Specify the fully qualified location of the Java home directory. This is the path to the external JRE. Press ENTER.
-
Specify 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.
- Type 1 if you want to enable FIPS. Press ENTER and continue to the next step.
- Type 2 and press ENTER if you want to use the default setting which is FIPS disabled.
-
Specify if you are planning to use a load balancer.
- Type 1 if you do not plan to use a load balancer. For next steps, proceed to Non-load balancer installation (console mode).
- Type 2 if you plan to use a network load balancer such as HAProxy. For next steps, proceed to Load balancer installation (console mode).
- Type 3 if you plan to use a cloud load balancer such as AWS Application Load Balancer. For next steps, proceed to Load balancer installation (console mode).