IBM Data Studio Developer, Version 1.2

Installation guide


Note

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

Version 1.2

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

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

Contents

Overview
IBM Installation Manager
Installation requirements
Hardware requirements
Software requirements
User privileges requirements
Planning to install
Installation scenarios
Deciding which features to install
Features
Upgrade and coexistence considerations
Offering coexistence considerations
Compatibility with other products
Package groups and the shared resource directory
Extending an existing Eclipse IDE
Installation repositories
Setting repository preferences in Installation Manager
Preinstallation tasks
Installation tasks
Installing Data Studio Developer from DVDs: task overview
Installing Data Studio Developer from an electronic image on your workstation: task overview
Installing from an electronic image
Installing Data Studio Developer from an electronic image on a shared drive: task overview
Placing Data Studio Developer on an HTTP Web server: task overview
Installing Data Studio Developer from a repository on a HTTP Web server: task overview
Installing from the Launchpad program
Starting the Launchpad program
Starting an installation from the Launchpad program
Installing IBM Data Studio Developer using the IBM Installation Manager graphical interface
Managing IBM Installation Manager
Installing Installation Manager on Windows
Installing Installation Manager on Linux
Starting Installation Manager on Windows
Starting Installation Manager on Linux
Uninstalling Installation Manager on Windows
Uninstalling Installation Manager on Linux
Installing silently
Managing licenses
Purchasing licenses
Starting Data Studio Developer
Modifying installations
Reverting updates to previous versions
Updating Data Studio Developer
Uninstalling Data Studio Developer
Notices
Trademarks and service marks

Overview

This installation guide provides instructions for installing and uninstalling IBM(R) Data Studio Developer.

For the most up to date version of this information, see the Data Studio information center.

Important:
Refer to the release notes for information about installation issues and limitations for Data Studio.

An HTML copy of this Installation Guide is available in the documentation directory of the product DVD.

Note:
If you have already installed Data Studio Developer Version 1.1.1, you can upgrade to Version 1.2 by using the update process described in the following section: Updating Data Studio Developer

IBM Installation Manager

IBM Installation Manager is a program that helps you install the Data Studio Developer product package on your computer. It also helps you update, modify, and uninstall any package that you install. A package can be a product, a group of components, or a single component that is specifically designed for Installation Manager to install.

IBM Installation Manager offers several time-saving features, which you can use to complete the following tasks:

For more information about IBM Installation Manager and how to use it to install and update Data Studio Developer, visit the Installation Manager Information Center at http://publib.boulder.ibm.com/infocenter/install/v1m0r0/index.jsp.

Installation requirements

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

For the most up-to-date, detailed system requirements, refer to The Data Studio Developer product Web site.

Hardware requirements

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

Hardware Requirements
Processor Minimum 2GHz or higher
Memory Minimum: 1GB RAM; For best results: 2GB RAM
Disk space Disk space requirements vary by release and edition. Refer to the release notes for each product for details. Minimum: 650 MB of disk space is required for product package installation. Additional disk space is required for the resources that you develop.
Note:
  • Disk space requirements can be reduced or increased depending on the features that you select to install.
  • Additional disk space is required if you download the product package to install this product.
  • For Windows(R): Additional disk space is required if you use FAT32 instead of NTFS.
  • For Windows: An additional 500 MB of disk space is required in the directory pointed to by your environment variable TEMP.
  • For Linux(R): An additional 500 MB of disk space is required in the /tmp directory.
Display 1024 x 768 display minimum using 256 Colors (or higher for best results)

Software requirements

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

Operating systems

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

Note:
This version of the IBM Data Studio Developer was developed for use with Eclipse 3.2.2, using JDK 1.5. If you are extending an existing Eclipse environment, refer to Extending an existing Eclipse IDE for more information.

Additional software requirements

User privileges requirements

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

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

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

These are the typical installation scenarios you might follow:

Note that in the latter three scenarios you can choose to run the Installation Manager program in silent mode to install Data Studio Developer. For details on running Installation Manager in silent mode, see Installing silently.

Installing from DVDs

In this installation scenario, you have the DVDs that contain the product package files, and typically you are installing Data Studio Developer on your own workstation. Refer to Installing Data Studio Developer from DVDs: 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 or another IBM Web site and you will install Data Studio Developer on your own workstation. Refer to Installing Data Studio Developer 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 Developer from a single location. Refer to Installing Data Studio Developer from an electronic image on a shared drive: task overview for an overview of the steps.

