Version 2003.06.00
This documentation (the "Work") is protected under the copyright laws of the United States and/or other jurisdictions, as well as various international treaties. Any reproduction or distribution of the Work is expressly prohibited without the prior written consent of Rational Software Corporation.
This document provides information about the 2003.06.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 Knowledge Center on RDNSM. RUP users should visit this page, from time to time, to check on updates and product information.
Also included is information about:
The following enhancements and new features appear in this release:
Additional product documentation is available in the following locations:
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:
Any Pentium-based PC-compatible computer system with
Either of the following supporting software is required
See Client Requirements.
See Client Requirements.
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.
There are no known issues regarding upgrading this product from previous releases.
N/A
This version of Rational Unified Process uses the current license.
If you want to view previous versions of Rational Unified Process or customized project websites in Internet Explorer after having installed the JRE plug-in for this release. Go to Tools -> Internet Options -> Advanced and uncheck the box for "Use Java2(vx.x)" where x.x is the version of your JRE plug-in. Doing this allows you to run both JRE and non-JRE applets.
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.
The following tools and respectively versions are used in constructing the RUP:
|
Tool |
Version |
| Microsoft FrontPage | 2000 |
| CorelDraw | 9 |
| PhotoShop | 5.5 |
Due to the many JRE plugin versions available for each operating system, the following are the versions that we have tested for tech supported operating system. There are versions that we recommend you use. You may encounter problems with other JRE plugin versions depending on your operating system.
| Windows 2000 and variants | JRE Plugin 1.4.1 |
| Solaris | JRE Plugin 1.4.1 |
| HP-UX | JRE RTE 1.4.0_03 and Plugin 1.4 |
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; that is, 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
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.
For users of Netscape 4.7x, if the default fonts are too small, the following changes to your preferences should solve the problem:
- Go to Edit>Preferences>Fonts
- Select "Use my default fonts, overriding document specified fonts"
- Set the default variable width font to Helvetica 12.
- Set the default fixed width font to Courier 12.
To enable the Sun JRE plug-in for your Netscape 4.7x browser, if it is not already enabled, you can set the NPX_PLUGIN_PATH environment variable. This environment variable must point to the installed Sun JRE plug-in location containing the javaplugin.so file.
For example, on SPARC processor platforms, the default location of javaplugin.so for the package installation is in /usr/j2se/jre/plugin/sparc/ns4. You can then set the variable by using the command:
setenv NPX_PLUGIN_PATH /usr/j2se/jre/plugin/sparc/ns4
Use the absolute path.
Furthermore, you may need to restart your Netscape 4.7x browser twice for the plug-in to be picked up. To check whether the plug-in is enabled, do Help -> About Plug-ins to confirm that the plug-in is loaded.
If you will get an error stating that there is an "out of memory" problem while publishing using RUP Builder, you can change certain kernal parameters to resolve this problem. The underlying cause is that for most Java applications, the kernel parameters, specifically, max_thred_proc, is by default, set at too low a value. As a result, there are not enough kernel threads to support the Java application and this manifests as an "out of memory" error.
More information can be found at: http://www.hp.com/products1/unix/java/infolibrary/prog_guide/java1_3/configuration.html
Furthermore, the tools used to determine the current parameter values (HPjconfig) and to modify them (Jave out-of-box tool) can be found from HP.com website.
In testing, these are the tuned parameters that we have found to fix the problem:
ParamNames Param Fomulas Recommended Tuned Valules max_thread_proc 64 3000 maxdsiz 0x10000000 2063835136 maxfiles 60 2048 maxfiles_lim 1024 2048 maxusers 32 512 ncallout (16+NKTHREAD) 6000 nfile (16*(NPROC+16+MAXUSERS)/10+32+2*(NPTY+NSTRPTY+NSTRTEL)) 3000 NKTHREAD (((NPROC*7)/4)+16) 6000 NPROC (20+8*MAXUSERS) 2068
There is a known defect for users of the process view editor on HP machines with the HP RTE 1.4.0_03 and plugin 1.4. During drag and drop operations, when you hold the drag and drop pointer on the target node for a few seconds in order to expand the target node, an exception will occur in the Java plugin, and the machine will freeze and you will need to reboot it. Note that this does not affect regular drag and drop operations, only the case when you hold the pointer for a few seconds in order to expand the target mode.
The workaround is to expand the target node first, and then drag and drop the source to it or to any of its children.
There is a known defect for users of MyRup on HP machines with the HP RTE 1.4.0_03 and plugin 1.4. During drag and drop operations on a MyRup tree, when you hold the drag and drop pointer on the target node for a few seconds in order to expand the target node, an exception will occur in the Java plugin, and the machine will freeze and you will need to reboot it. Note that this does not affect regular drag and drop operations, only the case when you hold the pointer for a few seconds in order to expand the target node.
The workaround is to expand the target node first, and then drag and drop the source to it or to any of its children.
Netscape 4.78 prevents drag and drop from the "Default Tree" window to your "MyRUP" tree in the main browser. This feature does work with Netscape 4.79.
‘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.
You will experience a delay when the "Where Am I" navigation button is pressed for the first time while browsing the RUP.
Netscape Navigator has problems displaying trademark () and registered () symbols in the title banners. They will show up as a question mark (?).
When starting up RUP using Netscape 4.7x, the following known problems may occur:
- An error indicating that the index.htm file not found. Users can simply click on OK and continue.
- A second error indicating that the Java Plug-in could not be loaded. To resolve problem, go to http://java.sun.com/products/archive/j2se/1.4.1/index.html and manually install the plugin. The Java Plug-in must be installed after Netscape is installed. The sequence of installation is important.
- On Windows NT4, after installing the Java Plug-in from step 2 above, users will have to manually enable the plug-in by going to Edit ->Presferences->Advanced and enable both the Java and the Java plug-in.
When using Windows 2000 or Windows 98, if the Internet Explorer browser window is too small to display the tree browser, the RUP will not be displayed properly. You will need to increase the browser window size and refresh.
When the cursor is in the tree browser 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 tree browser. The output of the print job will be blank.Use the Print icon located on the banner instead.
Using Internet Explorer 3.x and Netscape 3.x, you cannot run the Java applets, such as the tree browser 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 Site Map to browse the Unified Process using version 3.x of the browser.
The RUP uses Java applets to provide search, index and navigation capabilities; use of browsers that 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.
29 MB (Windows NT). Run the DOS command chkdsk for information on your file system.
UNIX 30 MB
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.
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.
JRE1.4.1 plugin must be used for both IE and Netscape. Windows users
who have installed RUP from the CD can install the JRE plug-in by running
j2re-1_4_1-windwos-i586-i.exe from common\rwp\JRE_plugins folder where
RUP is installed. Other RUP users need to get it from the JAVA SUN site
http://java.sun.com/products/archive/j2se/1.4.1/index.html. UNIX users
need to check on the website for their particular machine (i.e. HP or
SUN).
The internationalized version of the JRE plugin must be installed for operating systems with a double-byte character set, for example, Japanese or Chinese. The internationalized version of the JRE can be found from http://java.sun.com/products/archive/j2se/1.4.1/index.html
When RUP is started, the Java console starts up and will shut down when RUP is closed.
If your system has an ATI Radeon video card, you might experience undesired behavior. To find out whether your system has this type of video card, right-mouse click on your desktop -> Settings -> Advanced -> Adapter. There is an existing problem with the JRE used to run RUP and the driver for the ATI Radeon cards, which will intermittently, cause your system to freeze when you run or shutdown RUP. ATI has release a new driver which seems to fix the problem. The driver is available from Windows Update. Go to Drivers Update -> ATI Technologies Video card. You can also put the line "-Dsun.java2d.d3d=false -Dsun.java2d.noddraw=true" in the parameter string for your plug-in. Go to Control Panel, Java Plug-in, Advanced Tab. Put the above line into text box for Java Runtime parameters.
Full Path required in Publish Location
In RUP Builder, when you do not put the full path to the folder that you want to publish to, the folder will automatically be
put in the RUP Builder installed directory. When publishing is completed, and you are prompted to view the website, an error may occur as a result of the web browser not being given the full path to the folder location in the installed directory.Normally, as a user, you should put in the full path to the folder where you want to publish, such as "C:\Program Files\MyPublishedFolder" or "\\MyUNCServerLocation\MyPublishedFolder".
Defects logged in RATLC database for Rational Installer - RATLC00688306 Revised "Blue Screen" Install Solution Overview
Rational Installer Incompatible with Windows "Change Journal" Feature
Rational has determined that under certain circumstances file system corruption can result from installing Rational Version 2003 products on Windows 2000 to an NTFS partition that has the windows "Change Journal" (log) enabled on it. Rational is actively working with Microsoft to better understand and identify a fix for the problem.
Before installing any Rational Version 2003 product on a computer running Windows 2000, please read Rational Solution 182435434 at http://solutions.rational.com/solutions/display.jsp?solutionID=182435434 for latest information. Alternatively, you can search the Rational Solutions Knowledge Base at http://solutions.rational.com/solutions for the text "Change Journal".
Defects logged in RATLC database for Rational Unified Process and RUP Browser
- RATLC00036564: Fix outstanding broken links for Small Project Configuration
- RATLC00367528: RUP locks up when PVCS is on the machine
- RATLC00513210: Rose and Robot Tool Mentors come up as blank screens
- RATLC00513484: RUP hangs when starting up HP-UX with JRE 1.4.1
- RATLC00513735: "viewrup" does not appear to recognize JRE 1.4.1 on Solaris
Defects logged in RATLC database for RUP Builder
- RATLC00036596: Anchor tag after presentation name command disables link processing
- RATLC00036517: Builder crashes when there is & or % in the name of publication directory
- RATLC00036588: RUP Builder does not publish to an UNC path
- RATLC00036486: Keyword Index Applet indexes temporary files
- RATLC00036613: "Browse" and "Publish" buttons are cut off depending on screen resolution and/or window size
- RATLC00036640: <<rupReplaces>> not properly handled
N/A
N/A
This section may include lists of third-party components installed in this release. May also include a list of files changed in this release.
If you have questions about installing, using, or maintaining this product, contact Rational Technical Support as follows:
| Your Location | Telephone | Facsimile | |
| North America | (800) 433-5444 (toll free) (408) 863-4000 |
(781) 676-2460 Lexington, MA |
support@rational.com |
| Europe, Middle East, Africa | + 31 (0) 20 4546 200 Netherlands |
+31 (0) 20-4545-202 Netherlands |
support@europe.rational.com |
| Asia Pacific | +61-2-9419-0111 Australia |
+61-2-9419-0123 Australia |
support@apac.rational.com |
When you contact Rational Technical Support, please be prepared to supply the following information: