IBM Rational Software Analyzer, Version 7.0.0

Installation Guide

Overview

You can find the most recent version of this Installation Guide online at http://download.boulder.ibm.com/ibmdl/pub/software/rationalsdp/v7/rsar/70/ /docs/install_instruction/install.html.

IBM Installation Manager

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

• Install product packages
• Manage licenses for installed product packages
• Search for and install updates to installed product packages
• Modify installed product packages
• Roll back installed product packages to earlier versions
• Uninstall product packages

For more information about IBM Installation Manager, see the Installation Manager Information Center:

http://www.ibm.com/software/awdtools/installmanager/support/index.html

IBM Rational Software Delivery Platform

The delivery platform includes the following offerings:

• Rational Application Developer
• Rational Functional Tester
• Rational Performance Tester
• Rational Software Analyzer
• Rational Software Architect
• Rational Software Modeler
• Rational Systems Developer
• Rational Tester for SOA Quality

Also available but not part of the platform is Rational Manual Tester. Rational Manual Tester is included with Rational Functional Tester, or it can be purchased separately.

About Rational Software Analyzer

IBM Rational Software Analyzer is a simple and powerful software analysis tool. The developer edition is an Eclipse-based, standalone product that features language support for Java and C++, and a rich set of analysis rules for code review, architectural discovery, software metrics, and data flow analysis. Developers use a single, common interface to perform any type of analysis, view results, and fix problems.

Built on an extensible framework, the product includes an analysis API for customizing and creating new analysis rules, reports, and for integrating rules from other analysis tools.

For managers, the enterprise edition offers centralized reporting features to manage quality and compliance, and enables build integration for software analysis through the Rational Build Forge product.

Installation requirements

For the most up-to-date, detailed system requirements, see http://www.ibm.com/software/awdtools/analyzer/swanalyzer/sysreq/index.html.

Hardware requirements

Software requirements

Operating system

This product runs on the following operating systems:

• Microsoft^(R) Windows^(R) XP Professional with Service Pack 1 or 2
• Microsoft Windows Vista Business, Windows Vista Enterprise, and Windows Vista Ultimate
• Red Hat Enterprise Linux^(R) server versions 4.0 and 5.0 (32-bit mode)
• Red Hat Enterprise Linux Desktop versions 4.0 and 5.0 (32-bit mode)
• SUSE Linux Enterprise Server (SLES) versions 9 and 10 (32-bit mode)
• SUSE Linux Enterprise Desktop (SLED) versions 9 and 10 (32-bit mode)

The listed operating systems support all the languages that Rational Software Analyzer supports.

Software requirements for extending an existing Eclipse IDE

This version of the IBM Rational Software Analyzer product was developed for use with version 3.3 or later of the Eclipse IDE. You can only extend an existing Eclipse IDE of version 3.3 with latest updates from eclipse.org.

To extend an existing Eclipse IDE, you also require a JRE from one of the following Java^(TM) development kits:

• IBM 32-bit SDK for Windows, Java 2 Technology Edition, Version 5.0 service release 5; or Sun Java 2 Standard Edition 5.0 Update 12 for Microsoft Windows
• IBM 32-bit SDK for Linux on Intel architecture, Java 2 Technology Edition, Version 5.0 service release 5; or Sun Java 2 Standard Edition 5.0 Update 12 for Linux x86 (not supported for SUSE Linux Enterprise Server [SLES] Version 9)

Additional software requirements

• For the enterprise edition of Rational Software Analyzer, the Apache Tomcat server is configured to use default port 8080. If port 8080 is in use, configure Apache Tomcat to use a different port as follows:
  1. If the Rational Software Analyzer server is started, stop it.
  2. In the root installation directory, locate the tomcat\conf directory, and open the server.xml file.
  3. Change port="8080" to an available port.
  4. Start the Rational Software Analyzer server.
• To view the readme files and the installation guide, and to support the Standard Widget Toolkit (SWT) browser widget, you must have one of the following Web browsers:
  • Microsoft Internet Explorer 6.0 with Service Pack 1, or later
  • Mozilla
  • Firefox 1.0.x, 1.5, 2.0, or later
  Note:
  The launchpad does not support Mozilla 1.6; if your browser is Mozilla, you need version 1.7, or later, to run the launchpad.
• To properly view multimedia user assistance, such as tours, tutorials, and demonstration viewlets, you must install Adobe^(R) Flash Player.
  • Version 6.0 release 65, or later
  • Version 6.0 release 69, or later

User privilege requirements for installing the product

• Your user ID must not contain double-byte characters.
• You must be able to log in as root.
• 
  • For Windows Vista, you must log in to the Administrator account (or run as Administrator: right-click the program file or shortcut; then select Run as Administrator) to perform the following tasks:
    • Install or update IBM Installation Manager
    • Install or update a product offering
    • Install an Authorized-User license key for your product by using IBM Installation Manager
  • For other supported Windows versions, you must have a user ID that belongs to the Administrators group.

Windows Vista user privilege requirements for running the product

To enable users who do not have Administrator authority to work with Rational Software Analyzer, complete the following steps:

• Do not install the product into a package group that uses the C:\Program Files directory path.
• Do not choose a shared resources directory in the C:\Program Files directory path.

If you do install the product in a package group that uses C:\Program Files or choose a shared resource directory in C:\Program Files, Windows Vista users must run Rational Software Analyzer as Administrator.

If, at a later time, you want to allow Windows Vista users to run as a non-Administrator user, you must reinstall the product to make new selections for the package group and shared resources directory.

Planning to install the product package

Installation scenarios

The following factors might determine your installation scenario:

• The format and method by which you access your installation files (for example, from CDs or files downloaded from IBM Passport Advantage^(R))
• The location for your installation (for example, you can install the product onto your own workstation, or make the installation files available to your enterprise)
• The type of installation (for example, you can use the Installation Manager GUI, or install silently)

These are the typical installation scenarios you might follow:

• Installing from the CDs
• Installing from a downloaded electronic image on your workstation
• Installing from an electronic image on a shared drive
• Installing from a repository on an HTTP or HTTPS Web server

Installing from CDs

In this installation scenario, you have the CDs that contain the product package files, and typically you install Rational Software Analyzer on your own workstation.

See Installing from CDs: task overview.

Installing from a downloaded electronic image on your workstation

In this scenario, you download the installation files from IBM Passport Advantage and you install Rational Software Analyzer on your own workstation.

See Installing 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 place the electronic image on a shared drive so that users in your enterprise can access the installation files for Rational Software Analyzer from a single location.

See Installing from an electronic image on a shared drive: task overview.

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 Rational Software Analyzer on an HTTP or HTTPS Web server, you must use IBM Packaging Utility to copy the installation files in a package format to the server. The directory on the server that contains the product package is called a repository. IBM Packaging Utility is provided with Rational Software Analyzer. The Packaging Utility is on the Enterprise Deployment CD.

See Installing from a repository on an HTTP or HTTPS Web server: task overview and Placing the product package on an HTTP Web server: task overview.

Installation repositories

By default, IBM Installation Manager uses the embedded URL provided for each Rational software product to connect to a repository server over the Internet. Installation Manager then searches for the product packages, product updates, and new product features.

If the launchpad starts Installation Manager, the repository information is passed to Installation Manager. If you start the Installation Manager, you must specify an installation repository that contains the product packages to install.

Specify repository locations in the Preferences window on the Repositories page. See Setting repository preferences in Installation Manager.

Setting repository preferences in Installation Manager

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 shows any available repositories, their locations, and whether they are accessible.

3. On the Repositories page, click Add Repository.
4. In the Add repository window, specify the URL of the repository location and a file path.
5. Click OK.

   If you provided an HTTPS or restricted FTP repository location, then you are 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. To exit, click OK.

Package groups and the shared resource directory

Package groups

During the installation process, you must specify a package group for the Rational Software Analyzer package. A package group represents a directory in which packages share resources with other packages in the same group. When you install the product package using Installation Manager, you 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 is unavailable.

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 that are specific to the product package that is installed into that package group. Resources in the product package that other package groups can potentially use are placed in the shared resources directory.

Shared resources directory

The shared resources directory is the directory where installation artifacts are located so that one or more product package groups can use them.

• You can specify the shared resources directory once: the first time that you install a package. For the best results, use your largest disk drive. You cannot change this directory location unless you uninstall all packages.
• For Windows Vista, to enable users who do not have Administrator privileges to work with Rational Software Analyzer on a Windows Vista system, do not choose a directory in the C:\Program Files path.

Extending an existing Eclipse IDE

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

As an example, you might extend your existing Eclipse IDE to gain the Rational Software Analyzer functionality, but to save the preferences and settings in your current IDE when you work with Rational Software Analyzer. You might also want to work with plug-ins that you installed that already extend the Eclipse IDE.

Coexistence considerations

Offering coexistence considerations

Some products are designed to coexist and share functionality 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 blocks 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 share functionality when installed in a package group:

• Rational Application Developer
• Rational Functional Tester
• Rational Performance Tester
• Rational Software Analyzer
• Rational Software Architect
• Rational Software Modeler
• Rational Systems Developer
• Rational Tester for SOA Quality

Any number of eligible products can be installed in a package group. When a product is installed, its functionality is shared with all 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 the user interface. If you add a product with modeling tools, all of the products in the package group 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 functionality is available in both products. If you uninstall the product with the greater functionality, the original product remains. Note that this is a change from the upgrade behavior of version 6 products in the Rational Software Delivery Platform group.

Preinstallation tasks

1. Confirm that your system meets the requirements described in Installation requirements.
2. Confirm that your user ID meets the required access privileges for installing the product. See User privilege requirements for installing the product.
3. Read Planning to install the product package.

Installation tasks

The following sections provide an overview of the installation scenarios that the Installation scenarios section describes. The main steps link to detailed instructions.

Installing from CDs: task overview

The following steps describe how to install Rational Software Analyzer from CDs:

1. Complete the preinstallation steps listed in Preinstallation tasks.
2. Insert the first product installation CD into your CD drive.

   Mount the CD drive.

3. Start the installation of Rational Software Analyzer from the launchpad. For details, see Starting an installation from the launchpad program.

   If IBM Installation Manager is detected on your workstation, it starts automatically.

   If IBM Installation Manager is not detected on your workstation, then you must install it to continue. Follow the instructions in the wizard. When the installation is complete, Installation Manager starts automatically.

   For details, see Installing Installation Manager on Windows.

4. Click Install Packages and follow the instructions in the Install Packages wizard to complete the installation.

   For details, see Installing the product package using the Installation Manager GUI.

5. Configure your license. By default, a trial license for Rational Software Analyzer is included. You must configure the license to ensure that you have continued access to the product.

   For details, see Managing licenses.

