IBM Rational Developer for i V7.5

Installation Guide


GC23-7796-01
Note

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

Second Edition (November 2008)

This edition applies to Version 7.5 of IBM Rational Developer for i (PID 5733-RDI) and to all subsequent releases and modifications until otherwise indicated in new editions.

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

Contents

Overview
IBM Installation Manager
IBM Rational Software Delivery Platform
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
Installation repositories
Setting repository preferences in IBM Installation Manager
Package groups and the shared resource directory
Extending an existing Eclipse IDE
Preinstallation tasks
Installation tasks
Installing Rational Developer for i from CDs: task overview
Installing IBM Rational Developer for i V7.5 from an electronic image on your workstation: task overview
Installing from an electronic image
Installing IBM Rational Developer for i V7.5 from an electronic image on a shared drive: task overview
Installing Rational Developer for i V7.5 from a repository on an HTTP or HTTPS Web server: task overview
Placing IBM Rational Developer for i V7.5 on an HTTP Web server: task overview
Managing IBM Installation Manager
Installing IBM Installation Manager on Windows
Starting IBM Installation Manager on Windows
Uninstalling IBM Installation Manager on Windows
Silently installing and uninstalling IBM Installation Manager
Silently installing IBM Installation Manager
Silently uninstalling IBM Installation Manager from Windows
Verifying and extracting electronic images
Extracting the downloaded files
Installing from the launchpad program
Starting the launchpad program
Starting an installation from the launchpad program
Installing IBM Rational Developer for i V7.5 by using the Installation Manager GUI
Installing silently
Creating a response file with Installation Manager
Run Installation Manager in silent installation mode
Searching for and silently installing all available products
Silently installing updates to all currently installed products
Response file commands
Reference: Sample response file
Silent install log files
Starting IBM Rational Developer for i V7.5
Managing licenses
License activation
Importing a license activation kit
Viewing license information for installed product packages
Modifying installations
Updating IBM Rational Developer for i V7.5
Reverting updates to previous versions
Uninstalling IBM Rational Developer for i V7.5
IBM Packaging Utility
Installing IBM Packaging Utility
Copying product packages to an HTTP server using IBM Packaging Utility
Notices
Trademarks and service marks

Overview

This installation guide provides instructions for installing, updating, and uninstalling IBM® Rational® Developer for i V7.5.

You can find the most recent version of this Installation Guide online at http://download.boulder.ibm.com/ibmdl/pub/software/awdtools/rdi/v75/75/documents/install_instruction/.

IBM Installation Manager

IBM Installation Manager is a program that helps you install the IBM Rational Developer for i V7.5 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 does more than install packages; it helps you keep track of what you have installed, determine what is available for you to install, and organize installation directories.

IBM Installation Manager includes six wizards that make it easy to maintain packages through their life cycles:

  1. The Install wizard walks you through the installation process. You can install a package by simply accepting the defaults, or you can modify the default settings to create a custom installation. Before you install, you are provided with a complete summary of your selections throughout the wizard. Using the wizard you can install one or more packages at one time.
  2. The Update wizard will search for available updates to packages that you have installed. An update might be a released fix, a new feature, or a new version of the product. Details of the contents of the update are provided in the wizard. You can choose whether to apply an update.
  3. The Manage Licenses wizard helps you set up the licenses for your packages. Use this wizard to change your trial license to a full license.
  4. The Roll Back wizard enables you to revert to a previous version of a package.
  5. The Uninstall wizard will remove a package from your computer. You can uninstall more than one package at a time.
  6. With the Modify wizard you can modify certain elements of a package that you have already installed. During the first installation of the package, you select the features that you want to install. If you find later that you require other features, you can use the modify packages wizard to add them to your package. You can also remove features and add or remove languages.

For more information about IBM Installation Manager, visit the IBM Installation Manager Information Center at http://publib.boulder.ibm.com/infocenter/install/v1r2/index.jsp.

IBM Rational Software Delivery Platform

The IBM Rational Software Delivery Platform is a common development environment that contains the development workbench and other software components that are shared by multiple products.

Installation requirements

This section details hardware, software, and user privilege requirements that must be met in order to successfully install and run IBM Rational Developer for i V7.5.

Hardware requirements

Before you can install IBM Rational Developer for i V 7.5, verify that your system meets the minimum hardware requirements.

The following are hardware requirements for installing:

Hardware Requirements
Processor Intel® Pentium® III 800 MHz processor minimum (higher is recommended)
Memory 512 MB RAM; 1 GB RAM recommended
Disk Space Minimum: 800 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 install.
  • Additional disk space is required if you download the product package to install this product.
  • Additional disk space is required if you use FAT32 instead of NTFS.
  • An additional 500 MB of disk space is required in the directory pointed to by your environment variable TEMP.
Display 1024 x 768 resolution minimum using 256 Colors (or higher for best results)
Other hardware

  • Microsoft® mouse or compatible pointing device
  • CD-ROM drive

Software requirements

Before you can install IBM Rational Developer for i V7.5, verify that your system meets the software requirements.

System

Operating system

The following operating systems (running in 32-bit mode) are supported for this product:

Note:
IBM Rational Developer for i V7.5 is not supported on Microsoft Windows operating systems running on 64-bit processors.

