These release notes provide information critical to installing and using Rational Unified Process (RUP), including supporting platforms and known issues with this release.

Copyright © 1987 – 2001, Rational Software Corporation. All rights reserved.

Contents

Scope—Product Definition

Hardware/Software Information

Getting Started

Installation Information

Compatible Issues

Browser Compatibility
Other Tools

New and Changed Features

Enhanced and New Features

Guidelines and Restrictions on Using RUP

UNIX Platforms 
Netscape Browsers
Microsoft Browsers
General Errors

Contacting Technical Support

Scope—Product Definition

This document provides information about the 2002.05.00 release of RUP. For details of updates of the product from previous versions, please refer to the About page in the product.

You can find information about add-on products and upgrades at the RUP Resource Center. Users of the RUP users should visit the Resource Center page from time to time to check on updates and product information.

• Training courses for the RUP
• Add-on products
• Product upgrades
• FAQ
• Support
• Examples

Hardware/Software Information

Refer to the following information for system and software requirements. This section provides basic information on the platforms supported and the hardware and software requirements for running RUP. Refer to Compatibility Issues for more information.

This product has been tested on the following platforms:

• Windows98 (Microsoft Internet Explorer, Netscape Navigator)
• Windows2000 (Microsoft Internet Explorer, Netscape Navigator)
• Windows NT (Microsoft Internet Explorer, Netscape Navigator)
• Unix platforms (Netscape Navigator)

RUP requires Microsoft Internet Explorer 4.0 with SP 1 or later, or Netscape Navigator 4.0 or later. Please make sure that these are installed. Earlier versions may not be able to display all pages in the RUP. To obtain the latest version of your browser, click on the appropriate link below:

Getting Started

Installation Information

Follow the instructions provided by the installation CD. This release installs the Classic version of the Rational Unified Process and the RUP Builder which enables users to generate other RUP configurations available in this release. See installation guide for details.

Compatible Issues

Browser Compatibility

We strongly recommend using the RUP with the most currently available version of your web browser. RUP requires Microsoft Internet Explorer 4.0 with SP1 or later. Some older versions of browsers do not allow the full capabilities of the RUP to be exercised.

Other Tools

The following tools and respectively versions are used in constructing the RUP:

New and Changed Features

Enhancements and New Features

The following enhancements and new features appear in this release:

• All RUP process variants are no longer installable from the Rational Suite installer. They can now be installed using RUP Builder, shipped with this release of RUP.
• RUP Builder has been added:
  • Real-time specific content is componentized into its own plug-in, separately installable.
  • Microsoft variant is componentized into its own plug-in, separately installable.
  • The IBM variant is componentized into its own plug-in, separately installable.
• Restructuring of Test Discipline:
• Changes
  • Complete restructure of the Test Discipline Workflow and associated Workflow Details
  • Removed Existing Workflow Details and replaced with Iteration Goal focused work elements.
  • Rename and refactoring of existing Activities
  • Restructure of existing Test roles
  • Tester role now responsible for Test Implementation and Execution
  • Overloaded Test Designer role activities and artifacts distributed to other roles
• Additions
  • Introduced the following Roles
  • Test Manager
  • Test Analyst
• Introduced the following Workflow Details
  • Define Evaluation Mission
  • Verify Test Approach
  • Test and Evaluate
  • Achieve Acceptable Mission
  • Improve Test Assets (complete for OM Final)
• Introduced the following Activities
  • Agree Mission
  • Identify test Motivators
  • Obtain Testability Commitment
  • Assess Quality Gaps
  • Assess Test Effort
  • Identify Targets of Test
  • Identify Test Ideas
  • Define Test Details
  • Define Traceability and Assessment Needs
  • Determine Test Results
  • Define Test Approach
  • Define Test Environment Configurations
  • Identify Testability Mechanisms
  • Define Testability Elements
  • Implement Test Suite
  • Analyze Execution Failure
• Introduced the following Artifacts
  • Test Automation Architecture
  • Test Interface Specification
  • Test Environment Configuration
  • Test Suite
  • Test Ideas List
  • Test Log (complete for OM Final)
  • Test Data (complete for OM Final)
• Introduced improved Developer Testing Guidance
  • Test-first design
  • various concepts and guidelines focused on Testing for Developers
• Deletions
• Removed the following Artifacts
  • Test Model
  • Test Procedure
  • Test Package
  • Test Subsystem
• Removed the following Activities
  • Plan Test
  • Design Test
• Added new Roadmap: Agile Practices in RUP.
• Enhanced Key Concepts.
• Improved navigation buttons for the Disciplines
• Added new white paper "Content Management Defined".
• Added new sample configuration for Small Project.
• Added new tool mentors:
  • Tool Mentor: Profiling Memory Usage in Managed Code using Rational Purify and Rational Purify® Plus (Windows)
  • Tool Mentor: Comparing Baselines using Rational ClearCase®
  • Tool Mentor: Finding Actors and Use Cases Using Rational Rose RealTime®
  • Tool Mentor: Detailing a Use Case Using Rational Rose RealTime®
  • Tool Mentor: Structuring the Use-Case Model Using Rational Rose RealTime®
  • Tool Mentor: Creating Use-Case Realizations Using Rational Rose RealTime®
  • Tool Mentor: Managing Classes Using Ratinal Rose RealTime®
  • Tool Mentor: Managing Collaboration Diagrams Using Rational Rose RealTime®
  • Tool Mentor: Managing the Design Model Using Rational Rose RealTime®
  • Tool Mentor: Managing Sequence Diagrams Using Rational Rose RealTime®

