Connect ODBC

TM

Installation Guide

February 2002
© 2002 DataDirect Technologies. All rights reserved. Printed in the U.S.A.

DataDirect, DataDirect Connect, and SequeLink are registered trademarks,

and Client/Server MiddleWare, DataDirect Connect ADO, DataDirect Connect
Integrator, DataDirect Connect JDBC, DataDirect Connect ODBC, DataDirect
Connect OLE DB, DataDirect Connect Premium, DataDirect Reflector, and
DataDirect SequeLink Integrator are trademarks of DataDirect Technologies.
All other trademarks are the property of their respective owners.

No part of this publication, with the exception of the software product user
documentation contained in electronic format, may be copied, photocopied,
reproduced, transmitted, transcribed, or reduced to any electronic medium
or machine-readable form without prior written consent of DataDirect
Technologies.

Licensees may duplicate the software product user documentation

contained on a CD-ROM, but only to the extent necessary to support the
users authorized access to the software under the license agreement. Any
reproduction of the documentation, regardless of whether the
documentation is reproduced in whole or in part, must be accompanied by
this copyright statement in its entirety, without modification.

U.S. GOVERNMENT RESTRICTED RIGHTS. It is acknowledged that the

Software and the Documentation were developed at private expense, that
no part is in the public domain, and that the Software and Documentation
are Commercial Computer Software provided with RESTRICTED RIGHTS
under Federal Acquisition Regulations and agency supplements to them.
Use, duplication or disclosure by the U.S. Government is subject to
restrictions as set forth in subparagraph (c)(1)(ii) of The Rights in Technical
Data and Computer Software clause at DFAR 252.227-7013 et. seq. or
subparagraphs (c)(1) and (2) of the Commercial Computer Software
Restricted Rights at FAR 52.227-19, as applicable. Contractor is
DataDirect Technologies, 9420 Key West Avenue, Rockville, Maryland 20850.
Rights are reserved under copyright laws of the United States with respect to
unpublished portions of the Software.

DataDirect Technologies
9420 Key West Avenue
Rockville, Maryland 20850
 3

Table of Contents

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
What Is DataDirect Connect ODBC? . . . . . . . . . . . . . . . . . . . . . 7
Using This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Typographical Conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
About Connect ODBC Documentation. . . . . . . . . . . . . . . . . . . 10
Ordering Printed Books. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Contacting Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . 13

1 Before You Install . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Driver Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Connect ODBC for Btrieve. . . . . . . . . . . . . . . . . . . . . . . . . . 17
Connect ODBC for DB2 Wire Protocol . . . . . . . . . . . . . . . . 18
Connect ODBC for dBASE . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Connect ODBC for Excel Workbook . . . . . . . . . . . . . . . . . . 18
Connect ODBC for Informix . . . . . . . . . . . . . . . . . . . . . . . . 19
Connect ODBC for Informix Wire Protocol . . . . . . . . . . . . 20
Connect ODBC for Oracle . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Connect ODBC for Oracle Wire Protocol . . . . . . . . . . . . . . 23
Connect ODBC for Paradox . . . . . . . . . . . . . . . . . . . . . . . . . 23
Connect ODBC for PROGRESS 9 . . . . . . . . . . . . . . . . . . . . . 24
Connect ODBC for SQLBase. . . . . . . . . . . . . . . . . . . . . . . . . 24
Connect ODBC for SQL Server . . . . . . . . . . . . . . . . . . . . . . 24
Connect ODBC for SQL Server Wire Protocol. . . . . . . . . . . 25
Connect ODBC for Sybase Wire Protocol . . . . . . . . . . . . . . 26
Connect ODBC for Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Connect ODBC for XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Connect ODBC Installation Guide

4 Table of Contents

Supported Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Supported Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . 28

2 Installation on Windows. . . . . . . . . . . . . . . . . . . . . . 31
Before You Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Default Installation Directory . . . . . . . . . . . . . . . . . . . . . . 33

Installing from a CD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Installing from Downloaded Files . . . . . . . . . . . . . . . . . . . . . . 38
Installing from a Network Directory . . . . . . . . . . . . . . . . . . . . 39
Silent Installations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Command-Line Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Parameters and Arguments . . . . . . . . . . . . . . . . . . . . . . . . 42
Silent Installation Examples . . . . . . . . . . . . . . . . . . . . . . . . 46
The Log File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Configuring Drivers and Data Sources . . . . . . . . . . . . . . . . . . 47

Removing or Modifying the Installation. . . . . . . . . . . . . . . . . 48
Using the Remove Option . . . . . . . . . . . . . . . . . . . . . . . . . 48
Using the Modify Option . . . . . . . . . . . . . . . . . . . . . . . . . . 49

For More Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

3 Installation on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . 55
Before You Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Default Installation Directories . . . . . . . . . . . . . . . . . . . . . 57

Installing from a CD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Installing from Downloaded Files . . . . . . . . . . . . . . . . . . . . . . 62
Configuring Drivers and Data Sources . . . . . . . . . . . . . . . . . . 64
For More Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Connect ODBC Installation Guide

 Table of Contents 5

4 Installing and Viewing Online Books. . . . . . . . . . . . 67

About DataDirect’s Online Books . . . . . . . . . . . . . . . . . . . . . . . 67
Installing the Online Books . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Viewing the Online Books. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Using Hypertext Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Performing Text Searches . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Using Bookmarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

Customizing the Online Books . . . . . . . . . . . . . . . . . . . . . . . . . 71

About Acrobat Reader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Product Requirements for Acrobat Reader 4.x . . . . . . . . . . . . 72
Installing Acrobat Reader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Windows Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
UNIX Platforms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

Connect ODBC Installation Guide

6 Table of Contents

Connect ODBC Installation Guide

 7

Preface

This book describes the procedures for installing DataDirect®

Connect ODBC™ by DataDirect Technologies™ from a CD-ROM
and from downloaded files.

What Is DataDirect Connect ODBC?

DataDirect Connect ODBC drivers enable you to connect to a
variety of relational and flat-file databases from these platforms:

Windows

■ Windows 98
■ Windows Me
■ Windows NT with Service Pack 5 and higher
■ Windows 2000 with Service Pack 1 and higher
■ Windows XP Home Edition and Professional

UNIX

■ AIX 4.3.3 and higher with the 5.0.2.0 C++ runtime libraries
■ HP-UX 11 and 11i
■ Sun Solaris 7 and 8
■ Linux (Red Hat Linux 6.2, 7.1, and 7.2; Caldera OpenLinux 2.3
and 3.1; SuSE Linux 6.4 and 7.3)

If you purchased the Connect ODBC Pack for one or more of

these platforms, you can install any or all of the drivers. If you
purchased Connect ODBC Single Driver, you can install only one
driver per platform for the number of platforms purchased.

Connect ODBC Installation Guide

8 Preface

Using This Book

This book can be used by system and database administrators and
any users who need ODBC drivers to access databases. It is
assumed that you are familiar with the operation of your system,
and that you understand how to navigate to directories on your
system and on any networks attached to your system.

This book explains how to:

■ Install DataDirect Connect ODBC on a local or a network drive

under Windows platforms (see Chapter 2 “Installation on
Windows” on page 31).

■ Install DataDirect Connect ODBC under UNIX platforms (see

Chapter 3 “Installation on UNIX” on page 55).

■ Install DataDirect Connect ODBC documentation (see

Chapter 4 “Installing and Viewing Online Books” on page 67).

For the latest information about the specific DataDirect drivers

available for your platform, see the README file in your software
package, or refer to the DataDirect Technologies World Wide
Web page at:

http://www.datadirect-technologies.com

NOTE: This book refers the reader to Web URLs for more
information about specific topics, including Web URLs not
maintained by DataDirect Technologies. Because it is the nature
of Web content to change frequently, DataDirect Technologies
can guarantee only that the URLs referenced in this book were
correct at the time of publishing.

Connect ODBC Installation Guide

 Typographical Conventions 9

Typographical Conventions
This book uses the following typographical conventions:

Convention Explanation
italics 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.
UPPERCASE Indicates the name of a file. For operating
environments that use case-sensitive file names, the
correct capitalization is used in information specific
to those environments.
Also indicates keys or key combinations that you can
use. For example, press the ENTER key.
monospace Indicates syntax examples, values that you specify, or
results that you receive.
monospaced Indicates names that are placeholders for values that
italics you specify. For example, filename.

forward slash / Separates menus and their associated commands. For

example, Select File / Copy means that you should
select Copy from the File menu.
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.

Connect ODBC Installation Guide

10 Preface

Convention Explanation
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.

About Connect ODBC Documentation

This Guide and the Connect ODBC Reference are provided on
your DataDirect CD in PDF format, which allows you to view the
books online or print them. You can view the Connect ODBC
online documentation using Adobe Acrobat Reader. The
DataDirect CD includes Acrobat Reader 4.x with Search. Connect
ODBC product documentation is also available on the DataDirect
Technologies Web site:

http://www.datadirect-technologies.com/download/docs/
dochome.asp

See Chapter 4 “Installing and Viewing Online Books” on page 67

for complete information on installing the online documents.

On Windows platforms, online help is provided through the Help

button on the Driver Setup windows and through a separate,
general ODBC driver help file, installed in the Connect ODBC
program group.

On UNIX platforms, online help for driver configuration is

provided through this manual in PDF format, viewed with
Acrobat Reader version 3.0 or higher. By default, this online book
is not installed when you install the Connect ODBC product.
Optionally, you can install the Connect ODBC online books when
you install the product. In this case, the books are installed in the
following location: install_dir/books.

Connect ODBC Installation Guide

 Ordering Printed Books 11

Ordering Printed Books

As part of your Connect ODBC license agreement, you may print
and distribute as many copies of the Connect ODBC books as
needed.

If you do not want to print each of these online books, you can
order printed versions from DataDirect Technologies. To order,
please complete the following order form and fax your request
to DataDirect Technologies at (919) 461-4526.

Connect ODBC Installation Guide

12 Preface