Installing from a repository on an HTTP server

This scenario represents the fastest method for installing the product across a network. This scenario differs from the shared-drive installation. In order to place product package files for Data Studio Developer on an HTTP Web server, you must use this utility application - IBM Packaging Utility. This utility is provided with Data Studio Developer to copy the installation files in a format - a package - that can be used for installing Data Studio Developer directly from a HTTP Web server. The directory on the HTTP Web server that contain the package is called a repository. Note that, in this scenario, the installation files for only Data Studio Developer are placed in the package. Refer to Installing Data Studio Developer from a repository on a HTTP Web server: task overview and Placing Data Studio Developer on an HTTP Web server: task overview for an overview of the steps.

Deciding which features to install

You can customize your software product by selecting which features of Data Studio Developer to install.

When you install the Data Studio Developer product package using IBM Installation Manager, the installation wizard displays the features in the available product package. From the features list, you can select which to install. A default set of features is selected for you (including any required features). Installation Manager automatically enforces any dependencies between features and prevents you from clearing any required features.

Note:
After you finish installing the package, you can still add or remove features from your software product by running the Modify Packages wizard in Installation Manager. See Modifying installations for more information.

Features

The following table shows the features of Data Studio Developer that you can choose to install. Default selections of features to install may vary. If a feature already exists in your shared resources directory, it will not be selected by default and will not be installed again.

Some features contain license checking. If you do not have a valid trial or permanent license installed, these features will show an error message if you attempt to use them.

Feature Description
Data Studio Core Features Includes support for connecting to and browsing data sources and the objects contained in a connection, and creating, running, and tuning SQL statements and XML queries.
SQL Routine Development Provides tooling for developing, testing, and deploying SQL stored procedures and user-defined functions, including wizards, editors, and an integrated stored procedure debugger.
Database Object Management Provides tools for database administration, including an editor for creating and altering data objects and data object privileges.
XML Development Provides tooling for XML application development, including wizards for creating and registering XML schema documents and inserting XML data into XML columns, editors for XML, XSD, and DTD files, and a graphical mapping editor that allows you to annotate XML schemas for shredding.
Java(TM) Routine Development Provides tooling for developing, testing, and deploying Java stored procedures, including wizards, editors, and an integrated stored procedure debugger.
SQLJ Development Provides tools for building SQLJ applications, including an SQLJ editor with built in syntax highlighting, an SQLJ translator that translates SQLJ files to pure Java files and produces SQLJ serialized profiles, and an SQLJ debugger that enables you to debug SQLJ files directly. There are also built-in customization features that are available when you are developing SQLJ applications for DB2(R).
Data Web Services Provides support for creating and deploying Web services that allow client applications to access data in DB2 databases by means of database operations, such as SQL SELECT and DML statements, as well as calls to stored procedures.
WebSphere(R) Application Server Community Edition Installer WebSphere Application Server Community Edition is a free J2EE server for building and managing Java applications. Select this option to copy the installer for WebSphere Application Server Community Edition into the <install dir>\dwb\bin directory on your computer for later installation. You must run the *.exe file from this location to install WebSphere Application Server Community Edition on your computer.
ClearCase(R) Enablement The Rational(R) ClearCase SCM Adapter provides support for sharing data projects by using Rational ClearCase. After installation, you must enable this functionality on the Capabilities page of the Preferences window. This feature can only be used if you have a ClearCase client and a configured ClearCase server.
Development Center Project Migration Provides tooling for Development Center project migration. Install this feature if you have artifacts, such as stored procedures, that you want to migrate from a Development Center project.
pureQuery for Java Provides tools that make it easy to develop Java applications that access databases or in-memory data. The tooling enhances the Java editor with complete assistance for building, validating, and running SQL statements. You can also use the tooling to build pureQuery applications around existing code, SQL, or databases.

Upgrade and coexistence considerations

If you have a previous version of the product, or if you plan to install multiple IBM Eclipse-based products on the same workstation, review the information in this section.

Offering coexistence considerations

Some products are designed to coexist and share function when they are installed in the same package group. A package group is a location where you can install one or more software products or packages. When you install each package, you select whether you want to install the package to an existing package group, or whether you want to create a new one. IBM Installation Manager will block products that are not designed to share or do not meet version tolerance and other requirements. If you want to install more than one product at a time, the products must be able to share a package group.

