IBM Rational Data Architect, Version 7.5

Installation guide

Installation introduction

Installation terminology

These terms are used in the installation topics.

Admin user

A user who has write administrative privileges. In the context of installing, having write administrative privileges means that the user can write to the default common installation location. On Linux^(R) operating systems, this is the "root" or any user who is using "sudo" to start Installation Manager. On Microsoft^(R) Windows^(R) XP, a user with write administrative privileges is any user who is a member of the "Administrators" group. On Microsoft Windows Vista, this is the user who is using "Run As Administrator" to start Installation Manager.

Extension

A type of product package that provides additional function to another product package. You cannot install the extension without also installing the package that it extends.

Installation directory

The location of product artifacts after the package is installed.

Non-admin user

A user who does not have write administrative privileges. In the context of installing, this means that this user can only install into the home directory.

Package

An installable unit of a software product. Software product packages are separately installable units that can operate independently from other packages of that software product.

Package group

A package group represents a directory in which different product packages share resources with other packages in the same group. When you install a package using Installation Manager, you can create a new package group or install the packages into an existing package group. (Some packages cannot share a package group, in which case the option to use an existing package group is disabled.) Sharing a package group is sometimes also referred to as "shell sharing."

Repository

A persistent storage area where packages are available for download. A repository can be disc media, a folder on a local hard disk, or a server or Web location.

Shared resources directory

In some instances, product packages can share resources. These resources are located in a directory that the packages share.

Installation default values and conventions

What's new for installers

These important differences might affect the way you plan and implement your installation:

• You can install Rational Data Architect with a user ID with either administrative or non-administrative authority.
• Rational Data Architect now supports floating licenses.
• While installing Rational Data Architect, you must select the remote help options. Installation Manager guides you in making the selections.

Planning the installation

Installation Manager overview

Installation Manager provides tools that help you keep packages up to date, modify the packages, manage the licenses for your packages, and uninstall the packages from your system.

The prerequisite version of Installation Manager (version 1.2) is included with Rational Data Architect. You can also download Installation Manager directly from www.ibm.com. All instructions in this Installation Guide assume that you are using Installation Manager Version 1.2. If you upgrade later to a higher version of Installation Manager, some of the instructions might not be accurate. The Installation Manager Version 1.2 information center is on the Web at: http://publib.boulder.ibm.com/infocenter/install/v1r2/index.jsp

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

• 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.
• 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
• 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, to set up your servers for floating licenses and to select which type of license to use for each package.
• The Roll Back wizard enables you to revert to a previous version of a package.
• The Uninstall wizard will remove a package from your computer. You can uninstall more than one package at a time.
• 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.

Installation roadmap

Roadmap for installing Rational Data Architect

Perform^(TM) these tasks to install Rational Data Architect:

1. Verify that your computer meets the minimum hardware and software requirements for installing the product.
2. Verify that your user ID meets the requirements for installing the product.
3. Review the rest of the planning information .
4. Complete any necessary pre-installation tasks.
5. Complete one of the following tasks to install the product:
   • For an administrative installation, Start the launchpad, and click Install Product.
   • For a non-administrative installation, switch to the InstallerImage_<platform> folder in the disk1 directory, and run userinst.exe (for Windows), or userinst (for Linux).
6. Follow the instructions in the Install Packages wizard to install or update Installation Manager, if necessary, and install the product and verify the installation.
7. Perform any necessary post-installation tasks, such as configuring the appropriate product license.

If you are planning a silent installation of the product, see Silent installation roadmap.

Silent installation roadmap

Roadmap for installing Rational Data Architect silently

Perform these tasks to install Rational Data Architect silently:

1. Verify that your computer meets the minimum hardware and software requirements for installing the product.
2. Verify that your user ID meets the requirements for installing the product.
3. Review the rest of the planning information .
4. Complete any necessary pre-installation tasks.
5. Complete one of the following tasks, depending on your installation scenario:
   • If you already have Installation Manager installed on your computer:
     1. Create a response file with Installation Manager to install a package.
     2. Silently install packages by using Installation Manager.
   • If you do not already have Installation Manager installed on your computer:
     1. Create a response file to install Installation Manager and packages together.
     2. Silently install packages by using the Installation Manager installer.
6. Perform any necessary post-installation tasks, such as configuring the appropriate product license.

Installation requirements

Hardware and software requirements

Before you can install the product, verify that your system meets the minimum hardware requirements. For an up-to-date list of minimum requirements, go to this Web page: http://www.ibm.com/software/data/integration/rda/requirements/index.html

This version of Rational Data Architect was developed for use with Eclipse 3.4, using JDK 1.6 SR 2. If you are extending an existing Eclipse environment, refer to Extending an existing Eclipse IDE for more information.

Additional requirements for Linux operating systems

Environment variable might need setting for Firefox or Mozilla browsers

You might need to set the environment variable MOZILLA_FIVE_HOME to the folder containing your Firefox or Mozilla installation. For example, setenv MOZILLA_FIVE_HOME /usr/lib/firefox-1.5.

Firefox browsers must be dynamically linked

To support the SWT browser widget, your Firefox browser must be dynamically linked, which means it was not downloaded from mozilla.org, but was compiled from source. This is typically the case when the Firefox comes as part of the distribution (that is, it is in a place such as /usr/lib/firefox).

One way to ensure that this is true is to see if it is the browser that is pointed at by /etc/gre.conf. The purpose of this gre.conf file is to point at an embeddable browser.

SUSE Linux might require a fix for invisible text problem