6. Increase the number of file handles on your workstation.

   For details, see Increasing the number of file handles on Linux workstations.

Installing from an electronic image on your workstation: task overview

The following steps describe how to install Rational Software Analyzer 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. See Hardware requirements.
2. From IBM Passport Advantage, download all the required parts for the product image to a temporary directory.
3. Extract the installation image from the downloaded file and verify that the installation image is complete. For details, see Verifying and extracting electronic images.
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. For details, see Starting the launchpad program.
3. Start the installation of Rational Software Analyzer from the launchpad. For details, see Starting an installation from the launchpad program.
   • If IBM Installation Manager is not detected on your workstation, you must install it to continue. When the installation completes, Installation Manager starts automatically. For details, see Installing Installation Manager on Windows.
     Note:
     If you exit Installation Manager before completing the product installation, you must restart Installation Manager from the launchpad. If you start the Installation Manager directly, it is not preconfigured with the necessary installation repositories.
   • If IBM Installation Manager is detected on your workstation but a newer version is found, confirm that you want to install it and click OK to proceed. Installation Manager automatically installs the new version, stops, restarts, and resumes.
     Note:
     To enable Installation Manager to search the predefined IBM update repository locations for Installation Manager, in the Preferences window, on the Repositories page, the Search the linked repositories during installation and updates preference must be selected. This preference is selected by default. Internet access is also required.
4. To complete the installation, click Install Packages and follow the instructions in the Install Packages wizard.

   For details, see Installing the product package using the Installation Manager GUI.

5. Configure your license. By default, a trial license for Rational Software Analyzer is included. You must configure the license to ensure that you have continued access to the product.

   See Managing licenses for details.

6. Increase the number of file handles on your workstation.

   For details, see Increasing the number of file handles on Linux workstations.

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

To place the installation image on a shared drive, you perform the following steps:

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. For details, see Hardware requirements.
2. From IBM Passport Advantage, 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 and verify that the installation image is complete. For details, see Verifying and extracting electronic images.

To install Rational Software Analyzer from the installation files on the shared drive:

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

Installing from a repository on an HTTP or HTTPS Web server: task overview

These steps assume that the repository that contains the package for Rational Software Analyzer has been created on the HTTP or HTTPS Web server.

To install the Rational Software Analyzer package from a repository on an HTTP or HTTPS server:

1. Complete the preinstallation steps listed in Preinstallation tasks.
2. Install IBM Installation Manager. See Managing IBM Installation Manager. In this example, the Installation Manager installation files are available from a shared drive.
3. Start Installation Manager. For details, see Starting Installation Manager on Windows.
4. In Installation Manager, set the URL of the repository that contains the package of Rational Software Analyzer as a repository preference. See Setting repository preferences in Installation Manager.
5. In Installation Manager, start the Install Packages wizard and follow the instructions to complete the installation. For details, see Installing the product package using the Installation Manager GUI.
6. Increase the number of file handles on your workstation. For details, see Increasing the number of file handles on Linux workstations.

Placing the product package on an HTTP Web server: task overview

To prepare Rational Software Analyzer for installation from a repository on an HTTP or HTTPS Web server:

1. Ensure that the HTTP or HTTPS Web server has sufficient disk space to store the product package. See Hardware requirements.
2. Ensure that your workstation has sufficient disk space to store both the files that you must download from IBM Passport Advantage and the extracted installation image. See Hardware requirements.
3. From IBM Passport Advantage, download all the 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. For details, see Verifying and extracting electronic images.
5. From the Enterprise Deployment CD (or electronic disk) appropriate for your platform, install on your workstation the IBM Packaging Utility.
6. Using the Packaging Utility, copy the Rational Software Analyzer product package.
7. Copy the output of the Packaging Utility to an HTTP or HTTPS Web Server.
8. From the Enterprise Deployment CD, copy the installation files for IBM Installation Manager to a shared drive.
9. Instruct users in your organization to install Installation Manager.
10. Provide users with the URL to the repository that contains the Rational Software Analyzer product package you created earlier.

Verifying and extracting electronic images

You might want to verify the completeness of the downloaded files before extracting the image.

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.

Alternatively, you can compare the published MD5 values with the checksum of the downloaded files to determine whether the downloaded file is corrupt or invalid.

Extracting the downloaded files

Extract each compressed file to the same directory.

Do not include spaces in the directory names, or you will not be able to run the launchpad.sh command to start the launchpad from a command line.

Installing from the launchpad program

Use the launchpad program to start Rational Software Analyzer installation if you use any of the following methods:

• Installing from the product CDs
• Installing from an electronic image on your local file system
• Installing from an electronic image on a shared drive

By starting the installation process from the launchpad program, IBM Installation Manager is installed automatically if it is not on your computer, and it starts preconfigured with the location of the repository that contains the Rational Software Analyzer package. If you install and start Installation Manager directly, you must set repository preferences manually.

To install from the launchpad:

1. If you have not done so, complete the preinstallation tasks that are described in Preinstallation tasks.
2. Start the launchpad program. See Starting the launchpad program.
3. Start to install Rational Software Analyzer. See Starting an installation from the launchpad program.

To complete the installation, follow the instructions in the Install Packages wizard. For details, see Installing the product package using the Installation Manager GUI.

Windows Vista requirements for the launchpad program

Review the following requirements before starting the launchpad program on your Windows Vista system:

