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 Quick Reference

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

Table 2 Before You Install Quick Reference  
Step

Action

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


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 Installing Rational ClearQuest manual.
For Requisite Pro, see the Installing Rational Requisite Pro manual. You can find this manual on the Rational Solutions for Windows Online Documentation CD.

4 Do you plan to install Rational ClearCase?


If yes, install Rational ClearCase before you install Rational Suite DevelopmentStudio. Refer to the ClearCase product documentation 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 also Installation Requirements for Rational ClearCase LT.

5 Do you plan to use Rational SoDA?


If yes, see Installation Requirements for Rational SoDA.

6 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 DevelopmentStudio. 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 DevelopmentStudio and install Apex later. See Integrating Products That Are Not Part of the Suite for information about how to integrate Apex with Rose, Rose RT, 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 DevelopmentStudio.


See Installing Rational Suite DevelopmentStudio.


UNIX Installation Requirements

UNIX Hardware Requirements

Table 3 summarizes the hardware requirements for the installation and use of DevelopmentStudio for UNIX. 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 Rose models requires more memory.

Table 3 UNIX Hardware Requirements  
Product

Swap Space

Memory

Disk Space




Solaris

HP-UX

Rational Unified Process

NA

16 MB minimum

52 MB

52 MB

Rose

150 MB +
50 MB/user


64 MB + 32 MB/simultaneous user

335 MB + 1 to 3 MB for each model

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


SoDA with Frame

64 MB

32 MB minimum

221 MB

271 MB

Purify

*

2-5 times application size

16 MB

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


Quantify

*

2-5 times application size

15 MB

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


PureCoverage

*

2-5 times application size

9 MB

12 MB

ClearQuest

NA

48 MB

65 MB

143 MB

RequisitePro Web Interface

NA

NA

NA

NA

Totals

214 MB +
50 MB /user


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

720 MB

860-885 MB

Recommended Suite
Requirements


500 MB +
50 MB/user


256 MB + 32 MB/user

0.9 GB

1 GB