The listed operating systems support all of the languages that are supported by IBM Rational Developer for i V7.5.

Software requirements for extending an existing Eclipse IDE

The products in this version of the IBM Rational Software Delivery Platform were developed for use with version 3.4.1 of the Eclipse IDE. You can only extend an existing Eclipse IDE of version 3.4.1 with latest updates from the open source community.

To extend an existing Eclipse IDE, you also require a JRE from the following Java™ development kit:

Note:
You might need to update your Eclipse version in order to install updates to IBM Rational Developer for i V7.5. Refer to the update's release documentation for information on changes to the prerequisite Eclipse version.

Other software requirements

Some features of IBM Rational Developer for i V7.5, such as the IBM i Web Services and Java Tools feature require additional software. These features depend on some features that are provided in the following products:

Refer to the Features section for details.

To properly view multimedia user assistance, such as tours, tutorials, and demonstration viewlets, you must install Adobe® Flash Player, Version 6.0 release 65, or later.

User privileges requirements

You must have a user ID that meets the following requirements before you can install IBM Rational Developer for i V7.5.

Planning to install

Read all the topics in this section before you begin to install or update 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 you install or update IBM Rational Developer for i V7.5.

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 IBM Installation Manager program in silent mode to install IBM Rational Developer for i V7.5. For details on running IBM Installation Manager in silent mode, see Installing silently.

Note also that you can install updates at the same time that you install the base product package.

Installing from CDs

In this installation scenario, you have the CDs that contain the product package files, and typically you are installing IBM Rational Developer for i V7.5 on your own workstation. See Installing Rational Developer for i 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 either IBM Passport Advantage or IBM's Entitled software support site and you will install IBM Rational Developer for i V7.5 on your own workstation. See Installing IBM Rational Developer for i V7.5 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 IBM Rational Developer for i V7.5 from either IBM Passport Advantage or IBM's Entitled software support site. See Installing IBM Rational Developer for i V7.5 from an electronic image on a shared drive: task overview for an overview of the steps.

Installing from a repository on an HTTP or HTTPS Web server

This scenario is the fastest method for installing the product on a network and is different from the shared-drive installation. To place product package files for IBM Rational Developer for i V7.5 on an HTTP or HTTPS Web server, you must use IBM Packaging Utility, a utility application, to copy the installation files in a package format that you can use to install IBM Rational Developer for i V7.5 directly from an HTTP or HTTPS Web server. This utility is provided with IBM Rational Developer for i V7.5. The directory on the HTTP or HTTPS Web server that contains the package is called a repository. See Installing Rational Developer for i V7.5 from a repository on an HTTP or HTTPS Web server: task overview and Placing IBM Rational Developer for i V7.5 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 IBM Rational Developer for i V7.5 to install.

When you install the IBM Rational Developer for i V7.5 product package by 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). IBM Installation Manager automatically enforces any dependencies between features and prevents you from clearing any required features.

If you select any non-English language during the installation, all languages are installed. For components from other groups that do not translate into the same set, a mix of English and translated content may appear.

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

Features

The following table shows the features of IBM Rational Developer for i V7.5 that you can choose to install. Default selections of features to install might vary. If a feature already exists in your shared resources directory, it will not be selected by default and will not be installed again.

Name Description Selected for installation by default
Remote System Explorer and IBM i Projects Provides integrated tools for developing native IBM i applications. These workstation tools allow you to connect to IBM i, manage libraries, objects, members, jobs and IFS files, edit source members using a modern workstation based editor with many rich editing features for RPG, COBOL, CL and DDS, launch compiles and retrieve error feedback, perform remote searches and remotely debug programs. Yes
Screen Designer Technology Preview Screen Designer Technology Preview provides the ability to graphically edit DDS display files. Screen Designer integrates a graphical design environment with the DDS-editing capabilities of the Remote Systems LPEX Editor. Provides the ability to graphically edit DDS display files and integrates a graphical design environment with the DDS-editing capabilities of the Remote Systems LPEX Editor. Yes
IBM Application Diagram Component Provides tools to create a graphical view of the different resources in a native IBM i application and their relationships to each other. This includes a diagram to show the call graph for ILE RPG, ILE COBOL, and CL source and a diagram to show the binding relationships for program and service program objects. Yes
IBM i Web Services and Java Tools Provides tools for building SOA applications that use a Java Web Service front end to communicate with the business logic in IBM i ILE programs, service programs, or OPM programs.

Yes (if dependencies are met)

The Web Development Tools and the Tools for WebSphere Application Server 6.0, 6.1, or 7.0 features must be installed first. IBM Installation Manager checks to see that this dependency is met. If not, this feature will be disabled and you cannot select it for installation. See the notes below for details.

Rational Team Concert for i - Client

The Rational Team Concert for i - Client contains everything you need to connect to the Rational Team Concert Server from your workstation and interact with your team. No. This feature is not selected by default.

