Progress DataDirect Connect Series for JDBC Installation Guide

Transcription

1 Progress DataDirect Connect Series for JDBC Installation Guide Release 5.1.4

2

3 Notices For details, see the following topics: Copyright Copyright 2016 Progress Software Corporation and/or one of its subsidiaries or affiliates. All rights reserved. These materials and all Progress software products are copyrighted and all rights are reserved by Progress Software Corporation. The information in these materials is subject to change without notice, and Progress Software Corporation assumes no responsibility for any errors that may appear therein. The references in these materials to specific platforms supported are subject to change. Business Making Progress, Corticon, DataDirect (and design), DataDirect Cloud, DataDirect Connect, DataDirect Connect64, DataDirect XML Converters, DataDirect XQuery, Deliver More Than Expected, Icenium, Kendo UI, Making Software Work Together, NativeScript, OpenEdge, Powered by Progress, Progress, Progress Software Business Making Progress, Progress Software Developers Network, Rollbase, RulesCloud, RulesWorld, SequeLink, Sitefinity (and Design), SpeedScript, Stylus Studio, TeamPulse, Telerik, Telerik (and Design), Test Studio, and WebSpeed are registered trademarks of Progress Software Corporation or one of its affiliates or subsidiaries in the U.S. and/or other countries. AccelEvent, AppsAlive, AppServer, BravePoint, BusinessEdge, DataDirect Spy, DataDirect SupportLink, Future Proof, High Performance Integration, OpenAccess, ProDataSet, Progress Arcade, Progress Profiles, Progress Results, Progress RFID, Progress Software, ProVision, PSE Pro, SectorAlliance, Sitefinity, SmartBrowser, SmartComponent, SmartDataBrowser, SmartDataObjects, SmartDataView, SmartDialog, SmartFolder, SmartFrame, SmartObjects, SmartPanel, SmartQuery, SmartViewer, SmartWindow, WebClient, and Who Makes Progress are trademarks or service marks of Progress Software Corporation and/or its subsidiaries or affiliates in the U.S. and other countries. Java is a registered trademark of Oracle and/or its affiliates. Any other marks contained herein may be trademarks of their respective owners. 3

4 Notices Please refer to the readme applicable to the particular Progress product release for any third-party acknowledgements required to be provided in the documentation associated with the Progress product. 4

5 Contents Table of Contents Preface...7 About This Guide...7 What Is Progress DataDirect Connect Series for JDBC?...8 Using This Guide...8 About the Product Documentation...8 Typographical Conventions...9 Contacting Technical Support...10 Chapter 1: Before You Install...13 System and Product Requirements...13 JDBC Drivers...13 Kerberos Authentication...15 NTLM Authentication...16 SSL Encryption...17 Oracle Advanced Security...19 JTA Support...20 Bulk Load...21 Supported Databases...23 Choosing the Installer...26 Evaluation Installations...26 Chapter 2: Installing DataDirect Connect Series for JDBC...27 Default Installation Directory...28 Installing the Product...28 GUI Installation...28 Command-Line Installation...30 Silent Installation...31 Installation Log File...34 Upgrading an Evaluation Installation to a Licensed Installation...35 Testing the Drivers...35 Uninstalling...35 Using the Performance Tuning Wizard...35 Starting the Wizard...36 Tuning Performance Using the Wizard...37 Creating DB2 Packages...38 Using the Drivers with Application Servers...39 Using the Drivers with Hibernate...39 For More Information

6 Contents Index

7 Preface For details, see the following topics: About This Guide What Is Progress DataDirect Connect Series for JDBC? Using This Guide About the Product Documentation Typographical Conventions Contacting Technical Support About This Guide This guide provides information on installing Progress DataDirect Connect Series for JDBC, which includes the following products: DataDirect Connect for JDBC DB2 Driver Informix Driver MySQL Driver Oracle Driver PostgreSQL Driver Progress OpenEdge Driver 7

8 Preface Microsoft SQL Server Driver Sybase Driver DataDirect Connect XE for JDBC The Driver for Apache Hive Greenplum Driver Salesforce Driver What Is Progress DataDirect Connect Series for JDBC? Progress DataDirect Connect Series for JDBC provides a suite of JDBC drivers that supports most leading databases. The drivers are compliant with Type 4 architecture, but provide advanced features that define them as Type 5 drivers. These features include: Application failover Distributed transactions Bulk load The drivers consistently support the latest database features and are fully compliant with Java SE 8 and JDBC 4.0 functionality. Using This Guide This guide assumes that you are familiar with your operating system and its commands, the concept of directories, the management of user accounts and security access, and your network protocol and its configuration. For the latest information about the product, refer to the README file in your software package or refer to the DataDirect Connectors Documentation Web Page. Note: This book refers the reader to Web URLs for more information about specific topics, including Web URLs not maintained by Progress DataDirect. Because it is the nature of Web content to change frequently, Progress DataDirect can guarantee only that the URLs referenced in this book were correct at the time of publishing. About the Product Documentation The Progress DataDirect Connect Series for JDBC library consists of the following guides: Progress DataDirect Connect Series for JDBC Installation Guide details requirements and procedures for installing the product. 8

