|
This software contains proprietary and
confidential information of Rational and its suppliers. Use, disclosure or
reproduction is prohibited without the prior express written consent of
Rational. |
The
information in this document is applicable to Rational ProjectConsole on the
Rational Solutions CD version 2002.05.20.
Support
for Sybase SQL Anywhere
Starting
the ProjectConsole Servers
Starting
the ProjectConsole Agent Software
Using
Tomcat as the Web Server
Restrictions
and Guidelines on Using <Product>
Information
for Word 2002 Users
Known
Defects: ProjectConsole Template Builder
Contacting
Rational Technical Support
This section lists the hardware and software
requirements for installing ProjectConsole on the server and agent machines, and
on ProjectConsole Template Builder machines.
·
Dedicated workstation/PC
·
Recommended CPU: 500 MHz or higher
·
Recommended memory: 256 MB minimum
· Recommended swap space: 2 x physical memory
· 2 GB minimum free hard disk space before installation
·
Recommended CPU: 500 MHz or higher
·
Recommended memory: 256 MB minimum
· Recommended swap space: 2 x physical memory
· No hardware requirements
·
Recommended CPU: 500 MHz or higher
·
Recommended memory: 256 MB minimum
· Recommended swap space: 2 x physical memory
This section lists the software to install on the ProjectConsole server machine, ProjectConsole agent machines, ProjectConsole client machines, and ProjectConsole Template Builder machines.
·
Windows NT 4.0 Server (Service Pack 6a), Windows 2000
Server/Advanced Server (Service Packs 1 and 2), or Windows XP
Pro
·
Rational Suite, v2002.05.20
· Microsoft Word 2000, Word XP
One of the following supported databases:
·
Microsoft SQL Server 7.0 (Service Pack 3) or Microsoft
SQL Server 2000 (Service Pack 1)
·
Sybase SQL Anywhere 5.5.05
·
Oracle 8.0.5, Oracle 8.1.6 (8i), or Oracle
8.1.7
· IBM DB2 7.1 (Service Packs 2 and 3) or IBM DB2 7.2
Note If your Oracle or DB2 databases are on a machine other than the ProjectConsole server, you must install and configure the Oracle or DB2 client software on the ProjectConsole server.
One of the following Web server platforms:
·
Microsoft Internet Information Services (IIS) 4.0 or
5.0
· Jakarta Tomcat
·
Windows NT 4.0 Server/Workstation (Service Pack 6a),
Windows 2000 Professional/Server/Advanced Server (Service Packs 1 and 2), or
Windows XP Pro
· Rational Suite v2002.05.20
ProjectConsole client (accessing ProjectConsole through a browser) |
As of this release, ProjectConsole supports Sybase
SQL Anywhere for its metrics warehouse databases. For more information, see
Chapter 2, Preparing Vendor Databases in the manual Rational
ProjectConsole: Installation Guide, Version
2002.02.20.
The ProjectConsole Dashboard Designer Tool has a
new Create Metadata feature that lets you choose to have ProjectConsole
automatically create required metadata (dimension and measure tables, a mapping,
and a scheduled collection task) for a new source template. For more
information, see ProjectConsole Dashboard Designer Help.
Note If your source template contains a
date/time source field you cannot use an automatically created dimension table
to specify date/time as the data type for a source field. The date/time data
type can only be used for a field in a time dimension table. ProjectConsole does
not currently create time dimension tables automatically. To collect date/time
type data from a source, you must create the time dimension table
manually.
When you install this release of ProjectConsole, a
sample database and report are created for TestManager. The Rational
ProjectConsole Tutorial now includes a new section (Section 14) that shows you
how to use ProjectConsole to collect project metrics from this sample
TestManager database, and then generate the sample report to view the results.
Chapter 3, Installing and Setting Up Rational ProjectConsole in the Installation Guide, Rational ProjectConsole manual provides most of the information you need to install the Rational ProjectConsole software during installation of a Rational Suite product, and to get ProjectConsole up and running. This manual is available in pdf format. This section provides additions and changes to the content provided in Chapter 3.
Rational ProjectConsole is packaged with Rational Suite products. If you plan to set up a ProjectConsole server on an old RequisiteWeb server, then you must uninstall any previous versions of Rational products first. Otherwise, you can install over the installed version.
The printed manual Installation Guide: Rational ProjectConsole states that, to start the ProjectConsole servers, you must run the ServerStartup.bat file. The procedure for starting the servers has changed since the manual was printed.
To start the ProjectConsole servers:
· Click Start > Programs > <RationalSuiteProduct> > Rational ProjectConsole > Start Rational ProjectConsole Servers.
After you do this, a DOS Command Prompt window displays the startup status of the servers. In addition, one or more xmlagents.exe DOS windows open. These windows are automatically minimized. Do not close them.
To stop the ProjectConsole servers, maximize the Command Prompt window, type “stop,” and then close the xmlagents.exe window(s).
The printed manual Installation Guide: Rational ProjectConsole states that, to start the ProjectConsole agent software, you must run the agentstartup.bat file. The procedure for starting the agent software has changed since the manual was printed.
To start the ProjectConsole agent software:
· Click Start > Programs > <RationalSuiteProduct> > Rational ProjectConsole > Start Rational ProjectConsole Servers.
If you are using an
Oracle database, and the database server is a machine other than the
ProjectConsole server machine, you must configure ProjectConsole to use the
correct version of the Oracle client. You are only required to do this once on
the ProjectConsole server machine before you start the ProjectConsole
servers.
If you are using the
Oracle 8.0 client, run the following command:
Installutil registeroracleoption client_ver=8.0
If you are using the Oracle 8.1 (or 8i) client, run the
following command:
Installutil registeroracleoption client_ver=8.1
The procedures used to connect to vendor databases are
identical for ProjectConsole and Rational ClearQuest. For more information, see
the section ClearQuest with Oracle in the online document Rational ClearQuest
Release Notes.
To access the Rational ClearQuest Release Notes
document:
· Click Start > Programs > <RationalSuiteProduct> > Rational ClearQuest > Rational ClearQuest Release Notes.
Because ProjectConsole requires an SQL Server login for
each database and does not support Windows NT authentication, you must set up
SQL Server 2000 to operate in mixed mode (Windows NT Authentication and SQL
Server Authentication).
You can set the authentication option either during
Microsoft SQL Server 2000 installation, or after installation. For information
about using the SQL Server Enterprise Manager to set the authentication mode
after installation, see SQL Server Books Online.
During Microsoft SQL Server 2000 installation, you can select one of two authentication options; the “Windows only authentication” option or the “mixed mode (Windows and SQL Server) authentication” option. To use ProjectConsole with Microsoft SQL Server 2000 databases, you must select the mixed mode (Windows and SQL Server) authentication option.
Note During Microsoft SQL Server 2000 installation, you are prompted for a database instance name. The database instance name must be the same as the hostname of the machine on which you are installing. You can specify the correct hostname by leaving the instance name blank and accepting the default.
ProjectConsole requires a servlet engine to run. The default configuration for ProjectConsole is to use Microsoft Internet Information Services (IIS) as the Web server, and Jakarta-Tomcat (Tomcat) as the servlet engine. The Tomcat servlet engine is installed automatically during ProjectConsole server software installation. Tomcat can be used as the Web server as well as the servlet container. This section contains information about what you must do to use Tomcat as the Web server.
Tomcat is configured, by default, to run using port 8080
(IIS uses port 80). To use Tomcat as the Web server with ProjectConsole, you
must first specify 80 as its port number. You do this by editing the server.xml
file, as follows:
1. Start an ASCII text editor such as Notepad, and then open the server.xml file. You can find the file in the following directory:
TomcatDir\conf\server.xml
where TomcatDir refers to the directory where Tomcat
is installed. (The default TomcatDir is C:\Program
Files\Rational\jakarta-tomcat.)
2. Search for and select the single instance of the text "8080," and then type "80" to replace it.
Note
Make sure that you have no other
Web servers running using port 80.
Note If you do not change the port number to
80, then to log on to the ProjectConsole Web site, you must specify the port
(for example, http://myserver:8080/ProjectConsole).
If you have installed a Rational Suite product other than Rational Suite Enterprise and plan to use Tomcat, and not IIS, as your Web server, you must add the COMMONHOME environment variable to the System variables, and set its value to the installation directory for ProjectConsole. The default installation directory for ProjectConsole is C:\ProgramFiles\Rational\Common.
If you have installed ProjectConsole to a different location, use that directory as the value for the COMMONHOME environment variable.
For information about using IIS as the Web server, see the manual Rational ProjectConsole: Installation Guide.
You can request and install license keys before or after installing Rational products; however, you must have a license key installed and configured to run a Rational product. The license key that you received with the Rational Suite package you purchased is valid for Rational ProjectConsole software. For information about installing and configuring license keys, see the Administering Licenses for Rational Suite section of Installation Guide, Rational Suite and Rational Suite License Management Guide.
Normally, when you use ProjectConsole to generate a Web-based report on artifacts from a source such as Rose or Microsoft Project, the source application runs as a background process and its user interface is not visible. However, if the artifact collection process requires user interaction, the source application displays dialog boxes or message boxes that prompt the user for some input or action. To prevent this from occurring, make sure that no interaction is required to collect artifacts from the source domain repository.
Running Rational XDE 1.0 and Rational ProjectConsole (the server software with Web components) on the same machine is not supported in this release. If you install XDE and ProjectConsole on the same machine, Rational XDE does not work.
Workaround: To work around this incompatibility problem, you must add a new Path variable.
To
add a path variable:
1.
On your desktop, right-click My Computer, and then click
Properties on the shortcut menu.
2.
Click the Advanced tab.
3.
Click Environment Variables.
The Environment
Variables dialog box is displayed.
4.
In the System variables list, scroll down to and then
click Path.
5. In the Variable Value box, type "C:\Program Files\rational\jintegra\bin" in front of the existing value.
If you have a different version of jintegra on your path,
you must move Rational\Common in front of that existing entry. The Rational Software
Setup program installs the latest version of jintegra. Having an earlier version
on the path causes problems.
Normally, when you use ProjectConsole to generate a Web-based report on artifacts from a source such as Rose or Microsoft Project, the source application runs as a background process and its user interface is not visible. However, if the artifact collection process requires user interaction, the source application displays dialog boxes or message boxes that prompt the user for some input or action. To prevent this from occurring, make sure that no interaction is required to collect artifacts from the source domain repository.
If you are working on a Windows 2000 Professional machine
that has Trend OfficeScan installed and running, you may find that it takes a
very long time to start XML Server. To avoid this slow-down, before you start
XML Server, stop Trend I/O scanning.
The Rational ProjectConsole Help is optimized for viewing from Internet Explorer. If you use a different Web browser, you cannot resize the left pane, which displays the Help contents.
If you use Netscape as your Web browser, you must change the Netscape process priority value to “BelowNormal” in the Task Manager. Otherwise, ProjectConsole cannot display generated Web pages.
To
change the process priority of Netscape:
1.
Start Netscape.
2.
Start the Task Manager.
3. On the Processes tab, right-click the Netscape executable item, point to Set Priority, and then click BelowNormal on the shortcut menu.
Microsoft SQL Server 2000 can run in one of two security (authentication) modes: Windows authentication mode and mixed (Windows and SQL Server) mode. To ensure that ProjectConsole works with Microsoft SQL Server 2000, you must specify mixed mode authentication. Mixed mode authentication is not the default option for Microsoft SQL Server 2000 installation. For information about using the SQL Server Enterprise Manager to set the authentication mode, see SQL Server Books Online.
Note During Microsoft SQL Server 2000 installation, you are prompted for a database instance name. The database instance name must be the same as the hostname of the machine on which you are installing. You can specify the correct hostname by leaving the instance name blank and accepting the default.
The following documentation has been modified since the
Rational ProjectConsole v
2002.05.20.305.000 release:
· All sections of the Rational ProjectConsole Tutorial have been modified to reflect the addition of new features in the product. In addition, the tutorial now includes the following new sections:
Section 13, Configuring ProjectConsole to Collect
Microsoft Project Metrics, shows you how to gather data from Microsoft
Project.
Section
14, Configuring ProjectConsole to Collect TestManager Metrics, shows you
how to gather data from TestManager and display it in your ProjectConsole
metrics panels.
Section
15, Data Transformations and Derived Data, shows you how to use
transformations for data cleansing.
Section
16, Using Transformations to Obtain Derived Data, shows you how to use
transformations to obtain derived data.
·
The manuals Rational ProjectConsole: Installation Guide
and Rational ProjectConsole: Getting Started have been modified to reflect the
addition of new
features in the product and changes to the Rational ProjectConsole
Administrator user interface.
·
Rational ProjectConsole Maintenance Tool Help now
includes information about using SQL Anywhere databases for the metrics
warehouse.
·
Rational ProjectConsole Administrator Help includes
information about the modified Website Administration dialog box.
·
Rational ProjectConsole Dashboard Designer Help now
includes information about the new Create
Metadata feature.
The
scheduled collection tasks you start from ProjectConsole may take some time to
run. We strongly recommend that you schedule collection tasks to run during off
hours so that project artifact collection does not interfere with your
work.
Template Builder uses the Word comment feature to store the arguments it needs to extract and display information. Because comments have a different appearance and different behavior in Word 2002 than they do in Word 2000, you interact with the comment feature differently in the two versions of Word.
The Template Builder Help does not include Word 2002 procedures. Therefore, if you plan to use Word 2002 with Template Builder, review the Word 2002 information in Rational’s Solutions Knowledge Base to get the following information:
· Comparison of the comment feature in Word 2000 and Word 2002
· Explanation of how to delete Word comments using the Template Builder interface
· Procedure for deleting Word 2000 comments from a Word document
· Description of what you do to delete a Word 2002 comment marker in the Template Builder context
This section contains information about known defects for
both ProjectConsole and ProjectConsole Template Builder.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
If you have questions about installing, using, or
maintaining this product, contact
For new issues, please type ProjectConsole and a short
description of the problem in the subject line.
When you contact
·
Your name, company name,
telephone number, and e-mail address
·
Your operating system,
version number, and any service packs or patches you have
applied
·
The browser you are
using
·
Suite product name and
release number
·
Your Service Request number
(if you are following up on a previously reported problem)