IBM Rational Application Developer for WebSphere Software, Version 7.5 Beta - Installation Instructions

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

Contents

System requirements

For the system requirements, see the release notes document for this version of IBM® Rational® Application Developer for WebSphere® Software, Version 7.5 Beta at: http://publib.boulder.ibm.com/infocenter/radhelp/v7r5beta/index.jsp?topic=/com.ibm.rad.nav.doc/topics/rad_releasenotes.html.

User privileges requirements

You must have a user ID that meets the following requirements before you can install:
  • Your user ID must not contain double-byte characters.
  • For Microsoft® Windows® Vista, you must log in to the Administrator account (or run as Administrator; right-click the program file or shortcut and select Run as Administrator).
  • For other supported versions of Microsoft Windows, you must have a user ID that belongs to the Administrators group.
  • For Linux®: You must be able to log in as root.

Upgrade and coexistence considerations

If you have installed on your computer an earlier version of Rational Application Developer for WebSphere Software or another product that was installed with IBM Installation Manager, then you should note the following things before you install this version:

Release notes

For information about known problems and limitations in this version of IBM Rational Application Developer for WebSphere Software, Version 7.5 Beta, see the release notes document at: http://publib.boulder.ibm.com/infocenter/radhelp/v7r5beta/index.jsp?topic=/com.ibm.rad.nav.doc/topics/rad_releasenotes.html.
Note: The link to the release notes is incorrect on both the program menu created when the product is installed and also on the "More information" page which is accessed in IBM Installation Manager. Use the URL listed above.

Downloading and extracting the installation files

There are 6 required compressed files for Rational Application Developer for WebSphere Software, Version 7.5 Beta and you must download and extract the contents of all of them to successfully install it.

In addition, there are optional files for version 6.0, 6.1 and 7.0 of IBM WebSphere Application Server Test Environment. For any WebSphere Application Server Test Environment version that you want to install, you must download and extract the contents of all the “disks” for that version.
Note: The IBM WebSphere Application Server Test Environment versions are extensions of Rational Application Developer for WebSphere Software, Version 7.5 Beta, meaning they can be installed only if Rational Application Developer for WebSphere Software, Version 7.5 Beta is installed.
There are also optional files for Windows and Linux versions of Rational Application Developer for WebSphere Software Build Utility.
Note: For instructions on downloading and extracting the Rational Application Developer for WebSphere Software Build Utility files, see Installing the Rational Application Developer for WebSphere Software Build Utility.

You will need approximately 3 GB to download and store all of the required compressed files Rational Application Developer for WebSphere Software, Version 7.5 Beta, and approximately an additional 3 GB to extract the contents. To download all additional optional files, you will need approximately 4.5 GB to store the files and approximately an additional 4.5 GB to extract the contents.

The following table lists all the files that can be downloaded.
Table 1. Compressed installation files for Rational Application Developer for WebSphere Software, Version 7.5 Beta
File name File description Required or optional
RAD_BETA-RC0_75_SETUP.zip Rational Application Developer v7.5 Setup required
RAD_BETA-RC0_75_CORE_DISK1.zip Rational Application Developer v7.5 disk 1 required
RAD_BETA-RC0_75_CORE_DISK2.zip Rational Application Developer v7.5 disk 2 required
RAD_BETA-RC0_75_CORE_DISK3.zip Rational Application Developer v7.5 disk 3 required
RAD_BETA-RC0_75_CORE_DISK4.zip Rational Application Developer v7.5 disk 4 required
RAD_BETA-RC0_75_CORE_DISK5.zip Rational Application Developer v7.5 disk 5 required
RAD_BETA-RC0_75_WAS60_DISK1.zip WebSphere Application V6.0 Test Environment disk 1 optional
RAD_BETA-RC0_75_WAS60_DISK2.zip WebSphere Application V6.0 Test Environment disk 2 optional
RAD_BETA-RC0_75_WAS61_DISK1.zip WebSphere Application V6.1 Test Environment disk 1 optional
RAD_BETA-RC0_75_WAS61_DISK2.zip WebSphere Application V6.1 Test Environment disk 2 optional
RAD_BETA-RC0_75_WAS61_DISK3.zip WebSphere Application V6.1 Test Environment disk 3 optional
RAD_BETA-RC0_75_WAS61_DISK4.zip WebSphere Application V6.1 Test Environment disk 4 optional
RAD_BETA-RC0_75_WAS70_DISK1.zip WebSphere Application V7.0 Test Environment disk 1 optional
RAD_BETA-RC0_75_WAS70_DISK2.zip WebSphere Application V7.0 Test Environment disk 2 optional
RAD_BETA-RC0_75_WAS70_DISK3.zip WebSphere Application V7.0 Test Environment disk 3 optional
RAD_BETA-RC0_75_WAS70_DISK4.zip WebSphere Application V7.0 Test Environment disk 4 optional
RAD_BETA-RC0_75_WAS70_DISK5.zip WebSphere Application V7.0 Test Environment disk 5 optional
RAD_BETA-RC0_75_BuildUtility_Win32.zip Rational Application Developer for WebSphere Software Build Utility for Windows optional
RAD_BETA-RC0_75_BuildUtility_Linux.zip Rational Application Developer for WebSphere Software Build Utility for Linux optional

Extracting the installation 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.
When you are finished extracting all of the compressed files, the directory where you extracted the contents will have subdirectories with the following names:
Table 2. Subdirectories created after extracting compressed file contents
Subdirectory name Required or optional
RAD_SETUP required
RAD required
WAS60 optional
WAS61 optional
WAS70 optional

You now have a repository from which you can install Rational Application Developer for WebSphere Software, Version 7.5 Beta.

Installation steps

  1. Change to the RAD_SETUP subdirectory of the directory where you extracted the "disks" for Rational Application Developer for WebSphere Software, Version 7.5 Beta.
  2. Start the launchpad program:
    • For Microsoft Windows: Run launchpad.exe.

      Important - For Microsoft Windows Vista: You must run the launchpad program as administrator; right-click on launchpad.exe and click Run as Administrator.

    • For Linux: Run launchpad.sh.
  3. In the Select a Language dialog-box, select English and then click OK.
  4. In the launchpad dialog-box, click Install IBM Rational Application Developer for WebSphere V7.5 Beta. IBM Installation Manager starts.
  5. Install IBM Installation Manger Version 1.2:
    1. On the first page of the Install Packages wizard, IBM Installation Manager, Version 1.2 is selected as the package to install. 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. On the location page, in the Installation Manager Directory field, type the path 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.
  6. In the IBM Installation Manager(Beta=RADBeta) window, click Install. The Install Packages wizard opens.
  7. On the first page of the Install Packages wizard, do the following things and then click Next:
    • Ensure that you select Rational Application Developer Version 7.5.0 RC0 as a package to install.
    • (Optional) Select versions of IBM WebSphere Application Server Test Environment.
      Tip: The WebSphere Application Server Test Environment extensions can be installed at a later time if you choose to not install them now.
  8. On the Licenses page, read the license agreements for the products that you are installing. 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.
  9. On the Location page, in the Shared Resources Directory field, type the path for the shared resources directory or accept the default path and then click Next. 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 the first time that you install a package. Use your largest disk for this to help ensure adequate space for the shared resources of future packages. You cannot change the directory location unless you uninstall all packages.
    Important: For Microsoft Windows Vista: Choose a location that is not within the Program Files directory (C:\Program Files). If you select a shared resources directory within the Program Files directory, then you must run Rational Application Developer as administrator.
    Important: For Linux: Ensure that you do not include any spaces in the directory paths.
  10. On the next Locations page, ensure that you select Create a new package group and then type a path for the installation directory in the Installation Directory field or accept the default path, and then click Next.
    Important: For Microsoft Windows Vista: Choose a location that is not within the Program Files directory (C:\Program Files). If you select an installation directory within the Program Files directory, then you must run Rational Application Developer as administrator.
    Important: For Linux: Ensure that you do not include any spaces in the directory paths.
  11. Click Next. (Extending an existing Eclipse IDE is not supported in this beta release.)
  12. Click Next. (English is the only language that is supported in this beta release.)
  13. On the Features page, select the features that you want to install. Dependencies between features are automatically enforced.
    Note: If you are installing WebSphere Application Server, Version 6.0 Test Environment, then you must select the feature IBM Rational Application Developer > WebSphere Application Server Development > Tools for WebSphere Application Server, Version 6.0. This feature is not automatically selected.
    Note: If you are installing WebSphere Application Server, Version 6.1 Test Environment, then you must select the feature IBM Rational Application Developer > WebSphere Application Server Development > Tools for WebSphere Application Server, Version 6.1. This feature is not automatically selected.
    Click Next.
  14. On the Help System page, ensure that you select Remote Help and then click Next. The other help system options are not supported in this beta release.
  15. If you are installing any of the optional WebSphere Application Server Test Environment extensions, the Configuring the WebSphere Application Server page opens. For each WebSphere Application Server Test Environment extension that you are installing, perform the following steps:
    1. In the left-hand 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 (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 request that the non-root user to 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.
      2. (For version 7.0 and version 6.1) 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, enter a user ID and password in the corresponding fields.
  16. 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 installation choices, click Install.
  17. When the installation process is complete, a message confirms the success of the process. If you want to start IBM Rational Application Developer, ensure that it is selected and click Finish.

Starting Rational Application Developer for WebSphere Software, Version 7.5 Beta

You can start Rational Application Developer V7.5 Beta later from your desktop environment (for example, Start > All Programs > IBM Software Delivery Platform > IBM Rational Application Developer 7.5 > IBM Rational Application Developer) or from a command-line.

To start Rational Application Developer V7.5 Beta from a command-line, run the following commands:
  • For Microsoft Windows: <product installation directory>\eclipse.exe -product com.ibm.rational.rad.product.v75.ide
  • For Linux: <product installation directory>/eclipse -product com.ibm.rational.rad.product.v75.ide

Modifying installations

After installing Rational Application Developer for WebSphere Software, Version 7.5 Beta, you can add or remove features that you installed by running the Modify Packages wizard in Installation Manager. To change your feature selections:
  1. Start IBM Installation Manager RADBeta. (For example, click Start > All Programs > IBM Installation Manager RADBeta > IBM Installation Manager.)
  2. Click Modify Packages.
  3. In the Modify Packages wizard, select the installation location for Rational Application Developer, Version 7.5 Beta. Click Next.
  4. On the Features page, select the package features that you want to install or remove. Click Next.
  5. On the Summary page, review your choices and then click Modify.
  6. When the modification process completes, click Finish.
  7. Close Installation Manager.

Installing WebSphere Application Server, Version 6.0, 6.1 or 7.0 Test Environment extensions

If you did not install a WebSphere Application Server, Version 6.1 Test Environment extension at the same time that you installed Rational Application Developer for WebSphere Software, Version 7.5 Beta, then you can install one or more versions using the following steps:
  1. Ensure that you have the following features installed for Rational Application Developer for WebSphere Software, Version 7.5 Beta:
    Table 3. Rational Application Developer features required for WebSphere Application Server Test Environment extensions
    WebSphere Application Server Test Environment version Required feature
    WebSphere Application Server, Version 6.0 Test Environment WebSphere Application Server Development > Tools for WebSphere Application Server, Version 6.0
    WebSphere Application Server, Version 6.1 Test Environment WebSphere Application Server Development > Tools for WebSphere Application Server, Version 6.1
    WebSphere Application Server, Version 7.0 Test Environment WebSphere Application Server Development > Tools for WebSphere Application Server, Version 7.0
    To check which features are installed, start IBM Installation Manager (for example, click Start > All Programs > IBM Installation Manager RADBeta > IBM Installation Manager) and click File > View Installed Packages.
  2. If Installation Manager is running, stop it.
  3. Change to the RAD_SETUP subdirectory of the directory where you extracted the "disks" for Rational Application Developer for WebSphere Software, Version 7.5 Beta.
  4. Start the launchpad program:
    • For Microsoft Windows: Run launchpad.exe.

      Important - For Microsoft Windows Vista: You must run the launchpad program as administrator; right-click on launchpad.exe and click Run as Administrator.

    • For Linux: Run launchpad.sh.
  5. In the launchpad dialog-box, click Install IBM Rational Application Developer V7.5 Beta. IBM Installation Manager starts.
  6. Click Install packages. The Install Packages wizard opens.
  7. On the first page of the Install Packages wizard, select the versions of IBM WebSphere Application Server Test Environment that you want to install and then click Next.
  8. Ensure that the package group where you installed Rational Application Developer V7.5 Beta is selected and then click Next.
  9. On the Features page, select any additional features that you want to install. Click Next
  10. If you are installing any of the optional WebSphere Application Server Test Environment extensions, the Configuring the WebSphere Application Server page opens. For each WebSphere Application Server Test Environment extension that you are installing, perform the following steps:
    1. In the left-hand 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 (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 request that the non-root user to 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.
      2. (For version 7.0 and version 6.1) 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, enter a user ID and password in the corresponding fields.
  11. 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 installation choices, click Install.
  12. When the installation process completes, click Finish.
  13. Close Installation Manager.

Uninstalling

To uninstall Rational Application Developer for WebSphere Software, Version 7.5 Beta, run the Uninstall Packages wizard in Installation Manager:
  1. Start IBM Installation Manager. (For example, click Start > All Programs > IBM Installation Manager > IBM Installation Manager RADBeta.)
  2. Click Uninstall Packages.
  3. Select the Rational Application Developer, Version 7.5.0 Beta installation package, and then click Next.
  4. Click Uninstall.
  5. When the uninstall process completes, click Finish.
  6. Close Installation Manager.
To uninstall Installation Manager RADBeta, you must first uninstall all products that were installed by it. To uninstall IBM Installation Manager RADBeta:
  • For Windows: Use the Add or Remove Programs feature in the Control Panel to uninstall IBM Installation Manager RADBeta. For example, use these steps:
    1. Click Start > Control Panel and then click Add or Remove Programs.
    2. Select the entry for IBM Installation Manager and click Remove. Installation Manager starts and opens the Uninstall Packages wizard.
    3. In the Uninstall Packages wizard, ensure that IBM Installation Manager is selected. Click Next.
    4. Click Uninstall.
  • For Linux:
    1. Open a terminal window with root user privileges.
    2. Change directory to the uninstall directory of the installation directory of Installation Manager RADBeta (by default, /var/ibm/InstallationManagerRADBeta/uninstall)
    3. Run ./uninstall. Installation Manager starts and opens the Uninstall Packages wizard.
    4. In the Uninstall Packages wizard, ensure that IBM Installation Manager is selected. Click Next.
    5. Click Uninstall.

Installing the Rational Application Developer for WebSphere Software Build Utility

You can use the Rational Application Developer for WebSphere Software Build Utility to automate the process of building applications created from the Rational Application Developer product. The inputs into the Build Utility are projects developed using Rational Application Developer, and the output is the code compiled and packaged into JAR, WAR and EAR files. The Build Utility is an optional, stand-alone utility and is separately installed using the following instructions:
  • For Windows:
    1. Download and extract the Rational Application Developer for WebSphere Software Build Utility file (RAD_BETA-RC0_75_BuildUtility_Win32.zip) into any directory you want.
    2. The installation is now complete.
  • For Linux:
    1. Download and extract the Rational Application Developer for WebSphere Software Build Utility file (RAD_BETA-RC0_75_BuildUtility_Linux.zip) into any directory you want.
    2. The installation is now complete.

Notices and trademarks

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

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

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

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785 U.S.A.

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

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OR CONDITIONS OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

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

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

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

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

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

Trademarks and service marks

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

Linux is a 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.

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