For more information about which products are compatible in this release, refer to Compatibility with other products

Any number of compatible products can be installed to a package group. When a product is installed, its function is shared with all of the other products in the package group. If you install a development product and a testing product into one package group, when you start either of the products, you have both the development and testing functionality available to you in your user interface. If you add a product with modeling tools, all of the products in the package group will have the development, testing, and modeling functionality available.

If you install a development product and later purchase a development product with increased functionality and add that product to the same package group, the additional function will be available in both products. If you uninstall the product with the greater functionality, the original product remains.

Note:
Each product installed into a unique location may be associated with only one package group. A product must be installed into multiple locations in order to be associated with multiple package groups.

Compatibility with other products

If you have a previous version of the product, or if you plan to install multiple IBM Software Development Platform products on the same workstation, review the information in this section.

Data Studio Developer Version 1.2 can share a package group with other compatible products that have been installed with Installation Manager.

Before you can share a package group with Rational Software Architect or Rational Application Developer, you must upgrade to Installation Manager Version 1.1.1. See the "Installation limitations" section of the release notes for more details.

The following products have been tested with Data Studio Developer Version 1.2. Other products have not been tested and you should not attempt to install Data Studio Developer with them in a shared package group.

Important:
See the "Installation limitations" section of the release notes for important information about limitations for shared installations.

If you have installed other Eclipse 3.2.2 based products using a mechanism other than Installation Manager, you can attempt to install Data Studio Developer into the same Eclipse IDE, using the Extend an existing Eclipse IDE option in Installation Manager. However, be aware that this type of installation will fail if the Eclipse environment is not compatible with Data Studio Developer Version 1.2.

See the Data Studio Developer support page for additional technotes about extending an Eclipse 3.2.2 IDE.

Package groups and the shared resource directory

When you install the Data Studio Developer package with IBM Installation Manager, you must choose a package group and a shared resource directory.

Package groups

During the installation process, you must specify a package group for the Data Studio Developer package. A package group represents a directory in which packages share resources with other packages in the same group. When you install the Data Studio Developer package with Installation Manager, you can create a new package group or install the packages into an existing package group. (Some packages might not be able to share a package group, in which case the option to use an existing package group will be disabled.)

If you have products on your computer that were previously installed with Installation Manager, sharing a package group is the method that you use to enable shared installations.

Note that when you install multiple packages at the same time, all the packages are installed into the same package group.

A package group is assigned a name automatically; however, you choose the installation directory for the package group.

After you create the package group by successfully installing a product package, you cannot change the installation directory. The installation directory contains files and resources specific to the Data Studio Developer product package installed into that package group. Resources in the product package that can potentially be used by other package groups are placed in the shared resources directory.

You can install Data Studio Developer into an existing package group only if the product and version in the existing package group is compatible with Data Studio Developer. In most cases, if the existing product is not compatible, you will see an error and the shared installation will fail. However, in some cases Installation Manager will not block the shared installation of incompatible products, which can cause unpredictable installation results. For more information about which products are compatible in this release, refer to Compatibility with other products.

Shared resources directory

The shared resources directory is the directory where installation artifacts are located so that they can be used by one or more product package groups.

Important:
You can specify the shared resources directory once: the first time that you install a package. We suggest that you use your largest drive for this. You cannot change the directory location unless you uninstall all packages.

Extending an existing Eclipse IDE

When you install the Data Studio Developer product package, you can choose to extend an Eclipse integrated development environment (IDE) already installed on your computer by adding the functions that the Data Studio Developer package contains.

If you have products on your computer that were previously installed with the Eclipse update mechanism, extending an Eclipse IDE is the method that you use to enable shared installations. This type of installation should be attempted with caution, since installing product combinations using this method can cause unpredictable installation or product behavior.

The Data Studio Developer package that you install with IBM Installation Manager is bundled with a version of the Eclipse IDE or workbench; this bundled workbench is the base platform for providing the functionality in the Installation Manager package. However, if you have an existing Eclipse IDE on your workstation, then you have the option to extend, that is, add to the IDE the additional functionality provided in the Data Studio Developer package - that Eclipse instance.

