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

Copyright © 1987 - 2000, Rational Software Corporation. All rights reserved.

Contents

Scope - Product Definition

Hardware/Software Information

Getting Started

Installation Information
Installation Issues

Compatible Issues

Browser Compatibility
Other Tools

New and Changed Features

Enhanced and New Features
File Differences

Guidelines and Restrictions on Using Rational Unified Process

UNIX Platforms 
Netscape Browsers
Microsoft Browsers
General Errors

Contacting Technical Support

Scope - Product Definition  

This document provides information about the 2001.03.00 release of Rational Unified Process. The release number is listed in the About page in the product.

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

Also included is information about:

• Training courses for the Rational Unified Process
• 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 Rational Unified Process. Refer to Compatibility Issues for more information.

This product has been tested on the following platforms:

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

Rational Unified Process 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 Rational Unified Process. To obtain the latest version of your browser, click on the appropriate link below:

Netscape Navigator: http://home.netscape.com/comprod/mirror/client_download.html

Getting Started  

Installation Information  

Follow the instructions provided by the installation CD. This release of the Rational Unified Process offers three variants: standard; Rational Unified Process with IBM content for e-business; and Rational Unified Process with content for the Microsoft Web Solution Platform. To install the standard version of the Rational Unified Process, users should use the "typical" install. To install either variant choose custom install and select only one of the two variants. Please note that only one of the two variants should be selected at one time or the resulting installed Rational Unified Process will be corrupted. See installation guide for details.

Installation Issues  

Due to limitations of the Installer, some manual steps are required to uninstall the Rational Unified Process variants. Please see installation guide for details.

Compatible Issues  

Browser Compatibility  

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

Other Tools  

The following tools and respectively versions are used in constructing the Rational Unified Process:

New and Changed Features

Enhancements and New Features  

The following enhancements and new features appear in this release:

• New content and variant: Microsoft Web Solution (not available in Beta)
• Terminology change: "Worker" to "Role"
• Terminology change: "Architect" to "Software Architect"
• Terminology change: "Use-Case Specifier" to "Requirements Specifier"
• New tool mentors: for existing and new Rational tools
• New guidelines: CMM/ISO implementation (not available in Beta)
• New guidelines: XP Techniques (not available in Beta)
• New roadmap: Small Projects
• Corrections to reported defects

File Differences from Previous Release  

There have been addition and deletion of HTML and image files to the previous release of the Rational Unified Process. A list of these files are provided in the table below. File differences for earlier release are available on the Unified Process Resource Center.

File Changes from Rational Unified Process 2000 to Rational Unified Process 2001.03.00

Guidelines and Restrictions on Using Rational Unified Process

1. UNIX platforms

When launching the Rational Unified Process 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 Rational Unified Process 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. Netscape 6

   Netscape 6 has not been fully tested for Rational's web products or online documentation. Rational has not identified any specific issues associated with Netscape 6. Neither has Rational confirmed that Netscape 6 performs properly with all of Rational's products or documentation.

 

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. You get that installed if you do a full installation of Internet Explorer 5.X. 

   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 Rational Unified Process 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"

      The solution to this problem is to update the IE to 5.01 and make sure that the Virtual Machine is upgraded to 1.1.4.

       

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 Rational Unified Process, 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 Rational Unified Process utilizes 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). Up to 124MB (Windows 95) Note: Disk space usage may vary widely, particularly on Windows 95, depending on your file system configuration.
   Example: 58 MB is required on Windows 95 with FAT file system with 32.768 bytes in each allocation unit. Rational Unified Process includes 3784 files and each file uses one allocation unit. 3785*32768= 124 MB.
   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 Rational Unified Process. 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. Multiple Instances of Rational Unified Process

   Multiple instances of the Rational Unified Process opened on the same machine would prevent the Java applets from working properly. For example, if two instances of the Rational Unified Process are opened, the search engine from the second instance will fail to bring up the pages on the main window.

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

7. Minimal Install

   The Minimal Install functionality of Rational products is not supported in this release. You must choose the Typical or Custom/Full options to install your Rational product(s). For information on how to install your Rational product, see your product's Installation manual.

   Note that the installation manuals may include information on minimal installations. That information is no longer valid.

    

Contacting Technical Support

In North America,
Telephone: 1-800-433-5444 or 408-863-5000
E-mail: support@rational.com

In Europe, Middle East and Africa,
Telephone: +31 (0)29 4546 200
E-mail: support@europe.rational.com

In Asia Pacific,
Telephone: +61 2 9419 0111
E-mail: support@apac.rational.com

Or visit our Web site http://www.rational.com for more information about us!