9 Preface Progress DataDirect Connect Series for JDBC User s Guide provides information about customizing and using the product. Progress DataDirect Connect Series for JDBC Reference provides reference information for using the product. Installed Documentation The User's Guide and Reference are installed with the product as an HTML-based help system. This help system is located in the help subdirectory of the product installation directory. You can use the help system with any of the following browsers: Google Chrome 33.x or higher Internet Explorer 9.x or higher Mozilla Firefox 27.x or higher Safari or higher Opera 20.x or higher Online Documentation The Progress DataDirect Connect Series for JDBC library is available online in HTML and PDF formats by searching the supported database system on the DataDirect Connectors Documentation Web Page. Typographical Conventions This guide uses the following typographical conventions: italics Convention Explanation Introduces new terms with which you may not be familiar, and is used occasionally for emphasis. bold Emphasizes important information. Also indicates button, menu, and icon names on which you can act. For example, click Next. BOLD UPPERCASE Indicates keys or key combinations that you can use. For example, press the ENTER key. UPPERCASE Indicates SQL reserved words. monospace Indicates syntax examples, values that you specify, or results that you receive. monospaced italics > Indicates names that are placeholders for values that you specify. For example, filename. Separates menus and their associated commands. For example, Select File > Copy means that you should select Copy from the File menu. 9

10 Preface Convention Explanation / The slash also separates directory levels when specifying locations under UNIX. vertical rule Indicates an "OR" separator used to delineate items. brackets [ ] Indicates optional items. For example, in the following statement: SELECT [DISTINCT], DISTINCT is an optional keyword. Also indicates sections of the Windows Registry. braces { } Indicates that you must select one item. For example, {yes no} means that you must specify either yes or no. ellipsis... Indicates that the immediately preceding item can be repeated any number of times in succession. An ellipsis following a closing bracket indicates that all information in that unit can be repeated. Contacting Technical Support Progress DataDirect offers a variety of options to meet your support needs. Please visit our Web site for more details and for contact information: The Progress DataDirect Web site provides the latest support information through our global service network. The SupportLink program provides access to support contact details, tools, patches, and valuable information, including a list of FAQs for each product. In addition, you can search our Knowledgebase for technical bulletins and other information. When you contact us for assistance, please provide the following information: Your number or the serial number that corresponds to the product for which you are seeking support, or a case number if you have been provided one for your issue. If you do not have a SupportLink contract, the SupportLink representative assisting you will connect you with our Sales team. Your name, phone number, address, and organization. For a first-time call, you may be asked for full information, including location. The Progress DataDirect product and the version that you are using. The type and version of the operating system where you have installed your product. Any database, database version, third-party software, or other environment information required to understand the problem. A brief description of the problem, including, but not limited to, any error messages you have received, what steps you followed prior to the initial occurrence of the problem, any trace logs capturing the issue, and so on. Depending on the complexity of the problem, you may be asked to submit an example or reproducible application so that the issue can be re-created. 10

11 Preface A description of what you have attempted to resolve the issue. If you have researched your issue on Web search engines, our Knowledgebase, or have tested additional configurations, applications, or other vendor products, you will want to carefully note everything you have already attempted. A simple assessment of how the severity of the issue is impacting your organization. 11

12 Preface 12

13 1 Before You Install Before you install the product, verify that your database is supported and that your system meets the requirements described in this chapter. For details, see the following topics: System and Product Requirements Supported Databases Choosing the Installer Evaluation Installations System and Product Requirements For hard disk space requirements, refer to the README text file in your product package. JDBC Drivers The following table describes product requirements for using the drivers. Note: The Salesforce driver requires a Java SE 7 or higher JVM to comply with Salesforce security standards. 13

14 Chapter 1: Before You Install Table 1: Product Requirements for the Drivers JDBC 4.0 API JDBC 3.0 API SSL encryption For Applications Using... Oracle Advanced Security encryption and data integrity encrypted user ID and password authentication Kerberos authentication NTLM authentication distributed transactions using the Java Transaction API (JTA) DataDirect Bulk Load J2EE Connector Architecture JSR 114 Rowsets JDBC 2.0 Core API JDBC 2.0 Optional Package Java SE 5 or higher Java SE 5 or higher Java SE 5 or higher Product Requirements See SSL Encryption on page 17 for further requirements. Java SE 5 or higher See Oracle Advanced Security on page 19 for further requirements. Java SE 5 or higher Java SE 5 or higher See Kerberos Authentication on page 15 for further requirements. Java SE 5 or higher See NTLM Authentication on page 16 for further requirements. Java SE 5 or higher See JTA Support on page 20 for further requirements. Java SE 5 or higher See Bulk Load on page 21 for further requirements. Java SE 5 or higher Java SE 5 or higher Java SE 5 or higher Java SE 5 or higher Also, the following APIs are required and are supplied with the product: JDBC Optional Package 2.0 JNDI 1.2 JDBC 1.22 API Java SE 5 or higher 14