* Highly dependent on the application that`s instrumented

UNIX Software Requirements

Rational Suite DevelopmentStudio is supported on the following operating systems:

* Rational Unified Process is not supported on HP-UX 10.20. Supported HP-UX platforms for this product include HP-UX 11.00 and 11.11.

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

Table 4 Individual Product OS Version Compatibility  
Product

Solaris

HP-UX

Rose

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

10.20, 11.0, and 11.11

SoDA with Frame

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

10.20, 11.0, and 11.11

Purify

2.5.1, 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.5.1, 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.5.1, 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.5.1, 2.6, 2.7 (Solaris 7), and 2.8 (Solaris 8)

10.20, 11.0, and 11.11

Rational Unified Process +

2.5.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.


+ Requires an HTML browser. Netscape Navigator 4.6 or later is recommended.

Installation Requirements for Rational Rose

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

Table 5 Rose Software Requirements 
Software Item

Requirement

For

Operating system

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

  1. HP-UX 10.20 (ACE release1), 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

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



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.

Rational Rose - Operating System Run Time and/or Patch Requirements

The requirements below are in relation to the following platforms (operating system versions):

Note: If you are currently using Rose and your installed operating system patches are currently meeting your needs, we strongly recommend that you not change your installed patches. The following patches are recommended for new customers and customers experiencing problems. If you upgrade your patches, we recommend that you use the following patch versions. While we encourage you to contact the appropriate vendor to determine if a patch has been superseded, we cannot guarantee release compatibility with a patch version we have not yet tested. For information regarding the latest patch versions tested or required with this release, visit the Rational web site at http://www.rational.com/support.

Contact Rational Technical Support if you encounter any compatibility difficulties after installing a patch which supersedes the following patches.

HP-UX 10.20 and 11.00 Patch Requirements and Descriptions

Table 6 summarizes the patch requirements for HP-UX 10.20 and 11.00.

Table 6 HP-UX 10.20 and 11.00 Patch Requirements
Run-Time Patches

Description

Reason for Patch

Operating System Versions and Notes

PHCO_19434

S700_800 10.20 csh(1) cumulative patch

Fixes crash of csh exit of MainWin

HP-UX 10.20 (ACE)

PHSS_21461

S700_800 10.20 Xserver cumulative patch

Fixes Xserver crash with multiple rectangle

HP-UX 10.20 (ACE)

PHSS_17872

HP aC++ run-time libraries (aCC A.01.21)

Run time for compiler A.01.21

HP-UX 10.20 (ACE)

PHSS_19739

S700_800 10.20 HP DCE 9000 1.5 cumulative patch

Problem with threads

HP-UX 10.20 (ACE)

PHSS_17225

S700-800 10X dld.sl(5) cumulative patch

Run-time requirement

HP-UX 10.20 (ACE)

PHSS_173271

X/Motif 2.1 Dev Kit Mar99 Periodic Patch

Run-time requirement

HP-UX 11.00

PHSS_19866

ld(1) and linker tools cumulative patch

Resolve dld.sl error when using CORBA & Java Operation Specification Window:
/usr/lib/dld.sl: Unresolved symbol: (libot.sl (unknown))

HP-UX 11.00

PHSS_16587

s700_800 11.X
HP aC++ (aCC A.03.13) run-time libraries

Run-time requirement

HP-UX 11.00

1 See the following Note

Note: Rose requires HP-UX OS Patch PHSS_17327 (X/Motif 2.1 Dev Kit Mar99 Periodic Patch). This Patch requires PHSS_17326 (X/Motif 2.1 Run time Mar99 Periodic Patch). PHSS_17326 has been superseded by HP-UX OS Patch PHSS_23823

The HP-UX patches are available at:

Solaris Patch Requirements and Descriptions

Note: Some patches are required on the server (the computer which users login to, to run Rose) and the client (the computer which is used to display Rose), and some are required only on the client. In some cases, the server and client are the same computer, but often several users login to one server (to run the application) and have their own displays which serve as their client. The following Sun Solaris patch recommendations are specific to Sun Solaris servers and clients. Table 7 summarizes the server and client patches. Table 8 summarizes the client patches.

Table 7 Solaris Server and Client Patches 
Server and Client Run-Time Patches

Description

Reason for Patch

Operating System Version

103566-46

Xsun patch

To fix defects in XinitThreads and _XflushInt, i.e., defect fixes for multi-threaded applications under X.

Solaris 2.5.1

103627-11

Linker patch

Fixes problems in dlclose( )

Solaris 2.5.1

103640-29

Kernel nisopaccess & libthread patch

Kernel fix for dlclose( )

Solaris 2.5.1

106529-04

Shared library patch for C++

Shared library fix

Solaris 2.5.1

105181-16

Kernel update patch

Fixes kernel thread problems

Solaris 2.6

105591-06

Shared library patch for C++

Shared library fix

Solaris 2.6

105633-32

Xsun patch

See "Reason for Patch" under patch 103566-46

Solaris 2.6

106040-12

X input and output method patch

Fixes input/output problem

Solaris 2.6

106327-05

Shared library patch for C++

Shared library fix

Solaris 7

108376-03

Xsun patch

See "Reason for Patch" under patch 103566-46

Solaris 7

108434-01

Shared library patch for C++

Shared library fix

Solaris 8

Table 8 Solaris Client Patches 
Client (Display) Patches

Description

Reason for Patch

Operating System Version & Graphic Card
(see information describing how to detect graphics cards in the following
Notes section)

105789-07

VIS/XIL Graphics Patch

Provides the imaging and video foundation for Solaris

Supplemental for Creator or Elite graphics card on Solaris 2.5.1

105361-10

VIS/XIL Graphics Patch

Provides the imaging and video foundation for Solaris

Supplemental for Creator or Elite graphics card on Solaris 2.6

106147-03

VIS/XIL Graphics Patch

Provides the imaging and video foundation for Solaris

For Creator or Elite graphics card on Solaris 7

103792-25

M64 Graphics Patch

Required for PGX (M64 Graphics card) PCI-based Utra 5, 10, and 60:

For PGX (M64 Graphics card) on Solaris 2.5.1

105362-20

M64 Graphics Patch

See "Reason for Patch" under patch 103792-25

For PGX (M64 Graphics card) on Solaris 2.6

106146-10

M64 Graphics Patch

See "Reason for Patch" under patch 103792-25

For PGX (M64 Graphics card) on Solaris 7

105790-19

FFB Graphics Patch

Supplemental patch for VIS/XIL graphics patch:

For Creator Graphics Card on Solaris 2.5.1

105360-28

FFB Graphics Patch

See "Reason for Patch" under patch 105790-19

For Creator Graphics Card on Solaris 2.6

106145-12

FFB Graphics Patch

See "Reason for Patch" under patch 105790-19

For Creator Graphics Card on Solaris 7

105791-25

AFB Graphics Patch

Supplemental patch for VIS/XIL graphics patch for Elite 3D frame buffer:

For Elite3D Graphics Card on Solaris 2.5.1

105363-24

AFB Graphics Patch

See "Reason for Patch" under patch 105791-25

For Elite3D Graphics Card Solaris 2.6

106144-12

AFB Graphics Patch

See "Reason for Patch" under patch 105791-25

For Elite3D Graphics Card Solaris 7

103793-01

TCX Graphics Patch

To fix GUI hanging, and to fix paint problems (black/white regions appear in menus, dialog boxes, toolbars, and so on)

For TCX Graphics Card on Solaris 2.5.1

106391-01

TCX Graphics Patch

To fix GUI hanging, and to fix paint problems (black/white regions appear in menus, dialog boxes, toolbars, and so on)

For TCX Graphics Card on Solaris 2.6

107851-01

PGX32 2.1 Graphics Patch

Recommended for GFX graphics card

For GFX Graphics Card on Solaris 2.5.1, 2.6, and 7 if "VERSION" line from pkginfo -l TSIgfxOW indicates 2.1, otherwise refer to following patches

107714-01

PGX32 Graphics Patch

Recommended for GFX graphics card

For GFX Graphics card on Solaris 2.5.1 if 107851-01 does not apply

107715-04

PGX32 Graphics Patch

Recommended for GFX graphics card

For GFX Graphics card on Solaris 2.6 if 107851-01 does not apply

107716-04

PGX32 Graphics Patch

Recommended for GFX graphics card

For GFX Graphics card on Solaris 7 if 107851-03 does not apply

105492-02

cgsix driver patch

For issue related to GX frame buffer

For cgsix Graphics Card on Solaris 2.6

The Solaris patches are available at:

The Sun Solaris patches may not be available publicly.

The following may be necessary to obtain some of the Solaris patches listed above:

Notes

How to detect a graphics card on a Sun Solaris computer:

Installation Requirements for Rational SoDA

Note: FrameMaker + SGML is no longer shipped with SoDA. It must now be licensed and installed independently. Rational SoDA 2001A.04.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 DevelopmentStudio. 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 DevelopmentStudio 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 DevelopmentStudio. This way, you do not accidentally remove the previous version of Rational SoDA when you uninstall the Suite.

Installation Requirements for Rational ClearCase LT

Rational ClearCase LT is included with this release of Rational Suite DevelopmentStudio on a separate CD as an optional product for you to install. Your Suite license key can be used to install ClearCase LT

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

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


Windows Installation Requirements

Installation Requirements for RequisitePro

RequisitePro is available 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

To install and use RequisiteWeb you will need the following license:

This license can be served from either a UNIX license server or a Windows license server.

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.

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

NT Server 4.0, Service Pack 6A or later
NT 4.0 Option Pack which includes:
Microsoft Internet Information Server (IIS) 4.0 and Microsoft Transaction Server (MTS) 2.0
or
Microsoft Windows 2000 Advanced Server, which includes:

Internet Information Services (IIS) 5.0

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

Microsoft Word 2000

Oracle, version 7.3 or later, client software (for accessing projects in an Oracle database)

Microsoft Internet Explorer 5, 6
or Internet Explorer 4 with the XML parser available at http://msdn.microsoft.com/downloads/tools/xmlparser/xmldl.asp


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 DevelopmentStudio (Windows components) license key to install Rational ClearQuest Web on Windows. Installing ClearQuest Web allows UNIX users to access ClearQuest on Windows through their web browser.

This manual assumes that an existing Rational ClearQuest for Windows installation is being used and that only the web component is being installed. For installation requirements for ClearQuest Web, refer to the Installing 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 Installing Rational ClearQuest Installation manual.


Planning Your Installation

Rational Suite DevelopmentStudio 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 RequisitePro component. This server is only needed if you are going to use RequisitePro. See the RequisitePro document for more information. Access to RequisitePro is provided through a web interface.

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 DevelopmentStudio. 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 DevelopmentStudio 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 server. Individual workstations (execution clients) may simply run the installed software from the single installation area.

License Server Configurations

Rational Suite DevelopmentStudio 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 (Rational Requisite Pro and Rational ClearQuest Web). Information on installing the Windows license server is provided in Installing the FLEXlm License Server 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 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 9 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