• You must run the launchpad program as Administrator.
  • If you start the Rational Software Analyzer installation from the launchpad program, you must run the launchpad programs as Administrator.
  • If the launchpad program starts automatically (for example, if you are installing from a CD), stop the launchpad program and restart it by using the Run as administrator command. At the root level of the CD or disk image, right-click launchpad.exe; then click Run as Administrator.
• You should not select installation directories in the C:\Program Files path.

  If you select an installation location or a shared resources directory in the C:\Program Files path, the packages that you install must be run as Administrator.

Starting the launchpad program

If you have not done so, complete the preinstallation tasks that are described in Preinstallation tasks.

If you are installing from a CD and autorun is enabled on your workstation, the Rational Software Analyzer launchpad starts automatically when you insert the first installation disk into your CD drive. If you install from an electronic image, or if autorun is not configured on your workstation, you must start the launchpad program manually.

To start the launchpad program:

1. Insert the IBM Rational Software Analyzer CD into your CD drive.

   Mount the CD drive.

2. If autorun is enabled on your system, the IBM Rational Software Analyzer launchpad program opens automatically. If autorun is not enabled on your system, complete these steps:
   • Run launchpad.exe, which is located in the root directory of the CD.
   • Run launchpad.sh, which is located in the root directory of the CD.

Starting an installation from the launchpad program

1. Start the launchpad program.
2. If you have not done so, read the release information by clicking Release notes.
3. When you are ready to begin the installation, click Install IBM Rational Software Analyzer.

   If IBM Installation Manager is not detected on your system, or if a newer version is available, you must install the latest version.

   To complete the installation of IBM Installation Manager, follow the instructions in the wizard. See Installing Installation Manager on Windows for more information.

   When the installation of IBM Installation Manager completes, click Finish to close the wizard.

   • If this is a new installation, click Install Packages and follow the instructions in the wizard to complete the installation process.

     For details, see Installing the product package using the Installation Manager GUI.

   • If this is a product update, click Update Packages and follow the instructions in the wizard to complete the update process.

     For details, see Updating the product.

Installing the product package using the Installation Manager GUI

1. From the Installation Manager Start page, click Install Packages.
   Note:
   If a new version of Installation Manager is found, confirm that you want to install it to continue. Installation Manager automatically installs the new version, stops, restarts, and resumes.
2. The Install page of the Install Packages wizard lists all the packages found in the repositories that Installation Manager searched. If two versions of a package are discovered, only the most recent, or recommended, version of the package is displayed.
   • To display all versions of any package found by Installation Manager, click Show all versions.
   • To return to the display of only the recommended packages, deselect Show all versions.
3. Click the IBM Rational Software Analyzer package to display its description in the Details pane.
4. To search for updates to the IBM Rational Software Analyzer package, click Check for Other Versions and Extensions.

   Installation Manager searches for package updates in the predefined IBM update repository. It also searches any repository locations that you have set.

   Note:
   To enable Installation Manager to search the predefined IBM update repository locations for the installed packages, in the Preferences window, on the Repositories page, select the Search the linked repositories during installation and updates option. Internet access is also required.
5. If updates for the IBM Rational Software Analyzer package are found, they are displayed in the Installation Packages list on the Install Packages page, below their corresponding product. Only recommended updates are displayed by default.
   • To view all updates found for the available packages, click Show all versions.
   • To display a package description under Details, click the package name. If additional information about the package is available, such as a readme file or release notes, a More info link is included at the end of the description text. Click the link to display the additional information in a browser. To fully understand the package you are installing, review all the information before you start the installation.
6. Select the IBM Rational Software Analyzer 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, all the packages are 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 (for example, the base package and an update) are listed under the package name.

   1. If you agree to the terms of all the license agreements, click I accept the terms in the license agreements.
   2. Click Next to continue.
8. On the Location page, type the path for the shared resources directory in the Shared Resources Directory field, or accept the default path. (If you are installing on Linux, ensure that you do not include any spaces in the directory path.) The shared resources directory contains resources that one or more package groups can share. Click Next to continue.

   The default path is as follows:

   • C:\Program Files\IBM\SDPShared
   • /opt/IBM/SDPShared
   Important:
   You can specify the shared resources directory only the first time that you install a package. To help ensure adequate disk space for shared resources for future packages, use your largest disk drive. You cannot change the directory location unless you uninstall all the packages.
9. On the Location page, create a package group for the IBM Rational Software Analyzer package, or if you are updating a product, use the 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 or use the default path. The name for the package group is created automatically. (For Linux, the directory path cannot include spaces.)
      Important:
      For Windows Vista, do not select the default C:\Program Files directory unless you want your users to run Rational Software Analyzer as an Administrator. For details, see Windows Vista user privilege requirements for running the product.
   3. Click Next to continue.
10. 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 Software Analyzer package will be installed.
11. On the Summary page, review your choices before installing the IBM Rational Software Analyzer package. To change the choices that you made on previous pages, click Back and make the changes. When you are satisfied with your installation choices, click Install to install the package.
12. 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. In the Install Package wizard, select whether you want IBM Rational Software Analyzer to start when you exit the wizard.
    3. To open the selected package, click Finish. The Install Package wizard closes and you return to the Start page of Installation Manager.

Increasing the number of file handles on Linux workstations

Important: For best results, before you work with your Rational product, increase the number of file handles available for Rational Software Analyzer. A system administrator might need to make this change.

Exercise caution when you follow these steps to increase the file descriptors on Linux. Failure to follow the instructions might result in a computer that does not start correctly. For the best results, have your system administrator perform this procedure.

To increase the file descriptors:

1. Log in as root. If you do not have root access, you must obtain it before you continue.
2. Change to the etc directory.
3. Locate the initscript shell script. Open the file or create it with a Linux text editor.

   Important: Do not leave an empty initscript file on your computer. If you do so, your computer will not start the next time that you turn it on or restart it.

4. On the first line, set ulimit to a number significantly larger than 1024, the default on most Linux computers.

   ulimit -n 4096

   Caution: Setting ulimit too high can impact system-wide performance.

5. On the second line, type eval exec "$4".
6. Save and close the shell script.

For more information on the ulimit command, refer to the man page for ulimit.

Starting the product

Click Start > Programs > IBM Rational Software Analyzer > IBM Rational Software Analyzer Developer Edition.

Click Start > Programs > IBM Rational Software Analyzer Enterprise Edition > IBM Rational Software Analyzer Enterprise Edition.

To start Rational Software Analyzer Developer Edition from a command-line:

• <product installation directory>\eclipse.exe -product com.ibm.rational.rsar.product.ide
• <product installation directory>/eclipse -product com.ibm.rational.rsar.product.ide

To start Rational Software Analyzer Enterprise Edition from a command-line:

• <product installation directory>\eclipse.exe -product com.ibm.rational.rsar.enterprise.product.ide
• <product installation directory>/eclipse -product com.ibm.rational.rsar.enterprise.product.ide

Updating the product

Internet access is required unless your repository preferences point to your local update site.

Each installed package provides a location for its default IBM update repository. This location enables Installation Manager to search the IBM update repository for the installed packages if, in the Preferences window, on the Repositories page, the Search service repositories during installation and updates option is selected.

See the Installation Manager help for more information.

To find and install product package updates:

1. From the Start page of the Installation Manager, click Update Packages.
2. If IBM Installation Manager is not detected on your system or if a newer version is found, then you must continue with the installation of the latest release. To complete the installation of IBM Installation Manager, follow the instructions in the wizard.
3. In the Update Packages wizard, select the location of the package group where the Rational Software Analyzer product package that you want to update is installed or select the Update All check box, and then click Next.

   Installation Manager searches for updates in its repositories and in the predefined update sites for Rational Software Analyzer.

4. If updates for a package are found, 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 is included at the end of the description text. Click the link to display the information in a browser. Review this information before you install 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 that 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 in the license agreements.
   2. Click Next to continue.
8. On the Summary page, review your choices before you install the updates.
   1. To change the choices that you made on previous pages, click Back, and make the changes.
   2. When you are satisfied, click Update to download and install the updates. A progress indicator shows what percentage of the installation is complete.
   Note:
   During the update process, Installation Manager might prompt you for the location of the repository that contains 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. To open the log file for the current session in a new window, click View log file. You must close the Installation Log window to continue.
10. Click Finish to close the wizard.
11. Optional: Only the features that are already installed are updated by the Update wizard.

    If the update contains new features that you want to install, run the Modify Packages wizard and select the new features to install from the feature selection panel.

Modifying a product installation

Internet access is required unless the repository preferences points to a local update site. For more information, see the Installation Manager help.

To modify an installed product package:

1. From the Start page of the Installation Manager, click the Modify Packages icon.
2. In the Modify Packages wizard, select the installation location for Rational Software Analyzer and click Next.
3. On the Modify page, under Languages, select the languages for the package group, and 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 that are installed in this package group.

4. On the Summary page, review your choices before you modify the installation package, and then click Modify.
5. Optional: When the modification process completes, click View Log File to see the complete log.

Uninstalling the product

To uninstall the packages, you must log in to the system using the same user account that you used to install the product packages.

To uninstall the packages:

1. Close the programs that you installed by using Installation Manager.
2. On the Start page click Uninstall Packages.
3. On the Uninstall Packages page, select the Rational Software Analyzer product package to uninstall and 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 packages are uninstalled.
5. Click Finish to exit the wizard.

Managing licenses

Trial licenses expire 30 or 90 days after installation. To use a product after the expiration date, you must activate the product.

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

For more information about managing licenses for a Rational product, see the following resources:

• The technote at http://www.ibm.com/support/docview.wss?uid=swg21250404 dealing with Rational product activation.
• The Rational licensing support page at http://www.ibm.com/software/rational/support/licensing/.

Licenses

Authorized User License

An IBM Rational Authorized User license permits a single, specific individual to use a Rational software product. Purchasers must obtain an Authorized User license for each individual user who accesses the product in any manner. An Authorized User license cannot be reassigned unless the purchaser replaces the original assignee on a long-term or permanent basis.

For example, if you purchase one Authorized User license, you can assign that license to one specific individual, who can then use the Rational software product. The Authorized User license does not entitle a second person to use that product at any time, even if the licensed individual is not actively using it.

Authorized User Fixed Term License

An IBM Rational Authorized User Fixed Term License (FTL) permits a single, specific individual to use a Rational software product for a specific length of time (the term). Purchasers must obtain an Authorized User FTL for each individual user who accesses the product in any manner. An Authorized User FTL cannot be reassigned unless the purchaser replaces the original assignee on a long-term or permanent basis.

Floating license