If your operating system is SUSE Linux Enterprise Desktop 10 SP1 or SUSE Linux Enterprise Server 10 SP1, then you might need the following operating system update to resolve a problem with text not being displayed in some editors:http://support.novell.com/techcenter/psdb/44ab155e3202595389c101e6cf7e20f2.html.

User privilege requirements

Your user ID must not contain double-byte characters.

There are two methods of installation: administrative and non-administrative.

• To perform an administrative installation, Start the launchpad.
• To perform a non-administrative installation, switch to the InstallerImage_<platform> folder in the disk1 directory, and run userinst.exe (for Windows), or userinst (for Linux).

Implications of using an admin or non-admin user ID when installing

Planning what features to install

When you install the 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). Installation Manager automatically enforces any dependencies between features and prevents you from clearing any required features.

This table shows the features of IBM Rational Data Architect that you can 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.

Installation considerations

Installation directories

Shared resources directory

The shared resources directory is where some product resources are installed so that they can be used by multiple product package groups. You define the shared resources directory the first time that you install IBM Installation Manager. For best results, use your largest disk drive for shared resources directories. You cannot change the directory location unless you uninstall Installation Manager.

Package groups

During installation, you specify a package group into which to install a product.

• A package group represents a directory in which products might share resources with other products in the same package group. This option is also sometimes called "shell sharing."
• Not all products can share a package group, in which case the option to use an existing package group will be disabled.
• When you install a product using Installation Manager, you either create a package group or install the product into an existing package group. A new package group is assigned a name automatically; however, you choose the installation directory for the package group.
• After you create a package group you cannot change the installation directory. The installation directory contains files and resources shared by the products installed into that package group.
• When you install multiple products at the same time, all products are installed into the same package group.

Coexistence considerations

Coexistence within a package group

When you install each product package, you select whether you want to install the product package into an existing package group or whether you want to create a new package group. IBM Installation Manager offers only products that are designed to share a package group and meet version compatibility 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.

Any number of eligible products can be installed to a package group. When a product is installed, the product functions are 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 functions 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 functions available.

Coexistence between package groups

Multiple instances of a product package can exist on the same computer and they are automatically installed into separate package groups. The product packages can be at different versions or fix levels.

If you update a product package, you update only that instance of the product.

Compatibility with other products

Rational Data Architect Version 7.5 can share a package group with other compatible products that have been installed with Installation Manager.

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

• Rational Application Developer Version 7.5
• Rational Software Architect Version 7.5
• Rational Software Modeler Version 7.5

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

See the Rational Data Architect support page for additional technotes about extending an Eclipse 3.4 IDE.

Extending an existing Eclipse IDE

Rational Data Architect is bundled with a version of the Eclipse IDE or workbench; this bundled workbench is the base platform on top of which the functionality in Rational Data Architect is provided. If you have an Eclipse IDE on your workstation, then you have the option to extend it, that is, add to your current Eclipse IDE the additional functionality provided in Rational Data Architect.

Extending an Eclipse IDE adds the functions of the newly installed product, but maintains your IDE preferences and settings. Previously installed plug-ins are also still available.

Your Eclipse IDE and JRE must be at least at the minimum version levels that the product requires. See the product system requirements for details on the required versions. Installation Manager checks that the Eclipse instance that you specify meets the requirements for the installation package.

Upgrading from another release

You cannot change a previous version of IBM Rational Data Architect that is already installed on your computer to the current version. In other words, it is not possible to upgrade to the latest version.

However, the latest version of Rational Data Architect can coexist with earlier versions on the same computer and you can migrate your workspace and projects to the latest version.

Web-based help content

If your product is configured to use remote help, you can obtain help three ways. One of these options will be best for you, depending on your needs and situation:

• The help content can be accessed on the Web so that you can have the smallest installation footprint and the most up-to-date information.
• The help content can be downloaded and accessed on your computer so that you can work disconnected from the Internet with periodic updates.
• The help content can be deployed on an intranet server so that you can work behind a firewall with administrative updates.

If your help system supports remote help, you can change your access decision any time. If you install multiple products together, you can use different locations for the help for each product, depending on installation footprint, frequency of use, and internet policies. If internet speed is an issue, a longer one-time download and local access might be preferable. Later help updates include only differences.

If you are an administrator and you want users to access help content from an intranet server, see the Installation Manager information center for instructions on how to install the help WAR file on a server.

Pre-installation tasks

Pre-installation checklist

Increasing the number of file handles on Linux computers

Ensure that you complete the following steps correctly. If this procedure is not completed correctly, your computer will not start.

To increase the number of file handles on a Linux computer, complete the following steps:

1. Log in as root. If you do not have root access, you will need to obtain it before continuing.
2. Change to the etc directory.
   Attention: If you decide to increase the number of file handles in the next step, do not leave an empty initscript file on your computer. If you do so, your computer will not start the next time that you restart it.
3. Use the vi editor to edit the initscript file in the etc directory. If this file does not exist, type vi initscript to create it.
4. On the first line, type ulimit -n 4096. The point is that 4096 is significantly larger than 1024, the default on most Linux computers.
   Important:
   Do not set the number of handles too high, because doing so can negatively impact system-wide performance.
