Installation Instructions

Rational Software Architect RealTime Edition, Version 9.0 Beta

© Copyright IBM Corporation 1987, 2013. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents

Installation requirements

This section describes the installation requirements for IBM® Rational® Software Architect RealTime Edition, Version 9.0 Beta.

System requirements

Important: When you install Rational Software Architect RealTime Edition, Version 9.0 Beta, you are required to install an additional, limited function version of IBM Installation Manager. This beta version of IBM Installation Manager can be used only for installing, modifying, and uninstalling the products and extensions provided with this beta release. You cannot use this version of IBM Installation Manager to install other products or packages.

The hardware and software requirements for installing the products are similar to version 8.5.1. For details, see the version 8.5.1 system requirements at http://publib.boulder.ibm.com/infocenter/prodguid/v1r0/clarity/softwareReqsForProduct.html. Note that OS X 10.6, or later, is supported beginning with version 9.0, but in 64-bit mode only with the current beta release.

User privileges requirements

You must have a user ID that meets the following requirements before you can install:

Downloading and extracting the installation files for local installation

When you download the installation files for Rational Software Architect RealTime Edition, Version 9.0 Beta and create a local installation repository, you must correctly extract the contents of each .zip file to successfully install the product.

Downloading the installation files

You will need approximately 2.0 GB to download and store all of the required compressed files for each product and approximately an additional 3.5 GB to extract the contents.

The following tables list the files available for downloading to the computer where you plan to install the product:

Extracting the installation files

You must extract the contents of the .zip files that you downloaded. When you extract the contents of the .zip files:
  • Ensure that you preserve the directory structure of the contents of the .zip files.
  • For all files downloaded to the computer where you are installing Rational Software Architect RealTime Edition, extract the contents of all of the compressed files to the same directory.

Installing the product from downloaded installation files

This section provides the instructions for installing Rational Software Architect RealTime Edition, Version 9.0 Beta from installation files that you downloaded from the beta website.

Before you begin

You must download all the installation files for Rational Software Architect RealTime Edition, Version 9.0 Beta and correctly extract the contents of the .zip files.

Procedure

  1. Depending on your user ID, complete one of the following steps:
    • If you are installing with administrator or root privileges:
      1. Start the launchpad:
        • For Windows: Run RSA_SETUP\launchpad.exe, or RSA4WS_SETUP\launchpad.exe.
          Important: If your operating system is Windows 7, you must run launchpad.exe as administrator.
        • For Linux: Run RSA_SETUP/launchpad.sh or RSA4WS_SETUP/launchpad.sh.
        • For OS X: Run RSA_SETUP/launchpad.sh or RSA4WS_SETUP/launchpad.sh.
      2. In the launchpad dialog box, click Install IBM Rational Software Architect, or Install IBM Rational Rational Software Architect for WebSphere.
    • 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 RSA_SETUP\InstallerImage_win32_x86\userinst.exe or RSA4WS_SETUP\InstallerImage_win32_x86\userinst.exe.
        • For Linux: Run RSA_SETUP/InstallerImage_linux_gtk_x86/userinst or RSA4WS_SETUP/InstallerImage_linux_gtk_x86/userinst.
        • For OS X: Run RSA_SETUP/InstallerImage_macosx_cocoa_x86_64/./userinst or RSA4WS_SETUP/InstallerImage_macosx_cocoa_x86_64/./userinst.

    IBM Installation Manager starts.

  2. On the first page of the Install Packages wizard, ensure that both IBM Installation Manager Version 1.6.2 and IBM Rational Software Architect Version 9.0 Beta or IBM Rational Software Architect for WebSphere Version 9.0 Beta are selected, and then click Next.
    Note: The beta version of IBM Installation Manager that you are installing can be used only for installing, modifying, and uninstalling the packages provided with this beta release. You cannot use this version of IBM Installation Manager with other products or packages.
  3. On the Prerequisite page, click Next.
  4. 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.
  5. On the first Location Page, 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 paths.
    1. Type the path for the Shared Resources Directory field, or accept the default path. The shared resources directory contains resources that can be shared by one or more package groups.
      Note: You can specify the shared resources directory only once. 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 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.
  6. On the next Location page, specify the installation directory for the package group and select the bit mode of the installation.
    1. In the Installation Directory field, type the path for the installation directory for the package group or accept the default.
      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 paths.
    2. If you operating system is 64-bit, then select 64-bit or 32-bit to install the product in the corresponding bit mode. Note: For OS X, you must select 64-bit because only 64-bit is supported.
    3. Click Next.
  7. On the next Location page, do not choose to extend an Eclipse IDE and simply click Next to continue.
  8. 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.
  9. 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
  10. 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.
  11. 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.
  12. Close IBM Installation Manager.