15 System and Product Requirements Note: Standard installations of Java SE on some platforms do not include the jar file containing the extended encoding set that is required to support some of the less common database code pages. Check your Java SE installation to make sure that the charsets.jar is installed in the lib subdirectory of your Java SE installation directory. If you do not have the charsets.jar file, re-install Java SE, making sure that you install the international version of Java SE. Kerberos Authentication Kerberos authentication is a trusted third-party authentication service. Kerberos authentication can take advantage of the user name and password maintained by the operating system to authenticate users to the database or use another set of user credentials specified by the application. The following drivers support Kerberos authentication: The Driver for Apache Hive DB2 driver Oracle driver SQL Server driver 1 Sybase driver Verify that your environment meets the requirements listed in the following table before you configure your driver for Kerberos authentication. Table 2: Product Requirements: Kerberos Authentication for DataDirect Connect for JDBC Component Database server Requirements The database server must be running one of the following databases: Apache Hive: HiveServer2 protocol DB2: DB2 V8.1 for Linux/UNIX/Windows or higher DB2 V8.0 for z/os or higher Oracle 2 : Oracle 10g R1 (10.1) or higher Oracle9i R2 (9.2) or higher In addition, Oracle Advanced Security is required. Microsoft SQL Server: Microsoft SQL Server 2000 or higher Microsoft SQL Server 2000 Enterprise Edition (64-bit) Service Pack 2 or higher 1 Not supported for Microsoft Windows Azure SQL Database. 2 See the README file for the latest information about support for Kerberos on Oracle 12c. 15

16 Chapter 1: Before You Install Component Requirements SAP Adaptive Server Enterprise: Note: The SAP ASE Security and directory services package, ASE_SECDIR, is required. SAP Adaptive Server Enterprise 16.0 and higher Sybase 12.0 or higher Kerberos server The Kerberos server is the machine where the user IDs for authentication are administered. The Kerberos server is also the location of the Kerberos Key Distribution Center (KDC). If using Windows Active Directory, this machine is also the domain controller. Apache Hive, DB2, Oracle, and Sybase: Network authentication must be provided by one of the following methods: Windows Active Directory on one of the following operating systems: Windows Server 2003 or higher Windows 2000 Server Service Pack 3 or higher MIT Kerberos 1.5 or higher Microsoft SQL Server: Network authentication must be provided by Windows Active Directory on one of the following operating systems: Windows Server 2003 or higher Windows 2000 Server Service Pack 3 or higher Client Java SE 5 or higher must be installed. To use Kerberos authentication, some configuration is required after installing the product. Refer to the appropriate driver chapter in the DataDirect Connect Series for JDBC User s Guide for more information. NTLM Authentication NTLM authentication is a single sign-on OS authentication method. This method requires minimal configuration in the driver. The following drivers support NTLM authentication: Oracle driver (Windows only) SQL Server driver 3 Verify that your environment meets the requirements listed in the following table before you configure your driver for NTLM authentication. 3 Not supported for Microsoft Windows Azure SQL Database. 16

17 System and Product Requirements Table 3: Product Requirements: NTLM Authentication for DataDirect Connect for JDBC Component Database server Requirements The database server must be running one of the following databases: Oracle: Oracle 10g R1 (10.1) or higher Oracle9i R1 (9.0.1) or higher Oracle8i R2 (8.1.6) or higher Microsoft SQL Server: Microsoft SQL Server 2000 Service Pack 3 or higher Microsoft SQL Server 2000 Enterprise Edition (64-bit) Service Pack 2 or higher Domain controller Network authentication must be provided by NTLM on one of the following operating systems: Windows Server 2003 or higher Windows 2000 Server Service Pack 3 or higher Client Java SE 5 or higher must be installed. To use NTLM authentication, minimal configuration is required after installing the product. Refer to the appropriate driver chapter in the DataDirect Connect Series for JDBC User s Guide for more information. SSL Encryption Secure Sockets Layer (SSL) is an industry-standard protocol for sending encrypted data over database connections. SSL secures the integrity of your data by encrypting information and providing client/server authentication. The following drivers support SSL encryption: DataDirect Connect for JDBC DB2 driver MySQL driver Oracle driver PostgreSQL driver Progress OpenEdge driver SQL Server driver Sybase driver DataDirect Connect XE for JDBC 17

18 Chapter 1: Before You Install The Driver for Apache Hive Greenplum driver Salesforce driver Verify that your environment meets the requirements listed in the following table for your product package before you configure your driver for SSL encryption. Table 4: Product Requirements: SSL Encryption for DataDirect Connect for JDBC Driver Requirements DB2 DB2 V9.1 Fixpack 2 for Linux/UNIX/Windows or higher DB2 V9.1 for z/os or higher DB2 for i 6.1 or higher DB2 for i 5/OS V5R4 or higher MySQL MySQL 5.0 or higher Oracle Oracle 12c R1 (12.1) or higher Oracle 10g R1 (10.1) or higher Oracle9i R1 (9.0.1) or higher Oracle8i R2 (8.1.6) or higher Note: Oracle Advanced Security is required. PostgreSQL PostgreSQL 8.2 or higher Progress OpenEdge Progress OpenEdge 10.1.x or higher 18

19 System and Product Requirements Driver Microsoft SQL Server Requirements Microsoft Windows Azure SQL Database: Microsoft Windows Azure SQL Database Version 11 or higher Microsoft SQL Server: Microsoft SQL Server 2000 or higher Microsoft SQL Server 2000 Enterprise Edition (64-bit) or higher Sybase Note: The SAP ASE Security and directory services package, ASE_SECDIR, is required. SAP Adaptive Server Enterprise 16.0 or higher Sybase Adaptive Server Enterprise 11.5 or higher Table 5: Product Requirements: SSL Encryption for DataDirect Connect XE for JDBC Driver Requirements Apache Hive Apache Hive or higher Greenplum Greenplum 3.2 or higher Pivotal HAWQ 1.1 or higher Salesforce One of the following data sources: Salesforce.com Database.com Force.com Oracle Advanced Security The Oracle driver supports the encryption and data integrity features provided by Oracle Advanced Security. Because data integrity protection operates independently from the encryption process, you can enable data integrity with or without enabling encryption. For information about configuring your database server, refer to your Oracle documentation. 19

