Version 2003.06.00
Copyright © 2003 Rational Software Corporation. 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 Rational
Software 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, including compatibility issues.
This document provides
information about Rational ProjectConsole 2003.06.00 and Rational
ProjectConsole Template Builder 2003.06.00.
For information about known
issues resolved in this release, contact Rational
Customer Support.
Installation,
Upgrading, and Licensing
Upgrading from Previous Versions
of ProjectConsole
Restrictions
and Guidelines on Using ProjectConsole
Known
Issues and Change Requests
Contacting
Rational Technical Support
This
section provides information about new and enhanced features included in
Rational ProjectConsole 2003.06.00 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.
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.
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.
ProjectConsole
now handles double-byte characters and provides level 2 support
for German, French, Dutch, Italian, Hebrew, Swedish, Traditional and Simplified
Chinese, Japanese, and Korean.
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, and then, 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. This toolbar also features the Online properties tab, which you can use to connect to the
Rational corporate Web site home page and product page, as well as the Rational
Developer Network. 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.
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.
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 Rational Customer 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.
Folders
and panels in the Dashboard navigation tree now have shortcut menus that administrators
can use to:
·
Create
and rename folders
·
Cut,
copy, and paste panels and folders
·
Delete
panels and folders
·
Set
access control list (ACL) properties for folder nodes and their child nodes
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 a previous
version of ProjectConsole.
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 all
information about the navigation tree structure for the ProjectConsole Web
site, as well as user and group authorization information.
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:
1.
Go to http://solutions.rational.com/solutions/search.jsp.
2.
Under Search by Product and/or Keyword(s), in the
products list, select ALL PRODUCTS.
3.
In the Enter keyword(s) box, type a key word such as
“ProjectConsole,” “Dashboard,” or “Designer.”
4.
To refine your search, select an item in the Search Using list.
5.
Click Search.
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.
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
format):
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:
·
Practical
Measurement in the Rational Unified Process
·
Sample Project
Measures
·
Sample Microsoft® Project
Measures
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 (available on Rational Developer Network)
·
Section 13 – Creating a Report that
Includes a Metric Display
·
Section 14 – Creating a Report on XDE
Artifacts (available on
Rational Developer Network)
·
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:
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.
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 for Windows
ProjectConsole does not
support earlier versions of Netscape Navigator.
Web clients on non-Windows platforms
·
Netscape® Navigator 7.0 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 (TM) 2.6, 7 – 9
·
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:
o
Windows
NT® 4.0 Server or Workstation (SP6a with SRP)
o
Windows® 2000 Server or Professional (SP2, SP3)
o
Windows® 2000 Advanced Server
o
Windows® XP Server or Professional (SP1)
·
Rational
Suite version 2003.06.00
·
Microsoft® Word 2000 (SP1)
·
Repository
databases (supports the same vendor databases as ClearQuest):
o
IBM
DB2® 7.1, 7.2 (FixPack
8), 8.1
o
Microsoft® SQL Server 7.0 (SP4), 2000 (SP2, SP3)
o
Sybase
SQL Anywhere 5.5.05 (rolling upgrades only), 8.0.1 (new and copied databases)
o
Oracle® 8.0.5, 8.1.6, 8.1.7
o
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
Rational
has determined that under certain circumstances file system corruption can
result from installing Rational Version 2003 products on Windows 2000 to an NTFS partition that has the Windows "Change
Journal" (log) enabled on it. Therefore, the Rational Installer will
not install to such partitions. Rational is actively working with
Microsoft to better understand, repair, and/or work around the problem.
Before
installing any Rational Version 2003 product on a computer running Windows
2000, please read Rational Solution 182435434 at http://solutions.rational.com/solutions/display.jsp?solutionId=182435434
for the latest information. Alternatively, you can search the Rational
Solutions Knowledge Base at http://solutions.rational.com/solutions for the
text "Change Journal".
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 may re-install the product that includes the otman
driver.
For
more information, contact Rational Customer Support.
For
more information about installing the Rational ProjectConsole software for the
first time, see the printed manuals Rational® Software Server Products Installation Guide and Rational® Software Desktop Products Installation Guide.
ProjectConsole
was introduced in Version 2002.05.00. If
you are upgrading from that version, perform the following steps. For more
information, see the printed manual Rational Suite®
Upgrade Guide.
To migrate data collected using a previous version of
ProjectConsole for use with ProjectConsole 2003.06.00, perform the following
high-level tasks:
1.
Prepare to upgrade the database server.
2.
Back up new and changed files.
3.
On your ProjectConsole server machine, uninstall
2002.05.00.
4.
Install ProjectConsole 2003.06.00 on your ProjectConsole server
machine.
5.
Restore from backup the files you saved before the
upgrade.
6.
Use the ProjectConsole Maintenance Tool Version 2002.05.00
to migrate data from the existing data warehouse.
7.
Check for, and fix, any errors that occurred during data
migration.
8.
Perform post-migration steps.
To
prepare to upgrade ProjectConsole:
1.
Ensure that users are not connected to Rational
products or their associated datastores. (Either instruct them to disconnect
or, from each server, disconnect all users.)
2.
If the ProjectConsole schema is checked out, check it in:
a.
Log in to ProjectConsole and start the ProjectConsole
Designer.
b.
On the Designer menu bar, click Schema to see whether
the Check Out command is available.
If
this command is available, then the schema repository is already checked in.
c.
If the Check Out command is unavailable, then click Check In.
d.
Upgrade the warehouse if prompted to do so.
Note: You cannot
upgrade the ProjectConsole data if the schema is checked out. For more
information, see the Rational ProjectConsole Designer Help.
3.
On the ProjectConsole server, stop the following services:
·
World Wide Web (WWW) Publishing
service – Change the Startup Type for the WWW service to Disabled or Manual.
·
Default Web server under Internet Information Server
·
Tomcat Web server, if it is running
·
ProjectConsole servers and xmlagents.exe
4.
Back up changed and user-defined files in the following
directories:
…\rational\jakarta-tomcat\webapps\ProjectConsole
…\rational\ProjectConsole
User-defined
files to check would include:
·
Template files in:
…\Program
Files\Rational\ProjectConsole\templates
·
Transformation scripts, configuration (.ini) files, and
batch files in:
…\Program
Files\Rational\ProjectConsole\bin
·
Start.htm and associated image files in:
…\Program
Files\Rational\jakarta-tomcat\webapps\ProjectConsole\
·
Any user-created pages in:
…\Program
Files\Rational\jakarta-tomcat\webapps\ProjectConsole
·
Published views in …\Program Files\Rational\jakarta-tomcat\webapps\ProjectConsole\PublishedViews
Note: When you remove Rational Suite, the files
that have been installed by ProjectConsole, including files you have modified,
are removed from your system. Back up the files you modified and those you
added to a different directory (one that is not used by Rational products) so
that you can retrieve them later. For future reference, record the location of
your backup on the following line:
Backed-up ProjectConsole files: ___________________________________________
5.
In Version 2003.06.00, start pages are displayed, but root
pages are not. If your current installation includes
both types of pages, consider combining them into a single start page.
6.
Use database vendor tools to back up the schema repository
and warehouse databases. Alternatively, use the ProjectConsole Maintenance Tool
to copy the original databases to another set of databases.
Note: ProjectConsole data migration occurs in place, replacing
the earlier versions of your data. If you do not back up the schema repository
and warehouse, you have no recourse if you need the earlier version of the data
later.
7.
Write down the connection locations for the schema
repository and data warehouse databases.
Follow
these steps only if you have a one-system environment with SQL Anywhere server
and ProjectConsole servers on the same computer. For information about
upgrading an environment in which SQL Anywhere server and ProjectConsole
servers are on separate computers, see Upgrading
a two-system environment.
1.
Stop the SQL Anywhere 5.0 service
2.
Back up all of your SQL Anywhere 5.0 databases.
Note: When you are
prompted for the connection parameters, enter “dba”
for the database user ID and “sql” for the password.
For more information, see the SQL Anywhere Help. From
Sybase Central, click Help > SQL Anywhere Help. Click Using the SQL Anywhere Utilities > Backing up a database.
3.
Back up the SQL Anywhere 5.0 server software. (Copy the
files in …\Program Files\Rational\SQLAny50\win32 to another folder and record
the name of this folder.)
4.
Uninstall Sybase SQL Anywhere Database Server 5.0 on the
database server host.
5.
If earlier versions of Rational
software are installed on the database server host, uninstall that software.
Before
you upgrade to a new version of Rational software,
remove all existing Rational software from your computer. For information about
how to do this, see Removing Rational
Products in the printed document Rational
Suite Upgrade Guide.
Use
the new Rational Software Setup program to install Rational Suite on the
ProjectConsole server. Make sure that you install all ProjectConsole
components, including the ProjectConsole Web server component. During this
installation, SQL Anywhere 8.0, the report server, and collection agents are
installed automatically. For more information, see the printed document Rational Software Server Products
Installation Guide.
After
you install a Rational product, if your computer does
not have licensing configured, the License Key Administrator wizard starts up.
If you use a floating license, click Point to a Rational License server to get
my licenses, and then follow the wizard steps.
Note: For information about the license server to
use, see “Saving License Server Name” in the printed document
Rational Suite Upgrade Guide.
Perform the following set of
steps to upgrade a one-system environment (SQL Anywhere and ProjectConsole
servers are on the same machine). For information about how to upgrade a
two-system environment, skip to Upgrading
a two-system environment.
1.
Restore SQL Anywhere 5.0 server software on the server
machine by copying the files you backed up earlier to …\Program
Files\Rational\SQLAny50\win32.
Note: If you are prompted to confirm that you want
to overwrite existing files, click Yes.
2.
Start the SQL Anywhere 5.0 service.
3.
For both the schema repository
and data warehouse, update the SQL Anywhere 5 databases so that the SQL
Anywhere 8 server can have access to them. Open a DOS command line window and
enter the following command:
installutil preparedbforupgrade SQL_ANYWHERE
server database admin admin “SERVER_VER=5.0”
where:
server is the database service name
database is the full path to the schema repository or data warehouse
admin is the standard user name and password
for SQL Anywhere database owners
4.
Stop, and then disable the SQL Anywhere 5 service.
5.
To create and start the new SQL Anywhere 8.0 service:
a.
From Sybase Central, under Adaptive Server Anywhere 8,
click Services.
b.
In the right pane, double-click Add Service.
The
Create New Service wizard starts up.
c.
Use the wizard to create and start the new SQL Anywhere
8.0 service.
On
the Parameters page, enter the following
operands:
–n
servername
–gd all
–x
protocol
where protocol is one
protocol or a comma-separated list of protocols.
Possible
values are: ALL, NamedPipes (or NP), NONE, SPX, and TCPIP (or TCP)
1.
On SQL Anywhere 5 server, make sure that SQL Anywhere
server is running.
2.
From Sybase Central, open the Services folder.
Note: Make sure that the green light is on next to
the server.
3.
For both the schema repository and the data warehouse,
update the SQL Anywhere 5 databases from ProjectConsole server (which has Rational
Suite Version 2003.06.00), so that the SQL Anywhere 8 server can access them.
Open a command prompt window and enter the following command:
installutil preparedbforupgrade SQL_ANYWHERE server
database admin admin “SERVER_VER=5.0”
where:
server is the database service name
database is the full
path to the schema repository or data warehouse
admin is
the standard user name and password for SQL Anywhere database owners
Warning: If you do not run this command before stopping
the SQL Anywhere 5.0 service, you cannot reconnect to the schema repository and
warehouse later.
4.
Stop the SQL Anywhere service on the SQL Anywhere 5
database server.
5.
On the database server host, uninstall Sybase SQL Anywhere
Database Server 5 and any earlier version of Rational
software.
6.
On the same database server host, use the Rational Setup
Wizard to install the SQL Anywhere 8.0 server component. After the wizard
prompts you to select a product, click Sybase SQL Anywhere Database Server.
7.
To create and start the new SQL Anywhere 8.0 service:
a.
From Sybase Central, under Adaptive Server Anywhere
8,
click Services.
b.
In the right pane, double-click Add Service.
The
Create New Service wizard starts up.
c.
Follow the wizard to create and start the new SQL Anywhere
8.0 service. On the Parameters page, enter
the following operands:
–n servername
-x tcpip
-gd all
In the section Preparing to upgrade ProjectConsole, you backed up
ProjectConsole files that were added or changed. To restore these files, do the
following:
1. Copy the
modified and added files in …\Program
Files\Rational \jakarta-tomcat\webapps\projectconsole
to the …\Program Files\Rational\common\rwp\webapps\ProjectConsole directory.
2. Copy the Rational\ProjectConsole modified
files to the newly installed directories.
3. If you backed up transformation scripts,
configuration files (.ini)
or batch files, restore them to the …\Program
Files\Rational \ProjectConsole\bin directory.
To migrate data used in an
earlier version of ProjectConsole:
1.
Click Start > Programs > Rational Software > Rational
ProjectConsole > Rational ProjectConsole Maintenance Tool.
2.
On the first page of the Maintenance Tool, click Migrate data
from a previous version of ProjectConsole, and then click Next.
3.
On the next page, in the Database type list, select
the database vendor for the schema repository and warehouse databases that
contain the data you want to migrate.
Note: The available fields vary,
depending on the database type you choose.
4.
Specify the required database information, and then click Next.
5.
On the next page, perform the following steps:
a. In the New repository
name box, type a name for the new ProjectConsole repository for your
migrated data.
b.
In the Old install location box, if the installation path
for the previously installed version of Rational ProjectConsole was different
than the default path, then enter the correct path.
c.
In the New install location box, if the installation path
for the currently installed version of Rational ProjectConsole is different
than the default path, then enter the correct path.
6.
Click Finish.
After
data migration is competed, read the migration log to make sure that no errors
or exceptions occurred. The migration information is displayed on the status
page (last page) of the ProjectConsole Maintenance Tool. This information is
also saved to a file named PjsSetup.log, which is located in the …\Program
Files\Rational\ProjectConsole\bin directory. If you notice an error or
exception, address the problem before proceeding.
If you plan to use Universal
Naming Convention (UNC) paths on your ProjectConsole
Web site to access source templates or tasks on remote computers, you must
change the Rational Services Logon information. By default, the services run as
the Local System user. Configure them to run as a domain user with access to
the correct remote computer.
To configure the services:
·
Start
from the Services window of the Microsoft Management Console.
For
each of the following services, change the logon information, if it is
required:
Rational
ProjectConsole Collection Server
If you plan to run collection
tasks that access data repositories (Rose, TestManager, Microsoft® Project, text, and so on) stored on a remote computer, and the
tasks use a mapped network drive or a UNC path to
access those repositories:
·
Configure
the Rational ProjectConsole Collection Server service to log on using a named
account that has access to the remote resources.
Rational
ProjectConsole Dashboard Server
If you use either Microsoft® Access or SQL Anywhere for your data warehouse, and the databases
(.mdb or .db files) are accessed using a mapped
network drive or a UNC path:
·
Configure
the Rational ProjectConsole Dashboard Server service to log on using a named
account that has access to the remote resources.
Rational ProjectConsole
Report Server
If you
plan to set up report nodes on the ProjectConsole Web site that access data
repositories (Rose, TestManager, Microsoft® Project, text, and so on) stored on a
remote computer, and the report nodes use a mapped network drive or a UNC path to access the remote computer:
·
Configure
the Rational ProjectConsole Report Server service to log on using a named
account that has access to the remote resources.
Rational Web Platform,
servlet engine
If you plan to set up report
nodes on the ProjectConsole Web site that use the File System template to
display a list of files stored on a remote computer, and the report nodes use a
mapped network drive or a UNC path name to access the
remote computer:
·
Configure
the Rational Web Platform, servlet engine service to log on using a named
account that has access to the remote resources.
Note: After you setup the collection server service
or the report server service to run as a named account that has access to
remote machines, you can no longer collect data from Rose models or generate
artifact reports on Rose models.
If you plan to collect Rose model artifacts or generate
artifact reports on Rose models, you need to configure the Rational
ProjectConsole Collection Server and Rational ProjectConsole Report Server
services as follows:
1.
Log on using the Local System account.
2.
Select the Allow service to interact with desktop check box.
We
recommend that you use a separate agent machine for all Rose artifact
collections and for Rose artifact report generation.
If you plan to run collections on ClearQuest databases,
you must re-establish the connection to these databases. This connection was
lost when you uninstalled Rational ClearQuest.
To re-establish the connection to ClearQuest databases:
·
Start
the Rational ClearQuest Maintenance Tool, and then do one of the following:
o
If
you have saved the ClearQuest connection information to a profile, click File >
Import Profile, and then
enter the profile name.
o
If
you do not have a connection profile, click Connection > New, and then provide the connection
information.
To complete the ProjectConsole upgrade, check the
following items on your Web site.
Broken icon images
Check the navigation tree on the main page for broken
icons and fix any that are broken.
If
a custom icon was specified for a node in your Version 2002.05.00 navigation
tree, after migration, ProjectConsole displays a broken image icon next to the
node.
If
you see a broken image icon, do the following:
a.
Copy
the image file for the icon to the following directory:
…\Program
Files\Rational\Common\rwp\webapps\projectconsole\pjc\Icons
b.
Edit
the node and browse to select the icon.
For information about how
to edit a node in the navigation tree, see Rational ProjectConsole Help.
URLs
that reference virtual Internet Information Services directories
If
you configured any tree nodes to display URLs that reference virtual Internet
Information Services (IIS) directories, these URLs
are invalid unless you have configured the Rational Web Platform (RWP) and IIS to work together.
For
information on how to set up a server running both RWP
and IIS, see
“Allowing IIS and RWP to
Co-Exist on a Single Server” in
the printed document Rational Suite® Upgrade Guide.
HTML
files in v2002.05.00 directories
If
any nodes in the v 2002.05.00 navigation tree pointed to html files stored in
…\Program Files\Rational\jakarta-tomcat\webapps\projectconsole,
copy these html files to …\Program Files\Rational\Common\rwp\webapps\projectconsole.
Relative
references to HTML files
If
a node in the navigation tree used a relative reference to an html file (that
is, the URL contained only the html file name), copy the html file to …\Program
Files\Rational\ Common\rwp\ webapps\projectconsole\pjc.
Start
pages in v2002.05.00 directories
In
version 2003.06.00, the start.htm file
and any associated image files are located in …\Program Files\Rational\ProjectConsole\DataRepository\<YourDataRepository>.
If
this page did not migrate during the upgrade:
1.
Copy
the page and the associated image files from …\Program Files\Rational\jakarta-tomcat\webapps\projectconsole to the new data repository folder.
2.
Use
the ProjectConsole Maintenance Tool to re-connect to your repository.
Migrated ProjectConsole
Help and ProjectConsole Resources nodes
You
can now access the ProjectConsole Help from the Logo toolbar, so you can delete
the migrated ProjectConsole Help node from the navigation tree.
If the ProjectConsole Resources node contains no useful information,
delete it also.
Templates
in v2002.05.00 directories
If
a node in the navigation tree points to a template that uses an absolute path
value to reference the jakarta-tomcat\webapps directory (using the FileSystem
domain), then modify these paths to reference the location under the …\Rational\Common\rwp\webapps directory. This can be the case for templates that display a
published chart, for example.
Templates that reference GIF files
Modify
any templates that use a FileSystem domain OPEN command to reference GIF files. ProjectConsole no longer supports
GIF
files inserted with the
file system adapter. Convert GIF files to PNG or JPG format
and modify the OPEN command
to reference the new file format.
Username
and password updates
Specify
the username and password values for nodes that access RequisitePro,
ClearQuest, or TestManager. In Version 2002.05.00, ProjectConsole prompted
users to log in when an artifact report required authentication, and the
logged-in user was not a valid user for the specified product. In Version
2003.06.00, ProjectConsole no longer prompts users to log in.
If
the login information is specified in the node properties, then ProjectConsole
generates the artifact using the specified username and password. If no login
information is specified for a node, ProjectConsole generates the artifact
report using the username and password of the user who is currently logged in.
Note: Only nodes for which a username is specified
are included in scheduled, offline updates of generated reports on the Web
site. This includes report nodes for products that do not require a login.
New
sample metrics panels
ProjectConsole
Version 2003.06.00 has new sample published views.
If
you want to remove the sample views, delete the files in the following
directory:
…\Rational\Common\rwp\webapps\projectconsole\PublishedViews\Dashboard\ClassicsCD.com
Projects
Default admin user password
If
the original warehouse did not include a user with username admin,
ProjectConsole v2003.06.00 adds this user. The username is “admin” and the
password is “changeit.” You cannot delete, rename, or suspend this user, but
you can change its password. We recommend that you do so for security reasons.
Security prompt starting the Dashboard
or the Designer
After
you start the ProjectConsole Dashboard or Designer, a Security Warning box
opens and prompts you to indicate whether you want to trust the signed applet.
Select the Grant Always check box, or click Always to continue, depending on which Java plug-in version is
installed on your computer. We recommend that you notify users that they will
also be required to respond to the question about trusting the signed applet.
Migrating
SQL Anywhere 5 data to SQL Anywhere 8
For
SQL Anywhere database users: If you have upgraded your SQL Anywhere server from
version 5 to 8.0, and you continue to use SQL Anywhere 5 databases, you can use
the ProjectConsole Maintenance tool to copy the migrated schema repository and
data warehouse from SQL Anywhere 5 to SQL Anywhere 8. This will improve
database performance. For information about how to do this, see the Rational
ProjectConsole Maintenance Tool Help.
This section describes how to
configure a ProjectConsole agent. If you did not install the ProjectConsole
collection agents or report servers on a remote computer, you can skip this
section.
We assume that you have already performed these steps:
·
Upgraded the ProjectConsole server software on the
ProjectConsole server
·
Installed the ProjectConsole report server and collection
agents on a remote computer
To configure the ProjectConsole agent services:
1.
Click Start > Programs > Rational Software > Rational
ProjectConsole > Rational ProjectConsole Maintenance Tool.
2.
On the first page of the Maintenance Tool, leave Configure the
ProjectConsole services selected and click Next.
3.
Enter the Web server name.
This
page displays advanced options. In most cases, you can accept the default
value. The Maintenance Tool Help describes each option in detail.
4.
Click Finish.
5.
Verify that the message “Operation Complete” is displayed.
Note:
You are not required to restart the ProjectConsole collection agents or
report server. These components automatically detect the new Web server name
and connect to the ProjectConsole services running on the Web server.
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.
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 Rational
Developer Network.
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.
After
ClearCase is installed on a Template Builder machine, the ProjectConsole menu is
corrupted. When Template Builder detects ClearCase on the same machine, a
ProjectConsole toolbar is displayed under the main menu. To work around the
ProjectConsole menu problems, use the ProjectConsole toolbar commands instead
of the ProjectConsole menu commands.
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.
There
is a menu compatibility issue with ProjectConsole Template Builder and Acrobat
5.0.5. To work around this issue, display the ProjectConsole toolbar below the
main menu by clicking View > Toolbars > ProjectConsole Toolbar. Use the
commands on the toolbar instead of the commands on the ProjectConsole menu.
The Java 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.
There are no known restrictions
associated with this product.
The
following table lists the issues identified for Rational ProjectConsole
2003.06.00 and its components, including ProjectConsole Template Builder.
|
Component |
Defect
Number |
Description |
|
ProjectConsole
Designer |
RATLC00031285 |
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 “admin” 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 |
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
|
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 |
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 |
Messages
are truncated on sequence diagrams. Workaround:
In Rose, display the affected diagram, and then click Format > Autosize All. |
|
Designer |
RATLC00027512 |
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 |
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 |
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 |
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 |
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 |
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 |
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
RATLC00366593 |
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 Installation Guide for Rational
Server Products. |
|
ProjectConsole
Template Builder |
RATLC00369629 |
In
Microsoft® Word 2002, built-in heading styles change to Normal
during report generation. Workaround: Where a heading is followed by a table,
insert a carriage return after the heading. |
|
Dashboard Designer |
RATLC00369672
|
On Unix/Linux
systems, the Java plug-in download page is not correctly displayed if the
plug-in is not installed. After you do get the Java plug-in installed, the
java/lib/ext directory is sometimes write-protected. If this is the case, the
Dashboard applet cannot install some required classes and, therefore, cannot
run. Workaround:
You can manually display the Java plug-in download page using the
http://hostname/Java_Plugins URL. After you install and configure the Java
plug-in, make sure that the java lib/ext directory is not write-protected. If
you still cannot start the Dashboard after you have changed the permissions
on this directory, manually copy the klg45.jar file into this java lib/ext
directory. You can find the klg45.jar file on the ProjectConsole server in
the following directory: …\Rational\Common\rwp\webapps\projectconsole\pjc |
|
ProjectConsole |
RATLC00369977 |
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 |
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 “Managing the task logs” in the
Designer Help. |
|
Dashboard Designer |
RATLC00370471 |
After
you start the ProjectConsole Dashboard or Designer, the Java plug-in may display
a security dialog box that asks you whether you want to accept the applet.
This security dialog box is sometimes hidden behind the browser window, so
that it seems as though nothing is happening. Workaround:
Check the taskbar to see if it contains an icon for the dialog box. Click the icon, and then confirm that you
accept the applet. |
|
ProjectConsole ProjectConsole
Template Builder |
RATLC00369992
|
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 affects 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 |
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 “Collector” from the log file directory field. 4.
Click Finish. 5.
Restart your ProjectConsole server machine. |
|
Dashboard |
RATLC00370037 |
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 |
If
you start the ProjectConsole Dashboard and Designer using Microsoft® Internet Explorer 5.5 (SP2), an error
message indicating that an ActiveX controls cannot be run is displayed. Workaround:
Ignore the ActiveX error message. |
|
Dashboard Designer |
RATLC00370109 |
If you are using Netscape® 7 on a Unix/Linux system, the browser resize is not passed
into the ProjectConsole Dashboard applet and Designer applet. Therefore, if
you resize the browser, the Designer or Dashboard applet inside the browser
retains its original size. Workaround: On the browser View menu, click Reload. |
|
ProjectConsole
Template Builder |
RATLC00370695 |
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 |
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
Template Builder |
RATLC00371180 |
Microsoft® Word 2002 does not support tables
that exceed the page size. |
|
ProjectConsole ProjectConsole
Template Builder |
RATLC00371433 |
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 |
If
you use Netscape® 7 on
Unix/Linux with the Sun Java 1.4.1 plug-in, you cannot edit some of the text
fields in the Designer. If you open
the Java console window, the fields become editable. Workaround:
Do one of the following: ·
Run the Designer applet from a Windows machine. ·
Copy the designer.jar file
from a Windows machine (in …\Rational\Common\rwp\webapps
\projectconsole\pjc) to your Solaris machine, and
then run the Designer as an application (java -jar designer.jar). |
|
Maintenance
Tool |
RATLC00371712 |
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 |
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 |
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
Rational Suite Upgrade Guide. |
|
Dashboard |
RATLC00371387 |
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 “Setting the session timeout interval for work sessions” in the
Designer Help. |
|
ProjectConsole |
RATLC00371187 |
If
you use the Select Groups and Users window to modify the security settings
for a node in the navigation tree, and click 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 |
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) cannot be displayed. Workaround:
Do not use apostrophe characters in folder names in the Dashboard. |
|
Maintenance
Tool |
RATLC00371790 |
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
installation |
RATLC00371784 |
If
you install Rational Suite into a directory with a path that contains
non-ASCII characters, ProjectConsole will not generate some artifact pages
correctly, and Web site administration may not function correctly. Workaround:
Do not use non-ASCII characters in the path where you are installing Rational
products. |
|
ProjectConsole |
RATLC00371851 |
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 |
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 |
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 |
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 |
RATLC00372122 |
On
Unix/Linux systems, the Refresh button, which is located on the
ProjectConsole Operations toolbar, does not work. Workaround:
Do one of the following: ·
Set the report cache timeout to a low number so that
pages are regenerated more frequently. ·
Run update.bat to update the cached pages. |
|
ProjectConsole |
RATLC00372131 |
The
shortcut menus for nodes in the navigation tree are not supported on Linux
platforms. |
|
ProjectConsole |
RATLC00372168 |
ProjectConsole
does not support the collection of and reporting on measures from Rational
XDE. An |
|
Maintenance
Tool |
RATLC00371949 |
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 |
RATLC00372090
|
If you
use a Netscape browser to log in to the ProjectConsole Web site, you cannot
use the Administration section to administer users and groups. Workaround:
To administer users and groups, use Microsoft® Internet Explorer. |
|
Maintenance
Tool |
RATLC00372058 |
If
the source database is configured to use DB2, you cannot use the
ProjectConsole Maintenance Tool to copy a data repository. Workaround:
None |
|
ProjectConsole |
RATLC00372038
|
In
this release, an httpd: Link URL is only supported
for a folder node if you have selected the Display page in a new window check box. |
|
ProjectConsole |
RATLC00372039 |
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
installation |
RATLC00372018 |
You
cannot install ProjectConsole correctly on a Hebrew operating system. Workaround:
None |
|
ProjectConsole |
RATLC00372036 |
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), and 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 |
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.” 5.
Restart the ProjectConsole server. |
|
ProjectConsole
Template Builder |
RATLC0046972 |
On a
non-English operating system, diagram images extracted from Rose RealTime are
missing, cropped or scaled incorrectly if the “Measurement 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 |
The Rational
Unified Process Software Architecture Document listed in the ProjectConsole
Tool Mentor titled “Adding Rational Unified Process Templates to the
ProjectConsole Navigation Tree,” is not available. |
|
ProjectConsole |
RATLC00372332 |
If you
perform the steps provided in the ProjectConsole Tool Mentor titled “Adding
Rational Unified Process Templates to the ProjectConsole Navigation Tree,”
and you 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. |
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:
·
Delete the contents of the following directory:
...\Rational\Common\rwp\webapps\projectconsole\generated\soda
If
you have questions about installing, using, or maintaining this product,
contact Rational Customer Support as follows:
|
Your Location |
Telephone |
Facsimile |
E-mail |
|
North America |
(800) 433-5444 (408) 863-4000 |
(781) 676-2460 |
|
|
Europe, Middle East, Africa |
+ 31 (0) 20 4546 200 |
+31 (0) 20 4545 202 |
|
|
Asia Pacific |
+61 2 9419 0111 |
+61 2 9419 0123 |
When you contact Rational Customer Support, please be
prepared to supply the following information: