IBM Informix
|
Installation Notes for IBM Informix JDBC Driver
|
|
3.50.JC6, December 2009
|
|
This file contains instructions for installing and uninstalling
|
IBM® Informix® JDBC Driver 3.50.JC6.
|
|
|
JDK REQUIREMENT
|
_____________________________
|
|
To use IBM Informix JDBC Driver Version 3.50.JC6, you must use a
|
JDK 1.4.2 or later package on your platform.
|
|
|
|
OBTAINING THE JDBC DRIVER
|
_____________________________
|
|
You can obtain the IBM Informix JDBC Driver from the IBM Informix JDBC
|
Driver product CD, from the JDBC directory of the IBM Informix product
|
bundle CD, or you can download the driver
|
from http://www.ibm.com/software/data/informix/tools/jdbc
|
|
The CD or Web site download contain the following files:
|
|
* setup.jar
|
* doc/jdbcrel.htm
|
* doc/install.txt (this file)
|
* doc/patchinfo.htm
|
|
The setup.jar file is the IBM Informix JDBC Driver installation program.
|
|
The documentation directory, <dir>/doc, contains the release notes file in HTML
|
format. Refer to this document for any new information that is not
|
available in the manual.
|
|
|
|
INSTALLING THE JDBC DRIVER
|
_____________________________
|
|
Prerequisites:
|
|
If you downloaded the IBM Informix JDBC Driver as .zip file from the Web
|
site, unzip the file to a directory.
|
|
If you are installing the driver from a CD, load the CD into the CD-ROM
|
drive.
|
|
|
INSTALLING JDBC DRIVER IN GRAPHICAL OR CONSOLE MODE
|
|
1. From a command prompt, start the installation program by using one of
|
the following commands:
|
* To start in graphical mode:
|
java -cp <dir>/setup.jar run
|
|
* To start in console mode:
|
java -cp <dir>/setup.jar run -console
|
|
Where <dir> is the location of the setup.jar file.
|
|
If you want to log information during the installation, also
|
specify the -log parameter. See LOGGING INSTALLATION EVENTS
|
for information about the arguments that you can use with this
|
parameter.
|
|
2. Read the license agreement and accept the terms. Respond to the
|
prompts as the installation guides you.
|
|
3. When prompted, accept the default directory or specify a different
|
directory.
|
|
On a Windows platform, the default directory is:
|
|
C:\Program Files\IBM\Informix_JDBC_Driver
|
|
To prevent errors in installation and uninstallation, do not use an
|
exclamation point character (!) in the installation path.
|
|
4. When prompted, verify the location of the installation path.
|
|
The installer installs the JDBC driver and notifies you that an
|
uninstaller is being added to the installation directory.
|
|
Note: If the installation stalls when connected to an NFS-mounted
|
file system, you should first try resolving NFS issues. In some
|
cases, unmounting and remounting the share can resolve the
|
issue. Otherwise, forcefully terminate the installation, clean
|
up any orphaned processes, and restart the installation.
|
|
5. Specify Finish when you see this message:
|
InstallShield Wizard has successfully installed IBM Informix JDBC Driver.
|
|
|
INSTALLING INFORMIX JDBC DRIVER IN SILENT MODE
|
|
From a command prompt, run the following command:
|
|
java -cp <dir>/setup.jar run -silent -P product.installLocation=<destination-dir> -G licenseAccepted=true
|
|
Where:
|
|
<dir> is the location of setup.jar file.
|
|
<destination-dir> is the directory where you want to install the JDBC
|
Driver.
|
|
The installation is complete when the command has finished executing.
|
|
If you want to log information during the installation, also specify the
|
-log parameter. See LOGGING INSTALLATION EVENTS for information
|
about the arguments that you can use with this parameter.
|
|
|
|
LOGGING INSTALLATION EVENTS
|
_____________________________
|
|
You can enable logging by specifying the -log option when you run the
|
command to install the driver. The -log option takes arguments for
|
file type, event type, and file location. For example, to install the
|
IBM Informix JDBC Driver in graphical mode and retain a log of the
|
events, run the following command:
|
|
java -cp setup.jar run -log #![filename] @[event type];[event type]
|
|
Where:
|
|
# echoes the display to standard output.
|
|
![filename] is the name for the log file. You can omit the [filename]
|
argument to save the log information to the default file name.
|
|
@<event type> is the event type that you want to log.
|
|
Following are the arguments and their associated event types:
|
|
Argument Event Type
|
|
err Errors
|
|
wrn Warning
|
|
msg1 Primary events
|
|
msg2 Secondary events
|
|
dbg Debug events
|
|
ALL All events
|
|
NONE Disables logging and clears the log file
|
|
|
LOGGING EXAMPLES
|
|
The following command installs IBM Informix JDBC Driver in the graphical
|
mode and logs all events to /tmp/jdbcinstall.log:
|
|
java -cp setup.jar run -log !/tmp/jdbcinstall.log @ALL
|
|
The following command installs IBM Informix JDBC Driver in silent mode
|
and logs error events to /tmp/jdbcinstall.log:
|
|
java -cp setup.jar run -silent -P product.installLocation=< > -log
|
!"/tmp/jdbcinstall.log" @err
|
|
|
|
UNINSTALLING THE JDBC DRIVER
|
_____________________________
|
|
When you install IBM Informix JDBC Driver, the installation program
|
creates an uninstall package in the directory in which you installed the
|
JDBC Driver. Uninstalling IBM Informix JDBC Driver completely removes
|
the driver and all of its components from your computer.
|
|
The following section describes how to uninstall IBM Informix JDBC
|
Driver on all platforms.
|
|
Tip: If the <destination-dir> in which you installed the IBM Informix
|
JDBC Driver includes spaces in its pathname, enclose the entire
|
pathname in quotation marks when executing the uninstall command.
|
|
|
UNINSTALLING IN GRAPHICAL OR CONSOLE MODE
|
|
Run one of the following commands to start the uninstall program, where
|
<destination-dir> is the directory in which you installed the IBM
|
Informix JDBC Driver:
|
|
To start in graphical mode:
|
|
java -cp <destination-dir>/_uninst/uninstall.jar run
|
|
To start in console mode:
|
|
java -cp <destination-dir>/_uninst/uninstall.jar run -console
|
|
Follow the prompts to uninstall the JDBC driver.
|
|
|
UNINSTALLING IN SILENT MODE
|
|
Run the following command to start the uninstall program in silent mode,
|
where <destination-dir> is the directory in which you installed the IBM
|
Informix JDBC Driver:
|
|
java -cp <destination-dir>/_uninst/uninstall.jar run -silent
|
|
The Uninstall program does not send you any messages but uninstalls the
|
driver in silent mode.
|
|
_____________________________
|
|
CONTACT SUPPORT:
|
http://www.ibm.com/software/data/informix/ids/support/
|
|
_____________________________
|
|
NOTICES:
|
This information was developed for products and services offered in the U.S.A.
|
|
IBM® may not offer the products, services, or features discussed in this document in other countries.
|
Consult your local IBM representative for information on the products and services currently available in your area.
|
Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product,
|
program, or service may be used. Any functionally equivalent product, program, or service that does not infringe
|
any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and
|
verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications
|
covering subject matter described in this document. The furnishing of this document does not grant you any license to
|
these patents. You can send license inquiries, in writing, to:
|
|
IBM Director of Licensing
|
IBM Corporation
|
North Castle Drive
|
Armonk, NY 10504-1785
|
U.S.A.
|
For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department
|
in your country or send inquiries, in writing, to:
|
|
Intellectual Property Licensing
|
Legal and Intellectual Property Law
|
IBM Japan Ltd.
|
1623-14, Shimotsuruma, Yamato-shi
|
Kanagawa 242-8502 Japan
|
|
The following paragraph does not apply to the United Kingdom or any other country where such provisions are
|
inconsistent with local law:
|
|
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND,
|
EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT,
|
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or
|
implied warranties in certain transactions, therefore, this statement may not apply to you.
|
|
This information could include technical inaccuracies or typographical errors. Changes are periodically made
|
to the information herein; these changes will be incorporated in new editions of the publication. IBM may make
|
improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.
|
|
Any references in this information to non-IBM Web sites are provided for convenience only and do not in any
|
manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials
|
for this IBM product and use of those Web sites is at your own risk.
|
|
IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring
|
any obligation to you.Licensees of this program who wish to have information about it for the purpose of enabling:
|
(i) the exchange of information between independently created programs and other programs (including this one) and
|
(ii) the mutual use of the information which has been exchanged, should contact:
|
|
IBM Corporation
|
J46A/G4
|
555 Bailey Avenue
|
San Jose, CA 95141-1003
|
U.S.A.
|
|
Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.
|
|
The licensed program described in this document and all licensed material available for it are provided by IBM under
|
terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.
|
|
Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained
|
in other operating environments may vary significantly. Some measurements may have been made on development-level
|
systems and there is no guarantee that these measurements will be the same on generally available systems.
|
Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary.
|
Users of this document should verify the applicable data for their specific environment.
|
|
Information concerning non-IBM products was obtained from the suppliers of those products, their published
|
announcements or other publicly available sources. IBM has not tested those products and cannot confirm the
|
accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities
|
of non-IBM products should be addressed to the suppliers of those products.
|
|
All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice,
|
and represent goals and objectives only.
|
|
All IBM prices shown are IBM's suggested retail prices, are current and are subject to change without notice.
|
Dealer prices may vary.
|
|
This information is for planning purposes only. The information herein is subject to change before the products
|
described become available.
|
|
This information contains examples of data and reports used in daily business operations. To illustrate them as
|
completely as possible, the examples include the names of individuals, companies, brands, and products. All of these
|
names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.
|
|
COPYRIGHT LICENSE:
|
|
This information contains sample application programs in source language, which illustrate programming techniques
|
on various operating platforms. You may copy, modify, and distribute these sample programs in any form without
|
payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming
|
to the application programming interface for the operating platform for which the sample programs are written.
|
These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply
|
reliability, serviceability, or function of these programs. The sample programs are provided "AS IS", without
|
warranty of any kind. IBM shall not be liable for any damages arising out of your use of the sample programs.
|
|
Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows:
|
|
© (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs.
|
|
© Copyright IBM Corp. _enter the year or years_. All rights reserved.
|
|
If you are viewing this information softcopy, the photographs and color illustrations may not appear.
|
|
_____________________________
|
|
TRADEMARKS:
|
|
IBM, the IBM logo, and ibm.com® are trademarks or registered trademarks of International Business Machines Corp.,
|
registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies.
|
A current list of IBM trademarks is available on the Web at Copyright and trademark information at http://www.ibm.com/legal/copytrade.shtml.
|
|
Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.
|
|
Other company, product, or service names may be trademarks or service marks of others.
|
|
Contact support: http://www.ibm.com/software/data/informix/ids/support/
|
|
© Copyright IBM Corp. 1996, 2009
|