Starting the product

This section provides instructions for starting Rational Software Architect or Rational Software Architect for WebSphere, Version 9.0 Beta.

You can start Rational Software Architect or Rational Software Architect for WebSphere, Version 9.0 Beta from your desktop environment (for example, Start > All Programs > IBM Software Delivery Platform > IBM Rational Software Architect 9.0 Beta > IBM Rational Software Architect) or from a command line.

To start Rational Software Architect from a command line, run the following commands:
  • For Windows: <product installation directory>\eclipse.exe -product com.ibm.rational.rsa.product.v90.ide
  • For Linux: <product installation directory>/eclipse -product com.ibm.rational.rsa.product.v90.ide
  • For OS X: Use Finder to browse to the installation folder in which the product was installed (By default, it is /Users/your_user_id/IBM/SDP); then double-click the eclipse executable file.

To start Rational Software Architect for WebSphere Software from a command line, run the following commands:

  • For Windows: <product installation directory>\eclipse.exe -product com.ibm.rational.rsaws.product.v90.ide
  • For Linux: <product installation directory>/eclipse -product com.ibm.rational.rsaws.product.v90.ide
  • For OS X: Use Finder to browse to the installation folder in which the product was installed (By default, it is /Users/your_user_id/IBM/SDP); then double-click the eclipse executable file.

Modifying installations

After installing Rational Software Architect or Rational Software Architect for WebSphere Software, Version 9.0 Beta, you can add or remove features that you installed by using the Modify Packages wizard in IBM Installation Manager.

To change your feature selections:
  1. Start IBM Installation Manager Beta. (For example, click Start > All Programs > IBM Installation Manager Beta > IBM Installation Manager.)
  2. On the main page of IBM Installation Manger, click Modify.
  3. In the Modify Packages wizard, select the installation location for Rational Software Architect or Rational Software Architect for WebSphere Software, Version 9.0 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.

Uninstalling the product

This section provides instructions for uninstalling Rational Software Architect or Rational Software Architect for WebSphere Software, Version 9.0 Beta and IBM Installation Manager Beta.

To uninstall Rational Software Architect or Rational Software Architect for WebSphere Software, Version 9.0 Beta, run the Uninstall Packages wizard in IBM Installation Manager:
  1. Start IBM Installation Manager Beta. (For example, click Start > All Programs > IBM Installation Manager Beta > IBM Installation Manager.)
  2. On the main page of IBM Installation Manger, click Uninstall.
  3. Select the packages that you want to uninstall and then click Next.
  4. Click Uninstall.
  5. When the uninstall process completes, click Finish.
  6. Close Installation Manager.
Before you can uninstall IBM Installation Manager, you must first uninstall all products that were installed by it. To uninstall IBM Installation Manager:
  • For Windows: Use the Add or Remove Programs feature in the Control Panel to uninstall IBM Installation Manager Beta, for example:
    1. Click Start > Control Panel and then click Add or Remove Programs.
    2. Select the entry for IBM Installation Manager and click Remove. IBM 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 IBM Installation Manager Beta (by default, /var/ibm/InstallationManager_Beta/uninstall).
    3. Run ./uninstall. IBM 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.
  • For OS X:
    1. User Finder to locate the uninstall directory of the installation directory of IBM Installation Manager Beta (by default,  /Users/your_user_id/var/ibm/InstallationManager_Beta/Uninstall).
    2. Run ./uninstall. IBM 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.

Installing WebSphere Application Server Developer Tools for Eclipse

IBM WebSphere Application Server Developer Tools for Eclipse is a lightweight set of tools for developing, assembling, and deploying Java EE, OSGi, Web 2.0, and mobile applications to WebSphere Application Server.

For system requirements, installation instructions, and other information for WebSphere Application Server Developer Tools for Eclipse, see http://pic.dhe.ibm.com/infocenter/radhelp/v9/topic/com.ibm.rad.install.doc/topics/t_install_wdt.html.

Notices and trademarks

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:

Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan, Ltd.
19-21, Nihonbashi-Hakozakicho, Chuo-ku
Tokyo 103-8510, 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.

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:

Intellectual Property Dept. for Rational Software
3600 Steeles Avenue East
Markham, ON
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

IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at http://www.ibm.com/legal/copytrade.shtml.