Rational Software Corp.

TOC PREV NEXT INDEX


Before You Install

The following topics are covered in this chapter:

Ensure that you meet the requirements listed in this chapter before proceeding with the installation.

Before You Install Checklist

Table 3 provides a checklist for tasks that need to be performed before you install Rational Suite. Use this table as you run through steps to upgrade your Suite software or perform a new installation.

Table 3 Before You Install Checklist
Step
Action

1 Verify that you meet the hardware and software requirements for this release of Rational Suite.


See the following sections:

2 Determine how you want to set up your server configuration based on the products you are planning to use.


See Planning Your Installation

3 Backup your data. Backing up your data prior to installing any new software should be a regular practice.

This is especially important for database products such as Rational ClearQuest and Rational Requisite Pro.


For ClearQuest, see the Rational ClearQuest Installation Guide.
For Requisite Pro, see the Rational RequisitePro Installation Guide.

4 Do you plan to install Rational ClearCase?


If yes, install Rational ClearCase before you install Rational Suite. Refer to the ClearCase product documentation, located on the Rational Solutions for Windows Online Documentation CD, for instructions on how to install.

Do you plan to install Rational ClearCase LT?


If yes, you should install Rational Suite DevelopmentStudio first and ClearCase LT second. See Installation Requirements for Rational ClearCase LT.

5 Do you plan to use Rational SoDA?


If yes, see Installation Requirements for Rational SoDA.

6 If you are installing Rational Suite DevelopmentStudio, do you plan to use Rational Apex with Rational Rose or with Rational SoDA?


If yes, you may want to install Apex before you install Rational Suite. Make a note of the Apex installation directory as you need to provide this during the installation.
Alternatively, you can go ahead and install Rational Suite and install Apex later. See Integrating Products That Are Not Part of the Suite for information about how to integrate Apex with Rose or SoDA after you have installed the Suite.

7 Obtain a valid license key.


You need either a temporary license, an existing license, or a permanent license before you install the product.
If you are using an existing license, go to Step 8.
If you are using a temporary license, locate your license key certificate and go to Step 8.
If you want to install the product using a permanent license, see Requesting License Keys.

8 You are ready to install Rational Suite.


See Installing the Product.

Rational Suite (UNIX Components) Installation Requirements

Hardware Requirements

Table 4 summarizes the hardware requirements for Rational Suite DevelopmentStudio (Unix Components). Table 5 summarizes the hardware requirements for Rational Suite DevelopmentStudio RealTime (Unix Components). Note that the recommended amount of memory is only the suggested minimum amount. Additional memory may improve performance. Your memory requirements will also be larger depending on the tasks you are attempting and what else is resident (running concurrently on the system). For example, the construction of larger Rational Rose or Rational Rose RealTime models requires more memory.

Table 4 Rational Suite DevelopmentStudio Hardware Requirements
Product

Swap Space
Memory
Disk Space


Solaris
HP-UX

Rational Unified Process

NA

16 MB minimum

57 MB

57 MB

Rose

150 MB +
50 MB/user

64 MB + 32 MB/simultaneous user

335 MB + 1 to 3 MB for each model

365 MB (10.20)
365 MB (11.00)
+ 1 to 3 MB for each model

SoDA with Frame

64 MB

32 MB minimum

192 MB

252 MB

Purify1

-

2-5 times application size

16 MB

11 MB (32-bit)
12 MB (64 bit)

Quantify 1

-

2-5 times application size

15 MB

10 MB (32-bit)
12 MB (64 bit)

PureCoverage 1

-

2-5 times application size

9 MB

12 MB

ClearQuest

NA

48 MB

115 MB

230 MB

RequisitePro Web Interface

NA

NA

NA

NA

Totals

214 MB +
50 MB /user

160 MB + 32 MB/user + Purify, Quantify, and PureCoverage requirements

740 MB

940 MB

Recommended Suite
Requirements

500 MB +
50 MB/user

256 MB + 32 MB/user

0.9 GB

1.3 GB

1 Swap Space requirements are dependent on the size of the application that is being tested.