An IBM Rational Floating license is a license for a single software product that can be shared among multiple team members; however, the total number of concurrent users cannot exceed the number of Floating licenses that you purchase. For example, if you purchase one Floating license for a Rational software product, then any user in your organization can use the product at any given time. A user who wants to access the product must wait until the current user logs off.

To use Floating licenses, you must obtain Floating license keys and install them on a Rational License Server. The server responds to end-user requests for access to the license keys; it grants access to the number of concurrent users that matches the number of licenses that the organization purchased.

License enablement

Rational Software Analyzer product offering licenses are enabled by the following method:

Importing a product activation kit

Activation kits

Product activation kits contain the permanent license key for your trial Rational product. You purchase the activation kit, download the activation kit zip file to your local computer, and then import the appropriate .JAR file in the activation kit to enable the license for your product. You use IBM Installation Manager to import the activation kit to your product.

Viewing license information for installed packages

To view license information:

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

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

Importing a product activation kit

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 compressed .zip file, which contains a Java archive (.JAR) file. The .JAR file contains the permanent license key and must be imported to activate your product.

To import an activation kit .JAR file and enable the new license key:

1. Start IBM Installation Manager.
2. On the main page, click Manage Licenses.
3. Select a package and click the Import Activation Kit.
4. Click Next. Details for the selected package are shown, including the current license type 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 (.JAR) file and click Open.
6. Click Next. The Summary page displays the target install directory for the activation kit, the product that the new license applies to, and version information.
7. Click Finish.

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

Purchasing licenses

To purchase licenses and enable your product:

1. Determine the type of license that 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.
3. Depending on the type of license that you purchase, use the Proof of Entitlement that you receive and do one of the following things to enable your product:

   If you purchase Authorized User licenses for your product, go to Passport Advantage and follow the instructions for downloading the compressed product activation kit file. Once you have downloaded the activation kit, you must import the product activation .JAR file by using Installation Manager.

To import the activation kit for your product, use the Manage Licenses wizard in IBM Installation Manager.

Managing IBM Installation Manager

This section deals with common IBM Installation Manager tasks. For more information, see the Installation Manager online help or the Installation Manager Information Center at http://www.ibm.com/software/awdtools/installmanager/support/index.html.

Installing Installation Manager on Windows

If the launchpad program starts the product installation, IBM Installation Manager is installed automatically if it is not installed. For more information about this process, see Installing from the launchpad program. In other cases, you must manually install Installation Manager.

To manually install Installation Manager:

1. From the InstallerImage_win32 folder on the first installation disk or from the directory where you extracted the product installation files, run install.exe.
2. On the Install Packages page, click Next.
3. On the License Agreement page, review the license agreement, and to accept it, select I accept the terms in the license agreement, and click Next.
4. If required, to change the installation location, on the Destination Folder page, click Browse, and click Next.
5. On the Summary page, click Install. When the installation process is complete, a message confirms the success of the process.
6. Click Finish. IBM Installation Manager opens.

Installing Installation Manager on Linux

The launchpad program installs IBM Installation Manager. For more information about this process, see Installing from the launchpad program.

To install Installation Manager manually:

1. Open a terminal window with root user privileges.
2. From the InstallerImager_linux folder on the first installation disk or from the directory where you unzipped and extracted the product installation files, run install.
3. On the Install Packages screen, click Next.
4. On the License Agreement page, review the license agreement and, to accept it, select I accept the terms in the license agreement, and click Next.
5. If necessary, edit the installation directory location, and click Next.
6. On the information summary page, click Install. When the installation process is complete, a message confirms the success of the process.
7. Click Finish. IBM Installation Manager opens.

Starting Installation Manager on Windows

You should start IBM Installation Manager from the launchpad program. Doing so starts Installation Manager with a configured repository preference and selected Rational Software Analyzer packages.

If you start Installation Manager directly, you must set a repository preference and choose product packages manually. For more information, see Planning to install the product package.

To start Installation Manager manually:

On the Windows taskbar, click Start > All Programs > IBM Installation Manager > IBM Installation Manager.

Starting Installation Manager on Linux

You should start IBM Installation Manager from the launchpad program. Doing so starts the Installation Manager with a configured repository preference and selected Rational Software Analyzer packages. If you start Installation Manager directly, you must set a repository preference and choose product packages manually. For more information, see Planning to install the product package.

To start Installation Manager manually:

1. Open a terminal window with root user privileges.
2. Change directories to the installation directory for Installation Manager By default, this is/opt/IBM/InstallationManager/eclipse.
3. Run IBMIM.

Uninstalling Installation Manager on Windows

To uninstall Installation Manager:

1. On the Windows taskbar, click Start > All Programs > IBM Installation Manager > Uninstall IBM Installation Manager.
2. On the Uninstall page, click Next.

   IBM Installation Manager is selected for uninstallation.

3. On the Summary page, click Uninstall.

Uninstalling Installation Manager on Linux

You must uninstall IBM Installation Manager by 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 directories to the uninstall directory for Installation Manager. By default, this is /var/ibm/InstallationManager/uninstall.
3. Run ./uninstall.

Silently installing and uninstalling Installation Manager

Silently installing Installation Manager

To install Installation Manager silently, extract the installer and switch to the InstallerImage_platform subdirectory, and then use the following commands:

• installc --launcher.ini silent-install.ini -log <log file path and name>.

  For example: installc --launcher.ini silent-install.ini -log c:\mylogfile.xml