Note:
  1. During installation, you will be prompted on the Features page to select the package features that you want to install. To see the dependency relationships between features, select Show Dependencies.

    When you click a feature, its brief description displays under Details. When you select or clear features in the packages you are working with, IBM Installation Manager will automatically enforce any dependencies with other features and display updated download size and disk space requirements for the installation.

  2. The Web Development Tools and the Tools for WebSphere Application Server 6.0, 6.1, or 7.0 features are provided by some IBM Rational products. For example, IBM Rational Application Developer V7.5, IBM Rational Business Developer V7.5, IBM Rational Software Architect for WebSphere Software V7.5, IBM WebSphere Integration Developer V6.2.

    Note that in the IBM WebSphere Integration Developer, the Tools for WebSphere Application Server 6.0, 6.1, or 7.0 feature is provided by the optional feature 'Portlet and Portal tools. The Web Development Tools feature is not visible and is always installed by default.

Upgrade and coexistence considerations

If you have a previous version of the product, or if you plan to install multiple Rational Software Delivery Platform 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 into 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.

At the time of release, the following products will share function when installed into a package group:

IBM Rational Developer for i V7.5 does not support installation into a package group that contains one of the following products:

Any number of eligible products can be installed into 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.

Installation repositories

IBM Installation Manager retrieves product packages from specified repository locations.

If the launchpad is used to start IBM Installation Manager, the repository information is passed to Installation Manager. If the IBM 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 IBM 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 or HTTPS Web server. Your system administrators will need to provide you with the correct URL.

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

Setting repository preferences in IBM Installation Manager

When you start the installation of IBM Rational Developer for i V7.5 from the launchpad program, the location of the repository that contains the product package you are installing is automatically defined in IBM Installation Manager when it starts. However, if you start IBM Installation Manager directly (for example, installing IBM Rational Developer for i V7.5 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 IBM Installation Manager before you can install the product package. Specify these repository locations on the Repositories page of the Preferences window. By default, IBM Installation Manager uses an embedded URL in each Rational software development 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.

Before you begin

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

About this task

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

  1. Start IBM Installation Manager.
  2. On the Start page of IBM 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 provided an HTTPS or restricted FTP 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.

What to do next

For IBM Installation Manager to search the default repository locations for the installed packages, ensure the preference Search service repositories during installation and updates on the Repositories preference page is selected. This preference is selected by default.

Package groups and the shared resource directory

When you install the IBM Rational Developer for i V7.5 product package using 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 IBM Rational Developer for i V7.5 package. A package group represents a directory in which packages share resources with other packages in the same group. When you install the IBM Rational Developer for i V7.5 package using IBM Installation Manager, you can create a new package group or install it 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.)

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 IBM Rational Developer for i V7.5 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.

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. For best results, 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 IBM Rational Developer for i V7.5 product package, you can choose to extend an Eclipse integrated development environment (IDE) already installed on your computer by adding the functions that the Rational Developer for i package contains.

The IBM Rational Developer for i V7.5 product package that you install using 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 IBM Rational Developer for i V7.5 product package. However, if you have an existing Eclipse IDE on your workstation, then you have the option to extend it, that is, add to the IDE the additional functionality provided in the IBM Rational Developer for i V7.5 product package.

Note:
Not all features support the Sun JRE.

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

You might extend your existing Eclipse IDE, for example, because you want to gain the functionality provided in the IBM Rational Developer for i V7.5 product package, but you also want to have the preferences and settings in your current IDE when you work with the functionality from the IBM Rational Developer for i V7.5 product package. You also might want to work with plug-ins that you have installed that already extend the Eclipse IDE.

Your existing Eclipse IDE must be version 3.4.1. Installation Manager checks that the Eclipse instance you specify meets the requirements for the installation package.

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 your user ID meets the required access privileges for installing the product. See User privileges requirements.
  3. Read the section Planning to install and give particular attention to the topic Upgrade and coexistence considerations.

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 Rational Developer for i from CDs: task overview

In this installation scenario, you have the CDs that contain the installation files, and typically you are installing Rational Developer for i on your own workstation.

About this task

The following are the general steps for installing from CDs:

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

Installing IBM Rational Developer for i V7.5 from an electronic image on your workstation: task overview

About this task

The following are the general steps for installing IBM Rational Developer for i V7.5 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. You can download the installation image from either IBM Passport Advantage or IBM's Entitled Software Support site. 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. Start the launchpad program. Refer to Starting the launchpad program for details.
  3. Start the installation of IBM Rational Developer for i V7.5 from the Launchpad. For details, see Starting an installation from the launchpad program.
  4. Follow the instructions in the Install wizard to complete the installation. For complete details, see Installing IBM Rational Developer for i V7.5 by using the Installation Manager GUI.

Installing IBM Rational Developer for i V7.5 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 your enterprise can access the installation files for IBM Rational Developer for i V7.5 from a single location.

About this task

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. You can download the installation image from either IBM Passport Advantage or IBM's Entitled Software Support site. 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.

What to do next

To install IBM Rational Developer for i V7.5 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.

Installing Rational Developer for i V7.5 from a repository on an HTTP or HTTPS Web server: task overview

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

Before you begin

These steps assume the repository containing the package for IBM Rational Developer for i V7.5 has been created on the HTTP or HTTPS Web server.

About this task