Table 5 Rational Suite DevelopmentStudio RealTime Hardware Requirements
Product

Swap Space
Memory
Disk Space


Solaris
HP-UX

Rational Unified Process

NA

16 MB minimum

57 MB

57 MB

Rose RealTime

770 MB

256 MB minimum

355 MB
+ 1 to 3 MB for each model

355 MB
+ 1 to 3 MB for each model

SoDA with Frame

64 MB

32 MB minimum

192 MB

252 MB

Purify 1

-

2-5 times application size

16 MB

11 MB (32-bit)
12 MB (64 bit)

Quantify 1

-

2-5 times application size

15 MB

10 MB (32-bit)
12 MB (64 bit)

PureCoverage 1

-

2-5 times application size

9 MB

12 MB

ClearQuest

NA

48 MB

115 MB

230 MB

RequisitePro Web Interface

NA

NA

NA

NA

Totals

214 MB +
50 MB /user

160 MB + 32 MB/user + Purify, Quantify, and PureCoverage requirements

760 MB

905 MB

Recommended Suite
Requirements

500 MB +
50 MB/user

256 MB + 32 MB/user

0.9 GB

1 GB

1 Swap Space requirements are dependent on the size of the application that is being tested.

Software Requirements

The following platforms are supported in Rational Suite, version 2002.05.00:

Note the following point product exceptions:

Each point product within Rational Suite has its own range of OS version compatibility as summarized in Table 6. Customers should pick the OS version that intersects the product mix they intend to use.

Table 6 Individual Product OS Version Compatibility  
Product
Solaris
HP-UX

Rose

2.6, 2.7 (Solaris 7), and 2.8 (Solaris 8)

10.20, 11.0, and 11.11
See Table 7 for more information.

Rose RealTime1

2.6, 2.7 (Solaris 7), and 2.8 (Solaris 8)

10.20

SoDA with Frame

2.6, 2.7 (Solaris 7), and 2.8 (Solaris 8)

10.20, 11.0, and 11.11

Purify

2.6, 2.7 (Solaris 7), and 2.8 (Solaris 8)
(32 and 64 bit)

10.x through 11.0, and 11.11
32 and 64 bit (narrow and wide mode)

Quantify

2.6, 2.7 (Solaris 7), and 2.8 (Solaris 8)
(32 and 64 bit)

10.x through 11.0, and 11.11
32 and 64 bit (narrow and wide mode)

Pure Coverage

2.6, 2.7 (Solaris 7), and 2.8 (Solaris 8)
(32 bit only)

10.x through 11.0, and 11.11
32 bit only

ClearQuest

2.6, 2.7 (Solaris 7), and 2.8 (Solaris 8)

10.20, 11.0, and 11.11

Rational Unified Process 1

2.6, 2.7 (Solaris 7), and 2.8 (Solaris 8)

11.0 and 11.11
Note that Rational Unified Process is not supported on HP-UX 10.20.

1 Requires an HTML browser. Netscape Navigator 4.7 or later is recommended.

Installation Requirements for Rational Rose

This section lists requirements that must be met to successfully use Rational Rose. Table 7 summarizes the software requirements for Rational Rose.

Table 7 Rose Software Requirements 
Software Item
Requirement
For

Operating system

Solaris 2.6, 7, and 8 (kernel revision January 2000 and later)

  1. HP-UX 10.20 (ACE release 1 ), 11.00, and 11.11


Use

C++ Compiler #include files

Solaris SC 5.0
HP-UX 10.20:
HP aC++ B3910B A.01.21
HP aC++ B3910B A.01.19.02 Language Support Library

HP-UX 11.00:
HP aC++B3910B A.03.13
HP aC++B3910B X.03.11.10 Language Support Library

Analyzer


JDK, JFC, and J2EE

JDK 1.1.6
JFC 1.1 (swing classes for 1.1)
JDK 1.2 (based on 1.2.1)
J2SE 1.2 (based on 1.2.2)
J2SE 1.3
J2EE 1.2
or any of the major Java IDEs



Java

Rose J supports the following Java IDE's. Use the JDK appropriate to your IDE. 2