20 Chapter 1: Before You Install If you plan to use an encryption algorithm with a key size of more than 128 bits, you must override the policy files in your JVM with the Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files, available from the following Web site: Refer to the Oracle driver chapter in the DataDirect Connect Series for JDBC User s Guide for more information. JTA Support To use JDBC distributed transactions through the Java Transaction API (JTA) with the following drivers, the product requirements listed in the table below must be met: DB2 Driver Informix Oracle Driver Microsoft SQL Server driver 4 Sybase Table 6: Product Requirements: JTA Support for DataDirect Connect for JDBC Driver Requirements DB2 DB2 V8.0 for Linux/UNIX/Windows or higher DB2 V9.1 for z/os or higher DB2 for i 6.1 or higher DB2 for i 5/OS V5R4 or higher Informix Informix Dynamic Server 9.4 or higher Oracle Oracle 12c R1 (12.1) or higher Oracle 10g R1 (10.1) or higher Oracle9i R1 (9.0.1) or higher Oracle8i R3 (8.1.7) or higher Progress OpenEdge Progress OpenEdge 10.1.x or higher 4 Not supported for Microsoft Windows Azure SQL Database. 20

21 System and Product Requirements Driver Microsoft SQL Server Sybase Requirements JDBC XA Procedures must be installed. Refer to the DataDirect Connect Series for JDBC User s Guide for details. 5 SAP Adaptive Server Enterprise 16.0 or higher Sybase Adaptive Server Enterprise 11.5 or higher Refer to the appropriate driver chapters in the DataDirect Connect Series for JDBC User s Guide for more information. Bulk Load Bulk load allows your application to send large numbers of rows of data to a database (for example, DB2 or Microsoft SQL Server) or to a Salesforce instance. The following drivers support bulk load: DataDirect Connect for JDBC DB2 driver Informix driver MySQL driver Oracle driver PostgreSQL driver SQL Server driver Sybase driver DataDirect Connect XE for JDBC Greenplum driver Salesforce driver Verify that your environment meets the requirements listed in the following table for your product package before you configure your driver for bulk load. 5 Not supported for Microsoft Windows Azure SQL Database. 21

22 Chapter 1: Before You Install Table 7: Product Requirements: Bulk Load for DataDirect Connect for JDBC Driver Requirement DB2 DB2 V8.0 for Linux, UNIX, and Windows or higher DB2 V8.1 for z/os or higher DB2 for i 6.1 or higher DB2 for i 5/OS V5R4 or higher Informix Informix Dynamic Server 9.2 or higher MySQL MySQL 5.0 or higher Oracle Oracle 12c R1 (12.1) or higher Oracle 10g R1 (10.1) or higher Oracle9i R1 (9.0.1) or higher Oracle8i R3 (8.1.7) or higher PostgreSQL PostgreSQL 8.2 or higher Microsoft SQL Server Microsoft Windows Azure SQL Database: Microsoft Windows Azure SQL Database Version 11 or higher Microsoft SQL Server: Microsoft SQL Server 2000 or higher Sybase SAP Adaptive Server Enterprise 16.0 or higher Sybase Adaptive Server Enterprise 11.5 or higher 22

23 Supported Databases Table 8: Product Requirements: Bulk Load for DataDirect Connect XE for JDBC Driver Requirements Greenplum Greenplum 3.2 or higher Pivotal HAWQ 1.1 or higher Salesforce One of the following sources: Salesforce.com Database.com Force.com Refer to the appropriate driver chapters in the DataDirect Connect Series for JDBC User s Guide for more information. Supported Databases The following tables show database certifications for DataDirect Connect Series for JDBC drivers. Table 9: Databases Certified with DataDirect Connect for JDBC Driver Database DB2 DB2 V10.5, V10.1 for Linux, UNIX, and Windows DB2 V9.8, V9.7, V9.5, V9.1 for Linux, UNIX, and Windows DB2 V8.x for Linux, UNIX, and Windows DB2 V11 for z/os DB2 V10 for z/os DB2 V9.1 for z/os DB2 UDB V8.1 for z/os DB2 for i 7.2 DB2 for i 7.1 (DB2 UDB V7R1 for iseries) DB2 for i 6.1 (DB2 UDB V6R1 for iseries) DB2 for i5/os V5R4 (DB2 UDB V5R4 for iseries) 23

24 Chapter 1: Before You Install Driver Database Informix Informix Dynamic Server Informix Dynamic Server 11.7, 11.5, and 11.0 Informix Dynamic Server 10.0 Informix Dynamic Server 9.4, 9.3, and 9.2 MySQL MySQL Enterprise Edition 5.6, 5.5, 5.1, and 5.0 Oracle Oracle 12c R1 (12.1) Oracle 11g R1 (11.1) and R2 (11.2) Oracle 10g R1 (10.1) and R2 (10.2) Oracle9i R1 (9.0.1) and R2 (9.2) Oracle8i R2 (8.1.6) and R3 (8.1.7) PostgreSQL PostgreSQL 9.4, 9.3, 9.2, 9.1, and 9.0 PostgreSQL 8.4, 8.3, and 8.2 Progress OpenEdge Progress OpenEdge 11.4, 11.3, 11.2, 11.1, and 11.0 Progress OpenEdge 10.2B, 10.2A, 10.1C, 10.1B, and 10.1A 24