To install the IBM Rational Developer for i V7.5 package from a repository on an HTTP or HTTPS server:

  1. Complete the preinstallation steps listed in Preinstallation tasks.
  2. Install IBM Installation Manager. Refer to Managing IBM Installation Manager. In this scenario, for example, the IBM Installation Manager installation files are available from a shared drive.
  3. Start IBM Installation Manager. Refer to Starting IBM Installation Manager on Windows for details.
  4. Set the URL of the repository containing the package of IBM Rational Developer for i V7.5 as a repository preference in IBM Installation Manager. See Setting repository preferences in IBM Installation Manager.
  5. Start the Install wizard in IBM Installation Manager and follow the on-screen instructions in the Install Packages wizard to complete the installation. For complete details, see Installing IBM Rational Developer for i V7.5 by using the Installation Manager GUI.

Placing IBM Rational Developer for i V7.5 on an HTTP Web server: task overview

About this task

To prepare IBM Rational Developer for i V7.5 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 from IBM Passport Advantage and the extracted installation image. Refer to Hardware requirements
  3. Download all required parts for the product image from IBM Passport Advantage 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. See Verifying and extracting electronic images for details.
  5. Install on your workstation the IBM Packaging Utility. It is located in folder PackagingUtility on disk1.
  6. Using the Packaging Utility, copy the IBM Rational Developer for i V7.5 product package.
  7. Copy the output of the Packaging Utility to an HTTP or HTTPS Web server.
  8. Copy the installation files for IBM Installation Manager from product disk1 to a shared drive.
  9. Instruct users in your organization to install IBM Installation Manager.
  10. Provide users the URL for the repository that contains the IBM Rational Developer for i V7.5 product package you created earlier.

Managing IBM Installation Manager

About this task

This section deals with some common tasks relating to IBM Installation Manager. For more information, see the IBM Installation Manager online help or the IBM Installation Manager Information Center at http://publib.boulder.ibm.com/infocenter/install/v1r2/index.jsp.

Installing IBM Installation Manager on Windows

About this task

If you start the installation of your product from the launchpad program, then the installation of IBM Installation Manager is started automatically if it is not already installed on your workstation. (For more information on this process, refer to Installing from the launchpad program.) In other cases, you must manually start the installation of IBM Installation Manager.

To start the installation of IBM Installation Manager manually:

  1. Run install.exe from the InstallerImage_win32 folder on the first installation disk.
  2. Click Next on the Install Packages page.
  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 Browse button on the Location page to change the installation location if required. Click Next.
  5. Click Install on the Summary page. When the installation process is complete, a message confirms the success of the process.
  6. Click Finish. IBM Installation Manager opens.

Starting IBM Installation Manager on Windows

About this task

IBM Installation Manager should be started from the launchpad program. Doing so starts IBM Installation Manager with a configured repository preference and selected IBM Rational Developer for i V7.5 packages. If you start IBM Installation Manager directly, then you must set a repository preference and choose product packages manually. For more information, see Planning to install.

To start IBM Installation Manager manually:

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

Uninstalling IBM Installation Manager on Windows

About this task

To uninstall IBM Installation Manager from Windows complete the following steps:

  1. Click Start -> Control Panel.
  2. In the Control Panel window, click Add or Remove Programs.
  3. In the Add or Remove Programs window, select IBM Installation Manager and click Remove.
  4. In the Add or Remove Programs dialog box, click Yes to continue with the removal.

Silently installing and uninstalling IBM Installation Manager

IBM Installation Manager can be silently installed and uninstalled.

Silently installing IBM Installation Manager

About this task

To install IBM Installation Manager silently, switch to the InstallerImage_win32 subdirectory on disk1, then use the following commands:

After installation, you can use IBM Installation Manager or the IBM Installation Manager installer to silently install packages.

Silently uninstalling IBM Installation Manager from Windows

About this task

To silently uninstall IBM Installation Manager on Windows:

  1. From a command line, go to the uninstall directory for the IBM Installation Manager. By default, this is C:\Documents and Settings\All Users\Application Data\IBM\Installation Manager\uninstall. On Vista, by default the uninstall directory is C:\ProgramData\IBM\Installation Manager\uninstall
  2. Enter the following command: uninstallc.exe --launcher.ini silent-uninstall.ini

Verifying and extracting electronic images

If you download the installation files from IBM Passport Advantage or IBM's Entitled Software Support site, you must extract the electronic image from the compressed files before you can install IBM Rational Developer for i V7.5.

About this task

If you select the Download Director option for downloading the installation files, the Download Director applet automatically verifies the completeness of each file that it processes.

Extracting the downloaded files

About this task

Extract each compressed file to the same root directory (for example, C:\RDi75). After the files are extracted, they look like this:

Installing from the launchpad program

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

About this task

Use the launchpad program to start the installation of IBM Rational Developer for i V7.5 in the following cases:

By starting the installation process from the launchpad program, IBM Installation Manager is automatically installed if it is not already on your computer, and it starts preconfigured with the location of the repository that contains the IBM Rational Developer for i V7.5 package. If you install and start Installation Manager directly, then you must set repository preferences 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 IBM Rational Developer for i V7.5. See Starting an installation from the launchpad program.

What to do next

Follow the instructions in the Install Packages wizard to complete the installation. For complete details, see Installing IBM Rational Developer for i V7.5 by using the Installation Manager GUI.

Starting the launchpad program

Before you begin

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

About this task

If you are installing from a CD and autorun is enabled on your workstation, then the IBM Rational Developer for i V7.5 launchpad starts automatically when you insert the first installation disc into your CD 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 disk1 of IBM Rational Developer for i V7.5 into your CD drive.
  2. If autorun is enabled on your system, the IBM Rational Developer for i launchpad program automatically opens. If autorun is not enabled on your system, or if you are installing from an electronic image:

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 IBM Rational Developer for i V7.5.
  4. If IBM Installation Manager is not detected on your system or if an older version is already installed, when the installation wizard start, it lists both the IBM Installation Manager V1.2 and IBM Rational Developer for i for installation. If IBM Installation Manager V1.2 is already installed, only IBM Rational Developer for i V7.5 will be shown.
  5. Follow the instructions in the wizard to complete the installation of IBM Installation Manager and IBM Rational Developer for i. Refer to Installing IBM Installation Manager on Windows for more information.

Installing IBM Rational Developer for i V7.5 by using the Installation Manager GUI

The following steps describe installing the IBM Rational Developer for i V7.5 package with the IBM Installation Manager graphical user interface (GUI).

  1. From the IBM Installation Manager Start page, click Install.
    Note:
    If a new version of Installation Manager is found, you are prompted to confirm that you want to install it before you can continue. Click OK to proceed. Installation Manager automatically installs the new version, stops, restarts, and resumes.
  2. The Install wizard lists all the packages found in the repositories that IBM Installation Manager searched. If two versions of a package are discovered, only the most recent, or recommended, version of the package is displayed.
  3. Click the IBM Rational Developer for i V7.5 package to display its description in the Details pane.
  4. To search for updates to the IBM Rational Developer for i V7.5 package, click Check for Other Versions and Extensions.
    Note:
    For Installation Manager to search the predefined IBM update repository locations for the installed packages, the preference Search the linked repositories during installation and updates on the Repositories preference page must be selected. This preference is selected by default. Internet access is also required.
    Installation Manager searches for updates at the predefined IBM update repository for the product package. It also searches any repository locations that you have set. A progress indicator shows the search is taking place. You can install updates at the same time that you install the base product package.
  5. If updates for the IBM Rational Developer for i V7.5 package are found, then they will be displayed in the Installation Packages list on the Install Packages page below their corresponding product. Only recommended updates are displayed by default.
  6. Select the IBM Rational Developer for i V7.5 package and any updates to the package that you want to install. Updates that have dependencies are automatically selected and cleared together. Click Next to continue.
    Note:
    If you install multiple packages at the same time, then all the packages will be installed into the same package group.
  7. On the Licenses page, read the license agreement for the selected package.

    If you selected more than one package to install, there might be a license agreement for each package. On the left side of the License page, click each package version to display its license agreement. The package versions that you selected to install (for example, the base package and an update) are listed under the package name.

    1. If you agree to the terms of all of the license agreements, click I accept the terms of the license agreements.
    2. Click Next to continue.
  8. If you are installing Rational V7.0 (or later) product for the first time, type the path for the shared resources directory in the Shared Resources Directory field on the Location page, or accept the default path. The shared resources directory contains resources that can be shared by one or more package groups. Click Next to continue.

    The default path is:

    Important:
    You can specify the shared resources directory only the first time that you install a package. Use your largest disk for this to help ensure adequate space for the shared resources of future packages. You cannot change the directory location unless you uninstall all packages.
  9. On the Location page, create a new package group to install the IBM Rational Developer for i V7.5 package into, or use an existing package group. A package group represents a directory in which packages share resources with other packages in the same group. To create a new package group:
    1. Click Create a new package group.
    2. Type the path for the installation directory for the package group. The name for the package group is created automatically.

      The default path is:

      • C:\Program Files\IBM\SDP
    3. Click Next to continue.
  10. On the next Location page, you can choose to extend an existing Eclipse IDE already installed on your system, adding the functionality in the packages that you are installing. You must have Eclipse Version 3.4.1 with the latest updates from eclipse.org to select this option.
  11. On the Features page under Languages, select the languages for the package group. The corresponding national language translations for the user interface and documentation for the IBM Rational Developer for i 7.5 product package will be installed.
  12. In the Features page where you select features for installation, the IBM i® Web Services and Java Tools feature might be disabled. If this happens, it means that the features that this feature depends on have not been installed yet. If this feature is disabled, you can continue your installation of IBM Rational Developer for i V7.5 without it. After the required features have been installed, use the Modify Packages option in the IBM Installation Manager to add this feature. Refer to Features for details.

    You can also select the Rational Team Concert for i - Client option if you need to connect to the Rational Team Concert Server from your workstation and interact with your team.

    On the Summary page, review your choices before installing the IBM Rational Developer for i V7.5 package. If you want to change the choices that you made on previous pages, click Back and make your changes. When you are satisfied with your installation choices, click Install to install the package.

  13. When the installation process is complete, a message confirms the success of the process.
    1. Click View log file to open the installation log file for the current session in a new window. You must close the Installation Log window to continue.
    2. Click Finish to launch the selected package. The Install Package wizard closes and you are returned to the Start page of Installation Manager.

Installing silently

You can install the IBM Rational Developer for i V7.5 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.

About this task

Running Installation Manager in silent mode is helpful because it enables you to use a batch process to install, update, modify and uninstall product packages through scripts.

There are two main tasks required for silent installation:

  1. Create the response file.
  2. Run Installation Manager in silent installation mode.

Creating a response file with Installation Manager

