Installing Rational Application Developer for WebSphere Software

This topic provides the instructions for installing Rational® Application Developer for WebSphere® Software.

Before you begin

Review the topic Scenarios for installing with the Installation Manager GUI.

To enable Installation Manager to search for the latest available version of the software that you are installing, ensure that you are connected to the Internet.

Procedure

If you are installing from the Setup disk, complete one of the following steps:
- If you are installing as an Admin:
  1. Start the launchpad.
  2. Click Install IBM® Rational Application Developer for WebSphere Software.
- If you are installing as a non-Admin: Start the installation from the Setup disk by running the userinst program.
Install or update IBM Installation Manager, if necessary.
1. On the first page of the Install Packages wizard, click Check for Other Versions and Extensions to install the latest available version. If a newer version is available, it is automatically selected for installation. Click Next.
2. On the Licenses page, read the license agreements for IBM Installation Manager. If you agree to the terms of all of the license agreements, click I accept the terms in the license agreements and then click Next.
3. If Installation Manager is not already installed: On the location page, in the Installation Manager Directory field, type the path for the directory where you want to install Installation Manager or accept the default path and then click Next.
4. On the Summary page, review your choices before starting the installation process. If you want to change your selections, click Back to return to the previous pages. When you are satisfied with your selections, click Install.
5. When the installation process completes, click Restart Installation Manager. Installation Manager closes and restarts.
In the IBM Installation Manager window, click Install. The Install Packages wizard opens.
Ensure that you select IBM Rational Application Developer for WebSphere Software.
You can optionally select to install any of the following supporting software:
- IBM WebSphere Application Server, Version 8.5
- IBM WebSphere Application Server, Version 8.0
- IBM WebSphere Application Server, Version 7.0 Test Environment.
- IBM Rational Desktop Connection Toolkit for Cloud Environments.
If you choose to not install any of these software items at this time, you can install them later.
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 set.
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. If additional information about the package is available, a More info link is included at the end of the description text. Click the link to display the additional information in a browser.
Click Next.
On the Licenses page, read the license agreements for the selected packages. On the left 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.
Depending on whether you already used Installation Manager to install software, you might have to select the shared resources directory on the Location page. Type the path in the Shared Resources Directory field, or accept the default path and then click Next to continue. 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.
Note: Use your disk with the most available space for to help ensure adequate space for the shared resources of future packages. You cannot change the shared resources directory location unless you uninstall all packages.

On the Location page:

The software is installed into one or more package groups, depending on the items that you chose to install. Each package group has an installation directory for the software in the package group. You can accept the default locations or specify the installation location. To specify the installation location, click the package group and then 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. Depending on the software that you selected to install, the following package groups are created:

Package group name	Products in the package group (if selected for installation)
IBM Software Delivery Platform	Rational Application Developer for WebSphere Software IBM Rational Desktop Connection Toolkit for Cloud Environments IBM WebSphere Application Server, Version 7.0 Test Environment.
WebSphere Application Server V8.0	IBM WebSphere Application Server, Version 8.0.
WebSphere Application Server V8.5	IBM WebSphere Application Server, Version 8.5

Note: By default, Installation Manager checks for existing package groups that are compatible with the software that you are installing. Note the following cases:

If you are installing a software for a single package group (for example, you are only installing Rational Application Developer for WebSphere Software) and an existing compatible package group is found, you can either install into the existing package group (Use the existing package group), or you can select Create a new package group.
If you are installing software for multiple package groups (for example, you are installing Rational Application Developer for WebSphere Software and IBM WebSphere Application Server, Version 8.0.) and a compatible package group is found for Rational Application Developer for WebSphere Software, then you do not have the option to choose a new package group. If you want to install Rational Application Developer for WebSphere Software into a new package group, then you cannot simultaneously install software into other package groups; you must install them separately.

If you operating system is 64-bit, then select 64-bit or 32-bit to install the product in the corresponding bit mode.
Tip: For details on known problems or limitations for installing the product as a 64-bit application, see: http://www.ibm.com/support/docview.wss?uid=swg21499482
Click Next.

On the next Location page, you can choose to extend an Eclipse IDE already installed on your system and add to it 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 browse to the location of the folder that contains the Eclipse executable file (eclipse.exe or eclipse.bin). Installation Manager checks that the Eclipse IDE version is valid for the package that you are installing. The Eclipse IDE JVM field displays the Java™ virtual machine (JVM) for the IDE that you specified.
  3. Click Next to continue.
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.
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 automatically enforces any dependencies with other features and displays updated download size and disk space requirements for the installation.
4. When you are finished selecting features, click Next to continue.
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
If you are installingWebSphere Application Server Test Environment extension, version 7.0: The Configuration of the WebSphere Application Server page opens. Perform the following steps:
1. In the left column under the version of WebSphere Application Server Test Environment extension, click Configuring the WebSphere Application Server.
2. Either leave the default selection Create a profile to create a profile for the application server test environment or clear it if you want to create the profile later. You can create a profile using the workbench: Click Window > Preference > Server > WebSphere Application Server.
  Note: If you are the root user and are installing for a non-root user, then do not create a profile at this time, and then request that the non-root user create the profile later in the workbench.
3. If you selected to create a profile in the previous step, then do the following things:
  1. Type a profile name and profile path in the corresponding fields or accept the default entries.
    Note: If you are installing as a non-Admin user on Windows, then you might see a message that the profile path exceeded the maximum length of 80 characters. If this error occurs, type a shorter profile path. For example, type user.home/IBM/profiles/was70profile1 instead of user.home/IBM/SDP/runtimes/base_v70/profiles/was70profile1.
  2. By default, the option Enable administrative security on the profile is selected. Clear this selection if you do not want to enable security on the profile. Otherwise, type a user ID and password in the corresponding fields.
4. Click Next.
Note: If you are also installing WebSphere Application Server, Version 8.5 or 8.0 at the same time, then create a developer profile after the installation completes.
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.
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 start the selected package. The Install Package wizard closes and you are returned to the Start page of Installation Manager.
Close Installation Manager.