IBM Rational ProjectConsole Release Notes

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.

Legal Notices Information


Scope

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:

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.

 

Contents

What's New in This Release?

Product Documentation

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

What's New in This Release?

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.

Rational ProjectConsole Web site

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.

Common Web platform

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.

Hardware and Software Support features

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.

ProjectConsole services installed as Windows services

Now, when you install ProjectConsole, its server processes are installed and run as Microsoft services.

Firewall/SSL/HTTPS support

You can now log in to ProjectConsole within a firewall environment.

DataDirect Drivers

See the ProjectConsole Service Release Notes.

Level 2 Internationalization support

ProjectConsole now handles double-byte characters and provides level 2 support for German, French, Dutch, Italian, Hebrew, Swedish, Traditional and Simplified Chinese, and Japanese.

New Administration section

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.

Access Control List security access model

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.

Run the Dashboard and the Designer at the same time

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.

Customizable workspace in the ProjectConsole navigation tree

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.

Improved administration

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:

Microsoft Project 2002 support

ProjectConsole now supports collecting and reporting from Microsoft Project Standard and Professional 2002.

New and redesigned artifact report templates

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.

New report templates for TestManager and cross-product measurements

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.

Simplified report generation

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.

Cut/copy/paste

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.

Logo toolbar

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

Operations toolbar

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.

RUP-based ProjectConsole sample site

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.

Repository Databases

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.

Tutorial

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

Designer

Administrator and Designer merged

The Administrator and Designer applets have been merged into a single applet in Version 2003.06.00 – the Designer.

Schedule and run tasks

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.

Storing the latest data collection

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.

Modified data transformation features

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.

 

Dashboard

Advanced security management (access control lists)

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.

Expanded publishing

You can now publish all charts and indicators from the Dashboard.

Enhanced control of panels and metric displays

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.

New out-of-the-box metric display samples

The ProjectConsole sample site comes with a new set of metric display samples that you can reuse for your own projects.

New chart formats and features

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 in the Dashboard

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.

 

ProjectConsole Maintenance Tool

New migration tool

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

Enhanced data management: ProjectConsole repository

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.

Simplified services configuration

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.

Rational Software Solutions Knowledge Base

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:

  1. Go here to search IBM Rational software support for Technotes.

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

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

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

  5. To see the detailed description of a Technote in the list, click the underlined text in the Technote.

  6. After reviewing the information in a Technote, click the Back button in your browser to return to the "Search results" page.

ProjectConsole Template Builder

This section provides information about changes made to ProjectConsole Template Builder in this release.

Support for Microsoft Project 2002 and Rational XDE version 2003

You can now use Template Builder to report on Microsoft Project 2002 and Rational XDE version 2003.

Refresh Command

The new Refresh command on the ProjectConsole menu reloads dynamic schema changes made to a point product since you last opened Template Builder.

Help on Domains

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.

 

Product Documentation

Using IBM Rational Documentation

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:

Technical articles and white papers at IBM developerWorks Rational

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.

White papers on the ProjectConsole Web site

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):

  1. In the ProjectConsole navigation tree (in the left frame), expand the ClassicsCD.com Projects node (click + next to the node).

  2. Expand the Additional ProjectConsole Resources node.

  3. Expand White Papers, and then click one of the following titles:

ProjectConsole Tutorial

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:

To access the Rational ProjectConsole Tutorial:

  1. In the ProjectConsole navigation tree (in the left frame), expand the ClassicsCD.com Projects node (click + next to the node).

  2. Expand the Additional ProjectConsole Resources node.

  3. Click ProjectConsole Tutorial.

To open a section of the tutorial, scroll through the Rational ProjectConsole Tutorial page, and click the section title.

Getting Started

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.

Glossary

To access the updated ProjectConsole Glossary of Terms from the ProjectConsole main Web site, on the Logo toolbar, click Glossary.

Hardware and Software Information

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.

Client Requirements

Hardware Requirements

There are no product-specific hardware requirements for clients used to log in to ProjectConsole.

Software Requirements

Web clients on Windows platforms:

Web clients on non-Windows platforms:

Server Requirements

Hardware Requirements

Software Requirements

ProjectConsole server

Additional collection support:

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:

Template Builder

Installation and Licensing

Installation Information

Microsoft Windows 2000 NTFS "Change Journal" defect can cause file system corruption during installation of Rational products

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:

  1. Disable all virus detection software

  2. Read IBM Support Technote 1135295. Go to http://www-1.ibm.com/support/us/search/index.html and search for "Rational Installer Change Journal."

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

Open Transaction Manager (otman) Incompatible with Rational products installer

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:

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

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

Compatibility Issues

This section identifies special considerations for using ProjectConsole and ProjectConsole Template Builder with other Rational products and with third-party products.

With Rational Products

XDE

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.

ClearQuest

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.

TestManager

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.

With Third-Party Products

Netscape

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.

Graphics Cards and Java 1.4.1/1.4.1_01

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:

  1. Open the Windows control panel.

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

  3. Click the Advanced tab.

  4. In the Java Runtime Parameters box, type "-Dsun.java2d.noddraw=true" in the field

  5. Click Apply, and then close the Java Plug-in Control Panel window.

  6. Restart all browser windows.

Note:  This problem will be fixed in the 1.4.1_02 JRE.

Required Browser Settings

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

Microsoft Windows XP Service Pack 2 (SP2) Security Measures for ProjectConsole Web Client

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:

HTML with active content

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:

Firewall issues

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:

  1. Click Control Panel > Internet Connection Firewall > Exceptions Tab.
  2. Click Add.
  3. Select a program radio button.
  4. Browse to rational.exe (typically located at C:\Program Files\Rational\Common).
  5. Add a Description, click OK, and click OK again until you return to the Internet Connection Firewall window.
  6. Repeat the previous steps to add lmgrd.exe (C:\Program Files\rational\common\) to the Exceptions tab.
    Note: Make sure that the two items added in Steps 5 and 6 are selected in the Programs and Services box in the Internet Connection firewall window.
  7. Click OK. You might need to restart your computer.

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. 

Restrictions and Guidelines on Using Rational ProjectConsole

There are no known restrictions associated with this product.

Known Issues and Change Requests

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. 

v2003.06.01

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:

  • Copy from Oracle to another vendor such as Microsoft Access, and then copy from that database into your new Oracle database.

  • Use the ClearQuest Maintenance Tool to copy the schema repository and the ClearQuest Designer to copy the data warehouse.

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

  • For a FileSystem-based artifact report, use the toggle at the top of the page to control where the external files are displayed.

  • For a folder node that points to a Microsoft Project file using a local URL, select the Display page in a new window check box in the Add Node or Edit Node form.

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:

  • LocalSystem account if a valid ClearCase user is logged into the ProjectConsole server

  • A valid ClearCase user if a non-ClearCase user is logged into the ProjectConsole server

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:

  1. Start the ProjectConsole Maintenance Tool.

  2. Leave the first option "configure services" selected and click Next.

  3. Remove 鼎ollector・from the log file directory field.

  4. Click Finish.

  5. Restart your ProjectConsole server machine.

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:
  1. Run the designer applet from a windows machine.
  2. Copy the designer.jar file from a Windows machine to your Solaris machine and run the designer as an applicaton (java -jar designer.jar).

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:

  1. Start the ClearQuest Designer.

  2. In the Rational ClearQuest Schema Repository dialog box, in the Schema Repository list, select Dashboard.

  3. Log in as the last ProjectConsole user who checked out the schema. (If you are not sure who that is, log in as a ProjectConsole administrator and you can see who checked the schema out.)

  4. Check in the schema.

  5. Upgrade the data warehouse. (In the ClearQuest Designer, click Database > Upgrade Database.)

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:

  1. Click a different node in the tree.

  2. Delete the node without opening the document first.

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:

  1. Open a command prompt window in the ...\rational\common\java\jre\lib\security directory.

  2. Copy your security certificate into that directory.

  3. Make sure that the cacerts file is not write-protected.

  4. Import the security certificate into the cacerts keystore.

keytool -import -keystore cacerts -file your_trusted_certificate.crt

Note:  The default password for the cacerts keystore is "changeit".

  1. Restart the ProjectConsole server.

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.

  1. In Word, click Tools > Options.

  2. In the Options dialog box, click the General tab.

  3. In the Measurement units list, select Inches or Millimeters.

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):

  1. Open the rup_user-experience_storyboard_report.doc template file, which is located in the ・Program Files\Rational\ProjectConsole\templates\Rose folder.

  2. Click ProjectConsole > Save Web Page.

  3. Click OK to close the dialog box that tells you that the rup_user-experience_storyboard_report.htm file was created.

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

v2003.06.12

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.

v2003.06.13

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
"-x TCPIP(ServerPort=3644)" to parameters for the service and everything works perfectly.

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.

 

Documentation Updates

Rational ProjectConsole Maintenance Tool Help

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:

Contacting IBM Rational Software Support

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