25 Supported Databases Driver Microsoft SQL Server Database Microsoft Windows Azure SQL Database: Microsoft Windows Azure SQL Database Version 11 Microsoft SQL Server: Microsoft SQL Server 2014 Microsoft SQL Server 2012 Microsoft SQL Server 2008 R2, R1 Microsoft SQL Server 2005 Microsoft SQL Server 2000 Microsoft SQL Server 2000 Enterprise Edition (64-bit) Microsoft SQL Server 2000 Desktop Engine (MSDE 2000) Microsoft SQL Server 7.0 Sybase SAP Adaptive Server Enterprise 16.0 Sybase Adaptive Server Enterprise 15.7, 15.5, and 15.0 Sybase Adaptive Server Enterprise 12.5.x, 12.5, and 12.0 Sybase Adaptive Server 11.9 and 11.5 Table 10: Databases Certified with DataDirect Connect XE for JDBC Driver Source Driver for Apache Hive Apache Hive 0.8.x-0.14.x Apache Hive 1.0.x-1.2.x Note: For information on supported distributions, refer to the Supported Configurations page. 25

26 Chapter 1: Before You Install Greenplum Driver Source Greenplum 4.3, 4.2, 4.1, 4.0, 3.3, and 3.2 Pivotal HAWQ 1.2 and 1.1 Salesforce Salesforce.com Database.com Force.com Note: The Salesforce Web Service API is fully supported. For additional information, refer to the Supported Configurations page. Choosing the Installer You can install the product on a local drive on Windows or non-windows operating systems. Important: The Java installer can be run on any platform, including Windows. If the Java installer is run on Windows, turn off User Account Controls or select a non-system directory as the installation directory. The Windows-specific installer can be run on any supported Windows platform. The Windows installer allows you to install the driver in the Program Files system directory on Windows without turning off User Account Controls. See Installing DataDirect Connect Series for JDBC on page 27 for more information about the installers. Evaluation Installations The installer allows you to install all drivers for a 15-day evaluation. Note: DataDirect Bulk Load requires a licensed installation of the drivers. Contact your sales representative or Progress Support for further information. 26

27 2 Installing DataDirect Connect Series for JDBC Before you start installation, verify that your system meets the product requirements. See Before You Install on page 13 for details. The DataDirect Connect Series for JDBC User s Guide and DataDirect Connect Series for JDBC Reference are installed as HTML help in the install_dir/help directory, where install_dir is your product installation directory. For PDF versions of all books in the product library, go to: For details, see the following topics: Default Installation Directory Installing the Product Installation Log File Upgrading an Evaluation Installation to a Licensed Installation Testing the Drivers Uninstalling Using the Performance Tuning Wizard Creating DB2 Packages Using the Drivers with Application Servers Using the Drivers with Hibernate 27

28 Chapter 2: Installing DataDirect Connect Series for JDBC For More Information Default Installation Directory The installer allows you to specify the product installation directory. By default, the installer installs the product in: Windows: C:\Program Files\Progress\DataDirect\Connect_for_JDBC_51 UNIX/Linux: /opt/progress/datadirect/connect_for_jdbc_51 Installing the Product Note: Make sure that the Java Virtual Machine (JVM) is defined on your path. Java SE 7 or higher is required to use the Salesforce driver. For other Connect for JDBC drivers, Java SE 5 or higher is required. Before beginning, choose an installer directory for the product installer. This can also be the installation directory for the product, but does not need to be. You can choose another installation directory during the installation procedure. Important: The Java installer can be run on any platform, including Windows; however, if you run the Java installer on Windows, turn off User Account Controls or select a non-system directory as the installation directory. The Windows installer allows you to install the driver in the Program Files system directory on Windows without turning off User Account Controls. To install on your local drive: 1. Download the Windows or Java installer from the location provided by Progress DataDirect: Windows: PROGRESS_DATADIRECT_CONNECT_JDBC_5.1.4_WIN.zip Non-Windows: PROGRESS_DATADIRECT_CONNECT_JDBC_5.1.4.jar If you are installing on a non-windows operating system, skip to Step 3 on page 28; otherwise, continue at Step 2 on page Switch to the installer directory and extract the contents of the jar file to the installer directory. 3. Perform the installation: If you prefer to use a Graphical User Interface (GUI), go to GUI Installation on page 28 for instructions. If you prefer to use a command line, go to Command-Line Installation on page 30 for instructions. If you prefer to use a silent installation, go to Silent Installation on page 31 for instructions. GUI Installation To install the product: 1. From the installer directory, double-click the appropriate installer file to start the installer: 28

