INFORMIX
Installation Guide for Microsoft Windows Environments
Home Contents Index Master Index New Book

Installing Informix Client Products

 To install Informix client products, run the Setup program for each package that you wish to install. The Setup program allows you to choose which components of the package to install.

The following sections describe Informix client product installation options, how to install your software, and solutions to installation problems.

Order of Installation

Informix software products share some files, including runtime libraries, message files, and GLS files. If you install multiple products on the same computer, you must install them in the correct sequence, or in separate directories, so that shared files remain compatible.

Installing a Database Server and a Client Product on a Computer

 When you install Client SDK or Connect in the same directory as an Informix database server, install the client product before you install the database server.

Tip: In some cases, client products may be installed after the database server. Check the readme.txt file on the installation CD-ROM for installation dependency information.
You can install a client product into a different directory from the database server INFORMIXDIR. If you do this, before you execute a client application, you must set the value of the INFORMIXDIR environment variable to the directory where you installed the client product.

Installing a Newer Version of Client SDK

You can install a newer version of Client SDK in either of the following ways:

    This leaves the runtime environment of current applications unchanged. New applications can use the new version of the Client SDK.

    Current applications access most of the bug fixes and performance enhancements offered by the new runtime environment. To benefit from all bug fixes and performance enhancements, or to access new features, current applications must be recompiled using the new Client SDK.

Installing an older version of Client SDK into the same INFORMIXDIR of the existing Client SDK is not supported.

Installing a Newer Version of Connect

You can install a newer version of Connect in either of the following ways:

    Setup prompts you before replacing runtime libraries. When you choose not to replace the runtime libraries, only GLS and message files are replaced.

    When you choose to replace the runtime libraries, Setup saves existing runtime libraries (.dll files) with an extension of .old, and installs the new runtime libraries, message files, and GLS files.

Installing an older version of Connect into the same INFORMIXDIR of the existing Connect is not supported.

Installation Options

While running the Setup utility, you can select which components and sub-components to install. Subcomponents include on-line help and example programs. The installation options are described in the following table.
Option Description

Typical

Includes all components, on-line help, and examples.

Compact

Includes all components without on-line help and examples.

Custom

You select the components and subcomponents to install.

The following sections describe the components of the Informix client products.

Client SDK

The Client SDK allows you to develop and run client applications in Windows environments.

You must install the Client SDK to compile a client application. If you have already compiled an application and you want to deploy it on one or more other computers, you can install Connect on those computers instead.

The components of the Client SDK are described in the following table.

(1 of 2)

Component Description

Connect

Runtime versions of INFORMIX-CLI, INTERSOLV DataDirect ODBC Driver, Object Interface for C++, ESQL/C, GLS, LIBMI, and Object Interface for Java.

ESQL/C

An SQL embedded-language product used to create custom C applications. For more information, see the INFORMIX-ESQL/C Programmer's Manual and the INFORMIX-ESQL/C Programmer's Supplement for Microsoft Windows Environments.

INFORMIX-Object Interface for C++

A C++ interface to develop object-oriented client applications for use with all Informix database servers, and client-side value objects for Dynamic Server with UD Option. For more information, see the INFORMIX-Object Interface for C++ Programmer's Guide.

INFORMIX-Object Interface for Java

and

INFORMIX-Driver for JDBC

A library of Java classes and interfaces that allows programmers to create client applications and applets. When used with Dynamic Server with UD Option, the interface can also support value objects provided by DataBlade modules.

The Object Interface for Java also includes JDBC support.

The Object Interface for Java is located in the lib\java subdirectory of the Informix installation directory.

For more information, see the INFORMIX-Object Interface for Java Programmer's Guide.

INFORMIX-GLS

An interface that allows Informix products to use different locales, which have defined conventions for a particular language, culture, or code set. For more information, see the INFORMIX-ESQL/C Programmer's Supplement for Microsoft Windows Environments and the INFORMIX-GLS Programmer's Manual.

INFORMIX-CLI

The call-level interface for Informix database servers. It acts as the ODBC driver. INFORMIX-CLI Version 2.8 complies with ODBC 2.5 and supports extended data types.

INTERSOLV DataDirect ODBC Driver