To extend and existing Eclipse IDE: in the Location page of the Install Packages wizard, select the Extend an existing Eclipse IDE option.

You might extend your existing Eclipse IDE, for example, because you want to gain the functionality provided in the Data Studio Developer package, but you also want to have the preferences and settings in your current IDE when you work with the functionality from the Data Studio Developer package. You also might want to work with plug-ins you have installed that already extend the Eclipse IDE. However, be aware that if you have previously extended an Eclipse IDE by installing any other features or plugins, or if you are trying to extend an Eclipse product (that is, there are additional features and plugins in your installation other than just base Eclipse), it is possible that these features might not be compatible with Data Studio Developer. If they are not compatible, you will see error messages indicating that features need to be updated to a different version. To fix these incompatibilities, you must locate the appropriate versions and update each incompatible feature as indicated by the error messages.

Your existing Eclipse IDE must be the correct version to be extended. See Software requirements for details. In addition, Installation Manager checks that the Eclipse instance you specify meets the requirements for the installation package, and the installation will not proceed if the requirements are not met.

Installation repositories

IBM Installation Manager retrieves product packages from specified repository locations.

If the launchpad is used to start Installation Manager, the repository information is passed to Installation Manager. If the Installation Manager is started directly, you must specify an installation repository that contains the product packages that you want to install. See Setting repository preferences in Installation Manager.

Some organizations bundle and host their own product packages on their intranet. For information about this type of installation scenario, see Installing from a repository on an HTTP server. Your system administrators will need to provide you with the correct URL.

By default, Installation Manager uses an embedded URL in each product to connect to a repository server over the Internet. Installation Manager then searches for the product packages as well as new features.

Setting repository preferences in Installation Manager

When you start the installation of Data Studio Developer from the launchpad program, the location of the repository that contains the product package you are installing is automatically defined in Installation Manager when it starts. However, if you start Installation Manager directly (for example, installing Data Studio Developer from a repository located on a Web server) then you must specify the repository preference (the URL for the directory that contains the product package) in Installation Manager before you can install the product package. Specify these repository locations on the Repositories page of the Preferences window. By default, Installation Manager uses an embedded URL in each product to connect to a repository server through the Internet and search for installable packages and new features. Your organization may require you to redirect the repository to use intranet sites.

Note:
Before starting the installation process, be sure to obtain the installation package repository URL from your administrator.

To add, edit, or remove a repository location in Installation Manager:

  1. Start Installation Manager.
  2. On the Start page of Installation Manager, click File -> Preferences, and then click Repositories. The Repositories page opens, showing any available repositories, their locations, and whether they are accessible.
  3. On the Repositories page, click Add Repository.
  4. In the Add repository window, type the URL of the repository location or browse to it and set a file path.
  5. Click OK. If you entered a HTTPS repository location, then you will be prompted to enter a user ID and password. The new or changed repository location is listed. If the repository is not accessible, a red x is displayed in the Accessible column.
  6. Click OK to exit.

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 (on Windows systems) or the /tmp directory (on Linux systems) 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 and give particular attention to the topic Upgrade and coexistence considerations.
  5. For Linux: If you want to enable the product to be used by users other than root, then you must set to 0022, the umask variable before you install the product. To set this variable, log in as root user, start a terminal session, and type umask 0022.

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.

Installing Data Studio Developer from DVDs: task overview

In this installation scenario, you have the DVDs that contain the installation files, and typically you are installing Data Studio Developer on your own workstation.