Port map daemon

Must be running

Installation, Use

TCP/IP

Must be running

Installation, Use

Host names

Must be configured

Installation, Use

Page/swap space

150 + (50 * N) MB

Use

X Window System

Native X11R5 or X11R6 (except HP 10.20)
X news on Sun with OpenWindows 3.
PC X server eXceed version 6.1 or higher

Use

Window Manager

MWM (Motif Window Manager) version 1.2
vuewm on HP-UX
4dwm on SGI IRIX
dtwm (CDE (Desk Top) version 1.0)
olwm (Open Look Window Manager) on Sun is supported, but icons of Rose may not integrate well with other icons on the screen

The following Window Managers are not supported:

olvwm (olwm with virtual screens) Rose will not remain on original virtual desktop, but rather will follow when other desktops selected.
twm (shipped with X11)
tvtwm (twm with virtual screens)
fwm
gwm
fvwm

Use

1 Rose requires that an ACE release be installed to run properly on HP-UX 10.20. To determine if an ACE release is installed, run /usr/sbin/swlist | grep ACE.

2 See the Rose_IDE_Link_README file in the release for Rose UNIX/Linux IDE Link Integration setup information, prior to using the IDE Link integration.

Rational Rose - Operating System Runtime and Patch Requirements

For information regarding Rational Rose runtime and operating system patch requirements, see Appendix A, Rational Rose - Operating System Runtime and/or Patch Requirements.

Patches are recommended for new customers and customers experiencing problems. Contact Rational Technical Support if you encounter any compatibility difficulties after installing a patch.

Installation Requirements for Rational Rose RealTime

This section provides requirements that must be met to successfully use Rational Rose RealTime.

If you plan to install Rational Suite DevelopmentStudio RealTime on HP-UX 11.0 or 11.11 and want to use Rational Rose RealTime, you must do the following:

1 You must install Rational Suite DevelopmentStudio RealTime on an NFS-mounted drive that is accessible from an HP-UX 10.20 system.

2 Runs rs_setup from the HP-UX 10.20 system to set up the environment required to run Rational Rose RealTime and other Suite products.

    rs_setup is located in rational_dir (where rational_dir) is the directory in which you installed the Suite.

Rational Rose RealTime - Operating System Patch Requirements

For information regarding Rational Rose RealTime operating system patch requirements, go to the following web site:

http://www.rational.com/support/downloadcenter/patches

Patches are recommended for new customers and customers experiencing problems. Contact Rational Technical Support if you encounter any compatibility difficulties after installing a patch.

Installation Requirements Rational Rose RealTime Companion Products

Installation Requirements for Rational SoDA

Note: FrameMaker + SGML is no longer shipped with SoDA. It must now be licensed and installed independently. Rational SoDA 2002.05.00 supports FrameMaker+SGML 5.5 and 6.0.

You may want to install FrameMaker + SGML 5.5 or 6.0 before you install Rational Suite. Make a note of the FrameMaker + SGML installation directory as you need to provide this during the installation.

Alternatively, you can go ahead and install Rational Suite and install FrameMaker + SGML later. See Integrating Products That Are Not Part of the Suite for information about how to integrate FrameMaker + SGML with SoDA after you have installed the Suite.

If you have previously installed version 3.0.1, 3.0.3, or 3.1.0 of Rational SoDA, you may choose to use the installation of FrameMaker+SGML bundled with that release. To do this, copy the entire SoDA directory to a new location and uninstall the previous version of Rational Suite: this way, you do not accidentally remove the previous version of Rational SoDA when you uninstall the Suite. When you install Rational Suite, be sure to install the new version of SoDA, and when prompted for the FrameMaker + SGML location, enter the path to the previous version.

Note: To optimize disk space by removing the SoDA components and keeping only the FrameMaker+SGML components, refer to Technical Application Note 17972 at the following location: www.rational.com/support/.

Installation Requirements for Rational ClearCase LT

Rational ClearCase LT is included with on the Rational ClearCase LT (UNIX) CD. Your Rational Suite DevelopmentStudio for UNIX (UNIX Components) or Rational Suite DevelopmentStudio RealTime for UNIX (UNIX Components) license key can be used to run ClearCase LT.

