IBM Data Studio pureQuery Runtime, Version 1.1.2

Installation guide


Note

Before using this information and the product it supports, read the information in Notices.

Second Edition (March 2008)

This edition applies to version 1.1.2 of IBM Data Studio pureQuery Runtime and to all subsequent releases and modifications until otherwise indicated in new editions.

Copyright International Business Machines Corporation 2007. All rights reserved.
US Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents

Installation requirements
Hardware and software requirements
Hardware requirements
Software requirements
User privileges requirements
Planning to install
Installation scenarios
Verifying and extracting electronic images
Preinstallation tasks
Installation tasks
Installing Data Studio from CDs: task overview
Installing Data Studio pureQuery Runtime from an electronic image on your workstation: task overview
Installing Data Studio from an electronic image on a shared drive: task overview
Installing silently
Creating a response file
Installing in silent mode
Reference: Sample response file
Uninstalling in silent mode
Notices and trademarks

Installation requirements

This section details hardware, software, and user privilege requirements that must be met in order to successfully install and run your software.

Hardware and software requirements

Before you install IBM Data Studio pureQuery Runtime Version 1.1.2 (also referred to as the server console), ensure that your system meets all the hardware, data server, software, and user account requirements.

Hardware requirements

Before you can install the product, verify that your system meets the minimum hardware requirements.

Hardware Requirements
Memory Minimum:128 MB RAM
Disk space Minimum: 80 MB of disk space is required for product package installation. Additional disk space is required for the resources that you develop.
Display 1024 x 768 display minimum using 256 Colors (or higher for best results)
Other hardware Microsoft(R) mouse or compatible pointing device

Software requirements

Before you can install the product, verify that your system meets the software requirements.

Operating system

The following operating systems are supported for this product:

Note:
The listed operating systems support all of the languages that are supported by Data Studio.

Additional software requirements

User privileges requirements

You must have a user ID that meets the following requirements before you can install Data Studio.

Planning to install

Read all the topics in this section before you begin to install any of the product features. Effective planning and an understanding of the key aspects of the installation process can help ensure a successful installation.

Installation scenarios

There are a number of scenarios that you can follow when installing Data Studio.

The following are some of the factors that might determine your installation scenario:

These are the typical installation scenarios you might follow:

Installing from CDs

In this installation scenario, you have the CDs that contain the product package files, and typically you are installing Data Studio on your own workstation. Refer to Installing Data Studio from CDs: task overview for an overview of the steps.

Installing from a downloaded electronic image on your workstation

In this scenario, you have downloaded the installation files from IBM Passport Advantage and you will install Data Studio on your own workstation. Refer to Installing Data Studio from an electronic image on your workstation: task overview for an overview of the steps.

Installing from an electronic image on a shared drive

In this scenario, you will place the electronic image on a shared drive so that users in your enterprise can access the installation files for Data Studio from a single location. Refer to Installing Data Studio from an electronic image on a shared drive: task overview for an overview of the steps.

Verifying and extracting electronic images

You can compare the published MD5 values with the checksum of the downloaded files to check if the downloaded file is corrupt or incomplete.

Extracting the downloaded files

Extract each compressed file to the same directory.

Preinstallation tasks

Before you install the product, complete these steps:

  1. Confirm that your system meets the requirements described in the section Installation requirements.
  2. Confirm that the directory pointed to by your environment variable TEMP has at least 100 MB free. This is in addition to the space required for installing the product.
  3. Confirm that your user ID meets the required access privileges for installing the product. See User privileges requirements.
  4. Read the section Planning to install.

Installation tasks

The following sections provide an overview of the installation scenarios that are described in the section Installation scenarios. You can access detailed instructions from links in the main steps.

The InstallAnywhere wizard generates a log file in the installation directory. The file is named Data_Studio_pureQuery_Runtime_InstallLog.log.

On AIX, Linux, and Solaris systems, all installed files have the default permission of 755.

Installing Data Studio from CDs: task overview

In this installation scenario, you have the CD that contains the installation files, and typically you are installing Data Studio pureQuery Runtime on your own workstation.

The following are the general steps for installing from the CD:

  1. Complete the preinstallation steps listed in Preinstallation tasks.
  2. Insert the installation CD into your CD drive.
  3. For Windows: If autorun is enabled on your system, the installation program automatically opens. If autorun is not enabled, browse on the CD to the directory that is specific to the platform of your workstation and run the .exe or .bin file in that directory.
  4. Follow the on-screen instructions in the InstallAnywhere wizard to complete the installation.

Installing Data Studio pureQuery Runtime from an electronic image on your workstation: task overview

The following are the general steps for installing Data Studio from an electronic installation image.

  1. Ensure that your workstation has sufficient space to store both the files you must download from IBM Passport Advantage and the extracted installation image. Refer to Hardware requirements.
  2. Download all required parts for the product image from IBM Passport Advantage to a temporary directory.
  3. Extract the installation image from the downloaded file and verify that the installation image is complete. See Verifying and extracting electronic images for details.
  4. Continue with the steps in Installing from an electronic image below.

Installing from an electronic image

  1. Complete the preinstallation steps listed in Preinstallation tasks.
  2. Browse to the directory that is specific to the platform of your workstation and run the .exe or .bin file in that directory.
  3. Follow the on-screen instructions in the InstallAnywhere wizard to complete the installation.

Installing Data Studio from an electronic image on a shared drive: task overview

In this scenario, you will place the electronic image on a shared drive so that users in you enterprise can access the installation files for Data Studio from a single location.

The following steps are performed by the person who places the installation image on a shared drive.

  1. Ensure that your shared drive has sufficient disk space to store both the files you must download from IBM Passport Advantage and the extracted installation image. Refer to Hardware requirements for details.
  2. Download all required parts for the product image from IBM Passport Advantage to a temporary directory on the shared drive.
  3. Extract the installation image from the downloaded files into an accessible directory on the shared drive and verify the installation image is complete. See Verifying and extracting electronic images for details.

To install Data Studio from the installation files on the shared drive:

  1. Change to the directory on the shared drive containing the installation image.
  2. Follow the steps in Installing from an electronic image.

Installing silently

You can install Data Studio pureQuery Runtime in silent installation mode. When you install in silent mode, the InstallAnywhere wizard is not available; instead, the installation uses a response file to input the commands that are required to install the product package.

There are two main tasks required for silent installation:

  1. Create the response file.
  2. Install Data Studio pureQuery Runtime in silent mode.

Creating a response file

To create a response file for installation:

  1. On a command line, change to the directory that contains the .exe or .bin file that launches the InstallAnywhere wizard on your system.
  2. On a command line, type the following command, substituting your own file name and optional location and name for the response file:
  3. Follow the on-screen instructions in the InstallAnywhere wizard, stopping when you reach the Pre-Installation Summary page.
  4. Click Cancel.

A response file is created and resides in the location specified in the command. If you did not specify a location, the response file is created as installer.properties in the same directory as the .exe. or .bin file. You must specify a location if you are run the .exe or .bin file from the CD.

Installing in silent mode

To install Data Studio pureQuery Runtime in silent mode:

  1. On a command line, change to the directory that contains the .exe or .bin file that launches the InstallAnywhere wizard on your system.
  2. On a command line, type the following command, substituting your own file name and location for the response file:

When the installation completes, the installation creates a log file in the installation directory. You can use silent install log files to examine the results of a silent installation. In the installation directory, open the file Data_Studio_pureQuery_Runtime_InstallLog.log amd scroll down to the Summary section.

License agreement acceptance attribute

By default, you agree to accept whatever license an installation package carries when using silent installation mode.

Reference: Sample response file

You can edit a response file to specify an installation directory.

Sample response file
# Tue Nov 13 16:07:41 PST 2007
# Replay feature output
# ---------------------
# This file was built by the Replay feature of InstallAnywhere.
# It contains variables that were set by Panels or Consoles.



#Choose Install Directory
#------------------------
USER_INSTALL_DIR=C:\\Program Files\\IBM\\Data Studio pureQuery Runtime

Uninstalling in silent mode

To uninstall Data Studio pureQuery Runtime in silent mode from a command line:

  1. On a command line, change to the uninstall subdirectory in the directory where you installed Data Studio pureQuery Runtime.
  2. Enter and run the following command, substituting your own locations for the response file:

Notices and trademarks

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 give you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation 500 Columbus Avenue Thornwood, NY 10594 U.S.A.

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 publication 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 as your own risk.

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 information 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.

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.

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.

Trademarks

Company, product, or service names identified in this document may be trademarks or service marks of International Business Machines Corporation or other companies. Information on the trademarks of IBM Corporation in the United States, other countries, or both is located at http://www.ibm.com/legal/copytrade.shtml.