• install --launcher.ini silent-install.ini -log <log file path and name>.

  For example, install --launcher.ini silent-install.ini -log /root/mylogs/mylogfile.xml

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

Silently uninstalling Installation Manager from Windows

To silently uninstall Installation Manager on Windows:

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

Silently uninstalling Installation Manager on other platforms

To silently uninstall Installation Manager on other platforms:

1. From a terminal window, go to the uninstall directory of Installation Manager. By default, this is /var/ibm/InstallationManager/uninstall.
2. Run the following command: uninstall --launcher.ini silent-uninstall.ini

IBM Packaging Utility

Packaging Utility software is located on the Enterprise Deployment CD for each platform (Windows and Linux) that is included with Rational Software Analyzer.

To place a repository that contains a Rational Software Analyzer package on a shared drive, you must use the Packing Utility to copy the product package of Rational Software Analyzer into the repository.

If you want to place a repository that contains a Rational Software Analyzer package on a Web server that will be available over HTTP or HTTPS, you must use Packaging Utility to copy the product package of Rational Software Analyzer into the repository.

Use this utility to perform the following tasks:

• Create a new Installation Manager repository for product packages.
• Copy the product packages to a new repository.

  You can copy multiple product packages into a single repository, which creates a common location from which IBM Installation Manager can install product packages.

• Delete product packages from a repository.

For more information about the Packaging Utility, see the online help or the Installation Manager Information Center at http://www.ibm.com/software/awdtools/installmanager/support/index.html.

Installing Packaging Utility

To install IBM Packaging Utility software from the Enterprise Deployment CD:

1. Navigate to the Enterprise Deployment CD for the appropriate platform and extract the compressed file from the CD.
2. Navigate to the Packaging Utility directory and extract the Packaging Utility installation package from the compressed file (pu.disk_win32.zip or pu.disk_linux.zip).
3. Locate the executable file for the Packaging Utility installer.
   • Change to the InstallerImage_win32 directory in the area where the pu.disk_win32.zip file was unpacked. Locate the executable file for the installer, which is named install.exe.
   • Change to the InstallerImage_linux directory in the area where the pu.disk_linux.zip file was extracted. Locate the executable file for the installer, which is named install.
4. Start the executable file and follow the instructions in the wizard to install the Packaging Utility.
5. (Optional). If IBM Installation Manager is not detected on your workstation, you are prompted to install it and then the installation wizard starts. Follow the instructions in the wizard to complete the installation of Installation Manager. For details, see Installing Installation Manager on Windows.

   When the installation of Installation Manager completes, Installation Manager starts and automatically begins the Install Packages wizard.

6. If Installation Manager is installed on your computer, Installation Manager starts and automatically begins the Install Packages wizard.
7. Follow the instructions in the Install Packages wizard to complete the installation.

Copying product packages using Packaging Utility

To copy product packages with Packaging Utility:

1. If you are copying packages from a CD image, insert the first installation CD into your CD drive.

   Mount the CD drive.

   Note:
   If autorun is enabled on your system, the Rational Software Analyzer launchpad program opens automatically. Close the launchpad program.
2. Start Packaging Utility.
3. On the main page of the utility, click Copy product package.
4. On the Prerequisite page, complete one of these steps:
   • If you have not yet defined an accessible repository, click I will be downloading product packages from IBM Web.
   • If you have defined an accessible repository, click I will be obtaining the product packages from other sources.
5. Click Next.
6. On the Source page, if no product packages are available, open a repository that contains product packages:
   Note:
   A repository can be a path to a directory in the file system, a disk drive that contains the first CD of the product, or a URL to a directory on a server.
   • Click Open repository.
   • In the Open Repository window, browse to and select a repository location: either the common root directory that contains the electronic disk images or the drive that contains the first product installation CD.

     For example, if the Rational Software Analyzer (disk 1, disk 2, and so on) reside in C:\My product\unzip, you should define this location as a repository.

   • Click OK.
7. On the Destination page, browse to and select an existing repository directory, or create a new folder to store the products.
8. Click OK. The file path that you defined is listed on the Destinations page, in the Directory field.
9. Click Next.
10. On the Summary page, to copy the selected product packages to the destination repository, click Copy.
11. After the copy process finishes, on the Complete page, review the product packages that were copied successfully.
12. To return to the Packaging Utility main page, click Done.

After you use the Packaging Utility to copy the Rational Software Analyzer installation files into a repository, you can go to the preferences page of IBM Installation Manager and define this location as a repository. You can also place the repository on a UNC drive, or place the repository on a Web server to make the directories and files available over HTTP.

Installing silently

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.

You must install Installation Manager before you can silently install Rational Software Analyzer.

Two main tasks are required for silent installation:

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

For more information about Installation Manager and installing silently, see the Installation Manager Information Center: http://www.ibm.com/software/awdtools/installmanager/support/index.html.

Creating a response file with Installation Manager

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

1. At a command line, change to the eclipse subdirectory in the directory where you installed Installation Manager. For example:
   • cd C:\Program Files\IBM\Installation Manager\eclipse
   • For other platforms: cd /opt/IBM/InstallationManager/eclipse
2. At a command line, type the following command to start Installation Manager, substituting your own file name and location for the response file and (optionally) the log file:

   IBMIM -record <response file path and name> -log <log file path and name>

   Note:
   You can record a response file without installing or uninstalling a product by adding the optional -skipInstall <agentDataLocation> argument. For details, see Recording a response file using Installation Manager.
   Note:
   Ensure the file paths that you enter exist; Installation Manager does 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 the product package using the Installation Manager GUI.