Order Form
Fax your request to DataDirect Technologies at (919) 461-4526.
The cost of shipping will be added to your order.

Serial Number:____________________________________________________

Version Number*:_________________________________________________

Ordered By: ________________________ Phone: ( ___ ) ___

______________
-

Company Name: _________________________________________________

Mailing Address: _________________________________________________

City: ___________________________ State: ________ Zip: ______________

* Version Number: For the correct version number for Connect ODBC,
make sure that you write the version number that is listed at the top of
the README file.

Credit Card: Master Card® VISA® Discover® American Express®

Credit Card Number:

Expiration: Signature: ___________________________

Mo Yr

Book Title Price Quantity Total

Connect ODBC Installation Guide $35.00
Connect ODBC Reference $35.00

Shipping: Orders are shipped via Standard Airborne delivery from our Rockville
Distribution Center. Items should arrive within 5 business days of receipt of
order.

Connect ODBC Installation Guide

 Contacting Technical Support 13

Contacting Technical Support

DataDirect Technologies provides technical support for all
registered users of this product, including limited installation
support, for the first 30 days. You can register online for your
SupportLink user ID and password, which provide access to the
password-protected areas of the SupportLink web site, at
http://support.datadirect-technologies.com. Select Register on
the left toolbar, complete the information on the Register page,
and click Submit. Your user ID and password are issued to you by
email upon registration.

For support after 30 days, contact us using one of the following

methods or purchase further support by enrolling in the
SupportLink program. For more information about SupportLink,
contact your sales representative.

The DataDirect Technologies web site provides the latest support

information through SupportLink Online, our global service
network that provides access to support contact details, tools,
and valuable information. Our SupportLink users access
information using the web and automatic email notification.
SupportLink Online includes a knowledge base that allows you
to search on keywords for technical bulletins and other
information. You also can download product fixes and upgrades
for your DataDirect products.

World Wide Web

http://support.datadirect-technologies.com

E-Mail
USA, Canada, Mexico, [email protected]
Australia, and Asia
Pacific (except Japan)

Connect ODBC Installation Guide

14 Preface

E-Mail
Japan [email protected] (beginning March 2002)
[email protected] (until March 2002)
All other countries [email protected]

Local Telephone Support

Local phone numbers can be found at:
http://support.datadirect-technologies.com/websupport/supportnet/datadirect/
supportnetanswerline.asp
NOTE: You must have a SupportLink user ID and password to access this web
site. You can register online for your SupportLink user ID and password at
http://support.datadirect-technologies.com. Select Register on the left toolbar,
complete the information on the Register page, and click Submit. Your user ID
and password are issued immediately and confirmation is sent to you by email.
Answerline support is available 24 hours a day, seven days a week.

Fax Information
Fax US 1 919 461 4527
Fax International +32 (0) 15 32 09 19

When you contact us, please provide the following information:

■ The product serial number or a case number. If you do not

have a SupportLink contract, we will ask you to speak with a
sales representative.

■ Your name and organization. For a first-time call, you may be

asked for full customer information, including location and
contact details.

■ The version number of your DataDirect product.

■ The type and version of your operating system.

■ Any third-party software or other environment information

required to understand the problem.

Connect ODBC Installation Guide

 Contacting Technical Support 15

■ A brief description of the problem, including any error

messages that you have received, and the steps preceding
the occurrence of the problem. Depending on the complexity
of the problem, you may be asked to submit an example so
that we can recreate the problem.

■ An assessment of the severity level of the problem.

Connect ODBC Installation Guide

16 Preface

Connect ODBC Installation Guide

 17

1 Before You Install

Before you install Connect ODBC, you need to verify that you
have both the correct database client software on your system, a
supported version of the database, and a supported version of
the operating system.

Driver Requirements
The following section describes the client requirements for
Connect ODBC drivers.

Connect ODBC for Btrieve

To access a Btrieve database, you must be using the appropriate
client software for the version of the Btrieve database to which
you are connecting:

Database Versions Client Names

Pervasive.SQL 2000 Pervasive.SQL 2000 client software
Pervasive.SQL 7.0 Pervasive.SQL 7.0 client software
Btrieve 6.15 for Btrieve Developer’s Kit or
Windows 9x Btrieve WorkStation Client Engine
Btrieve 6.15 for Btrieve Developer’s Kit,
Windows NT Btrieve WorkStation Client Engine, or
Btrieve Client/Server Database Engine

Before you attempt to access Btrieve files, you must incorporate

existing Btrieve files into a Scalable SQL database. See the

Connect ODBC Installation Guide

18 Chapter 1 Before You Install

Connect ODBC Reference for information on defining table

structure.

NOTE: The Btrieve driver may experience problems if the Btrieve

Microkernel Engine’s communication buffer size is smaller than
the Btrieve driver’s Array Size attribute. You can increase the
communication buffer size with the Pervasive Software Setup
Utility. You can decrease the array size option when you
configure a data source using the ODBC Btrieve Driver Setup
dialog box, or when passing a connection string.

Connect ODBC for DB2 Wire Protocol

The server requirement for all platforms is the same. The DB2
database must be installed as the Server Version (not the Local
Version).

There are no client requirements for the DB2 Wire Protocol

driver.

Connect ODBC for dBASE

There are no client requirements for the dBASE driver.

Connect ODBC for Excel Workbook

The Excel Workbook driver requires the OLE32.DLL. This DLL is
typically provided by the Windows System. It is also provided with
Excel 5.1 and 7.0.

Connect ODBC Installation Guide

 Driver Requirements 19

Connect ODBC for Informix

This section provides the system requirements for using the
Informix driver on all supported platforms.

Windows
To access supported remote Informix databases through the
Informix driver, you need one of the following:

■ Informix Connect for Windows platforms, version 2.x

■ Informix Client Software Development Kit for Windows

platforms, version 2.x

Use the Setnet32 utility supplied by Informix to define servers

and the location of the INFORMIX directory. Use Ilogin to test
your connection to the Informix server. The path to the
ISQLT09A.DLL must be in your PATH environment variable.

UNIX (AIX, HP-UX, and Solaris)

The environment variable INFORMIXDIR must be set to the
directory where you have installed the Informix client.

For example, the following syntax is valid for C-shell users:

setenv INFORMIXDIR /databases/informix

For Bourne- or Korn-shell users, the following syntax is valid:

INFORMIXDIR=/databases/informix;export INFORMIXDIR

In addition, the INFORMIXSERVER variable must be set to the

name of the Informix server (as defined in your
$INFORMIXDIR/etc/sqlhosts file). For further details, refer to the
Informix documentation.

Connect ODBC Installation Guide

20 Chapter 1 Before You Install

To access supported remote Informix databases through the

Informix driver, you need one of the following:

■ On HP-UX and Solaris: Informix Connect version 2.x

■ On AIX: Informix Connect version 2.2 or higher

■ On HP-UX and Solaris: Informix Client Software Development

Kit version 2.x

■ On AIX: Informix Client Software Development Kit version 2.2

or higher

Connect ODBC for Informix Wire

Protocol
There are no database client requirements for the Informix Wire
Protocol driver.

Connect ODBC for Oracle

This section provides the system requirements for using the
Oracle driver on both Windows and UNIX.

Windows
IMPORTANT: You must have all components of the Oracle client
software installed; otherwise, the driver will not operate
properly.

The Oracle Net8 Client 8.0.5 or higher is required to access:

■ Remote Oracle8 servers 8.0.5 or higher

■ Remote Oracle servers 7.3.4.x

Connect ODBC Installation Guide

 Driver Requirements 21

To access remote Oracle9i servers, you must use either the Oracle
Net8 Client 8.1.6 or higher or the Oracle Net Client for 9i.

On Intel systems, the appropriate DLLs for the Oracle Net8 Client
or the Oracle Net Client for 9i must be on your path, for
example, ORA805.DLL, PLS805.DLL, and OCI.DLL.

UNIX
IMPORTANT: You must have all components of the Oracle client
software installed; otherwise, the driver will not operate
properly. See the DataDirect README for a component list.

The Oracle Net8 Client 8.0.5 or higher is required to access:

■ Remote Oracle8 servers 8.0.5 or higher

■ Remote Oracle servers 7.3.4.x

NOTE: On Linux, you must use the Oracle Net8 Client version
8.1.6.1.

To access remote Oracle9i servers, you must use either the Oracle
Net8 Client 8.1.6 or higher or the Oracle Net Client for 9i.

Before you can use the Oracle driver, you must have a supported
Oracle client installed on your workstation in the
$ORACLE_HOME source tree. ORACLE_HOME is an environment
variable created by the Oracle installation process that identifies
the location of your Oracle client components.

Set the environment variable ORACLE_HOME to the directory

where you installed the Oracle client. For example, for C-shell
users, the following syntax is valid:

setenv ORACLE_HOME /databases/oracle

For Bourne- or Korn-shell users, the following syntax is valid:

ORACLE_HOME=/databases/oracle;export ORACLE_HOME

Connect ODBC Installation Guide

22 Chapter 1 Before You Install

Building the Required Oracle Net8 Shared Library on

Solaris and HP-UX 11
A one-time site linking to build a replacement Oracle Net8 shared
library is required in the following cases:

■ For Oracle Net8 Client 8.0.5 and 8.0.6 on Solaris and

HP-UX 11

■ For Oracle Net8 Client 8.1.5 and 8.1.6 on HP-UX 11

This site linking binds your unique Oracle Net8 configuration into
the file, which is used by the Oracle driver to access local and
remote Oracle databases.

The Oracle driver requires the shared library libclntsh.so (Solaris)

and libclntsh.sl (HP-UX 11), which is built by the Oracle script
genclntsh. The genclntsh script provided by Oracle causes errors
resulting from undefined symbols. Users running Oracle8 on
specific platforms with certain versions of Oracle client software
(as documented below) must therefore use the genclntsh8 or
genclntsh816 script provided with Connect ODBC for Oracle to
build a replacement libclntsh.so or libclntsh.sl. These scripts, in
the src/oracle directory, place the new libclntsh.so or libclntsh.sl in
../../lib, which is your $ODBC_HOME/lib directory; it does not
overwrite the original libclntsh.so or libclntsh.sl in the
$ORACLE_HOME/lib directory.