You can create a response file by recording your actions as you install a Rational Developer for i product package using Installation Manager, or the Installation Manager installer. When you record a response file, all of the selections that you make in the Installation Manager GUI are stored in an XML file. When you run Installation Manager in silent mode, Installation Manager uses the XML response file to locate the repository that contains the package, select the features to install, and so on.

About this task

To record a response file for installation (or uninstallation):

  1. On a command line, change to the eclipse subdirectory in the directory where you installed Installation Manager. For example:
  2. On a command line, type the following command to start the Installation Manager, substituting your own file name and location for the response file and (optionally) the log file:
    Note:
    Ensure the file paths you enter exist; Installation Manager will not create directories for the response file and the log file.
  3. Follow the instructions in the Install Packages wizard to make your installation choices. For details, see Installing IBM Rational Developer for i V7.5 by using the Installation Manager GUI.
  4. Click Finish, then close Installation Manager.

Results

An XML response file is created and resides in the location specified in the command.

Run Installation Manager in silent installation mode

About this task

After a response file is created, run the following command from the eclipse subdirectory to install the product silently:

The following table describes the arguments used with the silent installation command:

Argument Description
-vm Specifies the Java launcher. In silent mode, always use java.exe on Windows, and java on other platforms.
-nosplash
Specifies that the splash screen should be suppressed.
--launcher.suppressErrors
Specifies that the JVM error dialog should be suppressed.
-silent Specifies that the IBM Installation Manager installer or IBM Installation Manager should be run in silent mode.
-input
Specifies an XML response file as the input to IBM Installation Manager installer or the IBM Installation Manager. A response file contains commands that installer or IBM Installation Manager runs.
-log
(Optional) Specifies a log file that records the result of the silent installation. The log file is an XML file.

Searching for and silently installing all available products

You can silently search for and install updates for all available products.

About this task

To search for and silently install all available products:

  1. On a command line, change to the eclipse subdirectory in the directory where you installed IBM Installation Manager.
  2. Enter and run the following command, substituting your own locations for the response file and, optionally, the log file:

Results

All available products known to IBM Installation Manager are installed.

Silently installing updates to all currently installed products

You can silently search for and install updates for all currently installed products.

About this task

To search for and silently install updates for all available products:

  1. On a command line, change to the eclipse subdirectory in the directory where you installed IBM Installation Manager.
  2. Enter and run the following command, substituting your own locations for the response file and, optionally, the log file:

Results

All available product updates known to IBM Installation Manager are installed.

Response file commands

If you want to use the silent installation capabilities of IBM Installation Manager, you need to create a response file that contains all of the commands that IBM Installation Manager must run. The recommended way to do this is to create a response file by recording your actions as you install the IBM Rational Developer for i V7.5 package. However, you can create or edit a response file manually.

There are two categories of commands for the response file:

For more detailed information about silent installation, visit the IBM Installation Manager Information Center at http://publib.boulder.ibm.com/infocenter/install/v1r2/index.jsp.

Reference: Sample response file

You can use an XML-based response file to specify predefined information such as silent installation preferences, repository locations, installation profiles, and so on. Response files are beneficial for teams and companies that want to install installation packages silently and to standardize the locations and preferences for installation packages.

Sample response file
<agent-input >

<!-- add preferences -->
<preference name="com.ibm.cic.common.core.preferences. http.proxyEnabled" 
value="c:/temp"/>

<!-- create the profile if it doesn't exist yet -->
<profile id="my_profile" installLocation="c:/temp/my_profile"></profile>

<server>
<repository location= 
"http://a.site.com/local/products/sample/20060615_1542/repository/"></repository>
</server>

<install>
	<offering profile= "my_profile" features= "core" id= "ies" 
version= "3.2.0.20060615">
	</offering>
</install>

</agent-input>

Silent install log files

You can use silent install log files to examine the results of a silent installation session.

The silent installation functionality creates an XML-based log file that records the result of the silent install execution (as long as a log file path is specified using -log your_log_file_path.xml). If your silent installation session is successful, the log file will contain just the root element of <result> </result>. However, if errors occur during the installation, the silent install log file will contain error elements with messages such as:

<result>
	<error> Cannot find profile: profile id</error>
	<error> some other errors</error>
</result>

For detailed analysis, you can look at the logs generated in the Installation Manager data area. By using a preference command, you can optionally set the data area to your preferred location, as shown in the response file topic.

Starting IBM Rational Developer for i V7.5

You can start IBM Rational Developer for i V7.5 from the desktop environment or a command-line interface. For example, click Start -> Programs -> IBM Software Delivery Platform -> IBM Rational Developer for i -> IBM Rational Developer for i.

About this task

To start IBM Rational Developer for i V7.5 from a command-line:

Managing licenses

Licensing for your installed IBM software and customized packages is administered using the Manage Licenses wizard in the IBM Installation Manager. The Manage Licenses wizard displays license information for each of your installed packages.

About this task

Using the Manage Licenses wizard, you can upgrade trial versions of an offering to a licensed version by importing a product activation kit.

License activation

If you are installing the software for the first time or want to extend a license to continue using the product, you can activate licensing for your product by importing a license activation kit.

Licenses for this product are activated by importing a license activation kit.