29 Installing the Product Windows: Setup.exe Non-Windows: PROGRESS_DATADIRECT_CONNECT_JDBC_5.1.4.jar 2. The Welcome window appears. Click Next. 3. 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. 4. Choose the type of installation to perform. Select one of the following options: Evaluation installation (will expire in 15 days). Select this option to install an evaluation version of the driver. Click Next to continue with the installation. Skip to Step 6. OEM or Licensed installation. Select this option if you have purchased a licensed version of one or multiple drivers. Click Next and continue with the next step to enter your product licensing information. 5. The Product Registration window appears. Type the serial number that was provided by Progress DataDirect. Then, type the IPE key (also known as the Control Number) that was provided for licensing purposes by Progress DataDirect in the IPE Key field, and click the Add button. The licensed driver appears in the Products with Valid Licenses list box. Click Next to continue with the installation. To delete the driver from the Products with Valid Licenses list box, select the driver and click the Delete button. The driver is removed from the list box. Click Cancel to end the installation. 6. In the Where Would You Like to Install? field, type the path, including the drive letter on Windows machines, of the product installation directory or click the Choose (...) button to browse to and select an installation directory. The default installation directory is: Windows: C:\Program Files\Progress\DataDirect\Connect_for_JDBC_51 29

30 Chapter 2: Installing DataDirect Connect Series for JDBC UNIX/Linux : /opt/progress/datadirect/connect_for_jdbc_51 Verify that you have entered (or selected) the correct installation directory, and click Next to continue. Note: If you specify a directory that contains a previous installation of the driver, a warning message appears allowing you to overwrite your existing installation or specify a different installation directory. 7. A window appears allowing you to confirm your installation options. Click Previous to revise your choices, or click Install to continue with the installation. When you click Install, the drivers you selected are installed. 8. If you installed a driver that can be optimized with the Performance Wizard, you can run the Wizard at this time. See Using the Performance Tuning Wizard on page 35 for a description of the Wizard. If you choose to run the Wizard, it will appear in a separate window when you exit the installer. 9. Click Done to exit the installer. Refer to the installation log file for a record of any problems that may have occurred during the installation. See Installation Log File on page 34 for details. Command-Line Installation 1. At a command prompt, type the appropriate installation command: Windows: Setup.exe -i console Non-Windows: java -jar PROGRESS_DATADIRECT_CONNECT_JDBC_5.1.4.jar -i console Press ENTER. The installer prompts you to answer questions regarding the installation. To accept the default value, press ENTER. To return to the previous step, type back and press ENTER. 2. The Introduction step appears. Press ENTER. 3. The product license agreement appears. Press ENTER multiple times to page to the end of the agreement. At the end, you are asked to accept the agreement: Type Y to accept the license agreement and continue with the installation. Type N to end the installation. Press ENTER. 4. You are prompted for the type of installation. If you are installing an evaluation copy of the product (expires in 15 days), type 1 and press ENTER. Continue at Step 7 on page 31. If you are doing an licensed install, type 2 and press ENTER. You are prompted for the serial number and key that were provided by Progress DataDirect. Type the serial number and press ENTER. Then, type the product key and press ENTER. Note: If you were issued multiple IPE keys (also known as the Control Numbers), you can type them sequentially, separating the keys with a space. For example: xxxxkey1 xxxxkey2 xxxxkey3. 5. You are prompted for the installation directory. Enter the full path to the installation directory, or press ENTER to accept the default directory. 30

31 Installing the Product 6. You are prompted to confirm the installation directory. If the installation directory is correct, type Y and press ENTER. Note: If you specify a directory that contains a previous installation of the driver, a warning message appears allowing you to overwrite your existing installation or specify a different installation directory. 7. You are prompted to review the product name and installation directory. Press ENTER to continue. 8. If the product was successfully installed, a message appears confirming the installation. Press ENTER to exit the installer. Refer to the installation log file for a record of any problems that may have occurred during the installation. See Installation Log File on page 34 for details. Silent Installation The silent installation is useful if you want to create a response file that can be distributed and run on multiple computers to create an identical installation of the product on each computer. To perform the silent installation, you must distribute both the response file and the PROGRESS_DATADIRECT_CONNECT_JDBC_5.1.4.jar file. A silent installation requires performing the following steps: Creating the response file. You can create this file in either of the following ways: Using the installer. See Creating the Response File Using the Installer on page 31 for instructions. Using a text editor. See Creating a Response File Using a Text Editor on page 33 for instructions. Performing the silent installation. See Performing the Silent Installation on page 34 for instructions. Important: Your product license may limit the number of CPUs that can exist on the machine on which the product is installed. This limit also is imposed on any machine on which the silent installation is performed. If you need to upgrade your product license, contact your Progress DataDirect sales representative. Creating the Response File Using the Installer 1. At a command prompt, type the command: java -jar PROGRESS_DATADIRECT_CONNECT_JDBC_5.1.4.jar -r response_file where response_file is the path and file name of the response file you want to create. You can specify an absolute or relative path. If the path is not specified, the specified file is created in the current working directory. Windows Example: This example creates a response file named installer.properties in the C:\temp directory. java -jar PROGRESS_DATADIRECT_CONNECT_JDBC_5.1.4.jar -r C:\temp\installer.properties UNIX/Linux Example: This example creates a response file named installer.properties in the /install directory, which is relative to the current working directory. 31