Before you build the Oracle Net8 shared library, install Oracle and
set the environment variable ORACLE_HOME to the directory
where you installed Oracle.

For Oracle Net8 Client 8.0.5 and 8.0.6 on Solaris and Oracle Net8
Client 8.0.5, 8.0.6, and 8.1.5 on HP-UX 11, the following
commands build the Oracle Net8 shared library:

cd ${ODBC_HOME}/src/oracle
genclntsh8

Connect ODBC Installation Guide

 Driver Requirements 23

For Oracle Net8 Client 8.1.6 on HP-UX 11, the following

commands build the Oracle Net8 shared library:

cd ${ODBC_HOME}/src/oracle
genclntsh816

WARNING: Oracle8 users will have the original libclntsh.so

library in the $ORACLE_HOME/lib directory. Therefore, the
$ODBC_HOME/lib directory, containing the correct library, must
be on the LD_LIBRARY_PATH (Solaris) or SHLIB_PATH (HP-UX 11)
before $ORACLE_HOME/lib. Otherwise, the original Oracle
library will be loaded, resulting in the unresolved symbol error.

Connecting to Oracle 8.1.7 on HP-UX

To connect to Oracle 8.1.7 on HP-UX, you must have the HP
patch PHSS_22514 incorporated into the operating system, and
you must set the LD_PRELOAD system variable to the absolute
path of the libjava.sl library.

Connect ODBC for Oracle Wire Protocol

There are no client requirements for the Oracle Wire Protocol
driver.

Connect ODBC for Paradox

To use the Paradox driver, you must install the Borland Database
Engine, which conforms to the IDAPI programming interface.
The Borland Database Engine can be found in any of the
following software packages:

■ Borland C++ for Windows

■ Delphi for Windows
■ Paradox 7, 8, or 9 for Windows

Connect ODBC Installation Guide

24 Chapter 1 Before You Install

You must have IDAPI32.DLL on your path or in your Windows 98

or Windows Me \SYSTEM directory, or Windows NT,
Windows 2000, or Windows XP \SYSTEM32 directory.

Connect ODBC for PROGRESS 9

To access a PROGRESS database with the PROGRESS 9 driver, your
system must have the following software installed:

■ On the client computer: PROGRESS SQL Client Access

version 9.1B or higher.

■ On the server computer: PROGRESS Enterprise Database

version 9.1B or higher.

NOTE: The PROGRESS 9 driver cannot access PROGRESS databases

created prior to version 9.1B.

Before using the driver, you must set the DLC environment
variable to your PROGRESS DLC directory. For example:

set DLC=C:\PROGRESS

Connect ODBC for SQLBase

To communicate with the SQLBase server, the SQLBase driver
requires the SQLBase 7.5 client software, which includes the
following shared libraries: SQLWNTM.DLL and SQLNGCI.DLL. The
directory containing these files must be on your path.

Connect ODBC for SQL Server

To use the SQL Server driver, you must have the appropriate
Microsoft SQL Server DB-Library and Net-Library version installed
(version 6.5 for access to 6.5 database systems; version 7.0 for
access to 7.0 and 2000 database systems).

Connect ODBC Installation Guide

 Driver Requirements 25

The SQL Server driver requires Microsoft client software; it does

not work with Sybase System 10 or 11 software.

Your database must support catalog stored procedures.

The DB-Library is NTWDBLIB.DLL. The Net-Library you need

depends on the network protocol used to connect to SQL Server.
For example, Named Pipes requires DBNMPNTW.DLL, and TCP/IP
requires DBMSSOCN.DLL. Contact your Microsoft SQL Server
vendor to obtain the appropriate DB-Library and Net-Library.

You must have NTWDBLIB.DLL on your path or in your

Windows 98 or Windows Me \SYSTEM directory, or Windows NT,
Windows 2000, or Windows XP \SYSTEM32 directory.

Connect ODBC for SQL Server Wire

Protocol
This section provides the driver requirements for using the SQL
Server Wire Protocol driver on both Windows and UNIX
platforms.

Windows
For support of version 7.0 and 2000 of SQL Server, the driver
requires the SQL Server 7.0 versions of Net-Library DLL files,
which are installed when you install Connect ODBC for SQL
Server Wire Protocol. The driver communicates with network
software through the SQL Server Net-Library interface.

There are no client requirements for the SQL Server Wire

Protocol driver.

Connect ODBC Installation Guide

26 Chapter 1 Before You Install

UNIX
To use the SQL Server Wire Protocol driver on UNIX, you must
have TCP/IP configured on both the UNIX client and the Windows
NT or Windows 2000 server on which the SQL Server database
resides. The UNIX SQL Server TCP/IP network client library is built
into the UNIX SQL Server ODBC driver. Nothing else is required
beyond the normal ODBC environment.

The SQL Server Client configuration has been merged with the
ODBC driver configuration and is set in the system information
file.

Connect ODBC for Sybase Wire Protocol

There are no client requirements for the Sybase Wire Protocol
driver.

Connect ODBC for Text

There are no client requirements for the Text driver.

Connect ODBC for XML

You must have Internet Explorer 5 installed.

Connect ODBC Installation Guide

 Supported Databases 27

Supported Databases
The following table shows the databases supported by each
Connect ODBC driver at the time of the release. For the most
current information, refer to the Connect ODBC matrix on
DataDirect Technologies web site:

http://www.datadirect-technologies.com/odbc/techresources/
matrix/connectodbc_files/sheet001.htm

NOTE: All drivers and supported databases are not available on

every platform version.

Driver Supported Databases

Btrieve Btrieve version 6.15, Pervasive.SQL 7.0, and
Pervasive.SQL 2000
DB2 Wire Protocol DB2 Universal Database 6.1, 7.1, and 7.2 on
Windows NT, Windows 2000, and UNIX;
DB2 Universal Database for AS/400 V4R5
and V5R1; DB2 for OS/390 Versions 6.1 and
7 (special licensing only)
dBASE dBASE IV and V on Windows and UNIX;
Clipper on Windows; FoxPro 2.5 and 2.6 on
Windows; FoxPro 3.0 on Windows and
UNIX; FoxPro 6.0 on Windows with 3.0
functionality only
Excel Workbook Excel Workbook 5.1 and 7.0
FoxPro 3.0 DBC (dBASE) FoxPro 3.0 database containers on
Windows
Informix Informix OnLine 7.x, Informix SE 7.2x,
Informix Dynamic Server with Universal
Data Option 9.1.4 and higher, and Informix
Dynamic Server 9.2x and 9.3x
Informix Wire Protocol Informix Dynamic Server with Universal
Data Option 9.x and Informix Dynamic
Server 9.2x and 9.3x

Connect ODBC Installation Guide

28 Chapter 1 Before You Install

Driver Supported Databases

Oracle Oracle 7.3.4 and higher, Oracle 8.0.5 and
higher, Oracle 8i R1, R2, R3 (8.1.5, 8.1.6,
8.1.7), and Oracle9i when using the
appropriate Oracle Net client
Oracle Wire Protocol Oracle 8i R2, R3 (8.1.6 and 8.1.7) and Oracle
9i
Paradox Paradox 4, 5, 7, 8, and 9 tables
PROGRESS 9 PROGRESS 9.1B and 9.1C
SQLBase SQLBase 7.5 and 7.6.x
SQL Server 6.5 functionality on SQL Server 6.5, 7.0, and
SQL Server 2000
SQL Server Wire Protocol SQL Server 7.0 and SQL Server 2000 with
Service Pack 1
Sybase Wire Protocol Sybase Adaptive Server 11.5 and higher,
and Sybase Adaptive Server Enterprise 12.0
and 12.5
Text ASCII text files
XML Hierarchical-formatted XML files,
Tabular-formatted files of the type:
Microsoft Data Islands, ADO 2.5 persisted
files, and DataDirect formatted files

Supported Operating Systems

Windows

■ Windows 98
■ Windows Me
■ Windows NT with Service Pack 5 and higher
■ Windows 2000 with Service Pack 1 and higher
■ Windows XP Home Edition and Professional

Connect ODBC Installation Guide

 Supported Operating Systems 29

UNIX

■ AIX 4.3.3 and higher with the 5.0.2.0 C++ runtime libraries
■ HP-UX 11 and 11i
■ Sun Solaris 7 and 8
■ Linux (Red Hat Linux 6.2, 7.1, and 7.2; Caldera OpenLinux 2.3
and 3.1; SuSE Linux 6.4 and 7.3)

Connect ODBC Installation Guide

30 Chapter 1 Before You Install

Connect ODBC Installation Guide

 31

2 Installation on Windows

DataDirect Connect ODBC includes a Setup program that enables

you to install the product from a CD, an electronic site, or a
network directory.

If you purchased Connect ODBC Pack, you do not have to install

all the drivers; you can select specific drivers to install.

Before You Install

Before you start installation:

■ Exit or close all applications that are running to prevent

file-locking conflicts.

■ Verify that your system meets the driver’s requirements for a

database before you install the driver. The driver will not
work if these requirements are not met. Refer to Chapter 1
“Before You Install” on page 17 for a list of driver
requirements.

■ You must be a system administrator or have update privileges

for the registry key [HKEY_LOCAL_MACHINE]. These
privileges are required to update the registry with the new
drivers being installed. See your system administrator if you
are unsure.

■ If the files are on a network, verify that you have write

privileges. See your network administrator if you are unsure.

IMPORTANT: You must have version 2.6 or higher of Microsoft

Data Access Components (MDAC) installed to configure and use
the Connect ODBC drivers. You can download a utility that

Connect ODBC Installation Guide

32 Chapter 2 Installation on Windows

determines the version of your currently installed MDAC from the

following Microsoft site:

http://www.microsoft.com/data/download.htm#26SDKinfo

If you do not have a supported version of MDAC, you can