5. On the second line, type eval exec "$4".
6. Save and close the file after making sure you have completed steps 4 and 5.
7. Optional: Restrict the number of handles available to users or groups by modifying the limits.conf file in the etc/security directory. Both SUSE Linux Enterprise Server (SLES) Version 9 and Red Hat Enterprise Linux Version 4.0 have this file by default. If you do not have this file, consider using a smaller number in step 4 in the previous procedure (for example, 2048). Do this so that most users have a reasonably low limit on the number of open files that are allowed per process. If you use a relatively low number in step 4, it is less important to do this. However, if you set a high number in step 4 earlier and you do not establish limits in the limits.conf file, computer performance can be significantly reduced.

   The following sample limits.conf file restricts all users, and then sets different limits for others afterwards. This sample assumes that you set handles to 8192 in step 4.

   *      soft nofile 1024
   *      hard nofile 2048
   root    soft nofile 4096
   root    hard nofile 8192
   user1   soft nofile 2048
   user1 hard nofile 2048
   

   Note that the * in the preceding example sets the limits for all users first. These limits are lower than the limits that follow. The root user has a higher number of allowable handles open, while number available to user1 is between the two. Make sure that you read and understand the documentation contained in the limits.conf file before making changes.

Mounting a drive

For Linux:

1. Log in as a user with root authority.
2. Insert the DVD in the drive and enter the following command:mount -t iso9660 -o ro /dev/cdrom /cdrom The /cdrom variable represents the mount point of the DVD.
3. Log out.

Some window managers can automatically mount your DVD drive for you. Consult your computer documentation for more information.

Verifying and extracting electronic images

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 files

When extracting the installation files from the downloaded compressed files, do the following things:

• Ensure that you preserve the directory structure of compressed files when you extract them.
• Extract the contents of all of the compressed files to the same directory. Do not include spaces in the directory names, or you won't be able to run the setup.sh command to start the launchpad from a command line.

When you are finished extracting all of the compressed files, the directory where you extracted the contents will have subdirectories with the following names:

Installing software

To install your product, follow the procedures and information in these topics.

Installing from the launchpad

Use the launchpad program to start the administrative installation of software in these cases:

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

To perform a non-administrative installation, switch to the InstallerImage_<platform> folder in the disk1 directory, and run userinst.exe (for Windows), or userinst (for Linux).

For products that are installed by IBM Installation Manager, starting the installation process from the launchpad program causes Installation Manager to be automatically installed if it is not already on your computer. Furthermore, the installation process is already configured with the location of the repository that contains the installation package. If you install Installation Manager separately, you must configure the repository preferences manually. Also, you can start the installation of a number of supporting software items from the launchpad.

Starting the launchpad

The launchpad performs an administrative installation of the product. To perform a non-administrative installation, switch to the InstallerImage_<platform> folder in the disk1 directory, and run userinst.exe (for Windows), or userinst (for Linux).

To start the launchpad, complete the following steps.

1. Insert the IBM Rational Data Architect DVD into your DVD drive. Ensure that you have mounted the DVD drive.
2. If autorun is enabled on your computer, the Rational Data Architect launchpad program automatically opens. If autorun is not enabled on your system, complete one of these steps:
   • 
     • For an administrator installation, run setup.exe, which is located in the root directory of the DVD.
     • For a non-administrator installation, run userinst.exe, which is located in the \disk1\InstallerImage_win32\ directory of the DVD.
   • 
     • For a root user installation, run setup, which is located in the root directory of the DVD.
     • For a non-root installation, run userinst, which is located in the /disk1/InstallerImage_linux/ directory of the DVD.

Installing IBM Installation Manager

If you start the installation of IBM Rational Data Architect by using the launchpad from the product DVD, IBM Installation Manager automatically starts even if it is not already installed. You will then install Installation Manager on your computer during the process of installing Rational Data Architect.

The latest version of Installation Manager might be required for your package. Updates are discovered if you have not cleared the Search service repositories for updates check box on Repositories page in the Preferences window of Installation Manager.

Starting IBM Installation Manager

If you already installed Installation Manager, you can start it in one of these ways:

• : Click Start -> All Programs -> IBM Installation Manager -> IBM Installation Manager
• : Change to Installation Manager directory/eclipse and run IBMIM

Installing Rational Data Architect

In the instructions that follow, it is assumed that you started your installation from the launchpad.

To install IBM Rational Data Architect, complete the following steps:

1. Start the launchpad. The file that you run is different, depending on whether you are installing as an administrator or as a non-administrator.
2. In the launchpad dialog-box, click Install Product for an administrative installation.
   Note:
   If a new version of IBM 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.
   IBM Installation Manager starts.
3. Ensure that IBM Rational Data Architect is selected.
4. You can install updates at the same time that you install the base product package. To search for updates to the packages, click Check for Other Versions and Extensions. 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.
5. To learn more about the packages that you can install, click the package name. A description of the package is displayed in the Details pane.
6. Click Next.
7. On the Licenses page, read the license agreements for the selected packages. On the left-hand side of the License page, click each package version to display its license agreement.
   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 Installation Manager: 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 can be shared by one or more package groups.
   Important:
   You can specify the shared resources directory only at the time that install Installation Manager. 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. Click Next to continue.
10. On the Location page, create a package group to install the product package into, or select an 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. (If you are installing on Linux, ensure that you do not include any spaces in the directory path.) The name for the package group is created automatically.
    After you select a package group, click Next.
11. On the next Location page, you can choose to extend an Eclipse IDE already installed on your system, adding the functionality in the packages that you are installing.
    • If you do not want to extend an Eclipse IDE, click Next to continue.
    • To extend an existing Eclipse IDE:
      1. Select Extend an existing Eclipse.
      2. In the Eclipse IDE field, type or navigate to the location of the folder that contains the eclipse executable file (eclipse.exe or eclipse.bin). Installation manager will check if the Eclipse IDE version is valid for the package that you are installing. The Eclipse IDE JVM field displays the Java^(TM) Virtual Machine (JVM) for the IDE that you specified.
      3. Click Next to continue.
12. 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 product package will be installed.
13. On the next Features page, select the package features that you want to install.
    1. Optional: To see the dependency relationships between features, select Show Dependencies.
    2. Optional: Click a feature to view its brief description under Details.
    3. Select or clear 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.
    4. When you are finished selecting features, click Next to continue.
14. On the help system configuration page, select one of the following options and then click Next:
    • Access help from the Web
    • Download help and access content locally
    • Access help from a server on your intranet
15. On the Summary page, review your choices before installing the product 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. A progress indicator shows the percentage of the installation completed.
16. 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 the product to start when you exit.
    3. Click Finish to launch the selected package. The Install Package wizard closes and you are returned to the Start page of Installation Manager.
17. Close Installation Manager.

Installing silently

Refer to the Silent installation roadmap for more information.

There are two ways to install packages silently:

1. Use the Installation Manager installer to silently install both Installation Manager and product packages together.
2. Install the Installation Manager, then use it in silent mode to install packages.

There are two main tasks required for any silent installation:

1. Create the response file. See Creating a response file with Installation Manager for details.
2. Run either installation tool in silent installation mode.

Installing packages silently

Creating a response file with Installation Manager to install a package

In this scenario, you already have Installation Manager installed on your computer.

To record a response file for installation (or uninstallation), complete the following steps:

1. On a command line, change to the eclipse subdirectory in the directory where you installed Installation Manager. For example:
   • For Windows: cd C:\Program Files\IBM\Installation Manager\eclipse
   • For other platforms: cd /opt/IBM/InstallationManager/eclipse
2. On 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 and path name> -log <log file and path name>. For example, IBMIM.exe -record c:\mylog\responsefile.xml -log c:\mylog\record_log.xml
   • You can record a response file without installing or uninstalling a product by adding the optional -skipInstall <agentDataLocation>. Note that <agentDataLocation> must be a writable directory. The argument causes Installation Manager to save the installation data without installing the product. You can use the same <agentDataLocation> in the next recording session to record updates or modifications to the product, or to record license management. Note that the products installed or preferences, including repository settings, that you may have set on install when not using the -skipInstall argument are not be stored. Using -skipInstall will make installation faster because the IM is not installing the product, it is just recording the installation data.

     The syntax for using the skipInstall argument is: IBMIM -record <response file and path name> -skipInstall <a writable directory for agent data location>. For example IBMIM -record c:\mylog\responsefile.xml -skipInstall c:\temp\recordData

     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 on-screen instructions in the Install wizard to make your installation choices.
4. Click Finish, then close Installation Manager.

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

Silently installing packages by using Installation Manager

After installing Installation Manager, use it in silent mode to install packages. This file explains how to install packages by using Installation Manager.

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

• For Windows: 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
• For other platforms: 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

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

-vm

-nosplash

--launcher.suppressErrors

-silent

-input

-log

-updateAll

-installAll

--launcher.ini silent-install.ini

-accessRights

-accessRights nonAdmin

-accessRights admin

The Installation Manager has an initialization or .ini file silent-install.ini that includes default values for the arguments in the table. For example, the silent-install.ini file might look something like this:

-vm
C:\Program Files\IBM\Installation Manager\eclipse\jre_5.0.2.sr5_20070511\jre\bin\java.exe
-nosplash
--launcher.suppressErrors
-silent
-vmargs
-Xquickstart
-Xgcpolicy:gencon

When the Installation Manager runs in silent installation mode; it reads the response file and writes a log file to the directory you specified. While you must have a response file when running in silent installation mode, log files are optional. The result of this execution should be a status of 0 on success and non-zero number on failure.

Installing Installation Manager and packages together silently

Creating a response file to install Installation Manager and packages together

In this scenario, you do not have Installation Manager on your computer.

To silently install packages using the Installation Manager installer that is included with Rational Data Architect:

1. On a command line, change to the InstallerImage_platform sub-directory in the disk1 directory.
2. On 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.

   You can record a response file without installing or uninstalling a product by adding the optional -skipInstall <agentDataLocation>. Note that <agentDataLocation> must be a writable directory. The argument causes Installation Manager to save the installation data without installing the product. You can use the same <agentDataLocation> in the next recording session to record updates or modifications to the product, or to record license management. Note that the products installed or preferences, including repository settings, that you may have set on install when not using the -skipInstall argument are not be stored. Using -skipInstall will make installation faster because the IM is not installing the product, it is just recording the installation data.

   Note:
   Ensure the file paths you enter exist; Installation Manager will not create directories for the response file and the log file.
   • For Windows (administrative installation): install.exe -record <response file and path name> -skipInstall <a writable directory for agent data location> -log <log file and path name>. For example, install.exe -record c:\mylog\responsefile.xml -skipInstall c:\RDA2_SILENT_DATA_SAVE -log c:\mylog\record_log.xml
   • For Windows (non-administrative installation): userinst.exe -record <response file and path name> -skipInstall <a writable directory for agent data location> -log <log file and path name>. For example, userinst.exe -record c:\mylog\responsefile.xml -skipInstall c:\RDA2_SILENT_DATA_SAVE -log c:\mylog\record_log.xml
   • For other platforms (administrative installation): install -record <response file and path name> -skipInstall <a writable directory for agent data location> -log <log file and path name>. For example, install -record c:\mylog\responsefile.xml -skipInstall c:\RDA2_SILENT_DATA_SAVE -log c:\mylog\record_log.xml
   • For other platforms (non-administrative installation): userinst -record <response file and path name> -skipInstall <a writable directory for agent data location> -log <log file and path name>. For example, userinst -record c:\mylog\responsefile.xml -skipInstall c:\RDA2_SILENT_DATA_SAVE -log c:\mylog\record_log.xml