You must install Rational Suite before you install Rational ClearCase LT. When you install Rational ClearCase LT you are prompted to provide the host name of the Rational Suite license server. By doing the installation in this sequence, ClearCase LT will be able to use the Rational Suite license key.

For more information about the requirements for installing Rational ClearCase LT, see the Rational ClearCase LT Installation Guide.

Rational Suite (Windows Components) Installation Requirements

Installation Requirements for Rational TestManager

Rational TestManager is included with this release and is provided on the Rational Solutions for Windows CD. Your Rational Suite DevelopmentStudio (Windows Components) or Rational Suite DevelopmentStudio RealTime (Windows Components) license key can be used to run Rational TestManager.

Note: You must install Rational Suite before you install Rational TestManager.

This product is run in a Windows environment. Before you can use Rational TestManager with a UNIX environment, you must install the UNIX Agent from the Rational Test Agent CD. For more information about requirements for installing Rational TestManager and Rational Test Agent, see the Rational Testing Products Installation Guide.

Installation Requirements for RequisitePro

RequisitePro is installed on the Windows platform and is accessed on UNIX through a web interface. Installation requirements for RequisitePro are listed in this section.

Complete installation instructions can be found on the Rational Solutions for Windows Online Documentation CD. You can also view the instructions online by typing rsdsu_help.

Note: It is recommended that for best web server performance a dedicated Windows Server system be configured.

Hardware Requirements

To run RequisitePro you need:

Licensing Requirements

Your Rational Suite DevelopmentStudio (Windows Components) or Rational Suite DevelopmentStudio RealTime (Windows Components) license key can be used to run Rational RequisitePro. This license can be served from a license server on UNIX or Windows.

Note: If you are configuring your Windows system to get licenses from a UNIX system, you will need to have DNS configured on your Windows system.

To check, try to ping the UNIX license server by name and by IP address. If networking is okay, you should be able to ping the system by IP address. If DNS is configured, you will be able to ping by name.

Installation Requirements for RequisiteWeb

RequisiteWeb provides a Web interface for accessing RequisitePro project data through a Web browser.

Installation and configuration instructions can be found in rational_dir/docs/html/reqweb_install/RequisiteWebInstall.html. This document is available through the documentation browser accessed through the rsdsu_help command.

Oracle and SQL Server Databases

To create and access RequisitePro projects in Oracle or Microsoft SQL Server databases, you must configure an Oracle or SQL Server schema on your database server, and install RequisitePro and RequisiteEnterprise on your client system.

Note: RequisiteEnterprise is available separately for Rational Suite users who require access to these database servers.

RequisiteWeb Interface

The RequisiteWeb interface requires the installation of Web components on a Microsoft Windows server and a Web browser on the client system.

Web Server

RequisiteWeb requires that it be installed on an Internet Information Server (IIS). If you prefer to use the Personal Web Server (PWS), you can do so by performing a "Custom Installation" and checking the box for Internet Service Manager.

IIS is the web server for Microsoft NT Server; PWS is the web server for Microsoft NT Workstation. Since NT Workstation and Personal Web Server have a limited number of connections, they are often not suitable for production use. However, you may find it convenient to use Personal Web Server for evaluation or demonstration purposes.

The following table summarizes the requirements for the RequisiteWeb server.

RequisiteWeb Component
Disk Space

Operating System

One of the following:

HTTP Server

One of the following:

Processor

400 MHz or greater

Memory

128 MB. For projects with more than 10,000 requirements or Web sites with more than 10 concurrent users, 256 MB or more is recommended.

Other products


Web Interface Client

To use the RequisiteWeb interface requires that a web browser be available. rs_install will install a version of Netscape that is compatible with RequisiteWeb. No additional client installation is required for use of the RequisiteWeb interface. If you choose not to use the supplied version of Netscape, the following web browsers should be compatible:

Installation Requirements for Rational ClearQuest Web

