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 – 2002, Rational Software Corporation. All rights reserved.

This software contains proprietary and confidential information of Rational and its suppliers. Use, disclosure or reproduction is prohibited without the prior express written consent of Rational.

Copyright Information

Contents

Scope—Product Definition

Hardware/Software Information

Getting Started

Installation Information

Compatible Issues

Browser Compatibility
Java 2 v1.3 or 1.4 Issues
Other Tools

New and Changed Features

Defects Fixed in this Service Release

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.01.305.000 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 SE (Microsoft Internet Explorer, Netscape Navigator)
• Windows XP (Microsoft Internet Explorer, Netscape Navigator)
• Windows ME (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 5.01 or later, or Netscape Navigator 4.72 to 4.78. 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.

Java 2 v1.3 or 1.4 Issues

Whenever Sun JRE 1.3.x or 1.4.x is installed, Java 2 v1.3 or 1.4 must be disabled in the properties of the browser or the RUP treebrowser will lnot display. Users requiring usage of JRE 1.3.1_02, please go to RUP knowledge center on Rational Developer Network for more information.

Other Tools

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

New and Changed Features

Defects Fixed in this Service Release

The following defects were fixed in this release:

• RATLC 21395 - Extended Help Common versioning API
• RATLC 22181 - RUP Vincente Encontre's white papers
• RATLC 12533 - RUP Rose Logo
• RATLC 22141 - RUP New company logo on White Papers
• RATLC 22139 - RUP Removing support for Win 95 in documents
• RATLC 22094 - RUP Fix broken glossary links
• RATLC 22095 - RUP Fix RUP broken links to external referenced web-sites
• RATLC 22096 - RUP Test Content various corrections to typos, grammar, etc.
• RATLC 22097 - RUP Correct Test Discipline Index entry errors
• RATLC 22170 - RUP Builder Access violations in the RUP process model and plug-ins

The following files were changed:

RationalUnifiedProcess\relnotes.htm
RationalUnifiedProcess\rup_relnotes.htm
RationalUnifiedProcess\rup_relnotes_sr.htm
RationalUnifiedProcess\_borders\rupversion.gif
RationalUnifiedProcess\addin_realtime\process\activity\chklists\ck_cpsl.htm
RationalUnifiedProcess\addin_realtime\process\activity\chklists\ck_prot.htm
RationalUnifiedProcess\addin_realtime\process\artifact\ar_cpsl.htm
RationalUnifiedProcess\addin_realtime\process\artifact\ar_prot.htm
RationalUnifiedProcess\addin_realtime\process\modguide\md_cpsl.htm
RationalUnifiedProcess\addin_realtime\toolment\rosert\tm_rrtconcur.htm
RationalUnifiedProcess\applet\rpw_artifact_subtree.dat
RationalUnifiedProcess\applet\rpw_discipline_subtree.dat
RationalUnifiedProcess\applet\rpw_img.zip
RationalUnifiedProcess\applet\rpw_lifecycle_subtree.dat
RationalUnifiedProcess\applet\searchdb.ws
RationalUnifiedProcess\applet\tree.dat
RationalUnifiedProcess\devkit\ruptools\application\search\doc\overview.htm
RationalUnifiedProcess\examples\devcase_sp\artifacts.htm
RationalUnifiedProcess\examples\extrnlcntrbtns\test\tstatmptrn.htm
RationalUnifiedProcess\examples\extrnlcntrbtns\test\tstatmtch.htm
RationalUnifiedProcess\examples\extrnlcntrbtns\test\tstidactl.htm
RationalUnifiedProcess\examples\test\tstatmgdl01.htm
RationalUnifiedProcess\index\contents.htm
RationalUnifiedProcess\index\navig.htm
RationalUnifiedProcess\manuals\intro\im_bp2.htm
RationalUnifiedProcess\manuals\intro\im_diff.htm
RationalUnifiedProcess\papers
RationalUnifiedProcess\papers\contentmgmt.htm
RationalUnifiedProcess\papers\papers.htm
RationalUnifiedProcess\papers\pdf
RationalUnifiedProcess\papers\pdf\apprmuc.pdf
RationalUnifiedProcess\papers\pdf\rupcmm.pdf
RationalUnifiedProcess\papers\pdf\rupcompxp.pdf
RationalUnifiedProcess\papers\pdf\sis.pdf
RationalUnifiedProcess\papers\pdf\TP164.pdf
RationalUnifiedProcess\papers\pdf\tp173a.pdf
RationalUnifiedProcess\papers\pdf\TP177.pdf
RationalUnifiedProcess\papers\pdf\TP178.pdf
RationalUnifiedProcess\papers\pdf\TP183_smproj.pdf
RationalUnifiedProcess\papers\pdf\traceabilityStrategies.pdf
RationalUnifiedProcess\papers\pdf\variants.pdf
RationalUnifiedProcess\papers\pdf\webapps.pdf
RationalUnifiedProcess\papers\pdf\xppair.pdf
RationalUnifiedProcess\papers\pdf\xprefact.pdf
RationalUnifiedProcess\papers\rt_test.htm
RationalUnifiedProcess\papers\teness.htm
RationalUnifiedProcess\process\activity\ac_devts.htm
RationalUnifiedProcess\process\activity\ac_tst_agrmsn.htm
RationalUnifiedProcess\process\activity\ac_tst_dfnasstrcnds.htm
RationalUnifiedProcess\process\activity\ac_tst_dfntstapr.htm
RationalUnifiedProcess\process\activity\ac_tst_dfntstdtl.htm
RationalUnifiedProcess\process\activity\ac_tst_dfntstelm.htm
RationalUnifiedProcess\process\activity\ac_tst_dtrtstrsl.htm
RationalUnifiedProcess\process\activity\ac_tst_idntstmch.htm
RationalUnifiedProcess\process\activity\ac_tst_imptst.htm
RationalUnifiedProcess\process\activity\ac_tst_imptstste.htm
RationalUnifiedProcess\process\activity\ac_tst_strtstatmimp.htm
RationalUnifiedProcess\process\activity\ac_untst.htm
RationalUnifiedProcess\process\activity\chklists\ck_dclss.htm
RationalUnifiedProcess\process\activity\chklists\ck_dmdl.htm
RationalUnifiedProcess\process\activity\chklists\ck_dpckg.htm
RationalUnifiedProcess\process\activity\chklists\ck_dsubs.htm
RationalUnifiedProcess\process\activity\chklists\ck_sgnl.htm
RationalUnifiedProcess\process\activity\chklists\ck_ucrlz.htm
RationalUnifiedProcess\process\artifact\ar_class.htm
RationalUnifiedProcess\process\artifact\ar_desmd.htm
RationalUnifiedProcess\process\artifact\ar_despk.htm
RationalUnifiedProcess\process\artifact\ar_dsub.htm
RationalUnifiedProcess\process\artifact\ar_event.htm
RationalUnifiedProcess\process\artifact\ar_if.htm
RationalUnifiedProcess\process\artifact\ar_signa.htm
RationalUnifiedProcess\process\artifact\ar_tstgl.htm
RationalUnifiedProcess\process\artifact\ar_tstidslst.htm
RationalUnifiedProcess\process\artifact\ar_tstlog.htm
RationalUnifiedProcess\process\artifact\ar_ucrea.htm
RationalUnifiedProcess\process\artifact\ar_wlmod.htm
RationalUnifiedProcess\process\artifact\arp_desmd.htm
RationalUnifiedProcess\process\artifact\ars_dsg.htm
RationalUnifiedProcess\process\glossary.htm
RationalUnifiedProcess\process\modguide\md_aggrg.htm
RationalUnifiedProcess\process\modguide\md_andid.htm
RationalUnifiedProcess\process\modguide\md_assoc.htm
RationalUnifiedProcess\process\modguide\md_class.htm
RationalUnifiedProcess\process\modguide\md_clsdm.htm
RationalUnifiedProcess\process\modguide\md_cncry.htm
RationalUnifiedProcess\process\modguide\md_coldm.htm
RationalUnifiedProcess\process\modguide\md_desmd.htm
RationalUnifiedProcess\process\modguide\md_despk.htm
RationalUnifiedProcess\process\modguide\md_dsub.htm
RationalUnifiedProcess\process\modguide\md_gener.htm
RationalUnifiedProcess\process\modguide\md_idad.htm
RationalUnifiedProcess\process\modguide\md_idccm.htm
RationalUnifiedProcess\process\modguide\md_idenv.htm
RationalUnifiedProcess\process\modguide\md_idep.htm
RationalUnifiedProcess\process\modguide\md_idimp.htm
RationalUnifiedProcess\process\modguide\md_idpmgt.htm
RationalUnifiedProcess\process\modguide\md_idreq.htm
RationalUnifiedProcess\process\modguide\md_if.htm
RationalUnifiedProcess\process\modguide\md_layer.htm
RationalUnifiedProcess\process\modguide\md_sbscr.htm
RationalUnifiedProcess\process\modguide\md_seqdm.htm
RationalUnifiedProcess\process\modguide\md_stadm.htm
RationalUnifiedProcess\process\modguide\md_style.htm
RationalUnifiedProcess\process\modguide\md_tstevlcls.htm
RationalUnifiedProcess\process\modguide\md_tstidssttact.htm
RationalUnifiedProcess\process\modguide\md_uclaar.htm
RationalUnifiedProcess\process\modguide\md_ucrea.htm
RationalUnifiedProcess\process\modguide\md_uig.htm
RationalUnifiedProcess\process\modguide\md_untst.htm
RationalUnifiedProcess\process\modguide\md_vbcd.htm
RationalUnifiedProcess\process\modguide\md_wana.htm
RationalUnifiedProcess\process\modguide\md_wlmod.htm
RationalUnifiedProcess\process\modguide\ovu_armd.htm
RationalUnifiedProcess\process\referenc.htm
RationalUnifiedProcess\process\reports\re_clrep.htm
RationalUnifiedProcess\process\reports\re_desms.htm
RationalUnifiedProcess\process\reports\re_dspkg.htm
RationalUnifiedProcess\process\reports\re_tstsv.htm
RationalUnifiedProcess\process\reports\re_ucrrp.htm
RationalUnifiedProcess\process\workers\wk_tstanl.htm
RationalUnifiedProcess\process\workers\wk_tstds.htm
RationalUnifiedProcess\process\workers\wk_tstmng.htm
RationalUnifiedProcess\process\workers\wk_tstr.htm
RationalUnifiedProcess\process\workflow\ana_desi\co_dpatt.htm
RationalUnifiedProcess\process\workflow\ana_desi\co_warchpatt.htm
RationalUnifiedProcess\process\workflow\ana_desi\mdov_and.htm
RationalUnifiedProcess\process\workflow\ana_desi\wfs_and4.htm
RationalUnifiedProcess\process\workflow\requirem\co_req.htm
RationalUnifiedProcess\process\workflow\test\co_exptst.htm
RationalUnifiedProcess\process\workflow\test\co_keyme.htm
RationalUnifiedProcess\process\workflow\test\co_qtydm.htm
RationalUnifiedProcess\process\workflow\test\co_stage.htm
RationalUnifiedProcess\process\workflow\test\co_tstidslst.htm
RationalUnifiedProcess\process\workflow\test\int_test.htm
RationalUnifiedProcess\process\workflow\test\ov_tst_art.htm
RationalUnifiedProcess\process\workflow\test\ov_tst_md.htm
RationalUnifiedProcess\process\workflow\test\wfs_achmsnacp.htm
RationalUnifiedProcess\relnotes.htm
RationalUnifiedProcess\rup_relnotes.htm
RationalUnifiedProcess\sitemap\artifacts.htm
RationalUnifiedProcess\sitemap\lifecycle.htm
RationalUnifiedProcess\sitemap\overview.htm
RationalUnifiedProcess\sitemap\workflow.htm
RationalUnifiedProcess\toolment\admin\tm_raconf.htm
RationalUnifiedProcess\toolment\devkit\tm_rupto.htm
RationalUnifiedProcess\toolment\reqpro\tm_debuc.htm
RationalUnifiedProcess\toolment\robot\tm_extst.htm
RationalUnifiedProcess\toolment\robot\tm_imtst.htm
RationalUnifiedProcess\toolment\robot\tm_tsten.htm
RationalUnifiedProcess\toolment\robot\tm_tstscr.htm
RationalUnifiedProcess\toolment\rose\images
RationalUnifiedProcess\toolment\rose\rose.htm
RationalUnifiedProcess\toolment\rose\rose_bm.htm
RationalUnifiedProcess\toolment\rqa\tm_rqa_implautoct.htm
RationalUnifiedProcess\toolment\testfact\tm_tfcap.htm
RationalUnifiedProcess\toolment\testfact\tm_tfcvg.htm
RationalUnifiedProcess\toolment\testfact\tm_tfenv.htm
RationalUnifiedProcess\toolment\testfact\tm_tfgen.htm
RationalUnifiedProcess\toolment\testfact\tm_tfts.htm
RationalUnifiedProcess\toolment\testfact\tm_tfvsc.htm
RationalUnifiedProcess\toolment\testfact\tm_tfvtp.htm
RationalUnifiedProcess\toolment\testfact\tm_tfvts.htm
RationalUnifiedProcess\toolment\testmgr\tm_extstsuite.htm
RationalUnifiedProcess\toolment\testmgr\tm_perftstsuite.htm
RationalUnifiedProcess\toolment\testmgr\tm_tstcs.htm
RationalUnifiedProcess\toolment\testmgr\tm_tstmn.htm
RationalUnifiedProcess\toolment\testmgr\tm_tstpln.htm
RationalUnifiedProcess\toolment\testmgr\tm_tstsuite.htm
RationalUnifiedProcess\webtmpl\templates\a_and_d\rup_ucrs.htm
RUPBuilder\repository\rup.rep
RUPBuilder\repository\rup_small.rep
RUPBuilder\RPWConfiguration.properties
RUPBuilder\rupbuilder.exe
 

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.