3. Follow the on-screen instructions in the Install wizard to make your installation choices.
4. Click Finish, then close Installation Manager.

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

Silently installing Installation Manager and packages by using the Installation Manager installer

You can use the Installation Manager installer to silently install Installation Manager as well as other packages. Optionally, use the installer to install Installation Manager, then use Installation Manager to install packages silently. This file contains instructions for installing software packages using the Installation Manager installer.

To silently install both Installation Manager and packages using the Installation Manager installer that is included with Rational Data Architect, from the InstallerImage_platform sub-directory in the disk1 directory, enter the following command:

• For Windows (administrative installation): installc.exe --launcher.ini silent-install.ini -input <response file path and name> -log <log file path and name>. For example: installc --launcher.ini silent-install.ini -input c:\mylog\responsefile.xml -log c:\mylog\silent_install_log.xml
• For Windows (non-administrative installation): userinstc.exe --launcher.ini silent-install.ini -input <response file path and name> -log <log file path and name>. For example: userinstc.exe --launcher.ini silent-install.ini -input c:\mylog\responsefile.xml -log c:\mylog\silent_install_log.xml
• For other platforms (administrative installation): install --launcher.ini silent-install.ini -input <response file path and name> -log <log file path and name>. For example: install --launcher.ini silent-install.ini -input /root/mylog/responsefile.xml -log /root/mylog/silent_install_log.xml
• For other platforms (non-administrative installation): userinst --launcher.ini silent-install.ini -input <response file path and name> -log <log file path and name>. For example: userinst --launcher.ini silent-install.ini -input /root/mylog/responsefile.xml -log /root/mylog/silent_install_log.xml

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

-vm

-nosplash

--launcher.suppressErrors

-silent

-input

-log

-updateAll

-installAll

--launcher.ini silent-install.ini

-accessRights

-accessRights nonAdmin

-accessRights admin

The Installation Manager installer has an initialization or .ini file silent-install.ini that includes default values for the arguments in the table. For example, the silent-install.ini file might look something like this:

-vm
C:\Program Files\IBM\Installation Manager\eclipse\jre_5.0.2.sr5_20070511\jre\bin\java.exe
-nosplash
--launcher.suppressErrors
-silent
-vmargs
-Xquickstart
-Xgcpolicy:gencon

When the Installation Manager installer runs in silent installation mode; it reads the response file and writes a log file to the directory you specified. While you must have a response file when running in silent installation mode, log files are optional. The result of this execution should be a status of 0 on success and non-zero number on failure.

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>

Response file commands

There are two categories of commands for the response file:

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

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" selected="true"></offering>

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

</install>

<update>
<offering profile= "profile id">
</update>

<modify>
<offering profile= "profile id">
</modify>

<uninstall modify="true">
<offering profile="profile id"
 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"/> 

Additional response file attributes

<agent-input clean="true">
</agent-input>

<agent-input clean="true" temporary="false">
</agent-input>

<agent-input acceptLicense="false">
</agent-input>

<agent-input rebootLater="false">
</agent-input>

Silent installation preference commands

When you define preferences in a response file, your XML code will look 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:

Starting Installation Manager in wizard mode

Installation Manager can be run in silent mode or wizard mode. To start Installation Manager in wizard mode, enter the following on the command line:IBMIM -mode wizard -input <response> where <response> is the response file path and name.

Based on the commands in your response file, Installation Manager will start in one of the following wizards: install, update, modify, or uninstall. Your response file can only contain commands for one of the Installation Manager wizards. For example, the response file can include either:

• server, preference, and install commands
• server, preference, and update commands
• server, preference, and modify commands
• server, preference, and uninstall commands

Searching for and silently installing all available products

Follow these steps to find and install all available products by using Installation Manager in silent mode:

1. On a command line, change to the eclipse subdirectory in the directory where you installed Installation Manager.
2. Enter and run the following command, substituting your own locations for the response file and, optionally, the log file:
   • For Windows: IBMIMc.exe --launcher.ini silent-install.ini -installAll -input <response file path and name> -log <log file path and name>
   • For other platforms: IBMIM --launcher.ini silent-install.ini -installAll -input <response file path and name> -log <log file path and name>

All available products known to Installation Manager are installed.

Silently installing updates to all currently installed products

To find and install all available updates for products that are installed, complete the following steps:

1. On a command line, change to the eclipse subdirectory in the directory where you installed Installation Manager.
2. Enter and run the following command, substituting your own locations for the response file and, optionally, the log file:
   • For Windows: IBMIMc.exe --launcher.ini silent-install.ini -updateAll -input <response file path and name> -log <log file path and name>
   • For other platforms: IBMIM --launcher.ini silent-install.ini -updateAll -input <response file path and name> -log <log file path and name>

All available product updates known to Installation Manager are installed.

Silently installing from authenticated repositories

Installation Manager uses the Eclipse infrastructure to save credentials in a file called a key ring file. While the contents of the key ring file are encrypted, you can provide an additional level of security by specifying a password to open the key ring file. For additional information on key ring files, refer to the Eclipse workbench user's guide.

To access authenticated repositories in silent mode, complete the following steps:

1. Create a key ring file and provide the appropriate credentials in the file.
2. Start Installation Manager in the user interface (UI) mode and specify the following command-line parameters: -keyring <file> [-password <password>]. For example, use the following commands on the appropriate platform:
3. When you use Installation Manager in UI mode and access a protected repository, a window opens where you can enter the credentials. Enter the correct credentials and then save them. Ensure that the Save password check box is selected. The credentials are saved into the specified key ring file.
4. Start Installation Manager in silent mode and specify the following command line parameter: -keyring <file> [-password <password>]. During silent install, the credentials for the protected repository are retrieved from the key ring file specified in the command line.
   1. On Windows, use launcher.exe --launcher.ini silent-install -input <input file path and name> -updateAll -log <log file path and name> -keyring <key ring file path and name> -password <password> where launcher is IBMIMc for the Installation Manager and installc for the Installation Manager installer.
   2. On other platforms, use launcher --launcher.ini silent-install -input <input file path and name> -updateAll -log <log file path and name> -keyring <key ring file path and name> -password <password> -keyring /tmp/keyring.txt -password my1secret where launcher is IBMIM for the Installation Manager and install for the Installation Manager installer.

Silently uninstalling Installation Manager

Before you can uninstall IBM Installation Manager, you must uninstall all of the packages, including products that were installed by IBM Installation Manager. You must close Installation Manager before attempting to uninstall the program. You must log in to the computer by using the same user account that you used to install Installation Manager.

To silently uninstall Installation Manager, complete the following steps:

1. Go to the uninstall directory for the Installation Manager.
   • For Windows, the default location is C:\Documents and Settings\All Users\Application Data\IBM\Installation Manager\uninstall.
   • For other platforms, the default location is /var/ibm/InstallationManager/uninstall
2. Enter the following command:
   • On Windows, enter: uninstallc.exe --launcher.ini silent-uninstall.ini
   • On other platforms, enter: uninstall --launcher.ini silent-uninstall.ini

Deploying and installing to the enterprise

The Installation Manager information center contains articles that will help you install your product in an enterprise environment. Visit the information center for Installation Manager 1.2 at http://publib.boulder.ibm.com/infocenter/install/v1r2/index.jsp.

Post-installation tasks

Post-installation checklist

Review the following information and ensure the post-installation steps are completed as required.

Starting Rational Data Architect

For Microsoft Windows operating systems: Click Start -> All Programs -> IBM Software Delivery Platform -> IBM Rational Data Architect 7.5 -> IBM Rational Data Architect.

To start Rational Data Architect from a command-line interface:

• On Windows: Type this command: <product installation directory>\eclipse.exe
• On Linux: Type this command: .<product installation directory>/eclipse

Managing licenses

Using the Manage Licenses wizard, you can upgrade trial versions of an offering to a licensed version by importing a product activation kit. You can also enable Floating license enforcement for offerings with trial or permanent licenses to use floating license keys from a license server.

For more information on managing licenses for your Rational product, see http://www.ibm.com/support/docview.wss?uid=swg21250404.

License activation

Licenses for this product are activated in two ways:

• Importing a license activation kit
• Activating Rational Common Licensing to obtain access to floating license keys

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.

Floating license enforcement

Optionally, you can obtain floating license keys, install IBM Rational License Server, and enable floating license enforcement for your product. Floating license enforcement provides the following benefits:

• License compliance enforcement across the organization
• Fewer license purchases
• Serve license keys for IBM Rational Team Unifying and Rational Software Delivery Platform desktop products from the same license server

Importing a license 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 .zip file containing 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, complete the following steps:

1. Start IBM Installation Manager.
2. On the main page, click Manage Licenses.
3. Select a package and click the Import Activation Kit button.
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.

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

Activating floating licenses

Before activating Floating license enforcement, you must obtain the license server connection information from your administrator. For details on license server, license key, and Rational Common Licensing administration, see the IBM Rational License Management Guide at http://download.boulder.ibm.com/ibmdl/pub/software/rationalsdp/v7/rcl/701/docs/install_instruction/install.html.

To activate floating licenses as the license type for specified packages and configure license server connections, complete the following steps:

1. Start IBM Installation Manager.
2. On the Start page, click Manage Licenses.
3. On the Manage License page, select a installed product package, select the Configure Floating license support option, and click Next.
4. On the Licenses page, read the license agreement for the selected package. If you agree to the terms of all of the license agreements, click I accept the terms of the license agreements and click Next to continue.
5. On the Floating License Support page, select the Enable Floating license enforcement and configure one or more license server connections:
   1. Click an empty field in the Servers table or click the Add button.
   2. If your administrator provided you with information for a redundant server environment, click the Redundant Server button. Fields for the primary, secondary, and tertiary server names and ports appear.
   3. Enter the host name of the license server in the Name field.
   4. Enter a value in the Port field for environments where a firewall is used. Do not assign a value to this port unless your administrator instructs you to do so.
   5. For redundant server environments, enter the names and ports (if required) for the secondary and tertiary servers.
   6. You can click the Test Connection button to confirm that the connection information is correct and that the server is available.
   7. Click OK.
6. Click Next.
7. Configure the license usage order for your shell shared or custom packages. The order of licenses in the list determines the order in which your package attempts to obtain access to license keys for a given licensed package.
8. Click Finish.

Now, when you start the activated product, a connection is created to the license server to obtain a license key from the pool of available floating license keys.

Types of 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.

If you notify IBM that you do not want to extend the license term, then you must stop using the product when the license expires.

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 you purchase. For example, if you purchase one floating license for a Rational software product, then any user in your organization may use the product at any given time. Another person 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 will grant access to the number of concurrent users that matches the number of licenses the organization purchased.

Viewing license information for installed product packages

To view license information, complete the following steps:

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

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

Configuring Web-based help