Rational ClearQuest is provided on UNIX; however, you may use your Rational Suite (Windows Components) license key to install Rational ClearQuest on Windows. Installing ClearQuest allows UNIX users to access ClearQuest through their web browser.

For installation requirements for ClearQuest Web, refer to the Rational ClearQuest Installation manual. If you are performing a full installation of ClearQuest, refer to the ClearQuest documentation provided on the Rational Solutions for Windows Online Documentation CD in addition to the Rational ClearQuest Installation manual.

Planning Your Installation

Rational Suite is designed to work in a distributed environment. Both Solaris and HP-UX versions are available, and both may be installed on the same network.

For the purposes of installation, your computers assume roles as depicted in Figure 1. Note that these roles are generalized; in practice, any particular computer can serve more than one role. In fact, this is typically the case. In many installations, the roles of the storage host, license server, install client, and exec client are provided by a single UNIX server. A separate Windows server is still required to act as the RequisitePro server.

Storage Host

This is the computer that hosts the physical disks on which the product will be installed. All computers with UNIX roles must have access to the installation directory on this disk, presumably through NFS. (Operating System: Solaris or HP-UX).

X-server

This is any computer, typically an engineering workstation, which provides an X-Windows display to the end user. This role is shown for completeness; its operation is transparent to the installation.

RequisitePro Server

This Windows computer hosts the Rational RequisitePro component. This server is only needed if you are going to use RequisitePro. See the RequisitePro document for more information. Access to RequisitePro from a UNIX client is provided through Rational RequisiteWeb.

Note: You cannot have two different versions of Rational Suite installed on the same Windows server.
Figure 1 Installation Computer Roles

License Servers

These computers provide licensing for Rational Suite. License server configurations are described in more detail in License Server Configurations.

Note: In most cases, it is possible to use the same license server to manage Suite licenses and individual point-product licenses; however, some exceptions apply. For example, ClearDDTS and Rational Suite licenses cannot be served by the same license server. This configuration requires that two separate license servers be set up on two different UNIX systems.

Install Client

This is simply the computer on which you run the installation utility. Typically, this is the same computer as the storage host. (Operating System: Solaris or HP-UX)

Execution Client

This is any computer which will execute the component products. There may be any number of execution clients on your network. (Operating System: Solaris or HP-UX)

Note that you only need to install the UNIX Components once, on the install client and storage host. Individual workstations (execution clients) may simply run the installed software from the single installation area.

License Server Configurations

Rational Suite supports three license server configurations:

Single Server Configuration

As shown in Figure 2, the single server configuration uses a single UNIX server to manage licenses for both UNIX Components and Windows Components. This is the recommended configuration because it is the simplest to manage.

Figure 2 Single Server Configuration

Two Server Configuration

As shown in Figure 3, a two-server configuration uses a UNIX server to manage licenses for UNIX Components and a Windows server to manage licenses for the Windows Components. Information on installing the Windows license server is provided in Installing the Rational License Server Software on Windows.

Figure 3 Two Server Configuration

Redundant Server Configuration

As shown in Figure 4, a redundant server configuration uses three UNIX servers to manage licenses in a fault-tolerant configuration known as redundancy. The redundant server configuration is described in more detail in Setting up Redundant License Servers on UNIX.

Figure 4 Redundant Server Configuration

Installation Worksheet

The following worksheet is provided for convenience in planning the installation. Note that some parts may not be known until you begin the installation.

Table 8 Installation Worksheet  
Storage Host







Host name

_____________________________



Installation directory (rational_dir location)

_____________________________



Installation user name (not root)

_____________________________

Install Client







Host name

_____________________________



Install user name (not root)

_____________________________

License Server







Host name for UNIX licenses

_____________________________



License port (default=27000)

_____________________________



License file

_____________________________



Host name for Windows licenses

_____________________________



License port

_____________________________

RequisitePro Server







Host name

_____________________________



URL for RequisiteWeb

_____________________________

Sample Exec Client







Host name

_____________________________

Rational Software Corporation  http://www.rational.com
support@rational.com
techpubs@rational.com
Copyright © 1993-2001, Rational Software Corporation. All rights reserved.
TOC PREV NEXT INDEX