Version 2003.06.13, September 2004
File last updated 08/18/2004
Material ID/Part Number: GI11-5898-03
© Copyright IBM Corporation 2001, 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 critical to installing and using Rational ProjectConsole and the Microsoft Word add-in ProjectConsole Template Builder, including hardware and software requirements, and known issues and compatibility issues.
Product changes described in this document and contained within this service release apply to Rational ProjectConsole and Rational ProjectConsole Template Builder:
ProjectConsole, Version 2003.06.00 (English only release)
ProjectConsole, Version 2003.06.10 (Japanese only release)
ProjectConsole, Version 2003.06.01 (English only service release)
ProjectConsole, Version 2003.06.12 (English and Japanese service release)
If you are upgrading from any of these releases, see the Service Release Notes, ProjectConsoleReleaseNotes_sr.htm for the defects fixed in this service release and earlier ProjectConsole version 2003.06 releases.
Hardware
and Software Information
Client Requirements
Server Requirements
Installation and Licensing
Installation Information
Licensing
Compatibility Issues
With Rational Products
With Third-Party Products
Restrictions and Guidelines on Using ProjectConsole
Known Issues and Change
Requests
Documentation Updates
Contacting IBM Rational Software Support
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-5898-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.)
This section provides information about new and enhanced features included in Rational ProjectConsole 2003.06.00 through 2003.06.13 and Rational ProjectConsole Template Builder. These changes were implemented after the release of Rational ProjectConsole 2002.05.00.
This version of Rational ProjectConsole provides several new features and enhancements that make the ProjectConsole Web site easier to use and manage. The look and feel of the ProjectConsole web site has been updated with the new standard IBM graphics to make ProjectConsole compatible with the other Rational web applications.
ProjectConsole uses the Rational Web Platform (RWP) ・an Apache/Tomcat-based Web server.� With RWP, no additional setup is required after installation.� When you install ProjectConsole, all Web configurations are performed automatically.
ProjectConsole also
provides support for the following:
– Windows
2000 Server or Professional (SP4)
– Microsoft Word 2003 as an additional
supported word processor platform
– Hebrew language
(see fixed defect RATLC00372018)
・nbsp; Netscape browsers (see
fixed defect RATLC00372090 and
RATLC00372122)
ProjectConsole supports the following browser/OS platform combinations:
Internet Explorer 5.5 and 6.
Windows XP
Windows 2K Professional and Server
Windows 2003
Windows NT 4.0
Netscape 7.0
Windows XP
Windows 2K Professional and Server
Solaris 8.0/9.0
Linux 8.0/9.0
Mozilla 1.6
Red Hat Linux 8.0/9.0
In addition the JRE requirements are version 1.3 and above (the current requirement) for all OS platforms.
Netscape 7.0 and above and Mozilla 1.6 require the 1.4.2_05 version of the Sun JRE. Netscape 7.1 and Mozilla 1.6 require the NS610-GCC32 version of the libjavapjugin_oji.so. Netscape 7.0 requires the NS610 version of the plug-in
The ProjectConsole components no longer require the Microsoft Java Virtual Machine to be installed on the ProjectConsole server. This was done to comply with Microsoft's decision to stop supporting their JVM.
The ProjectConsole server components now support Windows 2003 server.
Now, when you install ProjectConsole, its server processes are installed and run as Microsoft services.
You can now log in to ProjectConsole within a firewall environment.
See the ProjectConsole Service Release Notes.
ProjectConsole now handles double-byte characters and provides level 2 support for German, French, Dutch, Italian, Hebrew, Swedish, Traditional and Simplified Chinese, and Japanese.
The ProjectConsole Web site now includes an Administration section.� This section is used to administer the groups and individual users who log in to the Web site, set an expiration time for generated reports, and remove server names from the list of available report servers.
Administrators can now assign access to running reports on the Web site based on access control lists (ACLs).� ACLs can include groups as well as individual users.
Previously, if you were running the Dashboard, and you wanted to use the Designer, you had to close the Dashboard first. In ProjectConsole Version 2003.06.00, you can run the Dashboard and the Designer at the same time.
Note To run the Dashboard and the Designer at the same time, you must use the Java 1.4.x plug-in.
After you log in to ProjectConsole, you have read-only access to all reports and folders associated with the group(s) to which you belong. In addition, you now have your own private, customizable workspace in the navigation tree. You can copy read-only information to this workspace, and organize it to suit your needs.
Previously, an administrator used the ProjectConsole Administrator to manage users and the Web site navigation tree, and to create, run, and monitor scheduled tasks. In Version 2003.06.00, an administrator:
Uses the new Administration section on the main Web site to manage users and groups, set an expiration time for generated reports, and remove server names from the list of available report servers
Manages the ProjectConsole navigation tree from the main Web site
Uses the Designer to create, run, and monitor scheduled tasks
ProjectConsole now supports collecting and reporting from Microsoft Project Standard and Professional 2002.
ProjectConsole provides many new out-of-the-box Template Builder report templates that you can use to display data from development tools, including Rational TestManager. The improved template format produces reports that have a more professional look and feel and are easier to read.
Out-of-the box templates now include templates for displaying Rational TestManager and cross-products data.� You can access descriptions of all of the out-of-the-box templates in the navigation tree for the ClassicsCD.com sample Web site.� In the navigation tree, expand the ClassicsCD.com Projects node. Under Additional ProjectConsole Resources, click Descriptions of Supplied Templates.
Previously, if you used a navigation tree node to generate a report on data displayed from a point product that had security enabled, you were required to first log in to the point product.� In this release, you can run reports without logging in to a different product because you can now specify a username and password on the node properties page.
You can now use a shortcut menu to cut (administrators only) or copy a node in the navigation tree and then paste the node into a different section of the tree.
The new Logo toolbar gives you quick access to resources such as the Getting Started document, the ProjectConsole glossary of terms, contact information for customer support, and more. You can use the Log Out button to log out and then log in again as a different user.�
The new Operations toolbar contains buttons that you can use to start the Dashboard and the Designer, view your user profile, and perform administrative tasks.
The new ProjectConsole sample site features two ClassicsCD.com projects.� The folder hierarchies used for each product shows you examples of how you can organize your ProjectConsole Web site and shows capabilities across projects, such as rolled-up measurement views.
In addition to the repository databases supported in Version 2003.06.00, ProjectConsole now supports Oracle 9i. By providing support for Oracle 9i, ProjectConsole remains parallel with the vendor databases that ClearQuest supports. For more information regarding Oracle 9i support, refer to the ClearQuest Service Release 2003.06.12 Notes.
The following two sections
of the Rational ProjectConsole Tutorial are now distributed as part of the
installed Rational ProjectConsole Tutorial:
– Section 11 - Collecting XDE Artifacts
– Section 14 - Creating a Report on XDE
Artifacts
The Administrator and Designer applets have been merged into a single applet in Version 2003.06.00 – the Designer.
You now use the Designer to run scheduled tasks and view the task logs.
The time it takes to delete scheduled task logs has been significantly reduced. In the past, each task log took approximately 2-3 seconds to delete. ProjectConsole now deletes 20-30 task logs per second.
Previously, if you ran a collection task multiple times on a single day, you had to manually delete previous collection(s) to store only the data collected during the last run. Now, if you run a collection more than once on a given day, ProjectConsole does this for you automatically.
You can no longer use the Designer to create and schedule data transformations, but you can still perform data transformations by specifying transformation scripts as startup and/or shutdown commands in collection tasks. If you used the Designer in Version 2002.05.20 to create transformations, then you must convert them to external transformations.� For information on how to do this, contact IBM Rational Software Support.
The Dashboard has expanded security features that let you, as an administrator, selectively provide individual users and groups with access to folders and panels, based on what they need to view or modify to accomplish their work.
You can now publish all charts and indicators from the Dashboard.
Whatever your role on the development team, you can selectively view the reports and data tailored to your specific needs and interests.
Non-administrators who access the Dashboard can drill down on the metrics displays to explore the data presented in more detail and display charts using different formats. However, only administrators can create, modify, save, and delete Dashboard content. Your ProjectConsole administrator can create a personal folder for you in the Dashboard navigation tree. You can use this folder to customize your view of the folders and metrics you are authorized (as an individual user) to view. You can create folders and copy and/or delete folder and/or metrics panels in it. No one else has access to your personal folder by default.
The ProjectConsole sample site comes with a new set of metric display samples that you can reuse for your own projects.
In addition to the line, bar, scatter plot, and stacked bar chart formats, you can now present your collected measures in pie charts and area charts.
When a chart is displayed using the Dashboard, the value for a data point is automatically displayed when the cursor hovers over the point, bar or line on the chart.You can also display the value labels when publishing charts to PNG or PDF files. When you publish a chart or a panel, a new check box gives you the option of displaying the chart value labels. If the check box is selected, every data point on the chart will have a corresponding value label. Note that the chart can get very busy if there are multiple overlays and/or lots of data points.
You can now display the
list of filters that have been applied to a chart through the chart property
sheet or through drill-down operations.
Right-click the chart while it is displayed, and then select the
Properties command on the shortcut menu. The pop-up window that
is displayed shows the current filters that are applied to the chart.
Folders and panels in the Dashboard navigation tree now have shortcut menus that administrators can use to:
If an administrator has set up personal folders for individual users, as a non-administrator, you can also use the shortcut menu to add information to and organize it in your own folder.
You can now use the ProjectConsole Maintenance Tool to migrate project data you collected using an earlier version (2002.05.20 or earlier) of ProjectConsole to the 2003.06.00 release or later. There is no need to perform a migration from the 2003.06.00 to any of the subsequent service releases (2003.06.12, 2003.06.13, etc.)
In previous versions of ProjectConsole, the data storage facility was called the metrics warehouse. It consisted of a schema repository database and a warehouse database.� In this release, the metrics warehouse is replaced by the ProjectConsole repository. In a ProjectConsole repository, the schema repository and the warehouse database (now called the data warehouse) are closely tied to a new security database that stores ser and group authorization information in addition to all information about the navigation tree structure for the ProjectConsole Web site.
To configure the ProjectConsole server and agent software in earlier versions of the Maintenance Tool, two separate steps were required. Now, you can use the same step in the Maintenance Tool to configure both the server components and agent components installed on the ProjectConsole server.
Note: If you have installed the report server and collection agent software on one or more agent machines, you must still configure that software separately on each machine.
The Rational Software Solutions Knowledge Base now provides information from an extensive database of solutions managed by Rational ProjectConsole technical support professionals.
To access and use the knowledge base:
Go here to search IBM Rational software support for Technotes.
On the "Rational software support" page under Support by product, select Rational ProjectConsole in the All support pages in this product category list.
After you select Rational ProjectConsole, the browser automatically goes to the "Rational ProjectConsole" page. If this does not occur in your browser, click Go.
On the "Rational ProjectConsole" page under Self help, click Technotes.
The browser goes to the "Search results" page, which displays all the Technotes for ProjectConsole.
To refine your search of the ProjectConsole Technotes, type a key word such as "Dashboard" or "Designer" in the Additional search terms box on the "Search results" page, and then click the Go button next to the Document type list.
To see the detailed description of a Technote in the list, click the underlined text in the Technote.
After reviewing the information in a Technote, click the Back button in your browser to return to the "Search results" page.
This section provides information about changes made to ProjectConsole Template Builder in this release.
You can now use Template Builder to report on Microsoft Project 2002 and Rational XDE version 2003.
The new Refresh command on the ProjectConsole menu reloads dynamic schema changes made to a point product since you last opened Template Builder.
The domain information has been removed from the Template Builder Help system. Each domain is documented in its own PDF file. To access a domain PDF file, click Help > Help on Domains, and then click the domain name.
If you are installing IBM Rational products for the first time, read:
If you are upgrading to this release from an earlier version, read:
Note: Release Notes typically include information about new features and functionality, hardware and software requirements for installing IBM Rational products, and issues that may not be documented elsewhere. Service Release Notes supplement the Release Notes and typically include upgrade information, defects in the current service release, and a list of defects that have been fixed.
Additional product documentation is available from the following sources:
Unified Software Project
Management with Rational ProjectConsole
This article provides some useful tips on how you can use ProjectConsole to
easily put an effective metrics program in place. It describes a set of metrics
a development team would find useful in monitoring a project through all the phases
of a project developed using the Rational Unified Process from Inception to
Elaboration, through Construction, and finally, Transition.
Rational ProjectConsole
Database Sizing Estimation
This Tech Note from Rational Software provides a general formula that you can
use to estimate the amount of storage space required for each data source
collected in the ProjectConsole repository.
The SLOC Collection Agent
The SLOC Agent executable is designed to run standalone as well as with
Rational ProjectConsole. It parses files in a specified directory and creates a
comma-separated-value (CSV) file containing the number of source-lines-of-code
(SLOC) and the number of comments for each file within the directory.
The ProjectConsole Web site provides links to white papers that provide information about measurement planning and some of the sample measurements provided with ProjectConsole.
To view these papers (in PDF):
In the ProjectConsole navigation tree (in the left frame), expand the ClassicsCD.com Projects node (click + next to the node).
Expand the Additional ProjectConsole Resources node.
Expand White Papers, and then click one of the following titles:
The ProjectConsole Tutorial contains new sections that show you how to collect and report on TestManager data, create templates for creating reports on data collected from multiple domains, create reports that contain tables and metrics displays, and more.
The tutorial contains the following new sections:
Section 6 ・Creating Your Own ProjectConsole Web Site
Section 11 ・Collecting XDE Artifacts
Section 13 ・Creating a Report that Includes a Metric Display
Section 14 ・Creating a Report on XDE Artifacts
Section 15 ・Collecting and Reporting on TestManager Data Stored in Aggregate Measure Tables
Section 16 ・Creating Reports Containing Cross-Product Data
To access the Rational ProjectConsole Tutorial:
In the ProjectConsole navigation tree (in the left frame), expand the ClassicsCD.com Projects node (click + next to the node).
Expand the Additional ProjectConsole Resources node.
Click ProjectConsole Tutorial.
To open a section of the tutorial, scroll through the Rational ProjectConsole Tutorial page, and click the section title.
ProjectConsole has a new Getting Started document that points you to various ProjectConsole information sources.� To open the Getting Started document from the ProjectConsole main Web site, on the Logo toolbar, click Getting Started.
To access the updated ProjectConsole Glossary of Terms from the ProjectConsole main Web site, on the Logo toolbar, click Glossary.
The following sections provide information about the supported platforms and installation requirements for Rational ProjectConsole and Rational ProjectConsole Template Builder on server and client systems. These requirements are in addition to those outlined for Rational Suite.
There are no product-specific hardware requirements for clients used to log in to ProjectConsole.
Web clients on Windows platforms:
Microsoft Internet Explorer 5.5 (SP1, SP2) for Windows
Microsoft Internet Explorer 6.0 (none, SP1) for Windows
Netscape Navigator 7.0 and later for Windows
ProjectConsole does not support earlier versions of Netscape Navigator.
Web clients on non-Windows platforms:
Netscape Navigator 7.0 and later on Red Hat Linux 7.1 - 7.3, SuSE Linux 8.0, AIX 4.3.3, 5.1, 5.2, HP-UX 11.x, Solaris 2.6, 7 ・9
Mozilla 1.6 on Linux 8.0, 9.0
500 MHz or higher (Faster CPU results in faster report generation and data collection.)
256 MB RAM; more memory generally improves performance; required memory depends on the number of concurrent users, amount of data being requested, and the size of the database
2 x physical memory is the recommended swap space
In addition to Rational Suite disk space requirements, the ProjectConsole repository requires 1+GB
ProjectConsole server
Microsoft Windows operating systems:
Windows NT 4.0 Server (SP6a with SRP)
Windows 2000 Server (SP2, SP3)
Windows 2000 Advanced Server
Windows 2003 Enterprise Server
Windows 2003 STD Edition
Rational Suite Version 2003.06.00
Microsoft Word 2000 (SP1), 2002, 2003
Repository databases (supports the same vendor databases as ClearQuest):
IBM DB2 7.1, 7.2 (FixPack 8, 8.1), 8.1 Express
Microsoft SQL Server 7.0 (SP4), 2000 (SP2, SP3)
Sybase SQL Anywhere 5.5.05 (rolling upgrades only), 8.0.1 (new and copied databases)
Oracle 8.1.6, 8.1.7, 9.2
IBM DB2 7.1, 7.2 (FixPack 8), 8.1
Note: ProjectConsole also supports Oracle on Solaris 2.6, 7-9 and HP-UX 11.0 QPK1100, 11.11 GoldQPK11i and Bundle11i.
Additional collection support:
Microsoft Project 2000 Professional
Microsoft Project 2002 (.mpp only)
Collection agents/report servers
If you install the agent software (report server and collection agent) on additional computers, this software must be the same version as the ProjectConsole software installed on the server.
Additional collection support:
Microsoft Project 2000 Professional
Microsoft Project 2002 (.mpp only)
Template Builder
Microsoft Word 2000 (SP1) or Microsoft Word 2002, 2003
Under certain circumstances, file system corruption can result from installing Rational Version 2003 products on Windows 2000 to an NTFS partion that has enabled the Windows "Change Journal" (log). This corruption is caused by a defect in Windows 2000. Before you install any Rational Version 2003 product on a computer that is running Windows 2000:
Disable all virus detection software
Read IBM Support Technote 1135295. Go to http://www-1.ibm.com/support/us/search/index.html and search for "Rational Installer Change Journal."
Read Microsoft Knowledge Base article 820888 at http://support.microsoft.com/default.aspx?scid=kb;[LN];820888. This article includes information about an update from Microsoft that fixes the defect.
The Open Transaction Manager (otman), a device driver that is included in some backup software products, is incompatible with the Rational product installer. Installing a Rational product on a host where this driver is also installed can cause file system corruption that renders the volume on which the Rational product is installed unusable. If the Rational product installer displays a message indicating that this driver is installed on a host, you must remove the product that installed the driver before you can continue with your Rational product installation. Use "Add or Remove Programs" in the Windows Control Panel to remove the product. Products that are known to use this driver include:
Veritas Net Backup client
After you have finished installing your Rational product, you can reinstall the product that includes the otman driver.
For more information, contact IBM Rational Software Support.
For more information about installing the Rational ProjectConsole software for the first time, see the printed manuals "IBM Rational Software Desktop Products Installation Guide" and "IBM Rational Software Server Products Installation Guide."
Licensing has changed for ProjectConsole v2003.06.00. As of this release, every user who logs in to ProjectConsole must have either a ProjectConsole Web access license or a Suites floating license.
The ProjectConsole server checks out one Suite/TUP node-locked or floating license and one ProjectConsole Web access floating license for each client (IP address). If no ProjectConsole Web access licenses are available, it checks out a Suites floating license.
The following files from LEAD Technologies, Inc., which are used for graphic representation, are included in this release:
lfbmp13n.dll
lfcmp13n.dll
lflmb13n.dll
lfpng13n.dll
lfwmf13n.dll
ltdis13n.dll
ltefx13n.dll
ltfil13n.dll
ltimg13n.dll
ltkrn13n.dll
ltocx13n.ocx
lttwn13n.dll
This section identifies special considerations for using ProjectConsole and ProjectConsole Template Builder with other Rational products and with third-party products.
This ProjectConsole release, as installed, does not support the collection of and reporting on measures from Rational XDE. An updated version that provides this support is available from IBM developerWorks Rational.
There are limitations on the number of fields that can be queried using certain database vendors. These limitations vary from vendor to vendor. This generally applies to artifact report generation and measurements collection from ClearQuest databases.
If you are running the ProjectConsole Template Builder, generating an artifact report, creating a source template, or collecting measures from a ClearQuest database, and an error occurs that indicates your query contains too many fields, either switch to another database vendor or reduce the number of fields used in your ClearQuest query.
You can use ProjectConsole Version 2003.06.00 to report on (and collect data from) most Rational products of Version 2002.05.00 and higher. However, this is not the case for TestManager. With ProjectConsole Version 2003.06.00, you can only report on and collect data from TestManager Version 2003.06.00.
If you are using a Netscape browser to view ProjectConsole, you must use version 7.0 or above. On some platforms, if you access ProjectConsole using an unsupported Netscape version, an error message is displayed. On other platforms, the login process gets stuck on the "Loading ProjectConsole" page.
The 1.4.1/1.4.1_01 Java Runtime Engine (JRE) / plug-in causes machines with ATI graphics cards to lock up when displaying Java graphics from ProjectConsole.
To work around this, do the following:
Open the Windows control panel.
Double-click Java Plug-in.
The Java Plug-in Control Panel window opens.
Note: If the Java Plug-in Control Panel window does not open, install the DirectX 9.0 driver using your browser's Tools > Windows Update selection or download it from the Microsoft web site.
Click the Advanced tab.
In the Java Runtime Parameters box, type "-Dsun.java2d.noddraw=true" in the field
Click Apply, and then close the Java Plug-in Control Panel window.
Restart all browser windows.
Note: This problem will be fixed in the 1.4.1_02 JRE.
In order to be able to launch either the Designer or Dashboard, cookies need to be enabled. This is true for all browser types: IE, Netscape7.x and Mozilla1.6.
From the Mozilla toolbar: Tools > Cookie Manager > Allow cookies from this site
From the Netscape toolbar: Tools > Cookie Manager > Unblock cookies from this site
Note: The production release of Windows XP SP2 was not available for final testing at the time this document was finalized. To obtain the latest information about Windows XP SP2 support, go to IBM Rational Support at http://www.ibm.com/software/rational/support/ and search for 迭ational products and Windows XP SP2.・The following information is based on testing done with Windows XP SP2 Release Candidate 2, released June 14, 2004.
Microsoft Windows XP SP2 includes security measures that may affect IBM Rational products as follows:
You may receive warnings when using online or extended help from IBM Rational products affected by this issue:
Online Help and Rational product HTML files on the hard disk of the
local machine
When using online help for one of these applications, or accessing
Rational product HTML files on the hard disk of the local machine, a warning
dialog might open informing you that the page has been restricted from
running active content that might be able to access your computer. When you
are prompted to do so, choose to allow the page to access your computer.
Note: The warning dialog opens the first time you select HTML active content on the local disk. The dialog notifies you about the new Information bar (in Internet Explorer, beneath the Address box). By default, "Do not show this message again" is selected, and this warning dialog will not be displayed again. Read the content in the Information bar and click anywhere in the bar to select the option that enables active content. Online help should now display.
Rational Unified Process and Extended Help
When using Rational Unified Process or Extended Help from one of these
applications, a warning dialog might open informing you that the page has
been restricted from running active content that might be able to access
your computer. When you are prompted to do so, choose to allow the page to
access your computer.
Note: If the correct Java JRE is not installed on your computer, another warning dialog might open, displaying the following message: 笛RE required by RUP and Extended Help not found.・If you are operating on Windows XP SP2, this dialog might not open. Still, the correct Java JRE must be installed on your computer for Rational Unified Process and Extended Help to display. For more information about this and any other warnings that may be displayed when using online or extended help from IBM Rational products, go to IBM Rational Support at http://www.ibm.com/software/rational/support/ and search for 迭ational products and JRE with Windows XP SP2.・/p>
For more information about this issue with Windows XP SP2, click the following links:
Windows XP SP2 enables a firewall that might make it difficult for the IBM Rational product client and/or server to operate. You might receive warnings about network connections when using the following IBM Rational client applications:
You might receive warnings about network connections when using the following IBM Rational server applications installed on Windows XP SP2:
Allowing network traffic when using Windows XP SP2
If you are using one of the IBM Rational applications that are affected by
XP SP2, while making outgoing requests, a warning dialog might open to
inform you that an outgoing request is being made. If the firewall blocks
network traffic, then client/server applications will not operate. To ensure
that IBM Rational products operate with Windows XP SP2, you must allow
network traffic by doing one of the following:
More specific information for the IBM Rational License Server and SQL database affected by this issue is described in the following sections. For more specific information about the IBM Rational products affected by this issue, read the IBM Rational Suite Release Notes, or Release Notes for those products affected by this issue.
IBM Rational License Server (FLEXlm-based) and Windows XP Service Pack
2
Communication ports on Windows XP SP2 are closed by default. For a License
Server installed on Windows XP SP2 to be able to serve licenses to clients
other than itself, it needs two open ports, one each for rational.exe
and lmgrd.exe.
To open the firewall for the IBM Rational License Server (FLEXlm-based) on Windows XP SP2 machines, go to the Rational/common directory and double-click WinXPSP2.reg. This file will import the changes to the registry and open up the firewall for rational.exe and lmgrd.exe to use any ports.
Note: If you did not use the default path (C:\Program Files\Rational\Common\) to install the Rational License Server, you must edit the WinXPSP2.reg file by replacing the C:\Program Files\Rational\Common in two locations in each line with the actual install path. Optionally, you can open the firewall for the IBM Rational License Server (FLEXlm-based) manually by following these instructions:
SQL Anywhere and Windows XP Service Pack 2
For more information about SQL Anywhere Studio and Windows XP Service Pack
2, go to
http://www.ianywhere.com/developer/technotes/sas_xp_sp2.html.
For more specific information about the IBM Rational products affected by this issue, read the IBM Rational Suite Release Notes, or Release Notes for those products affected by this issue.
There are no known restrictions associated with this product.
The following tables list the issues identified for Rational ProjectConsole and its components for v2003.06.00 to v2003.06.13, including ProjectConsole Template Builder. For a list of issues for Rational ProjectConsole and its components for Rational ProjectConsole versions later than v2003.06.13, see the ProjectConsole Service Release Notes.
For other product-specific defects and limitations, read the release notes and service release notes for the product(s) of interest to you.
Component |
Defect Number/ APAR |
Description |
ProjectConsole Designer |
RATLC00031285/ No APAR |
The TestMgrExecutedTCCollection.bat command script that is run as a shutdown command on the sample TM_ExecutedTestCases_Collection task contains a hard-coded hostname to indicate where the PjC data warehouse is located. This is a limitation of the command script. If you try to run this script without changing the server name, it fails. Workaround: Before you run the sample TM_ExecutedTestCases_Collection task, you must edit the updateTestMgrExecutedTCCollection.bat file so that it points to your data warehouse instead. If you created a Microsoft SQL Server-based repository, replace "dishigali-w2kas" with your SQL Server machine name and replace "tutorialwarehouse" with your data warehouse name. Note If your SQL Server user does not use 殿dmin・as both username and password, you must also replace the username and password for the repository. For database products other than SQL Server, you must write a .bat file that connects to your ProjectConsole repository. If you are familiar with ClearQuest, you can use the pdsql command, for example. (To get Help for this command, type "pdsql" on the command line.) The updateTestMgrExecutedTCCollection.sql script that this .bat file references contains raw SQL commands that update the Test Manager ProjectConsole tables. Your ProjectConsole repository should contain the expected tables with the expected field names. If the script fails to run because it cannot find a table or a field, you must edit the SQL script so that the tables/field names correspond to those in your repository. Note: The names in the SQL script are the physical table and field names. You must make the same changes to the setExecutedTestCases.bat command script that is specified as a startup command for that same task and to any other batch file specified as a startup or shutdown command of a sample collection task. |
Maintenance Tool |
RATLC00031313/ No APAR |
If you try to move an Oracle-based ProjectConsole data warehouse to another Oracle-based ProjectConsole data warehouse using the ProjectConsole Maintenance Tool, an error occurs. Workaround: Do one of the following:
|
Designer ProjectConsole ProjectConsole Template Builder |
RATLC00365239/ No APAR |
The number of query fields a ClearQuest query can define in order to be successfully used by a Template Builder template or a domain source template varies, depending on the database vendor you use. If you encounter an error indicating that too many fields are defined when generating a report or collecting artifacts from a ClearQuest database, then you must reduce the number of query fields in the query used to generate that report or collect the data. |
ProjectConsole ProjectConsole Template Builder |
RATLC00012515/ No APAR |
Microsoft Project-based artifact reports may fail to generate if you have an .mpp file open within the Microsoft Project plug-in in Microsoft Internet Explorer. Workaround:� Open each .mpp file in a new browser window.�
|
ProjectConsole Template Builder |
RATLC00027119/ No APAR |
Messages are truncated on sequence diagrams. Workaround: In Rose, display the affected diagram, and then click Format > Autosize All. |
Designer |
RATLC00027512/ No APAR |
If you delete some of the source fields in a source template, the Designer may prevent you from saving that template.� This can happen if you delete a source field, and then recreate the same source field without first saving the template. Workaround: Close, and then reopen the source template.� If this does not solve the problem, recreate the source template. |
ProjectConsole |
RATLC00364926/ No APAR |
There is no way to pass information from a ProjectConsole artifact report into dynamic ClearQuest queries. (A dynamic ClearQuest query is a query that prompts the user for the value to use in one of the query filters.) Workaround: Do not use dynamic ClearQuest queries within a ProjectConsole artifact report or a domain source template. |
ProjectConsole Template Builder |
RATLC00367282/ No APAR |
While a template runs against an XDE model, you cannot modify the model because it is opened in the background by the Template Builder data access layer. Workaround: Wait for the session to complete, and then close Template Builder before updating your model. |
ProjectConsole Template Builder |
RATLC00368817/ No APAR |
In ProjectConsole Template Builder, as you build an artifact report template, you can add filters to constrain the data to display. All of the data inserted into an artifact report is returned from the data source as string data. The result is that all of the comparison filters use string comparisons, even on numeric data. Therefore, numeric strings may be filtered incorrectly (for example, 100 will be less than 99). Workaround: None |
ProjectConsole servers |
RATLC00368910/ No APAR |
If you are accessing an Microsoft Access or SQL Anywhere data warehouse on a remote machine using a UNC path, and the warehouse is configured to log on using the LocalSystem account, the Rational ProjectConsole Dashboard Server service cannot access the warehouse. Workaround: Configure the Rational ProjectConsole Dashboard Server service to log on as a named user account that has access to the specified UNC path. |
ProjectConsole servers |
RATLC00369173/ No APAR |
To perform a ClearCase/UCM collection, you must configure the ProjectConsole services to logon as:
Note: If ProjectConsole and ClearCase servers are on different machines, you must install ClearCase 5.0 client on the ProjectConsole collection machine. |
ProjectConsole |
RATLC00369306/ No APAR |
If you are using a Netscape browser to view ProjectConsole, you must use version 7.0 or above. On some platforms, if you access ProjectConsole using an unsupported Netscape version, an error message is displayed. On other platforms, the login process gets stuck on the "Loading ProjectConsole" page. Workaround: Upgrade your Netscape browser to version 7.0 or above. |
Maintenance Tool |
RATLC00369256/ No APAR RATLC00366593/ No APAR |
The Rational Web Platform (RWP) installed on the ProjectConsole server is configured by default to use port 80. If your ProjectConsole server machine has another Web server (such as Internet Information Services or WebSphere) configured to use port 80, RWP (and ProjectConsole) may not start. Workaround: For instructions on how to resolve Web server port conflicts, see the printed manual "IBM Rational Software Server Products Installation Guide." |
ProjectConsole |
RATLC00369977/ No APAR |
If you migrate data from a previous ProjectConsole release to the 2003.06.00 release, ProjectConsole will migrate the ProjectConsole Tools and Help nodes to ensure that no customer data is lost. The default content of the ProjectConsole Tools folder is no longer relevant in version 2003.06.00 because you now start the Dashboard and the Designer from the Operations toolbar. The Help node is no longer useful because you now access the Help from the Logo toolbar. Workaround:� If the migrated nodes contain only the default ProjectConsole content, you can delete them. If project-specific content was added to these nodes, move this content to another folder, and then delete the legacy nodes. |
Designer |
RATLC00369915/ No APAR |
In the 2003.06.00 release, the ProjectConsole Administrator was merged into the Designer. Therefore, the Designer may take somewhat longer to initialize than before. Workaround: The long initialization times can often be traced to a site that has a large number of scheduled task logs. To improve Designer startup time, delete older scheduled task logs. You can use the Scheduled Task Logs window to select multiple logs and delete them all at the same time. For information about how to delete the task logs, see the topic 溺anaging the task logs・in the Designer Help. |
ProjectConsole ProjectConsole Template Builder |
RATLC00369992/ No APAR |
The FileSys directory template now contains a link at the top of the document (click to change file display location) that you can use to specify whether files are displayed in the right frame of the main ProjectConsole window, or in a separate browser window. This setting only effects access to the files from the right frame (hyperlinks in the generated reports). Accessing those same files from the tree will always display their contents in the right frame of the main ProjectConsole Web site. |
ProjectConsole |
RATLC00370393/ No APAR |
After a migration from a previous ProjectConsole release to release 2003.06.00, the log file directory is incorrectly set to: ・Rational\ProjectConsole\logs\Collector instead of ・Rational\ProjectConsole\logs This means that a collector and a server directory are created in the logs\Collector directory to store the log files. Workaround:
|
Dashboard |
RATLC00370037/ No APAR |
If you select the View > Auto Arrange menu option in the ProjectConsole Dashboard, the metric displays in an open panel are arranged automatically. If you subsequently save the panel without making any other changes, the arrangement is not saved. Workaround: After you select View > Auto Arrange, make some other change (such as size or a property value) to a metric display and then save the panel. The arrangement is saved. |
Dashboard Designer |
RATLC00369958/ No APAR |
If you start the ProjectConsole Dashboard and Designer using Microsoft Internet Explorer 5.5 (SP2), an error message indicating that an ActiveX control cannot be run is displayed. Workaround: Ignore the ActiveX error message. |
ProjectConsole Template Builder |
RATLC00370695/ No APAR |
A Microsoft Word 2000 template that is upgraded to Microsoft Word 2002 can produce graphics that are sized incorrectly. This is caused by the Word upgrade process, which may reset the display size to a default too small for the graphic. Workaround: Manually reset the graphic to the correct size. |
ProjectConsole installation |
RATLC00370658/ No APAR |
Do not install the ProjectConsole Web Server components on machines with host names that contain an underscore. A security patch for Microsoft Internet Explorer versions 5.5 and 6.x causes cookies to be rejected from machines with host names that contain an underscore. If you try to log in to a ProjectConsole server that has an underscore in the hostname, the browser window continuously reloads and the login page is not displayed. Workaround: Remove the underscore character from the server hostname. |
ProjectConsole ProjectConsole Template Builder |
RATLC00371433/ No APAR |
When configuring a report node in the ProjectConsole navigation tree, you can either specify a user ID and password to be used, or not. If you leave the User ID and Password fields empty, ProjectConsole uses the username and password of the logged-in user to generate the artifact report. ProjectConsole also uses the username and password of the logged-in user for every OPEN statement in the artifact report template. Workaround: If your report template contains multiple OPEN statements, you must configure each data source to accept the same username and password. |
Designer |
RATLC00371610/ No APAR |
Using supported version of Netscape 7 on supported version of Solaris 8 with the Sun Java 1.4.1 plug-in, some of the
text fields in the Designer become non-editable. If you open the Java
console window, the fields become editable. There are two known workarounds
for this problem:
|
Maintenance Tool |
RATLC00371712/ No APAR |
If an administrator uses the ProjectConsole Maintenance Tool to create a new data repository, or to connect to a different repository, the start page may get updated as well. In some cases, client browsers cache the original start page so that after users log in to the site, they see the old start page. Workaround: Users must delete the temporary cached pages from their browsers. |
ProjectConsole |
RATLC00371403/ No APAR |
Running a FileSys-based artifact template on a remote server is not supported. � To use the FileSys/Directory template to view files, you must specify the ProjectConsole server as the report server on the Add Node or Edit Node form. |
Maintenance Tool |
RATLC00371308/ No APAR |
If a data warehouse migration fails because the ProjectConsole schema is checked out, then use the following steps to check in the schema:
After you perform these steps, start the ProjectConsole Maintenance Tool and migrate the data again. For more information, see the printed document "IBM Rational Suite Upgrade Guide." |
Dashboard |
RATLC00371387/ No APAR |
If you have the Dashboard running, and you are inactive for a period of time (the default is one hour), the log-in session expires and you must log in again to continue working. Certain operations, such as expanding a tree node or creating a chart, are done entirely in the client browser, or through the Dashboard data warehouse. Such operations work even after your session has expired. However, once you perform an action that requires a response from the server, you are notified that your session has expired and you are prompted to log in again. Workaround: If you are a ProjectConsole administrator, you can specify a longer session timeout interval. For instructions on changing the session timeout interval, see the topic 鉄etting the session timeout interval for work sessions・in the Designer Help. |
ProjectConsole |
RATLC00371187/ No APAR |
If you use the Select Groups and Users window to modify the security settings for a node in the navigation tree, clicking OK, this does not save your changes even though they are displayed on the Add Node or Edit Node form.� To save the changes, you must click Save at the bottom of the form. |
Dashboard |
RATLC00371846/ No APAR |
If you use an apostrophe in a folder name in the Dashboard, and you then publish a panel or metric display from that folder, the resulting published display(s) will not be shown. Workaround: Do not use apostrophe characters in folder names in the Dashboard. |
Maintenance Tool |
RATLC00371790/ No APAR |
You cannot use non-ASCII characters in the name of a repository when migrating data. Workaround: Migrate data to a repository with ASCII characters only, and then copy the migrated repository to a repository with non-ASCII characters in the name. |
ProjectConsole |
RATLC00371851/ No APAR |
After you exceed the maximum number of login attempts, an error message is displayed to indicate that the server must be restarted. This message is incorrect. Workaround: Close your browser window, and then try to log in again. |
Maintenance Tool |
RATLC00371869/ No APAR |
For performance reasons, we recommend that you use the -x operand when configuring the SQL Anywhere server. On the Configuration page of the Service Properties dialog box in Sybase Central, use -x protocol, where protocol is one protocol or a comma-separated list of protocols. Possible values are: ALL, Named Pipes (or NP), NONE, SPX, and TCPIP (or TCP). |
Dashboard Designer |
RATLC00371865/ No APAR |
The following applies to users who have the Java 1.3.0_01 plug-in version installed: After you first start the Dashboard or the Designer, and the security dialog box opens, select the Grant Always check box. This will ensure that the Dashboard and the Designer continue to work. Otherwise, you may see unexpected behavior in the Designer. If the problem persists, uninstall the current version of the Java plug-in, and then start the Designer or the Dashboard. You are then prompted to install the 1.4.1 version of the plug-in. |
ProjectConsole |
RATLC00371891/ No APAR |
If you try to generate an artifact report and the underlying report template cannot be located, ProjectConsole does not generate the report, and displays no error message to address the failure. (In some cases, an error message is displayed.) Workaround:� Instead of entering a template name manually on the Add Node and Edit Node forms, use the Browse button to select a report template. Also, after you migrate data from a previous release, verify that any custom templates you created were successfully migrated to the new templates folder. |
ProjectConsole |
RATLC00372131/ No APAR |
The shortcut menus for nodes in the navigation tree are not supported on Linux platforms. |
Maintenance Tool |
RATLC00371949/ No APAR |
If you use the ProjectConsole Maintenance Tool to create a new repository or connect to a different repository, the artifact report cache is not cleared. If the old and new data repositories contain the same report nodes, ProjectConsole may open some of the old cached pages. Workaround: Any time you connect to a new repository, delete the contents of the ...\Rational\Common\webapps\ projectconsole\generated\soda folder. |
ProjectConsole |
RATLC00372038/ No APAR |
In this release, an http: Link URL is only supported for a folder node if you have selected the Display page in a new window check box. |
ProjectConsole |
RATLC00372039/ No APAR |
If you create a folder node and associate it with a URL using an ftp:// protocol, you must configure the Web page to open in a new window. If the URL opens in the right frame instead, your browser session cannot process any more ProjectConsole requests. Workaround: Whenever you create a folder node and associate it with a URL using an ftp:// protocol, on the Add Node form, select the Display page in a new window check box. |
ProjectConsole |
RATLC00372036/ No APAR |
In the navigation tree, if you try to delete a node that points to a Microsoft document (Microsoft Word, Microsoft Excel, Microsoft Project, Microsoft PowerPoint, and so on), while that document is open in the right frame, an error occurs. Workaround:
|
ProjectConsole |
RATLC00372207/ No APAR |
After you configure your Web site to use Secure Socket Layer (SSL), you cannot generate artifact reports or run the update.bat script until you import the security certificate into the certificate keystore on the ProjectConsole server. Workaround:
|
ProjectConsole Template Builder |
RATLC0046972/ No APAR |
On a non-English operating system, diagram images extracted from Rose RealTime are missing, cropped or scaled incorrectly if the 溺easurement units・setting in Microsoft Word is set to "Centimeters." Workaround: Change the unit of measurement in Word.
|
ProjectConsole |
RATLC00372330/ No APAR |
The Rational Unified Process Software Architecture Document listed in the ProjectConsole Tool Mentor titled 鄭dding Rational Unified Process Templates to the ProjectConsole Navigation Tree,・is not available. |
ProjectConsole |
RATLC00372332/ No APAR |
If you perform the steps provided in the ProjectConsole Tool Mentor titled 鄭dding Rational Unified Process Templates to the ProjectConsole Navigation Tree,・ and then click the report node you created in this exercise, an error occurs. Note: This error only occurs with the Rational Unified Process User-Experience Storyboard Report template. Workaround: Before you run the Rational Unified Process User-Experience Storyboard Report template (click the report node):
|
ProjectConsole Installation | RATLC00450993/ No APAR |
When installing Rational Suite to a network release area, the ProjectConsole
Web server components should not be selected. If they are, every user who
installs from that release area will get the ProjectConsole Web server
components (and Rational Web Platform) software loaded and running on their
computers. In addition, when applying a service release to a 2003.06.00 Rational Suite release, you may receive one or more "Source File Not Found" warnings about files in the ...\Classics\Projects\... folder. These warnings can safely be ignored, as they are only used by the ProjectConsole Web server components when accessing the ProjectConsole sample site. For more information, read the "IBM Rational Software Server Products
Installation Guide." |
Component |
Defect Number/ APAR |
Description |
ProjectConsole | RATLC00373099/ No APAR | In the ProjectConsole Dashboard, if a panel or chart
has a name that contains the ":" (colon) character, you cannot
publish the panel or chart. Workaround: Do not use the ":" character in a panel or chart name. |
ProjectConsole | RATLC00373216/ No APAR | You cannot use double-byte characters in the name of a
ProjectConsole data repository. Workaround: Use ASCII names for your data repositories. |
ProjectConsole
Designer ProjectConsole Dashboard |
RATLC00373247/ No APAR | In the ProjectConsole Designer, if you delete a measure or dimension field from a measure table, and the field is only updated using a transformation script, ProjectConsole does not perform cross-reference checking. Any Dashboard chart, gauge, or indicator that displayed the deleted measure is no longer valid. |
ProjectConsole Maintenance Tool | RATLC00373512/ No APAR | After you use the ProjectConsole Maintenance Tool to
create or copy a ProjectConsole repository, ProjectConsole automatically
connects you to the new copy of the repository. Workaround: To remain connected to the original repository, after the copy/create operation is complete, use the ProjectConsole Maintenance Tool to connect to it manually. |
ProjectConsole TemplateBuilder | RATLC00959336/ No APAR | The Template Builder annotations are shown as Fields in WordXP. Before doing any Template Builder operations (save Web page, test Web page, etc.), the annotations must be hidden. If the annotations are not hidden, TemplateBuilder will report errors. This is a known limitation in Template Builder while working with WordXP. |
Component |
Defect Number/ APAR |
Description |
ProjectConsole | RATLC00724000/ No APAR |
Users are unable to connect to the ProjectConsole repository created
with SQLAnyWhere database.
Solution: Add a parameter to
SQL Anywhere service for the data warehouse so that it runs on a
different port. Add For more information, read the "IBM Rational Software Server Products
Installation Guide." |
ProjectConsole | RATLC00376592/ No APAR |
ProjectConsole does not currently support running remote collection and
report generation agents on a machine that has firewall software running
on it. By default, Windows XP SP2 has a firewall enabled. Therefore, you
should not attempt to use a Windows XP SP2 machine as a remote
collection and report generation server.
You can install the ProjectConsole Web server on Windows XP SP2 with the firewall enabled if you follow the steps required to configure ProjectConsole to work in a firewall enabled environment. This is documented in the online help for the ProjectConsole Maintenance Tool. |
ProjectConsole | RATLC00726174/ No APAR | In the 2003.06.13 release, ClearQuest converted to use a new set of DataDirect ODBC database drivers. As a result, some of the configuration parameters used to connect to a ClearQuest database were changed. Since ProjectConsole uses a ClearQuest database for the data warehouse, the parameters required to connect to a ProjectConsole data warehouse changed as well. For more information, read the "IBM Rational Suite Upgrade Guide." |
ProjectConsole Dashboard | RATLC00373099/ No APAR |
Within the Dashboard applet, if one of your panels or charts contains a
":" character in the name, you will not be able to publish the panel or
chart. Workaround: Do not use ":" characters in the name of a panel or chart. |
ProjectConsole | RATLC00373216/ No APAR |
Currently, you are unable to use double-byte characters in the name of a
ProjectConsole data repository. Workaround: Use ASCII names for your data repositories. |
ProjectConsole Dashboard Designer | RATLC00373247/ No APAR | When you delete a measure or dimension field from a measure table using the ProjectConsole designer where the field is only updated using a transformation script, there is no cross reference checking performed. If you previously had a Dashboard chart, gauge, or indicator displaying the deleted measure, that chart will no longer be valid. |
ProjectConsole Template Builder | RATLC00717594/ No APAR | When running ProjectConsole artifact reports against TestManager repositories, you may not get prompted to select a TestManager Project if you try to run TestManager on the ProjectConsole server machine. This is a limitation of TestManager. Avoid running TestManager interactively on the ProjectConsole server. |
ProjectConsole Dashboard Designer | RATLC00723384/ No APAR |
Microsoft Project, like IBM Rational Rose, requires the "interact with
desktop" flag to be set on the collector and/or report server service in
order for Rational Suite Extensibility to launch the application. In
order to set that flag on the service, the service needs to be run under
the "local system" account. But, services running under the "local
system" account do not have access to remote resources via either mapped
drives, or a UNC path. Therefore, ProjectConsole cannot collect metrics, or generate reports, from either Rose models, or Microsoft Project files, unless the model or project file is on the local file system. |
The Rational ProjectConsole Maintenance Tool Help is missing the following information:
If you use the Maintenance Tool to connect to a ProjectConsole repository (new or existing) other than the one to which you are currently connected, you must first remove generated reports that have been stored in the ProjectConsole report cache.
To empty the report cache:
...\Rational\Common\rwp\webapps\projectconsole\generated\soda
The IBM software support Internet site provides you with self-help resources and electronic problem submission. The IBM Rational Software Support Home page can be found at http://www.ibm.com/software/rational/support/.
Voice Support is available to all current contract holders by dialing a telephone number in your country (where available). For specific country phone numbers, go to http://www.ibm.com/planetwide/.