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

  1. Depending on your operating system and your user ID, complete one of the following steps:
    • If you are installing with administrator or root privileges:
      • For Windows and Linux:
        1. Start the Launchpad application:
          • For Windows: Run RAD_SETUP\launchpad.exe.
            Important: If your operating system is Windows 7, then you must run launchpad.exe as administrator.
          • For Linux: Run RAD_SETUP/launchpad.sh.
        2. In the Launchpad dialog-box, click Install IBM Rational Application Developer for WebSphere .
      • For OS X For OS X:
        1. From Finder, change the directory to RAD_SETUP/InstallerImage_macosx_cocoa_x86_64/.
        2. Double click Install.app.
    • If you are not installing with administrator or root privileges:
      1. Change to the directory where you extracted the disk images.
      2. Run the following command for your operating system:
        • For Windows: Run RAD_SETUP\InstallerImage_win32_win32_x86\userinst.exe.
        • For 32-bit Linux: Run RAD_SETUP/InstallerImage_linux_gtk_x86/userinst.
        • For 64-bit Linux: Run RAD_SETUP/InstallerImage_linux_gtk_x86_64/userinst.
        • For OS X:
          1. From Finder, change the directory to RAD_SETUP/InstallerImage_macosx_cocoa_x86_64/.
          2. Double-click Userinst.app.
    IBM Installation Manager starts.
  2. On the first page of the Install Packages wizard, ensure that you select IBM Rational Application Developer for WebSphere Software. If you do not already have IBM Installation Manager, Version 1.6.3.1, or later, installed, then it is also selected.
  3. You can optionally select to install any of the following supporting software:
    • IBM WebSphere Application Server Liberty for Developers
    • IBM WebSphere Software Development Kit Java™ Technology Edition for Liberty
    • IBM WebSphere Application Server for Developers
    • IBM WebSphere Application Server Test Environment
      Note: There are separate 32-bit and 64-bit packages.
    • 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.
  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 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. 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.
  6. Click Next.
  7. On the Licenses page, read and accept the license agreements for the selected packages.
    1. On the left-hand side of the License page, click each package version to display its license agreement.
    2. If you agree to the terms of all of the license agreements, click I accept the terms of the license agreements.
    3. Click Next to continue.
  8. If Installation Manager is not already installed, then specify the Shared Resources directory and the Installation Manager directory.
    Restriction: The directory path must not exceed 41 characters or the installation will fail.
    Note: For Linux Ensure that you do not include any spaces in the directory path.
    1. Type the path for the Shared Resources Directory, or accept the default 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.
    2. In the Installation Manager Directory field, type the path for the directory where you want to install Installation Manager or accept the default path.
    3. Click Next.
  9. On the Location page:
    1. 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 Test Environment
      WebSphere Application Server IBM WebSphere Application Server for Developers
      WebSphere Liberty
      • IBM WebSphere Application Server Liberty for Developers
      • IBM WebSphere Software Development Kit Java Technology Edition for Liberty
      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 for Developers) 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.
    2. 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
    3. Click Next.
  10. On the Features page under Languages, select the languages for the package group. The corresponding national language translations for the user interface and documentation for the product package will be installed.
  11. 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.
  12. 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
  13. If you are installingWebSphere Application Server Test Environment extension: 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 or WebSphere Application Server Liberty at the same time, then create a developer profile after the installation completes.
  14. 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.
  15. 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.
  16. Close Installation Manager.

Feedback