Load balancer installation (console mode)

1. Make the appropriate selection regarding SSL configuration based on your environment.

Important: If an SSL certificate is not specified, the installer will not generate the configuration and certificate files required for the installation of the On-Premises Connector and the ODBC and JDBC drivers.

Type 1 to specify the SSL certificate file to be used with the Hybrid Data Pipeline server. The specified file must be the root certificate used to sign the certificate for the load balancer server. PEM, DER, and Base64 encodings are supported. Type the full path to the certificate file. Then, press ENTER.

2. Choose the appropriate option depending on whether you are using MySQL Community Edition. MySQL Community Edition can be used as an external system database or as a data source. Hybrid Data Pipeline does not provide a driver for MySQL Community Edition. However, you can use the MySQL Connector/J driver to use MySQL Community Edition as an external system database or as a data source.

Type 1 and press ENTER, if you are using MySQL Community Edition. Type the name and location of the MySQL Connector/J jar file, and press ENTER again.

Type 2 and press ENTER, if you are not using MySQL Community Edition in your environment.

Note: To download the MySQL Connector/J driver, visit the MySQL developer website at https://dev.mysql.com/.

3. Select the type of external system database you want to use to store system information.

If you connect using the Oracle System Identifier (SID), type 1 and then enter the SID.

If you connect using the Service Name, type 2, then type the database service name that specifies the database that is used for the connection. The service name is a string that is the global database name—a name that typically comprises the database name and domain name.

d. Optionally, when prompted for Advanced Options, specify additional connection parameters and their values to be included the connection url. Values should be entered as a semicolon-separated list of parameter=value. For example, you may enter to following options to configure SSL:

encryptionLevel=Required;encryptionTypes=(AES256);
dataIntegrityLevel=Required;dataIntegrityTypes=(SHA1);
encryptionMethod=SSL;keyStore=/common/Oracle/trustStore.jks;
keyStorePassword=secret; serverType=dedicated;authenticationMethod=ntlm;
hostNameInCertificate=oracle;editionName=hybrid

5. Provide connection information for the MySQL Community Edition external database.

d. Optionally, when prompted for Advanced Options, specify additional connection parameters and their values to be included the connection url. Values should be entered as a ampersand-separated list of parameter=value.

e. Optionally, in the Advanced Options field, specify additional connection parameters and their values to be included in the connection URL. Values should be entered as a semicolon-separated list of parameter=value.

d. Optionally, in the Advanced Options field, specify additional connection parameters and their values to be included in the connection URL. Values should be entered as a semicolon-separated list of parameter=value.

8. You are prompted to provide the database credential information for a user with administrator privileges and for a user without administrator privileges. After you enter the credential information, press ENTER to continue.

Note: Administrator credentials are only required at install time to create the database schema. Administrator credentials are not used by the product at run time.

Note: If the installer is unable to validate, you are prompted to reenter credentials or skip validation. Skipping validation is often desired when performing a silent installation. See Silent installation process for details.

a. Type the administrator user name. The administrator user must have certain privileges that are specific to the database vendor. For a list of required privileges, see External system databases.

b. You are prompted to provide the Admin Password. Type the password for a administrator account for the external database.

c. You are prompted to provide the username for a user who does not have administrator privileges. Type a user name. The standard user must have certain privileges that are specific to the database vendor. For a list of required privileges, see External system databases.

9. Review the Server Access Port. The Server Access Port must be opened for the load balancer. The default is 8080.

Note: In most cases, the default port works without problems. However, your environment might have already defined a function for the port. If the default port is in use, the installer pops up a message so that you can make the necessary changes.

Note: An SSL certificate must be specified in Step 1 to use the On-Premises Connector.

If using the On-Premises Connector, type 1 and press ENTER. Then continue to the next step.

If not using the On-Premises Connector, type 2 and press ENTER. Continue at Step 12.

11. Review the On-Premises Access Ports. The On-Premises Access Port and the TCP Notification Server Port must be opened for the load balancer.

Note: In most cases, the default ports work without problems. However, your environment might have already defined a function for one or more of the ports. If a default port is in use, the installer pops up a message so that you can make the necessary changes.

Table 9. On-Premises Access Ports
Name	Default	Description
On-Premises Port	40501	Port for the On-Premises Connector
TCP Port	11280	Port for the Notification Server
Message Queue Port	8282	Port for the message queue

12. Review the Server Internal Ports. The Internal API Port and the Shutdown Port must be opened.

Table 10. Server Internal Ports
Name	Default	Description
Internal API Port	8190	Non-SSL port for the Internal API
Shutdown Port	8005	Shutdown port

13. Review the installation summary. If you are satisfied with your choices, press ENTER to install.

15. Verify the installation by accessing the Hybrid Data Pipeline user interface from a browser. The login page should appear. For example, type:

where <myserver> is the fully qualified hostname or IP address of the load balancer.

After logging in, administrators can verify product version information by selecting About from the question mark drop-down menu. For more information on retrieving version information, refer to "Get Version Information" in the Progress DataDirect Hybrid Data Pipeline User's Guide.

Refer to installation log files for a record of any problems that may have occurred during the installation. See Server installation log files for details.

During installation, the installer generates four configuration and certificate files. These files will be located in the redist subdirectory of the key location you specified in Step 10 in "Console mode installation." Before installing a component such as the ODBC driver, the JDBC driver, or the On-Premises Connector, these files must be copied to the installer directory of the component you are installing.

Note: If an SSL certificate was not specified in Step 1, the installer will not generate the configuration and certificate files required for the installation of the On-Premises Connector and the ODBC and JDBC drivers.