IBM Informix Client Products Installation Guide - Informix IBM Informix Client Products Installation Guide Version 3.50 GC23-9413-03

  • Published on
    29-Apr-2018

  • View
    216

  • Download
    2

Embed Size (px)

Transcript

  • IBM Informix

    IBM Informix Client Products Installation Guide

    Version 3.50

    GC23-9413-03

  • IBM Informix

    IBM Informix Client Products Installation Guide

    Version 3.50

    GC23-9413-03

  • NoteBefore using this information and the product it supports, read the information in Notices on page D-1.

    Edition

    This edition replaces GC23-9413-02.

    This document contains proprietary information of IBM. It is provided under a license agreement and is protectedby copyright law. The information contained in this publication does not include any product warranties, and anystatements provided in this publication should not be interpreted as such.

    When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in anyway it believes appropriate without incurring any obligation to you.

    Copyright International Business Machines Corporation 1996, 2009.US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

  • Contents

    Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viiAbout this Publication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viiWhats New in Installation For Client SDK, Version 3.50 . . . . . . . . . . . . . . . . . . . . viiClient SDK Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viiIBM Data Server Driver Installation Option (Windows only) . . . . . . . . . . . . . . . . . . . ixDifferences between .NET Providers . . . . . . . . . . . . . . . . . . . . . . . . . . . xSoftware Dependencies (Linux) . . . . . . . . . . . . . . . . . . . . . . . . . . . . xivAdditional Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xivCompliance with Industry Standards . . . . . . . . . . . . . . . . . . . . . . . . . . xivHow to Provide Documentation Feedback . . . . . . . . . . . . . . . . . . . . . . . . . xiv

    Part 1. Installing Client Products on UNIX, Linux, and Mac OS X

    Chapter 1. Preparing to Install Client SDK and IBM Informix Connect Connect onUNIX, Linux, and Mac OS X Systems . . . . . . . . . . . . . . . . . . . . . . 1-1About Installing Client SDK and IBM Informix Connect . . . . . . . . . . . . . . . . . . . . 1-1Determine Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1Check Online Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2Determine Installation Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2Prepare the Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3

    Creating the Group informix and User informix . . . . . . . . . . . . . . . . . . . . . . 1-3Configure Your Database Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4Load Product Files (UNIX and Linux) . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4Extracting Product Files (Mac OS X) . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4

    Chapter 2. Installing Client SDK and IBM Informix Connect on UNIX and LinuxSystems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1Installation Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1Client SDK and Informix Connect as Part of the Informix Dynamic Server Installation Application . . . . . . 2-2IBM Informix Dynamic Server and Informix Connect with the Client Installation Application. . . . . . . . 2-2

    Installation Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2Installing in Console Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3Installing in GUI Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4Using the Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4Alternative Installation Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4

    Installing in Silent Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5Performing a Silent Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7Installing Using Extraction With Command-Line Script . . . . . . . . . . . . . . . . . . . 2-8Installing Client SDK and IBM Informix Connect in Extraction with Command-Line Mode . . . . . . . 2-9Installing by Invoking the JAR File Directly . . . . . . . . . . . . . . . . . . . . . . . 2-9Installing Client SDK or Informix Connect by Invoking the JAR File . . . . . . . . . . . . . . . 2-10

    Chapter 3. Installing Client SDK and Informix Connect on Mac OS X. . . . . . . . . 3-1

    Chapter 4. Uninstalling Client SDK and IBM Informix Connect on UNIX, Linux, and MacOS X Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1Uninstalling Using the Uninstall Application . . . . . . . . . . . . . . . . . . . . . . . . 4-1

    Uninstalling in console (default) mode (UNIX, Linux) . . . . . . . . . . . . . . . . . . . . 4-1Uninstalling in GUI mode (UNIX, Linux) . . . . . . . . . . . . . . . . . . . . . . . . 4-1Uninstalling in GUI mode (Mac OS X) . . . . . . . . . . . . . . . . . . . . . . . . . 4-1Uninstalling in silent mode (UNIX, Linux) . . . . . . . . . . . . . . . . . . . . . . . . 4-1

    Uninstalling After Using the Extraction Application with Command-Line Script . . . . . . . . . . . . 4-2

    Copyright IBM Corp. 1996, 2009 iii

    ++

    ++++

    ||

    ||

  • Part 2. Installing Client Products on Windows Systems

    Chapter 5. Preparing to Install Client SDK and Informix Connect on Windows Systems 5-1System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1Database Server Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1Protocol Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1C Compiler Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2Installation Location and Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2Install Informix .NET Provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2

    Chapter 6. Installing Client SDK and Informix Connect on Windows Systems . . . . . 6-1Installing Client SDK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1

    Use the Windows Installation Program to Install Client SDK. . . . . . . . . . . . . . . . . . 6-1Installing IBM Informix Connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2Installing Client SDK from the Command Line Using msiexec . . . . . . . . . . . . . . . . . . 6-4

    Installing Client SDK with Silent Installation . . . . . . . . . . . . . . . . . . . . . . . 6-4Common msiexec Command Operations . . . . . . . . . . . . . . . . . . . . . . . . 6-5Setting Public Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-5Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-5Installing Client SDK by Using the Command Line: Advertised Mode . . . . . . . . . . . . . . 6-6Installing the IBM Data Server Driver . . . . . . . . . . . . . . . . . . . . . . . . . 6-6

    Chapter 7. Post-Installation Client Product Tasks on Windows Systems . . . . . . . 7-1Configuring IBM Informix Client Products on Windows Systems . . . . . . . . . . . . . . . . . 7-1

    Setting the Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1Setting Database Server Information . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2Setting Host Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3Overriding Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-4

    Configuring OLE DB Provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-4Common Installation Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-5Modifying the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-6Repairing the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-6

    Chapter 8. Uninstalling Client SDK on Windows Systems . . . . . . . . . . . . . 8-1Uninstalling Client SDK by Using the Windows Control Panel . . . . . . . . . . . . . . . . . . 8-1Uninstall Client SDK by Using the Command Line . . . . . . . . . . . . . . . . . . . . . . 8-1

    Part 3. Appendixes

    Appendix A. Environment Variables . . . . . . . . . . . . . . . . . . . . . . . A-1In this Appendix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1

    Appendix B. Distribute Your IBM Informix Client Applications (Windows). . . . . . . B-1In This Appendix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1Distribute IBM Informix Client Applications and Components . . . . . . . . . . . . . . . . . . B-1

    Client Runtime Component Redistribution Guidelines . . . . . . . . . . . . . . . . . . . . B-1IBM Informix Client Application Distribution Options . . . . . . . . . . . . . . . . . . . . B-2

    Installing IBM Informix Connect C and C++ Client Runtime Components . . . . . . . . . . . . . . B-6Creating the Installation Script. . . . . . . . . . . . . . . . . . . . . . . . . . . . B-7Creating the Client Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . B-7Creating Your Client Application Installation Program . . . . . . . . . . . . . . . . . . . . B-7Installing Client Runtime Components . . . . . . . . . . . . . . . . . . . . . . . . . B-8Configuring the Client Computer. . . . . . . . . . . . . . . . . . . . . . . . . . . B-8

    Verifying the Results of Silent Installation . . . . . . . . . . . . . . . . . . . . . . . . . B-8

    Appendix C. Accessibility . . . . . . . . . . . . . . . . . . . . . . . . . . . C-1Accessibility features for IBM Informix Dynamic Server . . . . . . . . . . . . . . . . . . . . C-1

    iv IBM Informix Client Products Installation Guide

    ++

  • Accessibility Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-1Keyboard Navigation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-1Related Accessibility Information . . . . . . . . . . . . . . . . . . . . . . . . . . . C-1IBM and Accessibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-1

    Dotted Decimal Syntax Diagrams . . . . . . . . . . . . . . . . . . . . . . . . . . . C-1

    Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-1Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-3

    Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . X-1

    Contents v

  • vi IBM Informix Client Products Installation Guide

  • Introduction

    This introduction provides an overview of the information in this publication anddescribes the conventions that it uses.

    About this PublicationThis publication explains how to install IBM Informix Client SoftwareDevelopment Kit (Client SDK), Version 3.50, and IBM Informix Connect, Version3.50, on computers that use UNIX, Linux, Mac OS X, and Windows.

    This publication is written for database administrators or software engineers whoare installing IBM Informix client products, and assumes that you are familiar withthe operating procedures of your computer and with your operating systems.

    Whats New in Installation For Client SDK, Version 3.50This publication includes information about new features and changes in existingfunctionality.

    The following changes are relevant to this publication.

    Table 1. Whats New in IBM Informix Client Products Installation Guide Version 3.50.xC6

    Overview Reference

    IBM Data Server Driver installation option(Windows only)

    You can install IBM Data Server Driver whenyou install Client SDK or IConnect.

    IBM Data Server Driver Installation Option(Windows only) on page ixChapter 5,Preparing to Install Client SDK andInformix Connect on Windows Systems, onpage 5-1

    IBM Database Add-Ins for Visual Studioinstallation discontinued (Windows only)

    IBM Database Add-Ins for Visual Studio(VSAI) is no longer installed with Client SDKor IConnect, but is downloadable forinstallation.

    Client SDK Components

    Client SDK ComponentsClient SDK allows you to develop and run client applications.

    The following table describes the components of Client SDK. Applications that runon client computers require IBM Informix Connect to access database servers.Informix Connect is a runtime connectivity product composed of runtime librariesthat are included in Client SDK.

    Copyright IBM Corp. 1996, 2009 vii

    +

    ++

    +

    ++

    ++

    ++

    ++

    +++++

    ++

    ++++

    +

    +

    +

  • Table 2. Client SDK Components

    Component Description

    IBM Informix .NETProvider (Windowsonly)

    The IBM Informix .NET Provider is a .NET assembly that lets.NET applications access and manipulate data in IBM Informixdatabases. It does this by implementing several interfaces in theMicrosoft .NET Framework that are used to access data from adatabase. Using the IBM Informix .NET Provider is more efficientthan accessing the an IBM Informix database through either ofthese two methods:

    v Using the Microsoft .NET Framework Data Provider for ODBCalong with the IBM Informix ODBC Driver

    v Using the Microsoft .NET Framework Data Provider for OLEDB along with the IBM Informix OLE DB Provider

    For more information, see IBM Informix .NET Provider ReferenceGuide.

    Documentation Viewer The viewer lets you see the release and machine notes in textformat.

    Informix ESQL/C withXA support

    An SQL embedded-language product that is used to createcustom C applications.

    For more information, see the IBM Informix ESQL/C ProgrammersManual.

    The finderr utility onUNIX systems and theInformix ErrorMessages utility onWindows systems

    These utilities enable you to obtain information about IBMInformix-specific error messages, including corrective actions.

    The Global Security Kit This kit provides the iKeyman utility, which you can use createkeystores and manage digital certificates. The iKeyman utility isa Java utility that requires the Java Cryptography Extension(JCE) security packages to be installed. This kit is not availablefor Mac OS X.

    For information, see the IBM Global Security Kit Secure SocketsLayer Introduction and iKeyman Users Guide.

    IBM Informix ObjectInterface for C++

    A C++ interface to develop object-oriented client applications foruse with all IBM Informix database servers and client-side valueobjects for Dynamic Server.

    For more information, see the IBM Informix Object Interface forC++ Programmers Guide.

    IBM Informix GLS An interface that allows IBM Informix products to use differentlocales that have defined conventions for a particular language,culture, or code set.

    For more information, see the IBM Informix ESQL/C ProgrammersManual and the IBM Informix GLS Users Guide.

    IBM Informix ODBCDriver with MTSsupport

    An IBM Informix implementation of the Open DatabaseConnectivity (ODBC) 3.0 Level 1+ standard that supportsMicrosoft Transaction Server (MTS). This driver containsextensibility support for Dynamic Server.

    For more information, see the IBM Informix ODBC DriverProgrammers Manual.

    viii IBM Informix Client Products Installation Guide

  • Table 2. Client SDK Components (continued)

    Com...

Recommended

View more >