The following are the general steps for installing from DVDs:

  1. Complete the preinstallation steps listed in Preinstallation tasks.
  2. Insert the first installation DVD into your DVD drive.
  3. For Linux: Mount the DVD drive.
  4. If autorun is enabled on your system, the Data Studio Developer launchpad program automatically opens. If autorun is not enabled, start the Launchpad program. Refer to Starting the Launchpad program for details.
  5. Start the installation of Data Studio Developer from the launchpad. For details, see Starting an installation from the Launchpad program.

    If Installation Manager is not detected on your workstation, you are prompted to install it and then the installation wizard starts. Follow the on-screen instructions in the wizard to complete the installation of Installation Manager. See Installing Installation Manager on Windows for details.

    When the installation of Installation Manager completes, or if it is already on your computer, Installation Manager starts and automatically begins the Install Packages wizard.

  6. Follow the on-screen instructions in the Install Packages wizard to complete the installation. For details, see Installing IBM Data Studio Developer using the IBM Installation Manager graphical interface.
  7. Optional: Configure your license. If you have a trial version of the product, you must configure a permanent license to ensure that you have continued access to all functions of the product. Refer to Managing licenses for details.

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

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

  1. Ensure that your workstation has sufficient space to store both the files you must download and the extracted installation image. Refer to Hardware requirements.
  2. Download all required parts for the product image to a temporary directory.
  3. Extract the installation image from the downloaded file.
  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. Start the launchpad program. Refer to Starting the Launchpad program for details.
  3. Start the installation of Data Studio Developer from the Launchpad. For details, see Starting an installation from the Launchpad program.

    If Installation Manager is not detected on your workstation, you are prompted to install it and then the installation wizard starts. Follow the on-screen instructions in the wizard to complete the installation of Installation Manager. See Installing Installation Manager on Windows for details.

    When the installation of Installation Manager completes, or if it is already on your system, Installation Manager starts and automatically begins the Install Packages wizard.

  4. Follow the on-screen instructions in the Install Packages wizard to complete the installation. For complete details, see Installing IBM Data Studio Developer using the IBM Installation Manager graphical interface.
  5. Optional: Configure your license. If you have a trial version of the product, you must configure a permanent license to ensure that you have continued access to all functions of the product. Refer to Managing licenses for details.

Installing Data Studio Developer 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 Developer 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 and the extracted installation image. Refer to Hardware requirements for details.
  2. Download all required parts for the product image 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.

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

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

Placing Data Studio Developer on an HTTP Web server: task overview

To prepare Data Studio Developer for installation from a repository located on an HTTP Web server:

  1. Ensure that your HTTP or HTTPS Web server has sufficient disk space to store the product package. Refer to Hardware requirements.
  2. Ensure that your workstation has sufficient disk space to store both the files you must download and the extracted installation image. Refer to Hardware requirements
  3. Download all required parts for the product image to a temporary directory on your workstation.
  4. Extract the installation image from the downloaded files into another temporary directory on your workstation and verify that the installation image is complete.
  5. Install on your workstation the IBM Packaging Utility from the Auxiliary DVD (or electronic disk) appropriate for your platform.
  6. Using the Packaging Utility, copy the Data Studio Developer product package.
  7. Copy the output of the Packaging Utility to a HTTP or HTTPS Web Server.
  8. Copy the installation files forInstallation Manager from the Auxiliary DVD's to a shared drive.
  9. Instruct users in your organization to install Installation Manager.
  10. Provide users the URL for the repository that contains the Data Studio Developer product package you created earlier.

Installing Data Studio Developer from a repository on a HTTP Web server: task overview

In this scenario, the product packages are retrieved by Installation Manager from an HTTP Web server.

These steps assume the repository containing the package for Data Studio Developer has been created on the HTTP Web server.

To install the Data Studio Developer package from a repository on an HTTP server:

  1. Complete the preinstallation steps listed in Preinstallation tasks.
  2. Install Installation Manager. Refer to Managing IBM Installation Manager. In this scenario, for example, the Installation Manager nstallation files are available from a shared drive.
  3. Start Installation Manager. Refer to Starting Installation Manager on Windows for details.
  4. Set the URL of the repository containing the package of Data Studio Developer as a repository preference in Installation Manager. See Setting repository preferences in Installation Manager.
  5. Start the Install Packages wizard in Installation Manager nd follow the on-screen instructions in the Install Packages wizard to complete the installation. For complete details, see Installing IBM Data Studio Developer using the IBM Installation Manager graphical interface.
  6. Optional: Configure your license. If you have a trial version of the product, you must configure a permanent license to ensure that you have continued access to all functions of the product. Refer to Managing licenses for details.

Installing from the Launchpad program

The Launchpad program provides you with a single location to view release information and start the installation process.

Use the launchpad program to start the installation of Data Studio Developer in the following cases:

By starting the installation process from the Launchpad program, IBM Installation Manager will start preconfigured with the location of the repository that contains the Data Studio Developer package. If you install and start Installation Manager directly, then you must set repository preference manually.

To install from the launchpad:

  1. Complete the preinstallation tasks described in Preinstallation tasks, if you have not done so already.
  2. Start the launchpad program. See Starting the Launchpad program.
  3. Start the installation of Data Studio Developer. See Starting an installation from the Launchpad program.