An ODBC driver that complies with ODBC 3.0. For more information, see the INTERSOLV DataDirect ODBC Driver User Guide for Informix Database Servers.

LIBMI, client implementation

A client-side implementation of the LIBMI C API, provided to ease migration of client applications from the Informix Illustra Server to Informix Dynamic Server with Universal Data Option.

Connect

Connect contains runtime versions of the Client SDK components, which are described in the "Client SDK" section. The runtime versions allow you to run compiled client applications in a Windows environment. If Client SDK is installed on a computer, it is not necessary to install Connect.

DataBlade Developers Kit

The DataBlade Developers Kit allows you to develop DataBlade modules for Informix Dynamic Server with Universal Data Option.

The components of the DataBlade Developers Kit are described in the following table.
Component Description

BladeSmith

A graphical user interface for defining and building DataBlade modules. It defines DataBlade module components and generates C and SQL source files and functional tests. For more information, see the DataBlade Developers Kit User's Guide.

BladePack

A graphical user interface for packaging a DataBlade module. It enforces a common installation strategy for all DataBlade modules and produces a package that BladeManager can install. For more information, see the DataBlade Developers Kit User's Guide.

BladeManager

A graphical user interface for registering and managing DataBlade modules. For more information, see the BladeManager User's Guide.

SQL Editor

A utility that allows users to create and submit SQL queries. For more information, see Using the SQL Editor.

Schema Knowledge

A graphical user interface that provides meta or schema information about Informix databases. Schema Knowledge allows you to see the objects in the database in relation to other database objects, to view the detailed structures of these objects, and to quickly find the details on referenced objects. For more information, see the Schema Knowledge User's Guide.

Database Administration Kit

The Database Administration Kit allows you to administer Dynamic Server with UD Option and DataBlade modules.

The components of the Database Administration Kit are BladeManager, SQL Editor, and Schema Knowledge, each of which is described in the "DataBlade Developers Kit" section.

Using Setup to Install Client Products

Run Setup to install each client product.

To install client products

    1. Load the media for your client product into the CD-ROM drive.

    1.

    Read the readme.txt file in the root directory of the CD-ROM. This file may have information you need before you continue.

    1. Start the Setup program. In the Run dialog box, or at the DOS prompt, type: d:setup

    Replace d: with the CD-ROM drive letter.

    1. In the Enter Serial# and Key dialog box, enter your serial number and key. You can find the serial number and key on the Serial Number Card you received with the product package.

    1. In the User Registration Information dialog box, enter your user name and company name. This information is for display purposes only.

Important: Setup sets the INFORMIXDIR environment variable to the destination directory you choose. Informix software products are designed to be installed in a single directory identified by this environment variable. If you install Informix products in different directories, only those in the directory identified by the INFORMIXDIR environment variable can run.
    Click Next. If you choose Custom installation type, the Select Installation Components dialog box appears. Otherwise, the Select Folder for Informix Applications dialog box appears.

    1. In the Select Installation Components dialog box (Figure 3), choose the components and subcomponents you wish to install.

    Figure 3
    Select Installation Components Dialog Box

    The disk-space requirements are listed next to each component and subcomponent. Informix recommends that you install all components.

    1. In the Select Folder for Informix Applications dialog box, choose the folder where you want to store Informix applications and icons. You can accept the default (INFORMIX), choose another existing folder, or enter the name of a new folder to create.

    Click Next. The Ready to Install Files dialog box appears.

    1. In the Ready to Install Files dialog box, make sure the information shown is correct. You cannot change any options on this screen; however, you can click Back to return to previous screens and change installation options.

    Click Next.

    1. If Setup does not encounter errors during the installation procedure, it displays the Setup Complete dialog box to indicate that the installation is successful.

    Click Finish to exit Setup.

After these steps are completed, Setup has copied the client product software to your computer, created the Setnet32 icon and other icons in the INFORMIX program folder, and created the INFORMIX subkey of the Windows Registry.

If Setup generates an error message, see "Error Messages" for assistance in diagnosing the error.



Installation Guide for Microsoft Windows Environments, version 2.0
Copyright © 1998, Informix Software, Inc. All rights reserved.