download it from this site or install it from the DataDirect CD. To
install from the DataDirect CD, navigate from the root directory
to \mdac and run MDAC_TYP.EXE.

System Requirements
The following are system requirements for using Connect ODBC
drivers on Windows.

■ The ODBC drivers are 32-bit drivers. All required network

software supplied by your database system vendors must be
32-bit compliant.

■ Memory requirements vary, depending on the database

driver. If you are using a flat-file database driver, you need at
least 8 MB of memory on Windows 98 and Windows Me, and
at least 16 MB of memory on Windows NT, Windows 2000,
and Windows XP. If your system is hosting a relational
database system, additional memory may be required.
Consult your relational database documentation to
determine the exact memory requirements.

■ Service Pack 5 or higher for Windows NT

■ Service Pack 1 or higher for Windows 2000

■ 25 MB of available hard disk space for 32-bit drivers.

Connect ODBC Installation Guide

 Installing from a CD 33

Default Installation Directory

The Setup program lets you specify the directory into which the
drivers will be installed. By default, the Setup program creates
and installs the drivers in the directory:

C:\Program Files\DataDirect\ODBC41

Installing from a CD
This section provides instructions for installing Connect ODBC
drivers and Connect ADO providers from a CD to your local drive.

Use the main installer window to install ODBC drivers and other
DataDirect products available on your CD. Upon completion of
the installation, the main installer window allows you to install
another product or exit.

To install DataDirect Connect ODBC from a CD:

1 Place the CD into the CD drive. If the CD drive is on a
network, you must mount the CD and create a mapping to
the CD drive.

2 On Windows, the main installer window displays

automatically when the CD is mounted if AutoPlay for CDs is
enabled. Click the product that you want to install.

If AutoPlay for CDs is not enabled or you do not have a

browser, use Windows Explorer to navigate from the root
directory of the CD to the folder for the product that you
want to install. Then, double-click the Setup program.

3 The Welcome window for the product appears. Click Next to

continue. The License Agreement window appears.

NOTE: You can exit the Setup program at any time by clicking
Cancel, or return to the previous window by clicking Back.

Connect ODBC Installation Guide

34 Chapter 2 Installation on Windows

4 On the License Agreement window, perform one of the

following actions:

■ Accept the agreement by clicking the appropriate option.

Then, click Next. A Product Selection window appears.

■ Do not accept the agreement by clicking Cancel to exit the

installation.

5 On the Product Selection window, select the product that you

want to install.

■ Desktop:

• Single Driver: An end-user version for a single Connect

ODBC driver. This enables connectivity to one database
from a desktop workstation.
• Driver Pack: An end-user version for the entire set of
Connect ODBC drivers. This enables connectivity to all
supported databases from a desktop workstation. Even
if you do not want to install all drivers, select this
option to be able to install more than one driver.
■ Server Single Driver: A server version for a single Connect
ODBC driver. This enables connectivity to one database
from an application or Web server.

■ OEM Embedding Driver Pack: An OEM version designed

exclusively for embedding use by commercial software
and database vendors. This includes the entire set of
Connect ODBC drivers to enable connectivity to all
supported databases from a development environment.
Even if you do not want to install all drivers, select this
option to be able to install more than one Connect OEM
driver.

Then, click Next to continue. The Options Available window

appears.

Connect ODBC Installation Guide

 Installing from a CD 35

6 On the Options Available window, select one, both, or

neither of the following check boxes:

■ Replace Existing Drivers. Removes the old ODBC driver

definitions from the HKEY_LOCAL_MACHINE odbcinst
drivers list. If you have other system DSNs or user DSNs
that refer to these old definitions, those DSNs will no
longer work.

■ Create Default Data Sources. Defines a data source name

in your system information for each Connect ODBC driver
that you install.

WARNING: These default data source names may overwrite

some of the data source names already in the system
information.

Then, click Next. The Browse for Installation Directory

window appears.

7 The Browse for Installation Directory window allows you to

change the installation directory from the default location of
C:\Program Files\DataDirect\ODBC41. This is optional.

To change the installation directory, click Change and select

the new installation directory path. Then, click OK to return
to the Browse for Installation Directory window.

Click Next. The Custom Setup window appears.

IMPORTANT: Connect ODBC 4.1 cannot be installed in the

same installation location as an earlier version of Connect
ODBC or Connect Premium.

8 The Custom Setup window allows you to choose the Connect

ODBC features that you want to install. There are two icons
for the two main features listed in the left-hand display pane
of the window: Online Books and All ODBC Drivers. Each
individual driver icon is listed as a subfeature of the All ODBC

Connect ODBC Installation Guide

36 Chapter 2 Installation on Windows

Drivers icon. Initially, all icons display a red X, which means

that the feature will not be installed.

Online Books: If you want to install the Online Books, click the
drop-down arrow in the icon and select "This feature will be
installed on local hard drive." The red X disappears from the
icon.

For more information about the Online Books, see Chapter 4

“Installing and Viewing Online Books” on page 67.

All ODBC Drivers: If you want to install ODBC drivers, perform

one of the following actions:

■ To install all ODBC drivers, click the drop-down arrow in

the All ODBC Drivers icon and select "This feature, and all
subfeatures, will be installed on local hard drive." The red
X disappears from the All ODBC Drivers icon, as well as
from the individual driver icons.

■ To install selected ODBC drivers, click the drop-down

arrow in the icon for each driver that you want to install
and select "This feature will be installed on local hard
drive." The red X disappears from the individual driver
icon(s), as well as from the All ODBC Drivers icon. If you
have selected individual driver icons, do not make a
selection under the All ODBC Drivers icon.

The Custom Setup window also has two additional buttons:

Help: Provides help on determining the install state of a

feature.

Space: Displays the amount of space available on your drives

and indicates whether this is sufficient for installation of the
selected features.

After configuring the features for installation, click Next. The

Licensing Information window appears.

Connect ODBC Installation Guide

 Installing from a CD 37

9 In the appropriate fields of the Licensing Information

window, enter your name and the company name. Then,
perform one of the following actions:

■ If you are installing a licensed copy of the product, enter

the serial number and key provided to you by DataDirect
Technologies.

■ If you are installing an evaluation copy of the product,

enter EVAL in the Serial field and Key field.

Then, click Next.

■ If you entered the correct data on the licensing

information window, the Ready To Install the Program
window appears. Click Install to begin the installation.

■ If you entered incorrect data or left any fields blank, you

receive an error message. Click OK; you are returned to
the Setup window that allows you to correct your error.

10 When the installation has finished, the Setup Completed

window appears. Click Finish to exit Setup.

After completion of the CD installation, the main installer

window reappears, allowing you the option to install another
DataDirect product.

A DataDirect Technologies Connect ODBC 4.10 program group is

created as part of the installation. This program group provides
the following shortcuts:

■ License Information
■ ODBC Administrator
■ ODBC Driver Help
■ ODBC Pack Readme
■ Online Books (if you installed the Online Books)
■ XML Persistence Demo

Connect ODBC Installation Guide

38 Chapter 2 Installation on Windows

After installation, you must:

■ For Windows 98 and Windows Me users only: Reboot to

write the drivers’ path to the PATH environment variable.

■ Configure drivers and data sources; see “Configuring Drivers

and Data Sources” on page 47 for details.

Installing from Downloaded Files

