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

  1. Launch the installer program according to your branding type:
    • Standard branding: From the temporary directory that contains the installer files, open the installer's binary file to start the installer.
    • (64-bit Linux only) Cross-platform branding:

      From a command-line, switch to the temporary directory that contains the untarred installer files and enter:

      ./PROGRESS_DATADIRECT_ODBC_8.0_LINUX_64_INSTALL.bin -DCROSS_BRAND=platform

      where:
      platform
      is the platform and bitness of the product that you want to install. Valid values are aix32, aix64, hpia32, hpia64, hprisc32, hprisc64, linux32, linux64, linuxia64, linuxppc32, linuxppc64, linuxzos64, power864, solaris32 (SPARC), solaris64 (SPARC), solarisx32, or solarisx64.
      Note: Cross-platform branding allows you to install branded versions of the product for AIX, HP-UX, Linux, and Solaris platforms in the 64-bit Linux environment. This feature is typically used to reduce the effort of installing and branding drivers for multiple platforms by running platform-specific installers on a single operating system (Linux x64) and then using the installed binaries in the building/packaging of your application. Only the Unified Installer supports cross-platform branding. For details, see "Cross-platform branding."

    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.
    Note: If you specify a directory that contains a previous installation of the driver, a warning message appears. You must install the drivers in the same installation directory.
    Note: For cross-platform branding, specify a unique directory for each platform to prevent the installer program from overwriting earlier installations.
  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 MongoDB and Oracle Wire Protocol

    In the Control # field, enter the product Control # for branding that was provided by Progress DataDirect, and then click Validate. The drivers that you purchased appear in the Drivers tree. Repeat this process for each driver you want to install.

    Select the drivers that you want to install, and then click Next.
    Note: You can only install one version of each driver. If you select multiple versions of the same driver, the installer program 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 the standard, unbranded, version 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. 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 MongoDB driver with the prefix gf, the installer renames this file to gfmongonn.so. 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.

    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][MongoDB ODBC Driver] Object has been closed

    becomes:

    [xyzcompany][MongoDB 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.so.

  9. The Pre-Installation Summary window provides the opportunity for you to click back through the installer-program windows and make any changes or corrections. When you are satisfied with your installation or branding option selections, click Install to begin the installation.
  10. Click Done to exit the installer.
This completes the installation.
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 UNIX and Linux".