Version 2003.06.13
September 2004
Material ID/Part Number: GI11-5908-03
© Copyright IBM Corporation. 1987, 2004. All Rights Reserved.
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 IBM Corporation.
This document provides information about the 2003.06.13 release of RUP. For details of updates of the product from previous versions, please refer to the About page in the product.
These Release Notes are accurate at the time this product was prepared for release. The most recent version of this file is available in the IBM Publications Center at http://www.ibm.com/shop/publications/order. Search for “GI11-5908-03" to find the latest version of these Release Notes in the IBM Publications Center. (To search for the IBM Publications Center, go to http://www.ibm.com and enter "IBM Publications Center" in the Search field.)
You can find information about add-on products and upgrades on IBM developerWorks at http://www.ibm.com/developerworks/rational. RUP users should visit this page, from time to time, to check on updates and product information.
Also included is information about:
What's New in This Release
Product
Documentation
Hardware and Software Information
Client
Requirements
Server
Requirements
Installing, Upgrading, and Licensing
Installation
Information
Installation
Issues
Upgrading from previous versions of Rational Unified Process
Licensing
Compatibility Issues
With
Previous Versions of Rational Unified Process
With
Third-Party Products
Restrictions and Guidelines on Using Rational
Unified Process
Known Issues and Change Requests
Defects
fixed in This Release
Additional Information
Contacting Rational Technical Support
From RUP v.2003.06.00
The following enhancements and new features appear in this release:
From RUP v.2003.06.12
N/A
From RUP v.2003.06.13
Support for Windows XP SP2
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:
Windows
Any Pentium-based PC-compatible computer system with
- SVGA-compatible display
- Any pointing device with at least two buttons
- Microsoft Windows NT 4.0 (SP6a) or Windows 2000 (SP2 or 3), or Windows XP (SP1 or none)
- 64 MB RAM minimum, 128 MB recommended
- 255 MB disk space
UNIX
- one of these supported UNIX platforms:
- HP-UX 11.0 or 11.11
- RedHat Linux 7.2 or 8.0
- Solaris 7, 8 or 9
- 225 MB disk space
Windows
Either of the following supporting software is required
- Microsoft Internet Explorer 5.01 with SP2 or later
- Netscape Navigator versions 4.72 to 4.77 and 7.0
UNIX
- Netscape Navigator 4.72 to 4.77 or later
- Sun JRE 1.4.1 plug-in
See Client Requirements.
Software 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.
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:
Tool | Version |
---|---|
Microsoft FrontPage | 2000 |
CorelDraw | 9 |
PhotoShop | 5.5 |
1. Operating System Support for Java Runtime Environment (JRE)
Due to the many JRE plugin versions available for each operating system, the following are the versions that we have tested for a 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 |
The RUP application is generally installed to systems by someone who has administrator privileges. A common "User" is usually not allowed to install any applications. If the administrator has forgotten to install the correct JRE 1.4.1 plug-in required by the RUP Browser, someone logged in as "User" or other than "Administrator" will observe that the RUP Browser will be hanging during launch without a notification. If this occurs, notify the system administrator to install the required version of the JRE plug-in.
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
i. Long startup 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.
ii. Font Settings using Netscape 4.7x
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.
iii. Enabling JRE Plug-in for Netscape 4.7x on Solaris
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.
iv. HP-UX 11.x
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/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 |
v. Using RUP Builder on HP with HP RTE 1.4.0_03 and plug 1.4
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.
vi. Using MyRUP on HP with HP RTE 1.4.0_03 and plug 1.4
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.
vii. "Add From Default Tree" feature not available on Netscape 4.78
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.
i. Delay using "Where Am I" navigation button
You will experience a delay when the "Where Am I" navigation button is pressed for the first time while browsing the RUP.
ii. Netscape Navigator on UNIX Banner Display problems
Netscape Navigator has problems displaying trademark () and registered () symbols in the title banners. They will show up as a question mark (?).
iii. Launching RUP using Netscape 4.7x
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.
i. Browser Window too Small
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.
ii. Printing Error
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.
i. 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 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.
ii. 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 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.
iii. Disk Space Usage
29 MB (Windows NT). Run the DOS command chkdsk for information on your file system.
UNIX 30 MB
iv. 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.
v. 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.
vi. JRE plugin requirements
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).
vii. JRE plugin requirements on non-English Operating Systems
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
viii. Java Console present while browsing RUP
When RUP is started, the Java console starts up and will shut down when RUP is closed.
ix. ATI Radeon Cards
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.
i. 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".
ii. 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://www.ibm.com/software/rational/support/?solutionID=182435434 for latest information.
iii. Defects logged in RATLC database for Rational Unified Process and RUP Browser
- 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
iv. Defects logged in RATLC database for RUP Builder
- 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
- RATLC00036640: <<rupReplaces>> not properly handled
N/A
N/A
The IBM software support Internet site provides you with self-help resources and electronic problem submission. The IBM Software Support homepage can be found at http://www.ibm.com/software/support.
Voice Support is available to all current contract holders via a telephone
number in your country (where available). For specific country phone numbers,
please refer to the IBM Software Support Handbook, Appendix B: Contact Information,
found at http://www.ibm.com/software/support