Accessing Web-based help

During installation, the option to access help from a remote information center was selected. This is the default selection.

Your product help system can retrieve content installed with the product, as well as content from a remote server running an information center. The information center for your product has the most current help content and when your product is configured to retrieve content from a remote information center, the contents of the information center can be accessed by selecting Help -> Help Contents to open your help system.

During installation, your product was configured to access the help from the product information center.

The information center for your product is available from the following URL: http://publib.boulder.ibm.com/infocenter/rdahelp/v7r5/index.jsp.

Follow these steps to check your connection to the information center:

1. Open the Preferences dialog
2. Select Help -> Content
3. Ensure that Include help content from a remote infocenter is selected.
4. Ensure that the URL for your product information center is in the list of available information centers. If your information center is not listed, complete the following steps:
   1. Click Add
   2. In the Name field, enter a name for the connection.
   3. In the Host field, enter publib.boulder.ibm.com
   4. In the Path field, enter /infocenter/rdahelp/v7r5
   5. Select Use default port
   6. Click OK
5. Select the entry for your product information center.
6. Click Test Connection.

Downloading help content with the Local Help System Updater site

During installation, the help access option, Download help and access the content locally, was selected.

Before using the help for the product, you have to download the help to your local system.

To download the help content from the Local Help System Updater site, complete the following steps:

1. With your product open, click Help -> Local Help Updater. The Updater site opens.
2. In the x pane, select the location of the help you want to download.
3. The Available Features list will be populated with a list of the help that is available for download. Depending on your network connection speed, this might take a few minutes. Select the help content that you need.
4. Click Install. The help content is downloaded and installed. A progress bar opens and tracks the status of the download.
5. When the download is completed, open the help in the product by selecting Help -> Help Contents.

The help that you selected is installed on your system. The files will be updated automatically when an Internet connection is available.

Updating help content

You have installed help features from the Local Help System Updater Web site.

Updates are automatically installed each time you start the product, if you have an Internet connection.

To update the help without restarting the product, complete the following steps:

1. Close the product help system window.
2. Open the Local Help System Updater by selecting Help -> Local Help Updater. The Updater site opens.
3. Click the Installed Features tab.
4. Click Search for Updates. If updates to the content you have installed are available, they are installed to your system. A progress bar indicates the status of the request.
5. When the update is completed, open the help in the product by selecting Help -> Help Contents.

Removing help content

You have downloaded help features using the Local Help System Updater.

To remove installed help content, complete the following steps:

1. Close the product help system window.
2. Open the Local Help System Updater by clicking Help -> Local Help Updater. The Updater site opens.
3. Click the Installed Features tab.
4. Select the features that you want to remove, then click Remove The help features you selected are removed from your system. A progress bar indicates the status of the request.
5. When the removal is completed, open the help in the product by selecting Help -> Help Contents.

Setting up an intranet server for help content

You have a server available that can be accessed by users behind a firewall.

See the Installation Manager information center for the instructions for setting up an intranet server for help content.

The WAR file that is needed to set up Rational Data Architect help on an intranet server is located on the product DVD, in the enterprise folder.

Changing the way you access help content

During the installation process, a help content access method was selected. Close the help browser before you change the way you access help content.

To change the way that you access help content, complete the following steps:

1. Click Windows -> Preferences. The Preferences window opens.
2. Expand the Help entry, and then click Content. A list of the information center or centers opens. Depending on the access method that was chosen, complete one of the following procedures.
   • To change from accessing help content from an information center on an IBM Web site to accessing help content on an intranet server, follow these steps:
   1. Disable the link to the internet site by selecting the internet URL in the Contents list, and then clicking Disable.
   2. Click Add; then name the intranet connection, specify the intranet URL for the server that contains the help content, and then click OK.
   3. Click OK to close Preferences.
   4. Click Help -> Help Contents, to open your help.
   • To change from accessing help content from an information center on an IBM Web site to downloading and accessing help content locally, follow these steps:
   1. Ensure that Include help content from a remote infocenter is selected.
   2. Disable the link to the product Information Center by selecting that connection in the Contents list, and then clicking Disable.
   3. Click Add; then enter a name for the local help connection. Specify the localhost Host IP address 127.0.0.1 and path /help. Select any unused port number, and then click OK.
   4. Save any work and close and restart the product.
   5. Follow the instructions in Downloading help content with the Local Help System Updater site to download help content.
   • To change from accessing help content locally to accessing help content from an IBM Web site, follow these steps:
   1. Ensure that Include help content from a remote infocenter is selected.
   2. Disable the link to localhost by selecting that connection in the Contents list, and then clicking Disable.
   3. Click Add; then name the connection, specify the Internet URL for the IBM Web site that contains the help content, and then click OK. This URL might already be available in the list of connections. If it is listed, select the connection and click Enable.
   4. Click OK to close Preferences.
   5. Click Help -> Help Contents, to open your help.
   • To change from accessing help content locally to accessing help content from an intranet server, follow these steps:
   1. Ensure that Include help content from a remote infocenter is selected.
   2. Disable the link to localhost by selecting that connection in the Contents list, and then clicking Disable.
   3. Click Add; then name the connection, specify the intranet URL for the server that contains the help content, and then click OK.
   4. Click OK to close Preferences.
   5. Click Help -> Help Contents, to open your help.
   • To change from accessing help content from an intranet server to downloading and accessing help content locally, follow these steps:
   1. Ensure that Include help content from a remote infocenter is selected.
   2. Disable the link to the intranet server by selecting that connection in the Contents list, and then clicking Disable.
   3. Click Add; then enter a name for the local help connection. Specify the localhost Host address 127.0.0.1 and path /help. Enter any unused port number, and then click OK.
   4. Save any work and close and restart the product.
   5. Follow the instructions in Downloading help content with the Local Help System Updater site to download help content.
   • To change from accessing help content from an intranet server to accessing help from an IBM Web site, follow these steps:
   1. Disable the link to your intranet site by selecting the intranet URL in the Contents list, and then clicking Disable.
   2. Click Add; then name the connection, specify the URL for the IBM Web site that contains the help content, and then click OK.
   3. Click OK to close Preferences.
   4. Click Help -> Help Contents, to open your help.