32 Chapter 2: Installing DataDirect Connect Series for JDBC java -jar PROGRESS_DATADIRECT_CONNECT_JDBC_5.1.4.jar -r./install/installer.properties 2. The DataDirect Connect (R) and Connect XE for JDBC 5.1 Welcome window appears. Click Next. 3. 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. 4. Choose the type of installation to perform. Select one of the following options: Evaluation installation (will expire in 15 days). Select this option to install an evaluation version of the driver. Click Next to continue with the installation. Skip to Step 6 on page 32. OEM or Licensed installation. Select this option if you have purchased a licensed version of one or multiple drivers. Click Next and continue with the next step to enter your product licensing information. 5. The Product Registration window appears. Type the serial number that was provided by Progress DataDirect. Then, type the IPE key (also known as the Control Number) that was provided for licensing purposes by Progress DataDirect in the IPE Key field, and click the Add button. The licensed driver appears in the Products with Valid Licenses list box. Click Next to continue with the installation. To delete the driver from the Products with Valid Licenses list box, select the driver and click the Delete button. The driver is removed from the list box. Click Cancel to end the installation. 6. In the Where Would You Like to Install? field, type the path, including the drive letter on Windows machines, of the product installation directory or click the Choose (...) button to browse to and select an installation directory. The default value for the installation directory is C:\Program Files\Progress\DataDirect\Connect_for_JDBC_51. Verify that you have entered (or selected) the correct installation directory. 32

33 Installing the Product Click Next to continue. Note: If you specify a directory that contains a previous installation of the driver, a warning message appears allowing you to overwrite your existing installation or specify a different installation directory. 7. A window appears allowing you to confirm your installation options. Click Previous to revise your choices, or click Install to continue with the installation. When you click Install, the drivers you selected are installed. 8. A window appears asking you if you want to run the Performance Wizard. Select the No option to bypass the Wizard. Important: Failing to bypass the Wizard when creating the response file causes the Wizard to appear when the silent installation is performed. 9. Click Done to exit the installer. The response file is created in the directory you specified in Step 1 on page 31. Refer to the installation log file for a record of any problems that may have occurred during the installation. See Installation Log File on page 34 for details. See Performing the Silent Installation on page 34 for instructions on running the response file. Creating a Response File Using a Text Editor Using a text editor, you can create a response file with the following contents: ## SERIALNUMBER=xxxxxxx KEYLIST=yyyyyyy USER_INSTALL_DIR=install_dir where: xxxxxxx yyyyyyy is your product serial number. is your IPE key (also known as the Control Number). If specifying multiple keys, separate them using a space, for example, KEYLIST= install_dir is your product installation directory. Note: If coding a path on Windows to an installation directory using the Universal Naming Convention (UNC), you must escape the double backslash (\\) and the single backslash with a Java escape character. For example: \\\\server1\\progress\\datadirect\\connect_for_jdbc_51. See Performing the Silent Installation on page 34 for instructions on running the response file. 33

34 Chapter 2: Installing DataDirect Connect Series for JDBC Windows Example: ## SERIALNUMBER= KEYLIST=xxxkey1 xxxkey2 xxxkey3 USER_INSTALL_DIR==\\Program Files\Progress\DataDirect\Connect_for_JDBC_51 UNIX/Linux Example: ## SERIALNUMBER= KEYLIST=xxxkey1,xxxkey2,xxxkey3 USER_INSTALL_DIR==/opt/Progress/DataDirect/Connect_for_JDBC_51 Performing the Silent Installation 1. At a command prompt, change to the directory containing the PROGRESS_DATADIRECT_CONNECT_JDBC_5.1.4.jar file. 2. Type the command: java -jar PROGRESS_DATADIRECT_CONNECT_JDBC_5.1.4.jar -f response_file -i silent where response_file is the path and file name of the response file created in Creating the Response File Using the Installer on page 31. You can specify an absolute or relative path. If the path is not specified, the silent installation looks for the response file in the current working directory. Windows Example: This example performs a silent installation by running a response file named installer.properties in the C:\temp directory. java -jar PROGRESS_DATADIRECT_CONNECT_JDBC_5.1.4.jar -f C:\temp\installer.properties -i silent UNIX/Linux Example: This example performs a silent installation by running a response file named installer.properties in the /install directory, which is relative to the current working directory. java -jar PROGRESS_DATADIRECT_CONNECT_JDBC_5.1.4.jar -f./install/installer.properties -i silent 3. The installation proceeds without any further user intervention or notification. Refer to the installation log file for a record of any problems that may have occurred during the installation. See Installation Log File on page 34 for details. Installation Log File If the installer successfully creates the product installation directory, the installer writes a log file named Progress_DataDirect_Connect_(R)_and_Connect_XE_for_JDBC_5.1_SP4_InstallLog.log to the following directory: Windows: install_dir\uninstallerdata\logs 34

35 Upgrading an Evaluation Installation to a Licensed Installation UNIX/Linux : install_dir/uninstallerdata/logs Examine the log file for a record of any problems that may have occurred during the installation. If a product installation fails completely, the installer does not create the product installation directory and writes a file named Progress_DataDirect_Connect_(R)_and_Connect_XE_for_JDBC_5.1_SP4_InstallFailed.txt in the machine s default temporary directory. If you need help interpreting the contents of these files, contact Progress DataDirect customer support. Upgrading an Evaluation Installation to a Licensed Installation After an evaluation installation, you may want to upgrade your evaluation installation to a licensed installation. To upgrade, see Installing the Product on page 28 and follow the procedure for installation. When asked to choose an installation type, select the OEM or Licensed installation option. When asked to enter your product license information, add the IPE key (also known as the Control Number) and serial number that were provided by Progress DataDirect. Testing the Drivers To get started using the drivers and for complete information about establishing connections and testing the drivers, refer to the DataDirect Connect Series for JDBC User s Guide and DataDirect Connect Series for JDBC Reference. Uninstalling To uninstall from a Windows machine, use the Windows Add or Remove Programs option. To uninstall from a non-windows machine or after using the Java installer on a Windows machine, delete the entire installation directory. Using the Performance Tuning Wizard The Performance Tuning Wizard leads you step-by-step through a series of questions about your application. Based on your answers, the Wizard provides the optimal settings for performance-related connection properties. The Wizard runs as an applet within a browser window. To use the Wizard, your browser must be configured to run applets. Refer to your browser s documentation for information on configuring your browser. 35