Note:
If you are using a trial license, it will expire 60 days after installation. You need to activate your product to use it after the expiration date.

Activation kits

A license activation kit contains the permanent license key for you product. You purchase the activation kit, download the activation kit compressed file to your computer, and then use IBM Installation Manager to import the activation kit (a .jar file) to activate the license for your product.

Importing a license activation kit

To install your permanent license key, you must import the license activation kit from the download location or the product media by using IBM Installation Manager.

Before you begin

If you have not purchased an activation kit, you must do this first. If you have purchased a product or a product activation kit, insert the appropriate CD or download the activation kit from IBM Passport Advantage to an accessible workstation. The activation kit is packaged as a .zip file containing a Java archive (.jar) file. The .jar file contains the permanent license key and must be imported to activate your product.

About this task

To import an activation kit .jar file and enable the new license key, complete the following steps:

  1. Start IBM Installation Manager.
  2. On the main page, click Manage Licenses.
  3. Select a package and click Import Activation Kit.
  4. Click Next. Details for the selected package are shown, including the current license kind and the product version range of the license.
  5. Browse to the path on the media CD or download location for the activation kit; then select the appropriate Java archive (JAR) file and click Open.
  6. Click Next. The Summary page displays the target install directory for the activation kit, the product the new license applies to, and version information.
  7. Click Finish.

Results

The product activation kit with its permanent license key is imported to the product. The Manage Licenses wizard indicates whether the import is successful.

Viewing license information for installed product packages

You can review license information for your installed product packages, including license types and expiration dates, from IBM Installation Manager.

About this task

To view license information, complete the following steps:

  1. Start IBM Installation Manager.
  2. On the Start page, click Manage Licenses.

Results

The package vendor, current license types, and expiration dates are displayed for each installed product package.

Modifying installations

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

Before you begin

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 IBM Installation Manager before modifying.

About this task

To modify an installed product package:

  1. From the Start page of the IBM Installation Manager, click the Modify icon.
  2. In the Modify wizard, select the installation location for the IBM Rational Developer for i V7.5 product package and click Next.
  3. On the Modify page, under Languages, select the languages for the package group, then click Next. The corresponding national language translations for the user interface and documentation for the packages will be installed. Note that your choices apply to all packages installed under this package group.
  4. On the Features page, select the package features that you want to install or remove.
    1. To learn more about a feature, click the feature and review the brief description under Details.
    2. If you want to see the dependency relationships between features, select Show Dependencies. When you click a feature, any features that depend on it and any features that are its dependents are shown in the Dependencies window. As you select or exclude features in the packages, Installation Manager will automatically enforce any dependencies with other features and display updated download size and disk space requirements for the installation.
  5. When you are finished selecting features, click Next.
  6. On the Summary page, review your choices before modifying the installation package, and then click Modify.
  7. Optional: When the modification process completes, click View Log File to see the complete log.

Updating IBM Rational Developer for i V7.5

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

Before you begin

By default, Internet access is required unless your repository preferences points to your local update site.

Each installed package has the location embedded for its default IBM update repository. For IBM Installation Manager to search the IBM update repository locations for the installed packages, the preference Search service repositories during installation and updates on the Repositories preference page must be selected. This preference is selected by default.

See the IBM Installation Manager help for more information.

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

About this task

To find and install product package updates:

  1. From the Start page of the Installation Manager, click Update.
  2. If a new release or an update of IBM Installation Manager is found, you must continue with the installation of the new release or update. Follow the instructions in the wizard to complete the installation or updating of Installation Manager.
  3. In the Update wizard, select the location of the package group where the IBM Rational Developer for i V7.5 product package you want to update is installed or select the Update All check box, and then click Next. IBM Installation Manager searches for updates in its repositories and the predefined update sites for IBM Rational Developer for i V7.5. A progress indicator shows the search is taking place.
  4. If updates for a package are found, then they are displayed in the Updates list on the Update Packages page below their corresponding package. Only recommended updates are displayed by default. Click Show all to display all updates found for the available packages.
    1. To learn more about an update, click the update and review its description under Details.
    2. If additional information about the update is available, a More info link will be included at the end of the description text. Click the link to display the information in a browser. Review this information before installing the update.
  5. Select the updates that you want to install or click Select Recommended to restore the default selections. Updates that have a dependency relationship are automatically selected and cleared together.
  6. Click Next to continue.
  7. On the Licenses page, read the license agreements for the selected updates. On the left side of the License page, the list of licenses for the updates you selected is displayed; click each item to display the license agreement text.
    1. If you agree to the terms of all the license agreements, click I accept the terms of the license agreements.
    2. Click Next to continue.
  8. On the Summary page, review your choices before installing the updates.
    1. If you want to change the choices you made on previous pages, click Back, and make your changes.
    2. When you are satisfied, click Update to download and install the updates. A progress indicator shows the percentage of the installation completed.
    Note:
    During the update process, Installation Manager might prompt you for the location of the repository for the base version of the package. If you installed the product from CDs or other media, they must be available when you use the update feature.
  9. Optional: When the update process completes, a message that confirms the success of the process is displayed near the top of the page. Click View log file to open the log file for the current session in a new window. You must close the Installation Log window to continue.
  10. Click Finish to close the wizard.

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. IBM Rational Developer for i V7.5 does not support rollback.