DataDirect makes several Connect ODBC product packages
available for either purchase or evaluation via its download site
on the World Wide Web
(http://www.datadirect-technologies.com). Installation of any of
these packages follows essentially the same procedure as
installation from a CD.

This section provides instructions for installing ODBC drivers

downloaded from an electronic site to your local drive or to a
network location.

To install DataDirect Connect ODBC drivers from downloaded

files:

1 Download the appropriate ODBC driver zip file from the

electronic site.

2 Unzip the files, maintaining the directory structure in the zip

file, to a temporary directory, for example:

C:\TEMP
3 From Windows Explorer, navigate to this directory; then,
double-click the Setup program.

4 The Welcome window for the product appears. To complete

installation, follow Step 3 through Step 9 under “Installing
from a CD” on page 33.

Connect ODBC Installation Guide

 Installing from a Network Directory 39

After installation, you must:

■ For Windows 98 and Windows Me users only: Reboot to

write the drivers’ path to the PATH environment variable.

■ Configure drivers and data sources; see “Configuring Drivers

and Data Sources” on page 47 for details.

Installing from a Network Directory

The Setup program for the ODBC drivers can be copied to a
network directory from the CD or from the directory containing
downloaded files. You can then install the ODBC drivers from
this directory:

■ Copying files from the CD. Copy the entire contents from the
appropriate platform directory to a network directory. For
example, to install the Connect ODBC Pack, copy the
contents of:

\ODBC\WIN9XNT
Navigate to the network directory and double-click the Setup
program. The product Welcome window appears. To
complete installation, follow Step 3 through Step 9 under
“Installing from a CD” on page 33.

■ Copying downloaded files. Copy all of the downloaded files

from their temporary directory to a network directory.
Navigate to the network directory and double-click the Setup
program. The product Welcome window appears. To
complete installation, follow Step 3 through Step 9 under
“Installing from a CD” on page 33.

Connect ODBC Installation Guide

40 Chapter 2 Installation on Windows

After installation, you must:

■ For Windows 98 and Windows Me users only: Reboot to

write the drivers’ path to the PATH environment variable.

■ Configure drivers and data sources; see “Configuring Drivers

and Data Sources” on page 47 for details.

Silent Installations
The Connect ODBC Setup provides a command-line option for
silent installations on Windows NT, Windows 2000, and Windows
XP. The silent installation is useful for system administrators who
want to create a batch file to execute multiple identical
installations of Connect ODBC. To perform a silent installation,
use the following procedure.

1 From a command-line prompt, change to the directory

containing the Connect ODBC file SETUP.EXE, or insure that
this directory is on your path.

2 The command-line syntax for executing a silent installation is:

setup.exe /s /v"arguments /qn /l*v path\log"

See “Command-Line Syntax,” for an explanation of the syntax
rules. See Table 2-1 for an explanation of each command-line
parameter. See Table 2-2 and Table 2-3 for an explanation of
the arguments that follow the /v parameter. The tables are
followed by specific examples of the command-line syntax.

Connect ODBC Installation Guide

 Silent Installations 41

3 The installation proceeds without any further user

intervention or notification unless you enter an incorrect IPE
key or invalid driver choices; in which case, an error is
displayed. For example, if you specify
PRODUCTSELECTED=DESKTOPSINGLE and choose two drivers
to install, DB=TRUE and ORACLE=TRUE, you receive the
following error message:

You have chosen more than one driver.

Setup will abort and you must correct the silent installation
command line.

Consult the log that is created during the installation (see

“The Log File” on page 47) to determine whether the
installation was successful and, if it failed, why it failed. You
must have this log available if you contact DataDirect for
technical support.

Command-Line Syntax
In general, there must be a space between all command-line
parameters and between each argument:

setup.exe /s /v"arguments /qn /l*v path\log"

The exception is that there cannot be a space between /v and

the double quotation mark that follows it. There can be multiple
arguments and parameters specified between the opening and
closing double quotation marks, but each one must be separated
by a space. The arguments are case-sensitive.

Connect ODBC Installation Guide

42 Chapter 2 Installation on Windows

IMPORTANT: When any of the command-line parameters include

a value that contains a space, that value must be preceded and
followed by the escape characters \". For example:

INSTALLDIR=\"C:\Program Files\My Drivers\"

and

CUSTOMER=\"John Doe\"

Parameters and Arguments

See Table 2-1 for an explanation of each command-line
parameter. See Table 2-2 and Table 2-3 for an explanation of the
required and optional arguments that follow the /v parameter.

Table 2-1. Silent Installation Parameters

Parameter Description
/s Instructs Setup to perform a silent installation.
/v"arguments Passes arguments to the installer; the v cannot be followed by a space.
parameters" The arguments and following parameters must be enclosed between
quotation marks.
/qn Additional parameter required to perform a silent installation.
/l*v path\name Instructs the installer to create a log file of the installation. The v must be
followed by a space, then by the path where you want the log file
created, as well as the name of the log file. The directory you specify
must exist. If you specify a directory that does not exist, the installation
fails.

Connect ODBC Installation Guide

 Silent Installations 43

Table 2-2. Required Arguments

Argument Description
COMPANY=company name Provide your company name.
CUSTOMER=user name Provide your name.
INSTALLDIR=installation directory Provide the directory name where you want to install
the drivers. The suggested default is C:\Program
Files\DataDirect\ODBC41.
Because this path contains spaces, you must use
escape characters as explained under
“Command-Line Syntax” on page 41.
IMPORTANT: Connect ODBC 4.1 cannot be installed in
the same installation location as an earlier version of
Connect ODBC or Connect Premium.
LICENSE=key value Provide the license key for your purchased product or
enter EVAL to install an evaluation copy.
OPTION=PACK You must include this argument only if you are
installing either the Desktop or OEM Pack.
OPTION=SINGLE You must include this argument only if you are
installing either a DESKTOPSINGLE or SERVERSINGLE.

Connect ODBC Installation Guide

44 Chapter 2 Installation on Windows

Table 2-2. Required Arguments (cont.)

Argument Description
PRODUCTSELECTED= Choose the option that you want to install, such as,
{DESKTOPSINGLE | DESKTOPPACK | PRODUCTSELECTED=DESKTOPPACK.
SERVERSINGLE | OEMPACK} If you specify DESKTOPPACK, you must also specify
either DRIVER=ALL or driver=TRUE, where driver is
the name of a Connect ODBC driver (as described in
Table 2-3). You can specify
driver=TRUE for each driver you want to install; see
“Example 3” on page 47.
If you specify OEMPACK, you must also specify
DRIVER=ALL.
If you specify either DESKTOPSINGLE or
SERVERSINGLE, you must also specify
driver=TRUE, where driver is the name of a Connect
ODBC driver (see Table 2-3). In this case, you can
specify this argument only once; see “Example 2” on
page 46.
SERIALNUMBER=serial number value Provide the serial number for your purchased
product or enter EVAL to install an evaluation copy.

Connect ODBC Installation Guide

 Silent Installations 45

Table 2-3. Optional Silent Installation Arguments

Argument Description
BTRIEVE=TRUE Installs the Btrieve driver.
DB=TRUE Installs the DB2 Wire Protocol driver.
DBASE=TRUE Installs the dBASE driver.
DEFAULTDATA=TRUE Creates default data sources.
DRIVER=ALL Installs all the Connect ODBC drivers. You do not have to
list each driver individually if you use this argument. This
argument is required if you set the PRODUCTSELECTED
argument to either DESKTOPPACK or OEMPACK (see
Table 2-2).
EXCEL=TRUE Installs the Excel driver.
EXISTINGDRIVER=TRUE Overwrites existing Connect ODBC drivers.
FOXPRO=TRUE Installs the FoxPro driver.
INFORMIX=TRUE Installs the Informix and the Informix Wire Protocol
drivers.
ONLINEBOOKS=TRUE Installs the Online Books.
ORACLE=TRUE Installs the Oracle and Oracle Wire Protocol drivers.
PARADOX=TRUE Installs the Paradox driver.
PROGRESS=TRUE Installs the PROGRESS 9 driver.
SQLBASE=TRUE Installs the SQLBase driver.
SQLSERVER=TRUE Installs the SQL Server and SQL Server Wire Protocol
drivers.
SYBASEASE=TRUE Installs the Sybase Wire Protocol driver.
TEXT=TRUE Installs the Text driver.
XML=TRUE Installs the XML driver.

Connect ODBC Installation Guide

46 Chapter 2 Installation on Windows

Silent Installation Examples

The following examples illustrate some typical command-line
installations.

Example 1

This example installs a licensed copy of the Connect ODBC Pack

desktop version; creates default data sources; overwrites existing
drivers; installs the Online Books; creates an installation directory
named \Program Files\DataDirect\ODBC41, and creates a log file
named log.txt in the temp directory:

Setup.exe /s /v"PRODUCTSELECTED=DESKTOPPACK OPTION=PACK DRIVER=ALL

DEFAULTDATA=TRUE EXISTINGDRIVER=TRUE ONLINEBOOKS=TRUE INSTALLDIR=
\"C:\Program Files\DataDirect\ODBC41" CUSTOMER=\"John Doe\" COMPANY=
DataDirect SERIALNUMBER=12345 LICENSE=1234678 /qn /l*v D:\temp\log.txt"

Example 2

This example installs an evaluation copy of the Connect ODBC

Oracle drivers; creates default data sources; installs the Online
Books; creates an installation directory named \ODBC\Oracle, and
creates a log file named log.txt in the temp directory:

Setup.exe /s /v"PRODUCTSELECTED=DESKTOPSINGLE OPTION=SINGLE ORACLE=TRUE

DEFAULTDATA=TRUE ONLINEBOOKS=TRUE INSTALLDIR=C:\ODBC\Oracle CUSTOMER=\"John
Doe\" COMPANY=DataDirect SERIALNUMBER=EVAL LICENSE=EVAL /qn /l*v
D:\temp\log.txt"

Connect ODBC Installation Guide

 Configuring Drivers and Data Sources 47

Example 3

This example installs licensed copies of the DB2 Wire Protocol,

Oracle, and Oracle Wire Protocol drivers, and creates an
installation directory named \Program Files\Connect ODBC, and
creates a log file named odbclog.txt in the "odbc log" directory:

Setup.exe /s /v"PRODUCTSELECTED=DESKTOPPACK OPTION=PACK DB=TRUE ORACLE=TRUE

INSTALLDIR=\"C:\Program Files\Connect ODBC\" CUSTOMER=James COMPANY=\"Laser
Products\" SERIALNUMBER=12345 LICENSE=1234678 /qn /l*v \"C:\odbc
log\odbclog.txt\""

The Log File

The log file created during the installation can be read with a
text editor or word processor. Although the file can be very long,
the most important information is at the beginning and end.
The final lines of the log file indicate whether the installation
was successful. The initial lines reproduce all of the
command-line arguments that you entered. If there was a
failure, check the command-line entries closely to see if the
syntax is correct. DataDirect Technologies provides technical
support to help you interpret the log file if you encounter
problems.

Configuring Drivers and Data Sources

Before you can use a driver, you must configure a data source for
it. A data source consists of a data source name, driver location,
and optional driver information in the system information. Use
the ODBC Administrator to select an installed driver and then
configure a data source for it. Configuration instructions are
provided in the online help for each driver’s configuration
window and in the Connect ODBC Reference.

Connect ODBC Installation Guide

48 Chapter 2 Installation on Windows

Removing or Modifying the Installation

You can remove or modify your Connect ODBC installation
through the Add/Remove Programs option in the Control Panel
of the Windows Start menu.

Using the Remove Option

On all Windows platforms, the Remove option of the Connect
ODBC Setup deletes driver files and entries in the system
information.

NOTE for Windows 98 and Windows Me Users: If you create

default data sources for Connect ODBC drivers during installation
and then remove Connect ODBC, the default data sources are not
deleted from the Registry.

You should use the Remove option in the following

circumstances:

■ If you have an evaluation copy of the Connect ODBC Pack

installed and you want to install a licensed single driver, first
remove the evaluation copy of the Connect ODBC Pack. Then,
install a licensed single driver.

■ If you have a driver installed and want to install the same

driver in a different location, remove the installed driver.
Then, reinstall the driver in the new location.

To remove your Connect ODBC installation:

1 After opening Add/Remove Programs, select Connect ODBC

and click Add/Remove. This displays the Connect ODBC Setup
Welcome window. Click Next to display the Program
Maintenance window.

2 Select Remove, and then, click Next. The Remove the Program
window appears.

Connect ODBC Installation Guide

 Removing or Modifying the Installation 49

3 Click Remove.

4 On the Setup Completed window, click Finish.

Using the Modify Option

You should use the modify option in the following
circumstances:

■ If you have a licensed copy of the Connect ODBC Pack and

you have one driver installed and want to install an
additional driver.

WARNING: Do not install an evaluation copy of a single

driver if you already have a licensed copy of a single driver
installed. You must not mix licensed and evaluation copies of
drivers.

■ If you have one driver installed and want to install a different

driver. For example, if you have a single driver license and
installed the DB2 driver, and then, you decide you want to
install the Oracle driver instead.

■ If you have an evaluation copy of the Connect ODBC Pack

installed and you want to make it a licensed copy.

■ If you have an evaluation copy of a single driver installed and

you want to make it a licensed copy.

To modify your Connect ODBC installation:

1 After opening Add/Remove Programs, select Connect ODBC

and click Add/Remove. This displays the Connect ODBC Setup
Welcome window. Click Next to display the Program
Maintenance window.

Connect ODBC Installation Guide

50 Chapter 2 Installation on Windows

2 Select Modify on the Program Maintenance window. Then,

click Next to continue. The Product Selection window
appears.

3 On the Product Selection window, click the product that you

want to install.

■ Desktop:

• Single Driver: An end-user version for a single Connect

ODBC driver. This enables connectivity to one database
from a desktop workstation.
• Driver Pack: An end-user version for the entire set of
Connect ODBC drivers. This enables connectivity to all
supported databases from a desktop workstation. Even
if you do not want to install all drivers, select this
option to be able to install more than one driver.
■ Server Single Driver: A server version for a single Connect
ODBC driver. This enables connectivity to one database
from an application or Web server.

■ OEM Embedding Driver Pack: An OEM version designed

exclusively for embedding use by commercial software
and database vendors. This includes the entire set of
Connect ODBC drivers to enable connectivity to all
supported databases from a development environment.
Even if you do not want to install all drivers, select this
option to be able to install more than one Connect OEM
driver.

Then, click Next to continue. The Options Available window

appears.

Connect ODBC Installation Guide

 Removing or Modifying the Installation 51

4 On the Options Available window, select one, both, or

neither of the following check boxes:

■ Replace Existing Drivers. Removes the old ODBC driver

definitions from the HKEY_LOCAL_MACHINE odbcinst
drivers list. If you have other system DSNs or user DSNs
that refer to these old definitions, those DSNs will no
longer work.

■ Create Default Data Sources. Defines a data source name

in your system information for each Connect ODBC driver
that you install.

WARNING: These default data source names may overwrite

some of the data source names already in the system
information.

Then, click Next. The Browse for Installation Directory

window appears.

5 Do not change the driver installation directory. Otherwise,

the Modify option will fail. Click Next. The Custom Setup
window appears.

6 On the Custom Setup window, choose the Connect ODBC

features that you want to install and deselect any features
that you do not want to install. (When this window appears,
the Connect ODBC features that you currently have installed
are selected.)

There are two icons for the two main features listed in the
left display pane of the window: Online Books and All ODBC
Drivers. Each individual driver icon is listed as a subfeature of
the All ODBC Drivers icon. Initially, all icons display a red X,
which means that the feature will not be installed.

Online Books: If you want to install the Online Books, click

the drop-down arrow in the icon and select "This feature will

Connect ODBC Installation Guide

52 Chapter 2 Installation on Windows

be installed on local hard drive." The red X disappears from

the icon.

For more information about the Online Books, see Chapter 4

“Installing and Viewing Online Books” on page 67.

All ODBC Drivers: If you want to install ODBC drivers, perform

one of the following actions:

■ To install all ODBC drivers, click the drop-down arrow in

the All ODBC Drivers icon and select "This feature, and all
subfeatures, will be installed on local hard drive." The red
X disappears from the All ODBC Drivers icon, as well as
from the individual driver icons.

■ To install selected ODBC drivers, click the drop-down

arrow in the icon for each driver that you want to install
and select "This feature will be installed on local hard
drive." The red X disappears from the individual driver
icon(s), as well as from the All ODBC Drivers icon. If you
have selected individual driver icons, do not make a
selection under the All ODBC Drivers icon.

The Custom Setup window also has two additional buttons:

Help: Provides help on determining the install state of a

feature.

Space: Displays the amount of space available on your drives

and indicates whether this is sufficient for installation of the
selected features.

After configuring the features for installation, click Next. The

Licensing Information window appears.

Connect ODBC Installation Guide

 For More Information 53

7 In the appropriate fields of the Licensing Information

window, enter your name and the company name. Then,
perform one of the following actions:

■ If you are installing a licensed copy of the product, enter

the serial number and key provided to you by DataDirect
Technologies.

■ If you are installing an evaluation copy of the product,

enter EVAL in the Serial field and Key field.

Then, click Next.

■ If you entered the correct data on the licensing

information window, the Ready To Modify window
appears. Click Install.

■ If you entered incorrect data or left any fields blank, you

receive an error message. Click OK; you are returned to
the Setup window that allows you to correct your error.

8 On the Setup Completed window, click Finish.

For More Information

We recommend that you read the README text file that
accompanies the product for current information regarding the
release.

Connect ODBC Installation Guide

54 Chapter 2 Installation on Windows

Connect ODBC Installation Guide

 55

3 Installation on UNIX

DataDirect Connect ODBC includes a Setup program that enables

you to install the product from either a CD or an electronic site.

This chapter describes the procedure for installing Connect

ODBC drivers on Solaris, AIX, HP-UX, and Linux.

Before You Install

Before you start installation:

■ Verify that you have write privileges for the installation

directory.

■ Verify that your system meets the driver’s requirements for a

database before you install the driver. The driver will not
work if these requirements are not met. Refer to “Driver
Requirements” on page 17 for a list of database
requirements.

Connect ODBC Installation Guide

56 Chapter 3 Installation on UNIX

System Requirements
The following are system requirements for using Connect ODBC
drivers on AIX, HP-UX, Solaris, and Linux. Refer to the Connect
ODBC Reference for further details.

AIX
■ 25 MB of available hard disk space
■ AIX 4.3.3 and higher operating system with the 5.0.2.0 C++
runtime libraries
■ CSet++ 5.0 compiled application
■ AIX native threading model built application

HP-UX 11 aCC
■ 25 MB of available hard disk space
■ HP-UX 11 and 11i operating system
■ HP aCC (3.05 or higher) compiled application

Solaris
■ 25 MB of available hard disk space
■ Sun SPARCstation
■ Solaris 7 and 8 operating system
■ Forte C++ version 6 compiled application
■ Solaris native (kernel) threading model built application

Linux
■ 25 MB of available hard disk space
■ The following Linux distributions are supported:
• Red Hat Linux 6.2, 7.1, and 7.2
• Caldera OpenLinux 2.3 and 3.1
• SuSE Linux 6.4 and 7.3
■ Intel x86 machine

Connect ODBC Installation Guide

 Installing from a CD 57

■ g++ GNU project C++ Compiler (egcs-2.91.66) compiled

application
■ Linux native pthread threading model (Linuxthreads) built
application

Default Installation Directories

The Setup program lets you specify the directory into which the
drivers are installed. By default, the Setup program creates and
installs the drivers in the directory:

/opt/odbc

Installing from a CD
NOTE: The following steps reflect the messages displayed when
installing on Solaris. If you are installing on a different UNIX
platform version, the name of that platform is substituted.

To install Connect ODBC drivers from a CD:

1 Insert the CD into the CD drive. On Solaris, by default the
CD-ROM drive mounts automatically when you insert the CD.
The other UNIX platforms supported do not automatically
mount the CD by default. If your workstation is not
configured to automatically mount a CD, you must enter the
command for mounting the drive, as follows.

■ For HP-UX, enter:

# mount -F cdfs -o cdcase device mount_point

where device is the device name assigned to your
CD-ROM drive. The device name can be found using the
HP-UX tool sam.

Connect ODBC Installation Guide

58 Chapter 3 Installation on UNIX

For example, if the device name for your CD-ROM drive is

/dev/dsk/c0t4d0 and you want to mount it over the
directory /cdrom, you would enter the following
command:
# mount -F cdfs -o cdcase /dev/dsk/c0t4d0 /cdrom
■ For IBM-AIX, enter:

# mount -r -v cdrfs /dev/device /cdrom

where device is the device name assigned to your CD-ROM
drive. The device name can be found using the AIX tool
smit.
■ For Linux, enter:

# mount -r -t iso9660 /dev/device /mnt/cdrom

where device is the device name assigned to your CD-ROM
drive.
2 To run Product Setup, change to the top-level directory on the
CD and start the following installation script:

# ksh unixmi.ksh
Product Setup prompts you to answer questions regarding
the installation. Default answers for the questions are
displayed in square brackets at the end of the prompt. To
accept the default value, press ENTER.

3 Product Setup prepares for installation by determining your

UNIX operating system:

The following operating system has been detected:

Solaris

Is this the current operating system on your

machine(Y/N)?[Y]

Connect ODBC Installation Guide

 Installing from a CD 59

■ Press ENTER if Setup has detected the correct operating

system and go to the next step.

■ Enter N if Setup did not detect the correct operating

system. The installation will be cancelled.

4 If you accept the operating system that Setup detects, a

Product Selection prompt appears, listing the products that
you can choose to install:

■ App Server—Driver Pack: A server version for the entire

set of Connect ODBC drivers. This enables connectivity to
all supported databases from an application or Web
server.

■ App Server—Single Driver: A server version for a single

Connect ODBC driver. This enables connectivity to one
database from an application or Web server.

■ Online Books: The Connect ODBC documentation set in

Adobe .PDF format. For more information about the
Online Books, see Chapter 4 “Installing and Viewing
Online Books” on page 67.

Enter the list number of the product you want to install.

5 The action you perform in this Step depends on the selection

you made in Step 4.

■ If you did not choose to install Online Books in Step 4, the

next prompt, asks whether or not you want to install the
Connect ODBC Online Books.

• Enter Y to install the Online Books.

• Enter N to not install the Online Books.
■ If you did choose to install Online Books in Step 4,
complete Step 6 and then move directly to Step 12.

The Online Books are installed in a directory named books

beneath the installation directory, for example,
/opt/odbc/books.

Connect ODBC Installation Guide

60 Chapter 3 Installation on UNIX

6 At the next prompt, enter the full path to the temporary

installation directory. The default is /tmp. The directory you
specify must already exist.

7 The Product Registration prompt requests the following

information, one field at a time:

■ Your name
■ Your company name
■ Serial number
■ IPE Key

Enter your name and the company name. Then, perform one
of the following actions:

■ If you are installing a licensed copy of the product, enter

the serial number and IPE key provided to you by
DataDirect Technologies.

■ If you are installing an evaluation copy of the product,

enter EVAL for the serial number and leave the IPE key
blank.

8 Setup displays the product registration information that you

just entered, and you are prompted to accept or change the
information:

■ Press ENTER to accept the information.

■ Enter C to change the information. You are prompted for

the information again.

9 After you accept the registration information, a DataDirect

product license agreement appears. You are asked to accept
the agreement:

■ Enter YES to accept the license agreement and continue

with the installation.

■ Enter anything other than YES to stop the installation.

Connect ODBC Installation Guide

 Installing from a CD 61

10 After entering YES, one of the following occurs:

■ If you are installing a licensed copy of the product and

have entered the correct IPE key, Setup proceeds
immediately to Step 11.

■ If you are installing a licensed copy of the product and

have entered an incorrect IPE key, you see a message.

• Enter C to re-enter the IPE key. If you re-enter an

incorrect key, Setup automatically installs an
evaluation copy of the product.
• Press ENTER instead to install an evaluation copy of the
product.
• Enter E to exit.
■ If you are installing an evaluation copy of the product,
you see a message. Press ENTER to continue with the
installation.

11 After Step 10, one of the following occurs:

■ If this is a single driver installation for a driver other than

DB2 for OS/390, a list of drivers is displayed. Enter the list
number of the ODBC driver you want to install.

■ If this is a Driver Pack installation or a DB2 for OS/390

single driver installation, Setup proceeds to Step 12.

12 You are prompted to enter the full path to the installation

directory. The default is /opt/odbc. This cannot be the same
directory as the temporary installation directory. If the
directory you enter does not exist, Setup creates it.

After completion of the CD installation, a message appears

indicating that you have installed the software successfully. You
are then asked if you want to install another product:

■ Press ENTER to install another product.

■ Enter N to exit Product Setup.

Connect ODBC Installation Guide

62 Chapter 3 Installation on UNIX

After installation, you must configure drivers and data sources;

see “Configuring Drivers and Data Sources” on page 64 for
details.

Installing from Downloaded Files

DataDirect has several Connect ODBC product packages available
for either purchase or evaluation via its download site on the
World Wide Web (http://www.datadirect-technologies.com).
Installation of any of these packages follows essentially the same
procedure as installation from a CD.

To install DataDirect Connect ODBC drivers from downloaded

files:

1 Download the appropriate Connect ODBC product

compressed file from the electronic site into a temporary
directory, for example, /tmp.

IMPORTANT: Do not download the Connect ODBC product

compressed file to the installation directory that you will
specify during the installation.

2 Switch to the temporary directory and uncompress the

contents of this file. Enter:

uncompress compressed_filename

where compressed_filename is the name of the file you

downloaded, for example, solaris.tar.Z in the case of Solaris.
The file is renamed to solaris.tar as part of uncompression.

3 Untar the contents of this file. Enter:

tar -xvf tar_filename

In the case of Solaris, tar_filename is solaris.tar.

The untarred files appear in the temporary directory.

Connect ODBC Installation Guide

 Installing from Downloaded Files 63

4 To run the installation script, enter ksh unixpi.ksh from the

platform directory in the temporary directory, where
platform is either: solaris, hp11, aix, or linux.

5 Setup determines which UNIX operating system you have:

The following operating system has been detected:

Solaris

Is this the current operating system on your

machine(Y/N)?[Y]
■ Press ENTER if Setup has detected the correct operating
system and go to the next step.

■ Enter N if Setup did not detect the correct operating

system. The installation will be cancelled.

6 If you accept the operating system that Setup detects, a

Product Selection prompt appears, listing the products that
you can choose to install.

■ App Server—Driver Pack: A server version for the entire

set of Connect ODBC drivers. This enables connectivity to
all supported databases from an application or Web
server.

■ App Server—Single Driver: A server version for a single

Connect ODBC driver. This enables connectivity to one
database from an application or Web server.

■ Online Books: The Connect ODBC documentation set in

Adobe .PDF format. For more information about the
Online Books, see Chapter 4 “Installing and Viewing
Online Books” on page 67.

Enter the list number of the product you want to install.

Connect ODBC Installation Guide

64 Chapter 3 Installation on UNIX

7 The action you perform in this Step depends on the selection

you made in Step 6.

■ If you did not choose to install Online Books in Step 6, the

next prompt asks whether or not you want to install the
Connect ODBC Online Books.

• Enter Y to install the Online Books.

• Enter N to not install the Online Books.
■ If you did choose to install Online Books in Step 6, move
directly to Step 12 under "Installing from a CD."

The Online Books are installed in a directory named books

beneath the installation directory, for example,
/opt/odbc/books.

8 To complete installation, follow Step 7 through Step 12 in the

section "Installing from a CD."

Configuring Drivers and Data Sources

Before you can use an installed driver, you must configure a data
source for the driver. A data source consists of a data source
name, driver location, and optional driver information in the
system information. See the appropriate driver chapter in the
Connect ODBC Reference.

NOTE: Not all drivers and not all supported databases are
available on UNIX platform versions.

Connect ODBC Installation Guide

 For More Information 65

For More Information

We recommend that you read the README text file that
accompanies the product for current information regarding the
release.

Connect ODBC Installation Guide

66 Chapter 3 Installation on UNIX

Connect ODBC Installation Guide

 67

4 Installing and Viewing Online

Books

The DataDirect CD and the DataDirect Technologies Web site

provide online books for the DataDirect Product Series. In
addition, they provide Adobe Acrobat Reader, which is required
to view the online books.

This chapter explains how to:

■ Install the online books without using a product installer

■ View the online books
■ Customize the online books
■ Install Acrobat Reader from the CD

NOTE: Instructions for downloading the online books and

Acrobat Reader from the Web are provided on the DataDirect
Web site.

About DataDirect’s Online Books

You can view the online books from the CD or install them to a
local or network location. You must view the online books using
Acrobat Reader 3.x, or later, licensed from Adobe Systems. The
DataDirect CD includes Acrobat Reader 4.x with Search.

You can print the online books to create high-quality, hard-copy

books. While viewing an online book in the Acrobat Reader,
select File / Print to print the entire file (book), the current page,
or a range of pages.

Connect ODBC Installation Guide

68 Chapter 4 Installing and Viewing Online Books

Installing the Online Books

If you want to install the online books without using a product
installer, you must maintain the same directory structure that is
on the CD. You can install all the online books or specific ones:

■ To install all product books, copy the entire \books directory

to your local or network drive.

■ To install a specific set of books, copy that book’s directory

structure (beneath the \books directory) to your local or
network drive. For example, to install the Connect
ODBC books, you would copy the entire odbc directory
beneath the books directory (\books\odbc).

Viewing the Online Books

To help you navigate through a DataDirect product’s online
books, an Acrobat file, called books.pdf, is provided. This file lists
each online book provided for a product. We recommend that
you open this file first and, from this file, open the book you
want to view.

If you want to keep the books.pdf file open until you choose to
close it, go to the Reader menu bar and select File / Preferences /
General. Clear the check box for the Open Cross-Document Links
in Same Window option.

NOTE: If you do not already have Acrobat Reader installed, you

must install it before you can view the books. See "Installing
Acrobat Reader" on page 74 for details.

Connect ODBC Installation Guide

 Viewing the Online Books 69

To view the online books:

1 Start Acrobat Reader in one of the following ways:

■ For Windows, click Start on the Taskbar and select

Programs. Select the Adobe Acrobat folder that was
created during the installation of the Acrobat Reader,
and click the Acrobat Reader icon.

■ For UNIX, you can start the Reader from the command
line by using its launch script:

• If the launch script directory is in the search path set by

the PATH environment variable, type the following to
start Acrobat Reader:
% acroread
• If the launch script directory is not set in the PATH
environment variable, type:
% /acrobatreaderinstalldir/bin/acroread
2 On the Reader menu bar, select File / Open, and choose the
path where the books.pdf file resides. For example, for
SequeLink:

D:\Program Files\DataDirect\slodbc51\books\slnk\books.pdf

or for Connect ODBC:

D:\Program Files\DataDirect\books\odbc\books.pdf

3 Click Open.

While viewing the online books, you can use hypertext links,
perform text searches, and use bookmarks.

Connect ODBC Installation Guide

70 Chapter 4 Installing and Viewing Online Books

Using Hypertext Links

Cross-reference links within online books allow you to jump to
related topics and other books within a product’s documentation
set. These links are displayed in blue and allow you to jump to a
cross reference with a single click of the mouse. Some links take
you to a URL on DataDirect’s World Wide Web site (if you have an
HTML browser installed on your computer). The page numbers in
the table of contents and index are also hypertext links.

Performing Text Searches

With Acrobat Reader with Search, you can perform full-text,
boolean searches across all of a product’s online books. You type
a query and Acrobat Reader displays the matching text.

NOTE: If you will be performing searches across online books on

the CD over a non-UNIX network, you must explicitly map to the
network drive that contains the CD to enable the Search tool.

The search indexes for DataDirect online books were created

with the word stemming search option. This option finds words
that share a stem with a search word. For example, if you search
for “programming,” the Reader will also find “program” and
“programs.” The search indexes were not created using the
Sounds Like and Case Sensitive options. Therefore, you cannot
use these options when searching online books. Finally, numbers
are not included in the search index and will not be found by a
search.

Using Bookmarks
All of the online books contain predefined bookmarks that make
it easy for you to quickly jump to a specific topic. By default, the
bookmarks are displayed to the left of each online book. For

Connect ODBC Installation Guide

 Customizing the Online Books 71

more information about using Acrobat Reader, refer to the

online help for the product.

Customizing the Online Books

If you have Adobe Acrobat Exchange 3.0 or higher, you can
customize the online books to reflect information specific to
your work environment. For example:

■ Notes. You can embed notes within an online book to help

identify important procedures or helpful hints specific to
your organization. A note appears in the online books as a
note icon; double-click the icon to view the embedded note
text.

■ Bookmarks. You can also add customized bookmarks to an

online book to help you find topics even faster. Bookmarks
can be used to jump to topics within a book, or to other PDF
files.

For specific instructions on how to customize a book, refer to the

Acrobat documentation.

About Acrobat Reader

You must view the online books using Acrobat Reader 3.x, or
later, licensed from Adobe Systems. This CD includes the English
version of Acrobat Reader 4.x with Search for the following
platforms: Windows 9x, Windows NT, Windows 2000, Solaris,
IBM-AIX, and HP-UX. The CD also includes Acrobat Reader 4.x
without search for the Linux platform; Acrobat Reader 4.x with
Search is not available at this time on Linux.

Connect ODBC Installation Guide

72 Chapter 4 Installing and Viewing Online Books

DataDirect Technologies software products may support

platforms that are not supported by the Reader. To view the
online books for these products, you must do so on a platform
that the Reader does support.

NOTE: For the latest information about supported platforms for

Acrobat Reader, refer to the Adobe Web site at:

http://www.adobe.com/prodindex/acrobat/readstep.html

Product Requirements for Acrobat Reader 4.x

Windows Platforms
■ 486 or Pentium processor-based personal computer

■ Microsoft Windows 9x, Windows NT 4.0 with Service Pack 3 or

later, Windows 2000

■ 10 MB of RAM for Windows 9x (16 MB recommended); 16 MB

of RAM for Windows NT and Windows 2000 (24 MB
recommended)

■ A hard disk with at least 10 MB of free disk space

■ CD-ROM drive, locally or on a network

Sun SPARCstation Workstations

■ Solaris 2.3 or later operating system (Acrobat Reader will not
run on SunOS, Solaris 2.0, 2.1, or 2.2)

■ Sun OpenWindows 3.0 or later, Motif 1.2.3 or later, OpenLook

3.0, or Common Desktop Environment (CDE) 1.0 or later

■ A hard disk with at least 12 MB of free disk space

Connect ODBC Installation Guide

 Product Requirements for Acrobat Reader 4.x 73

■ 32 MB of RAM

■ CD-ROM drive, locally or on a network

HP Workstations
■ HP 9000 Series Workstations model 700 or 800

■ HP-UX 9.0.3 or later operating system

■ X Window System X11R5 running HP-VUE or Common

Desktop Environment (CDE) 1.0 or later

■ 32 MB of RAM

■ A hard disk with at least 12 MB of free disk space

■ CD-ROM drive, locally or on a network

IBM-AIX Workstations
■ RS/6000 workstation

■ AIX 4.2.1 or later operating system

■ Common Desktop Environment (CDE) 1.0 or later, or Motif

■ 32 MB of RAM

■ A hard disk with at least 12 MB of free disk space

■ CD-ROM drive

Linux
■ Red Hat Linux 5.1 or later (non-glibc versions)

■ 32 MB of RAM

■ A hard disk with at least 12 MB of free disk space

Connect ODBC Installation Guide

74 Chapter 4 Installing and Viewing Online Books

Installing Acrobat Reader

The CD contains Acrobat Reader 4.x. To view the online books,
you must have Acrobat Reader 3.x or later installed on a local or
network location. You cannot start the Reader directly from the
CD. If you already have a copy of the correct version of Acrobat
Reader with Search installed on your machine, you can skip the
procedure documented in this section.

Network Administrators: To allow users to install Acrobat Reader

from a network location, copy the entire \Readers\platform
directory and its contents from the CD into a directory on the
network server.

Windows Platforms
The instructions to install the Reader are the same whether you
install it locally or to the network.

To install Acrobat Reader:

1 Insert the DataDirect CD into the CD-ROM drive. If the
CD-ROM drive is on a network, you must mount the CD and
create a mapping to the CD-ROM drive.

2 Start the Setup program as follows, substituting the

appropriate CD-ROM drive letter if necessary.

From Windows Explorer, navigate to the drive and directory

containing the Reader; then, double-click the self-extracting
program:

drive:\Readers\Windows\rs405eng.exe
3 Follow the on-screen instructions to complete the installation.

Connect ODBC Installation Guide

 Installing Acrobat Reader 75

UNIX Platforms
To install Acrobat Reader on UNIX:
1 Insert the CD into the CD-ROM drive.

2 Mount the drive on a local workstation as a file system.

NOTE: To mount a CD-ROM drive, you must know your

system’s root password. If you do not know the password,
contact your system administrator.

The following examples assume that the /cdrom mount point

is available on your UNIX system. If not, replace /cdrom with
a valid mount point.

a Open a UNIX shell.

b Change to the root user and type the root password:

# su - root
Password: root_password
c On Solaris, by default the CD-ROM drive mounts
automatically when you insert the CD. The other UNIX
platforms supported do not automatically mount the CD
by default. If your workstation is not configured to
automatically mount a CD, you must enter the command
for mounting the drive.

• For HP-UX, enter:

# mount -F cdfs -o cdcase device mount_point
where device is the device name assigned to your
CD-ROM drive. The device name can be found using
the HP-UX tool sam.
For example, if the device name for your CD-ROM
drive is /dev/dsk/c0t4d0 and you want to mount it over
the directory /cdrom, you would enter the following
command:
# mount -F cdfs -o cdcase /dev/dsk/c0t4d0 /cdrom

Connect ODBC Installation Guide

76 Chapter 4 Installing and Viewing Online Books

• For IBM-AIX, enter:

# mount -r -v cdrfs /dev/device /cdrom
where device is the device name assigned to your
CD-ROM drive. The device name can be found using
the AIX tool smit.
• For Linux, enter:
# mount -r -t iso9660 /dev/device /mnt/cdrom
where device is the device name assigned to your
CD-ROM drive.
3 Verify that the drive containing the CD is mounted by
entering:

# mount
You should see a list of mounted file systems, including the
CD-ROM drive you just mounted.

4 Copy the appropriate Acrobat Reader compressed file (.Z file)

from the CD to your UNIX machine:

■ For AIX, /readers/Aix/AIXRS.tar.Z

■ For HP-UX, /readers/Hpux/HPUXRS.tar.Z
■ For Linux, /readers/Linux/ILINXR.tar.Z
■ For Solaris, /readers/Solaris/SSOLR.tar.Z

5 Uncompress the file by entering:

uncompress compressed_filename
6 Untar the .tar file that was extracted from the compressed
file:

tar -xvf filename.tar

7 Use the instructions in the Instguid.txt file to complete the
Acrobat Reader installation. This file is one of the files that
was extracted from the .tar file.

Connect ODBC Installation Guide

 77

Index

A default installation directory

on UNIX 57
on Windows 33
Acrobat Reader documentation
about 71 customizing online books 71
installing 74 installing online books 68
product requirements 72 order form 12
AIX. See UNIX ordering printed books 11
printing online books 67, 71
viewing online books 68
downloaded files, installing from 38, 62
B driver requirements
Btrieve 17
before you install DB2 Wire Protocol 18
on UNIX 55 dBASE 18
on Windows 31 Excel Workbook 18
bookmarks, using 70 Informix 19
Btrieve driver requirements 17 Informix Wire Protocol 20
Oracle 20
Oracle Wire Protocol 23
Paradox 23
C PROGRESS 9 24
SQL Server 24
command-line syntax for silent installation SQL Server Wire Protocol 25
41 SQLBase 24
configuring drivers and data sources Sybase Wire Protocol 26
on UNIX 64 Text 26
on Windows 47 XML 26
contacting Technical Support 13
customizing online books 71

E
D Excel Workbook driver requirements 18

databases supported 27
DB2 Wire Protocol driver requirements 18
dBASE driver requirements 18

Connect ODBC Installation Guide

78 Index

H O
help, online 10 online books
HP-UX. See UNIX customizing 71
hypertext links, using 70 installing 68
order form 12
printing 67, 71
viewing 68
I operating systems supported 28
Oracle driver requirements 20
Informix driver requirements 19 Oracle Wire Protocol driver requirements 23
Informix Wire Protocol driver requirements ordering printed books 11
20
installing online books 68
installing the drivers
from a CD P
on UNIX 57
on Windows 33 Paradox driver requirements 23
from a network directory 39 parameters and arguments for silent
from downloaded files installation 42
on UNIX 62 performing text searches 70
on Windows 38 printed books, order form 12
on UNIX 57 printing online books 67, 71
on Windows 33 PROGRESS 9 driver requirements 24

L R
Linux. See UNIX removing the installation 48
log file 47

S
M
silent installation
modifying the installation 48 command-line syntax 41
examples 46
log file 47
overview 40
N parameters and arguments 42
Solaris. See UNIX
network directory, installing from 39 SQL Server driver requirements 24

Connect ODBC Installation Guide

 Index 79

SQL Server Wire Protocol driver

requirements 25
W
SQLBase driver requirements 24
SupportLink 13 Web install 38, 62
Sybase Wire Protocol driver requirements 26 Windows
system requirements before you install 31
for UNIX 56 default installation directory 33
for Windows 32 driver requirements 17
installing from a CD 33
installing from a network directory 39
installing from downloaded files 38
T system requirements 32

Technical Support, contacting 13

Text driver requirements 26
text searches, performing 70
X
XML driver requirements 26

U
uninstalling 48
UNIX
before you install 55
default installation directories 57
driver requirements 17
installing from a CD 57
installing from downloaded files 62
system requirements 56
using
bookmarks 70
hypertext links 70

V
viewing online books 68

Connect ODBC Installation Guide

80 Index

Connect ODBC Installation Guide