Specifying the repository

To specify a repository, complete the following steps:

1. Start IBM Installation Manager.
2. On the Start page, click File -> Preferences.
3. In the Preferences widow, click Repositories. The Repositories page opens, showing available repositories, their locations, and whether they are connected.
4. On the Repositories page, click Add Repository.
5. In the Add repository dialog box, type the URL of the repository location or use Browse to find a .zip or JAR file that contains a repository, a diskTag.inf file, or the repository.config file of an expanded repository; then click OK. The new repository location is listed. If the repository is not connected, a red x is displayed in the Connection column.
   Note:
   Updates to packages can be stored in service repositories, for example IBM support sites or local update repositories, which might be linked to the repositories you have listed in the previous procedure. To search for updated packages in these linked service repositories, make sure Search service repositories during installation and updates is selected. This option is selected by default.
6. Click OK to close the Preferences window.

Modifying installed product packages

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

To modify an installed product package:

1. Start IBM Installation Manager.
2. On the Start page, click Modify.
3. In the Modify Packages wizard, select the product package group and click Next.
4. On the Languages page, 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 installed under this package group.
5. On the Features page, select the features that you want to install or remove. Some products do not have optional features.
   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.
   3. Click Next
6. On the Summary page, review your choices before modifying the installation package and click Modify.
7. Optional: When the modification process completes, click View Log File to see the complete log.
8. Click Finish to close the wizard.

Updating installed product packages

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

Each installed package has the location embedded for its default IBM update repository. For 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 Installation Manager help for more information.

To find and install product package updates:

1. Start IBM Installation Manager.
2. On the Start page of IBM Installation Manager, click Update.
3. Optional: If a required version of IBM Installation Manager is not detected on your computer, you must continue with the update of Installation Manager. Follow the instructions in the wizard to complete the update.
4. In the Update Packages wizard, select the product package group that you want to update or click the Update All check box and click Next. Installation Manager searches for updates in its repositories and the predefined update sites for the product.
5. On the Update page, if updates for a package are found, they are displayed in the Updates list below their corresponding package and only recommended updates are displayed by default. Complete the following steps:
   1. To display all updates found for the available packages, click Show all.
   2. To learn more about an update, click the update and review its description under Details. 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.
   3. 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 or cleared.
   4. Click Next.
6. 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. If you agree to the terms of all the license agreements, click I accept the terms of the license agreements and Click Next.
7. On the Features page, select the features that you want to update and complete the following steps:
   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.
   3. Click Next
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.
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.
11. Optional: Only the features that you already have installed are updated using the Update wizard. If the update contains new features that you would like to install, run the Modify wizard and select the new features to install from the feature selection panel.

Reverting updates to previous versions

During the rollback process, Installation Manager must access files from the earlier version of the package. By default, these files are stored on your computer when you upgrade to a new package. If you have deleted the files that are saved locally for rollback or cleared the Save files for rollback check box in the Preferences page (File > Preferences > Files for Rollback) while upgrading, you will not be able to roll back to the previous version without the media or repositories that were used to install that version of the package.

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, 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 Installation Manager online help or Information Center.

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

1. Start IBM Installation Manager.
2. On the Start page, click Roll Back.
3. In the Roll Back Packages wizard, from the Package Group Name list, select the package that you want to revert to the previous version and click Next.
4. Follow the instructions in the wizard.

Uninstalling software

For Windows, you can use the Control Panel and, for Linux and UNIX, you can use the Uninstall IBM Installation Manager icon on your computer's desktop to uninstall IBM Installation Manager.

Uninstalling product packages

To uninstall a product package, you must log in to the system by using the same user account that you used to install the product package. You must close the programs that you installed by using IBM Installation Manager.

To uninstall a product package, complete the following steps:

1. Start IBM Installation Manager.
2. On the Start page click Uninstall.
3. On the Uninstall Packages page, from the Installation Packages list, select the product package that you want to uninstall and click Next.
4. On the Summary page, review the list of packages that will be uninstalled and click Uninstall. The Complete page is displayed after the packages are removed.
5. Click Finish.

Uninstalling IBM Installation Manager

Before you can uninstall IBM Installation Manager, you must uninstall all of the packages, including products that were installed by IBM Installation Manager. You must close Installation Manager before attempting to uninstall the program. You must log in to the computer by using the same user account that you used to install Installation Manager.

To uninstall Installation Manager, complete the following steps:

• To uninstall 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.

• To uninstall Installation Manager from Linux, complete the following steps:
  1. Open a terminal window and run /var/ibm/InstallationManager/uninstall/uninstall if this was an installation by root.
  2. In the IBM Installation Manager Uninstall Packages wizard, click Next; then click Uninstall.

Notices

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

This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to:

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.

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this documentation and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.

Trademarks and service marks

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

• developerWorks^(R)
• IBM
• Passport Advantage
• Rational
• WebSphere
• iSeries^(R)
• zSeries^(R)

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

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

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