Follow the on-screen instructions in the Install Packages wizard to complete the installation. For complete details, see Installing IBM Data Studio Developer using the IBM Installation Manager graphical interface.

Starting the Launchpad program

Complete the preinstallation tasks described in Preinstallation tasks, if you have not done so already.

If you are installing from a DVD and autorun is enabled on your workstation, then the Data Studio Developer launchpad starts automatically when you insert the first installation disc into your DVD drive. If you are installing from an electronic image, or if autorun is not configured on your workstation, then you must start the Launchpad program manually.

To start the Launchpad program:

  1. Insert the IBM Data Studio Developer DVD into your DVD drive. For Linux: Ensure that you have mounted the DVD drive.
  2. If autorun is enabled on your system, the IBM Data Studio Developer launchpad program automatically opens. If autorun is not enabled on your system:

Starting an installation from the Launchpad program

  1. Start the launchpad program.
  2. If you have not done so already, read the release information by clicking Release Notes.
  3. When you are ready to begin the installation, click Install.
  4. A message window opens to inform you whether the program IBM Installation Manager is detected on your workstation.
  5. Follow the on-screen instructions in the Install Packages wizard to complete the installation. For complete details, see Installing IBM Data Studio Developer using the IBM Installation Manager graphical interface

Installing IBM Data Studio Developer using the IBM Installation Manager graphical interface

For information about how to use the Installation Manager interface to install or update a package, refer to the Installation Manager information center.

Managing IBM Installation Manager

Installing Installation Manager on Windows

IBM Installation Manager is installed by the launchpad. For more information on this process, refer to Installing from the Launchpad program.

To install Installation Manager manually:

  1. Run install.exe from the disk1\InstallerImage_win32 folder on the first installation disk.
  2. Click Next on the Welcome screen.
  3. Review the license agreement on the License Agreement page and select I accept the terms in the license agreement to accept. Click Next.
  4. Click the Change button on the Destination Folder page to change the installation location if required. Click Next.
  5. Click Next on the Setup Type page.
  6. Click Install on the Ready to Install Program page. The Completed page opens after the installation is complete.
  7. Click Finish.

Installing Installation Manager on Linux

IBM Installation Manager is installed by the launchpad. For more information on this process, refer to Installing from the Launchpad program.

To install Installation Manager manually:

  1. Open a terminal window with root user privileges.
  2. Run install from the disk1/InstallerImager_linux folder on the first installation disk.
  3. Click Next on the Welcome screen.
  4. Review the license agreement on the License Agreement page and select I accept the terms in the license agreement to accept. Click Next.
  5. If necessary, edit the installation directory location. Click Next.
  6. Click Install on the information summary page.
  7. Click Finish on the InstallShield Wizard Completed page.

Starting Installation Manager on Windows

IBM Installation Manager should be started from the launchpad program. Doing so starts Installation Manager with a configured repository preference and selected Data Studio Developer packages. If you start Installation Manager directly, then you must set a repository preference and choose product packages manually.

To start Installation Manager manually:

  1. Open the Start menu from the Taskbar.
  2. Select All Programs -> IBM Installation Manager -> IBM Installation Manager.

Starting Installation Manager on Linux

Installation Manager should be started from the launchpad program. Doing so starts the Installation Manager with a configured repository preference and selected Data Studio Developer packages. If you startInstallation Manager directly, then you must set repository preference and choose product packages manually.

To start Installation Manager manually:

  1. Open a terminal window with root user privileges.
  2. Run /opt/IBM/InstallationManager/eclipse/IBMIM.

Uninstalling Installation Manager on Windows

To uninstall Installation Manager manually:

  1. Click Start -> All Programs -> IBM Installation Manager -> Uninstall IBM Installation Manager.
  2. Click Next on the Welcome screen.
  3. Select the Remove button on the Program Maintenance page. Click Next.
  4. Click Next on the Setup Type page.
  5. Click Remove on the Remove the Program page.
  6. Click Finish on the InstallShield Wizard Completed page.

Uninstalling Installation Manager on Linux

IBM Installation Manager must be uninstalled using the package management tool that is included with your Linux version.

To uninstall Installation Manager manually on Linux:

  1. Open a terminal window with root user privileges.
  2. Change directory to /var/ibm/InstallationManager/uninstall/.
  3. Run ./uninstall.