Before you begin

During the rollback process, IBM Installation Manager must access files from the earlier version of the package. By default, these files are stored on your computer when you install a package. If you installed the package from a repository, the files are not available on your computer. You must have listed in your Preferences (File > Preferences > Repository) the repository from which you installed the previous version of the product. If you installed the product from CDs or other media, they must be available when you use the rollback feature.

About this task

Use the rollback feature if you have applied an update to a product package and decide later that you want to remove the update and revert to the earlier version of the product. When you use the rollback feature, IBM Installation Manager uninstalls the updated resources and reinstalls the resources from the previous version. You can only roll back one version level at a time.

For more information, see the IBM Installation Manager online help or Information Center.

To revert an update to a previous version, complete the following steps:

  1. On the Start page, click Roll back Packages.
  2. In the Rollback wizard, from the Installation Packages list, select the package that you want to revert to the previous version.
  3. Follow the instructions in the wizard.

Uninstalling IBM Rational Developer for i V7.5

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

About this task

To uninstall the packages:

  1. Close the programs that you installed using IBM Installation Manager.
  2. On the Start page, click Uninstall.
  3. On the Uninstall Packages page, select the IBM Rational Developer for i V7.5 product package that you want to uninstall. Click Next.
  4. On the Summary page, review the list of packages that will be uninstalled and then click Uninstall. The Complete page is displayed after the uninstallation finishes.
  5. Click Finish to exit the wizard.

IBM Packaging Utility

Use IBM Packaging Utility software to copy product packages to a repository that can be placed on a Web server available over HTTP or HTTPS.

Use this utility to perform the following tasks:

IBM Packaging Utility software is located on disk1. If you want to place a repository that contains an IBM Rational Developer for i V7.5 product package on a Web server that will be available over HTTP or HTTPS, you must use IBM Packaging Utility to copy the product package of IBM Rational Developer for i V7.5 into the repository.

Refer to the online help for IBM Packaging Utility for full instructions about using the tool.

Installing IBM Packaging Utility

IBM Packaging Utility must be installed from disk1 before it can be used to copy the IBM Rational Developer for i V7.5 product package.

About this task

Use the following steps to install IBM Packaging Utility software from disk1:

  1. Navigate to the PackagingUtility directory and extract the Packaging Utility installation package from the compressed file (pu.disk_win32.zip).
  2. Locate the Packaging Utility installer executable.
  3. Start the installer executable and follow the instructions in the wizard to install the IBM Packaging Utility.
  4. Follow the instructions in the Install Packages wizard to complete the installation.

Copying product packages to an HTTP server using IBM Packaging Utility

To create a repository on an HTTP or HTTPS server, you must use IBM Packaging Utility to copy the product package for IBM Rational Developer for i V7.5.

About this task

Note also that IBM Packaging Utility can be used to combine multiple product packages into a single repository location. See the IBM Packaging Utility online help for more information.

To copy product packages with IBM Packaging Utility:

  1. If you are copying from a CD image, perform these tasks:
    1. Insert the disk1 into your CD drive.
    2. If autorun is enabled on your system, the IBM Rational Developer for i V7.5 launchpad program automatically opens. Close the launchpad program.
  2. Start IBM Packaging Utility.
  3. On the main page of the utility, click Copy Packages. The Copy page displays.
  4. Click Next to advance to the Source page. If there are no product packages to select, you must open a repository that contains product packages.
  5. To open a repository, click the Open repository button. The Open Repository window opens.
    Note:
    A repository can be a path to a directory in the file system, a disk drive containing disk1 of the product, or a URL to a directory on a server.
  6. To define a repository location, click the Repository Location Browse button, and then navigate to and select the Repository location - either the common root directory that contains the electronic disk images or the drive containing disk1. For example, if the IBM Rational Developer for i V7.5 files reside in C:\My product\unzip, you should define this location as a repository.
  7. Click OK to define the repository location and to close the Browse to a repository directory window.
  8. On the Destination page, click the Browse button and select an existing repository directory, or create a new folder to store the products.
  9. After you specify a repository for the selected product packages and any fixes, click OK to close the Browse to a directory window.
  10. Click Next to advance to the Summary page. The Summary page displays the selected product packages that will be copied into the destination repository. This page also lists the amount of storage space that the copy requires, as well as the amount of available space on the drive.
  11. Click Copy to copy the selected product packages to the destination repository. A status bar opens at the bottom of the wizard indicating how much time is remaining in the copy process. After the copy process is finished, a Complete page opens and displays all of the product packages that were copied successfully.
  12. Click Done to return to the Packaging Utility main page.

Example

Now that you have used IBM Packaging Utility to copy the IBM Rational Developer for i V7.5 installation files into a repository, you can place the repository on a Web server and make the directories and files available over HTTP. (The repository can also be placed on a UNC drive.)

Notices

© Copyright IBM Corporation 2008. All rights reserved.

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 documentation 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 documentation. The furnishing of this documentation does not give 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 OR CONDITIONS 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.

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.

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.

Acrobat and Acrobat Reader are trademarks of Adobe Systems Incorporated in the United States, other countries, or both.

Java is a trademark of Sun Microsystems, Incorporated in the United States, other countries, or both.

Pentium is a trademark of Intel Corporation in the United States, other countries, or both.

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