36 Chapter 2: Installing DataDirect Connect Series for JDBC Starting the Wizard You can start the Wizard by launching the following file from your browser, where install_dir is your installation directory: install_dir/wizards/index.html Note: Security features set in your browser can prevent the Performance Wizard from launching. A security warning message is displayed. Often, the warning message provides instructions for unblocking the Performance Wizard for the current session. To allow the Performance Wizard to launch without encountering a security warning message, the security settings in your browser can be modified. Check with your system administrator before disabling any security features. 36

37 Using the Performance Tuning Wizard Tuning Performance Using the Wizard After you start the Wizard, a Welcome window appears. Click Start to start the process and select a driver. The following figure shows an example of one of the questions you are asked to answer for the DataDirect Connect Series for JDBC Oracle driver. Figure 1: DataDirect Connect for JDBC Performance Tuning Wizard 37

38 Chapter 2: Installing DataDirect Connect Series for JDBC When you have answered all questions for a driver, results are displayed as shown in the following figure. You can copy the results to use in your application or in a data source configuration tool. In addition, you can copy and paste the results into a text file for reference. Figure 2: DataDirect Connect for JDBC Performance Tuning Wizard Results Refer to the appropriate driver chapters in the DataDirect Connect Series for JDBC User s Guide for information about connection properties for the drivers. Creating DB2 Packages In most cases, you do not need to create DB2 packages because the DB2 driver automatically creates them the first time it connects to the database. If, for some reason, you need to explicitly create them, you can create them in any of the following ways: Using the DataDirect DB2 Package Manager, a Java graphical tool that makes it easy for you to create, drop, and replace DB2 packages. Using certain driver connection properties specified in a connection URL or data source. 38

39 Using the Drivers with Application Servers Running the appropriate DB2 package creation list file for your operating system on the database server. On z/os and i only, copy the packages that are installed with the DB2 driver. Refer to the DataDirect Connect Series for JDBC User s Guide for instructions on creating DB2 packages. Using the Drivers with Application Servers Refer to the Progress Knowledge Base for technical articles about using the drivers with various application servers, such as JBoss, Apache Tomcat, Oracle/BEA WebLogic, and Sun Java System Application Server 6. Using the Drivers with Hibernate For information about using the drivers with Hibernate, refer to the following Web pages: Using DataDirect JDBC Drivers with Hibernate How to Configure DataDirect with Hibernate For More Information We recommend that you read the README text file that accompanies the product for current information regarding the release. You can find the latest README text file on the Progress DataDirect Web site. 6 Also known as Sun GlassFish Enterprise Server. 39

40 Chapter 2: Installing DataDirect Connect Series for JDBC 40

41 Index Index A Apache Hive Kerberos authentication, product requirements 15 application servers, using the drivers with 39 authentication Kerberos, product requirements 15 NTLM 16 B before you install 13 C conventions, typographical 9 copyright 3 creating DB2 packages 38 response file using a text editor 33 response file using the installer 31 D DataDirect DB2 Package Manager 38 DB2 Kerberos authentication, product requirements 15 DB2 packages connection properties, using to create 38 copying packages installed by driver (z/os and i) 38 creating 38 DataDirect DB2 Package Manager, using to create 38 package creation list files, using to create 38 documentation library 8 driver requirements 13 drivers, testing 35 E evaluation licensing 26 upgrading to a licensed installation 35 H help, online 10 Hibernate, using the drivers with 39 I installation command-line 30 GUI 28 non-windows 28 silent 31 Windows 28 installation log file 34 J Java Transaction API, product requirements 20 JBoss application server 39 JDBC XA Procedures 21 JNDI K Kerberos authentication, product requirements 15 L library, documentation 8 licensing evaluation 26 upgrading to a licensed installation 35 log file, installation 34 N NTLM authentication, product requirements (Oracle and SQL Server) 16 O Oracle Kerberos authentication, product requirements 15 NTLM authentication 16 Oracle Advanced Security product requirements 19 P performance tuning 35 Performance Tuning Wizard starting 36 performance wizard 35 performing a silent installation 34 product documentation 8 41

42 Index product requirements Kerberos authentication 15 NTLM authentication (Oracle and SQL Server) 16 R requirements 13 requirements, system and product 13 response file for silent installation creating using a text editor 33 creating using the installer 31 S silent installation about 31 creating a response file using a text editor 33 using the installer 31 performing 34 SQL Server Kerberos authentication, product requirements 15 NTLM authentication 16 starting the Performance Tuning Wizard 36 Sun Java System application server 39 support online help 10 technical support 10 Sybase Kerberos authentication, product requirements 15 system requirements 13 T Technical Support 10 testing drivers 35 Tomcat application server 39 Type 4 8 Type 5 8 U uninstalling 35 upgrading to a licensed installation 35 User Access Controls disabling before installation 28 using drivers with application servers 39 Hibernate 39 W WebLogic application server 39 Windows User Access Controls 28 wizard, performance 35 42