Guidelines and Restrictions on Using RUP

1. UNIX platforms

When launching the RUP Netscape Navigator on UNIX, a warning dialog may appear:

Netscape: subprocess diagnostics (stdout/stederr)

Warning: Name: HorScrollBar Class: XmScrollBar The scrollbar page increment is less than 1

This occurs whenever the horizontal scrollbar must be displayed (i.e. it may not occur if your initial window is large enough that the left panel doesn't need a scrollbar)

You may disable dialogs for warning and error messages, and redirect messages to a file using the following command:

netscape -xrm '*useStderrDialog: False' –xrm '*useStdoutDialog: False' >&/tmp/log.$USER.ns

1. Long start-up times on Unix

It can take more than one minute to start the RUP online on Unix. Also the search engine can take up to one minute to start. This is due to the slow start-up of the Java virtual machine.

2. Netscape Browsers

‘Banners’ on page titles are not correctly displayed using some versions of Netscape Navigator and Communicator. The problem is purely cosmetic and does not affect use of the product. 



1. The Treebrowser Area Does Not Resize using Netscape Navigator

   If you resize the window, or the left frame, using Netscape Navigator, the treebrowser area is not resized.
   To resize the treebrowser area:

   • hold down the Shift key
   • position the cursor in the left frame, and finally
   • click the right-button on the mouse, and select "Reload Frame" in the menu.
     

2. Delay using "WhereAmI" navigation button

   You will experience a delay when the "WhereAmI" navigation button is pressed for the first time while browsing the RUP. 

3. Netscape Navigator 4.08 Display problems

   Netscape Navigator 4.08 has problems displaying certain components. E.g. the title banners. It is recommended to use Netscape browser of version 4.7 or later.

 

3. Microsoft Browsers

   1. Nothing Happens When Clicking on "Resource Center"

      If you click on the "Resource Center" in the treebrowser, using Internet Explorer 4.0, nothing happens.

      This is due to a problem in Internet Explorer. To solve this, you need to upgrade the Internet Explorer with the Service Pack 1 (SP1), from the Microsoft home page.

      To upgrade Internet Explorer 4.01, either press Help > Product Updates, in the Internet Explorer, or go to the Microsoft home page: http://www.microsoft.com.

   2. Hyperlinks to bookmarks using Internet Explorer

      Using Internet Explorer hyperlinks to bookmarks on a page does not always work as expected. The top of the target page is displayed instead of the position on the page, where the bookmark is. Using the index (which is opened in a separate window) you can click on the link one more time, when the page is displayed. This will display the correct position on the page. On other pages there is no other way to find the correct position than to do a search (Edit>Find) on the target page.

   3. Treebrowser Java applet

      The treebrowser java applet does not start with Internet Explorer 5.X. It only works if Microsoft Virtual Machine is installed.

   4. Browser Window too Small

      When using Windows 2000 or Windows 98, if the Internet Explorer browser window is too small to display the treebrowser, the RUP will not be displayed properly. You will need to increase the browser window size and refresh.

   5. Printing Error

      When the cursor is in the treebrowser frame, if one tries to print the content in the main frame by selecting File > Print. The product splash screen will be displayed in the main frame under you click on another node in the treebrowser. The output of the print job will be blank.

   6. Inability to "Refresh" or "Back"

      Users running IE 5.0 with Microsoft Virtual Machine 1.1 on Windows NT 4.0 will not be able to do a "Refresh" or "Back". Attempts to do so will cause the treebrowser and the splashscreen to hang and will get the following message in the Java Console: 

      java.lang.NullPointerException
      at ruptools/tree/MyTreeView.Ý
      at ruptools/tree/MyTreeView.Ð
      at ruptools/TreeBrowse.run
      at java/lang/Thread.run"

4. General Errors

1. The Java Applets Do Not Run with version 3.x of Netscape and Microsoft browsers

   Using Internet Explorer 3.x and Netscape 3.x, you cannot run the Java applets, such as the treebrowser in the left frame. When you start the RUP, using IE 3.x, a new window will be displayed that

   a) Directs you to the Microsoft or Netscape home pages to download the latest version of the browser.

   b) Gives you the option to use the SiteMap to browse the Unified Process using version 3.x of the browser.

2. The Java Applets do not run with browsers which do not support Java applets (IE 2.x and Netscape 2.x)

   The RUP uses Java applets to provide search, index and navigation capabilities; use of browsers which do not support Java applets is not supported. See browser compatibility note above.

   Browsing the Unified Process using non-Java compliant browsers can be accomplished with a loss of functionality using the web page ./sitemap/sitemap.htm under the Unified process install directory.

3. Disk Space Usage

   29 MB (Windows NT). Run the DOS command chkdsk for information on your file system.

   Unix 30MB

4. Crude Formatting using Netscape Navigator 3.x and Microsoft Internet Explorer 3.x

   Navigator 3.x and IE 3.x do not support cascading style sheets (CSS), which are used by the RUP. This means that the formatting and layout is crude on Navigator 3.x and IE 3.x. We strongly recommend upgrading to a newer release of your browser.

5. Small fonts

   If you find the text font to be too small you can change the web-browsers default font. This will make the text on all pages to be displayed with a larger font.