To brand the Progress DataDirect for ODBC drivers using the GUI:

  1. At a command prompt, switch to the directory containing the unzipped installer files; then, type the command:

    installer_filename.exe -r response_file

    where:

    installer_filename
    is the full name of the installer's executable file you unzipped in Step 2 in "Branding the drivers on Windows."
    response_file
    is the absolute path and file name of the response file you want to create.

    For example, the following command creates a response file named installer.properties in the C:\temp directory:

    PROGRESS_DATADIRECT_ODBC_8.0_WIN_64_INSTALL.exe -r C:\temp\installer.properties

    The product Introduction window appears. Click Next.

  2. The License Agreement window appears. Make sure that you read and understand the license agreement. To continue with the installation, select the I accept the terms in the License Agreement option; then, click Next.
  3. In the Where Would You Like to Install? field, type the path, including the drive letter, of the product installation directory or click the Choose (...) button to browse to and select an installation directory.

    Verify that you have entered (or selected) the correct installation directory. To restore the installation directory to its default setting, click Restore Default Folder. Then, click OK to return to the Install Directory window. Click Next to continue. Proceed as follows:

    • If you are using a single-driver installer, proceed to the next step.
    • If you are using a Unified Installer, skip to Step 5.
  4. When prompted for the type of installation, select the OEM or Licensed installation option and click Next to enter your product licensing information.
  5. The Product Registration window appears.
    Product Registration window with validated control numbers for Apache Hive and Oracle Wire Protocol

    In the Control # field, enter the product control number for branding that was provided by Progress DataDirect ; then, click Validate. The driver that corresponds to that control number appears in Drivers tree. Repeat this process for each driver you want to install.

    Select the drivers that you want to install from the tree, and then click Next.
    Note: You can only install one version of each driver. If multiple versions of the same driver are selected, the installer will return an error message.
  6. You are prompted to select the OEM Installation Type. Select one of the following:
    • To install branded drivers, select Branded Installation. Skip to Step 8.
    • To install unbranded drivers, select Unbranded Installation. This option allows you to install standard, unbranded, versions of the product with an OEM license. Proceed to the next step.
  7. The Product Registration window appears.
    Product Registration window with all fields blank

    Provide the following information; then, click Next to continue.

    1. Type your name and company name in the corresponding fields.
    2. Type the serial number that was provided by Progress DataDirect.

    Skip to Step 9.

  8. A Product Branding window appears, prompting you for branding information.
    Progress DataDirect Driver for ODBC Product Branding

    Provide the following information; then, click Next.

    User Name: Type your name.

    Company Name: Type your company name. This name is used in the license file and appears on the Version tab when displaying the properties of a DLL. The restrictions are:

    • The field is case-sensitive.
    • A maximum of 127 characters is allowed.
    • The field is ignored if DataDirect is specified in the Message Prefix field.

    Serial Number: Type the serial number that was provided by Progress DataDirect in the Serial Number field.

    New Prefix: Type the 2-character prefix that you registered with Progress DataDirect to encode the driver and license files. See "Before branding the drivers" for details. For example, if you brand the Apache Hive driver with the prefix gf, the installer renames this file to gfhivenn.dll. The case-insensitive license file uses the same prefix.

    Product Name: Type your product name. The restrictions are:

    • The field is case-sensitive.
    • A maximum of 63 characters is allowed.

    Password: Type the password you registered through the Partners section of the Progress DataDirect Web site. The password is case-sensitive. If you enter fewer than 24 characters, the password is automatically padded with uppercase Qs.

    This password is locked into the branded driver license file to prevent unauthorized applications from using the branded drivers.
    Important: For security purposes, the value of the password field is not populated to the response file by the installer. You will need also need to manually add the password value to the generated response file with a text editor before executing your silent installation. The password entry takes the following form: PASSWORD=password. For more information on manually editing the response file, see Creating a response file using a text editor.

    Message Prefix: Type an error message prefix for the branded drivers. The restrictions are:

    • The field is case-sensitive.
    • A maximum of 30 characters is allowed.

    After branding, driver error messages are displayed with this prefix. For example, if xyzcompany is your message prefix, the driver error message:

    [DataDirect][Apache Hive ODBC Driver] Object has been closed

    becomes:

    [xyzcompany][Apache Hive ODBC Driver] Object has been closed

    Note: To continue using the DataDirect message prefix, specify a value of DataDirect. Be aware that when DataDirect is your message prefix, the installer program uses Progress Software Corporation as the company name, regardless of the value specified in the Company Name field.

    Branding Suffix: (Optional) Type a branding suffix for the branded drivers. The suffix can consist of a maximum of two numeric characters (0 to 9).

    After branding, the driver file names are displayed with this suffix. For example, if you brand the Amazon Redshift Wire Protocol driver with the prefix gf and the branding suffix 17, the files are renamed as gfrsft17.DLL.

  9. The Create Default Data Source window appears. Select the Create Default Data Sources check box to define a user data source for each DataDirect driver that you install.
    Warning: If you select Create Default Data Sources, data sources currently in your Registry with the same DataDirect default name will be overwritten. To maintain your current DataDirect default data sources, rename them before you continue.

    Click Next to proceed.

  10. The Pre-Installation Summary window allows you to review your installation details before installing. When you are satisfied with your installation or branding option selections, click Install to begin the installation.
  11. Click Done to exit the installer.

See "Performing the silent installation" for instructions on running the response file.

Note: For TLS/SSL-enabled drivers: Some releases of the product install multiple versions of the OpenSSL library file. By default, the installer brands the most secure installed version; however, you may want to brand a different version of the library based on the needs of your application. For details, see "Branding OpenSSL library files on Windows."