4. Click Finish, and then close Installation Manager.

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

Recording a response file using Installation Manager

Later, if you want to record updates or modifications to a product, record license management, or record uninstalling the product, you must use the same <agentDataLocation> in subsequent recording sessions. Note that installed products or the preferences, including repository settings, that you record when not using -skipInstall option are not available.

Recording a response file for the installer

To record installation data for the installation of Installation Manager:

1. Extract Installation Manager, and then go to the InstallerImage_platform directory.
2. To start recording, enter install -record <response file path and name> -skipInstall <agentDataLocation> -vmargs -Dcom.ibm.cic.agent.hidden=false

Recording a response file for a product install

To record installation data for a product install with the Installation Manager installer, follow these steps:

1. Go to the InstallerImage_platform directory where you extracted Installation Manager.
2. Open the install.ini file by removing the following lines: -input and @osgi.install.area/install.xml
3. Enter the following command: IBMIM -record <response file path and name> -skipInstall <agentDataLocation>. For example, IBMIM -record c:\mylog\responsefile.xml -skipInstall c:\temp\recordData
4. Start Installation Manager and complete the Install Packages wizard.

Installing and running Installation Manager in silent mode

For additional documentation about running Installation Manager in silent mode, see the Installation Manager Information Center: http://www.ibm.com/software/awdtools/installmanager/support/index.html.

The following table describes the arguments to use with the silent installation command:

-nosplash

--launcher.suppressErrors

-input

-log

Both the Installation Manager installer and the Installation Manager have an initialization or .ini file: silent-install.ini. This file includes default values for the arguments in the table.

The Installation Manager installer installs Installation Manager.

Extract the installer, switch to the eclipse subdirectory, and then use the following commands:

• installc --launcher.ini silent-install.ini -log <log file path and name>

  For example, installc --launcher.ini silent-install.ini -log c:\mylogfile.xml

• install --launcher.ini silent-install.ini -log <log file path and name>

  For example, install --launcher.ini silent-install.ini -log /root/mylogs/mylogfile.xml

After Installation Manager is installed, you can use it to install other products.

To run Installation Manager in silent mode, run the following command from the eclipse subdirectory:

• IBMIMc.exe --launcher.ini silent-install.ini -input <response file path and name> -log <log file path and name>

  For example, IBMIMc.exe --launcher.ini silent-install.ini -input c:\mylog\responsefile.xml -log c:\mylog\silent_install_log.xml

• IBMIM --launcher.ini silent-install.ini -input <response file path and name> -log <log file path and name>

  For example, IBMIM --launcher.ini silent-install.ini -input /root/mylog/responsefile.xml -log /root/mylog/silent_install_log.xml

When the Installation Manager installer or Installation Manager runs in silent installation mode, it reads the response file and writes a log file to the directory that you specified. A response file is required; log files are optional. The result of this execution should be a status of 0 for success and a non-zero number for failure.

Response file commands

The response file has two categories of commands:

• Preference commands set the preferences in Installation Manager that are located under File > Preferences, such as repository location information.
• Silent installation commands emulate the Install Packages wizard in Installation Manager.

Silent installation preference commands

When you define preferences in a response file, the XML code looks similar to the following example:

<preference
	name = "the key of the preference"
	value = "the value of the preference to be set">
</preference>

Use the following table to identify keys and their associated values for silent installation preferences:

Silent installation commands

<profile 
id="the profile (package group) id" 
installLocation="the install location of
 the profile">
<data key="key1" value="value1"/>
<data key="key2" value="value2"/>

</profile>

<server>
<repository location="http://example/
repository/">
<repository location="file:/C:/
repository/">
<!--add more repositories below-->
<...>
      </server>

<install>
<offering profile= "profile id" 
features= "feature ids" 
id= "offering id" version= "offering 
version"></offering>

<!--add more offerings below>
<...>

</install>

<uninstall modify="true">
<offering profile="profileID"
 id="Id" version="Version" 
features="-"/>
</uninstall>

<uninstall>
<offering profile= "profile id" 
features= "feature ids" 
id= "offering id" version= "offering 
version"></offering>

<!--add more offerings below>
<...>

</uninstall>

<rollback>
<offering profile= "profile id"
 id= "offering id" 
version= "offering version">
</offering>

<!--add more offerings below
<...>

</rollback>

<installALL/>

-silent -installAll 

<updateALL/>

-silent -updateAll 

<license policyFile="policy file
 location"/>

<license policyFile="c:\mylicense.opt"/> 

<launcher -mode wizard -input 
< response file >

Reference: 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 installation log files

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 contains just the root element of <result> </result>. However, if errors occur during the installation, the silent install log file contains error elements with messages such as the following one:

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

For detailed analyses, you can look at the log files that are generated in the Installation Manager data area. By using a preference command, you can optionally set the data area to your preferred location.

Notices

Copyright IBM Corporation 2005, 2008. All rights reserved.

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:

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

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.

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:

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.

Trademarks and service marks

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

• IBM
• ibm.com
• Build Forge^(R)
• Passport Advantage
• Rational

Adobe is a registered trademark of Adobe Systems Incorporated in the United States, other countries, or both.

Intel and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

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

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

UNIX^(R) is a registered trademark of The Open Group in the United States and other countries.

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