Installing silently

You can install the Data Studio Developer product package by running Installation Manager in silent installation mode. When you run Installation Manager in silent mode, the user interface is not available; instead, Installation Manager uses a response file to input the commands that are required to install the product package. You can also install Installation Manager silently using the Installation Manager installer. You can then use the installer to silently install product packages.

Typically, you silently install Installation Manager and the Data Studio Developer package at the same time. The general process is the same as the processes that are described in the following Installation Manager information center topics. Follow the links below to read the topics, or access them from the Installation Manager information center by clicking Help -> Help Contents from the Installation Manager main menu.

The only difference for Data Studio Developer is that you must run the Installation Manager install program from the <Data Studio media root>/disk1/InstallerImage_<platform> location.

The following tasks are the main tasks that are required for silent installation:

  1. Create the response file.
  2. Run the silent installation command using one of the following methods:
  3. Optional: If you have a trial version of the product, install the permanent license key silently. This step must be performed separately.

Refer to the related links for additional information about silent installation commands and files. This same information is available in the Installation Manager information center by clicking Help -> Help Contents.

Managing licenses

You can manage the licenses for your installed products and customized packages by using the Manage Licenses wizard and associated Preferences pages. The Manage Licenses wizard displays license type and license expiration information for each of your installed packages.

You can upgrade trial or non-licensed versions of Data Studio Developer to licensed versions by importing product activation kits.

For information about how to work with licenses in Installation Manager, refer to the topic called Managing licenses in the Installation Manager online information center. This same information is available in the Installation Manager information center by clicking Help -> Help Contents.

Purchasing licenses

You can purchase new licenses if your current product license is about to expire or if you want to acquire additional product licenses for team members.

To purchase licenses and enable your product, complete the following steps:

  1. Determine the type of license you want to purchase.
  2. Go to ibm.com(R) or contact your IBM sales representative to purchase the product license. For details, visit the IBM Web page on How to buy software.

When you want to import the activation kit for your product, use the Manage Licenses wizard in Installation Manager.

Starting Data Studio Developer

You can start Data Studio Developer from the desktop environment or a command-line interface.

For Windows: Click Start -> Programs -> IBM Data Studio -> Data Studio Developer.

To start Data Studio Developer from a command-line:

Modifying installations

The Modify Packages wizard in Installation Manager enables you to change the language and feature selections of an installed product package.

By default, Internet access is required unless the repository preferences points to a local update site. See the Installation Manager help for more information.

Note:
Close all programs that were installed using Installation Manager before modifying.

To modify an installed product package, follow the instructions in the Installation Manager online information center topic called: Modifying installed packages. This same information is available in the Installation Manager information center by clicking Help -> Help Contents.

Reverting updates to previous versions

You can remove an update to some packages to revert to a previous version by using the Roll back Packages wizard of IBM Installation Manager.

To modify an installed product package, follow the instructions in the Installation Manager online information center topic called: Rolling back updates. This same information is available in the Installation Manager information center by clicking Help -> Help Contents.

Updating Data Studio Developer

You can install updates for packages that were installed with Installation Manager.

Prerequisites:

Note:

To modify an installed product package, follow the instructions in the Installation Manager online information center topic called: Installing updates. This same information is available in the Installation Manager information center by clicking Help -> Help Contents.

Uninstalling Data Studio Developer

The Uninstall Packages option in Installation Manager enables you to uninstall packages from a single installation location. You can also uninstall all the installed packages from every installation location.

To uninstall Data Studio Developer, follow the instructions in the Installation Manager online information center topic called: Uninstalling products, packages, and updates. This same information is available in the Installation Manager information center by clicking Help -> Help Contents.

If you want to uninstall Installation Manager, follow the instructions in the Installation Manager online information center topic called: Uninstalling Installation Manager . This same information is available in the Installation Manager information center by clicking Help -> Help Contents.

Notices

Note to U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

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:

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, 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:

Intellectual Property Dept. for Rational Software
IBM Corporation
3600 Steeles Avenue East
Markham, Ontario
Canada L3R 9Z7


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

Trademarks and service marks

The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both:

Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both.

Linux is a trademark of Linus Torvalds in the United States, other countries, or both.

Other company, product or service names, may be trademarks or service marks of others.