Before using this information, be sure to read the general information under Appendix. Notices.
This document provides information about installing and using IBM(R) Rational(R) ProjectConsole and the Rational ProjectConsole Template Builder (a Microsoft(R) Word add-in). This information includes hardware and software requirements, known problems, and compatibility issues.
The product changes described in this document apply to the following versions of Rational ProjectConsole and Rational ProjectConsole Template Builder:
This document is intended for system administrators and users of Rational ProjectConsole.
This manual uses the following typographical conventions:
For related information, see:
Product documentation is available on the IBM Publications Center, where you can download documents or purchase printed copies. To find documentation:
This chapter provides information about product installation and new features in IBM Rational ProjectConsole versions 7.0 through 7.0.3.
If you are installing IBM Rational products for the first time, or upgrading from an earlier release of Rational ProjectConsole, see the IBM Rational ProjectConsole Installation and Upgrade Guide
Delete all files in the system /temp folder before upgrading to Rational ProjectConsole 7.0.2. Typically, this folder is found in C:\Documents and Settings\username\Local Settings
The minimum value of the DB2 transaction log is insufficient to support the upgrade to feature level 6 for Rational ProjectConsole version 7.0.3. To correct the issue:
To download the most current edition of this document from the IBM Publications Center:
The version of the release notes available from the IBM Publications Center contains the following additional chapters:
The following sections describe sources from which you can obtain additional product documentation.
IBM developerWorks(R) Rational (http://www.ibm.com/developerworks/rational/) is an online community that provides information and an exchange of ideas and best practices. Content on the site has been edited for quality and relevance, and organized by technology and process. There are also links to Web-based training. You can use the site for the following purposes:
The following articles and white papers provide information relevant to configuring and using Rational ProjectConsole. They are available from IBM developerWorks Rational (http://www.ibm.com/developerworks/rational/).
The Rational ProjectConsole Web site provides links to white papers that provide information about measurement planning and links to some of the sample measurements provided with Rational ProjectConsole.
To view white papers on the Rational ProjectConsole Web site:
This section describes new and enhanced features in this release.
Rational ProjectConsole databases and schemas are based on Rational ClearQuest. With this release, feature level 6 replaces the feature level supported in earlier releases. Migration to feature level 6 is mandatory.
To upgrade to feature level 6, you must create an empty schema repository and user database and run the Rational ProjectConsole Maintenance Tool to upgrade your databases. For more information, see Maintenance Tool help.
This section describes new and enhanced features in this release.
For optimal use, the Rational ProjectConsole Designer and Dashboard applets require that IBM JRE be installed.
With Microsoft Internet Explorer, you are automatically directed to a location from which you can download the IBM JRE if it is not currently installed. Both Sun JRE and IBM JRE are supported.
If you are using the Firefox browser, you are not directed to the IBM JRE. In this case, you can use the Sun JRE.
To enable Mozilla, access the Java Plug-In Control Panel 1.4.2, navigate to the Browser tab, and click Enable Mozilla 1.1 or later.
This release supports the new Rational Web Platform (RWP), which is based on the embedded version of WebSphere Application Server. For information about Rational Web Platform, see the IBM Rational ProjectConsole Installation and Upgrade Guide.
The Rational Web Platform (RWP) is supported only on server platforms; it is not supported on Windows(R) XP.
Cloudscape has replaced SQL Anywhere as the Rational ProjectConsole security database.
This section presents announcements and changes for this release.
The Start path for Rational ProjectConsole has changed for this release. Here is the new path: Tools > Start > Programs > IBM Rational > IBM Rational ProjectConsole > ProjectConsole menu items
In version 7.0.0.0, the names of installed ProjectConsole services have changed. Table 1 lists the old name and new name of each service. If you previously configured any of the Rational ProjectConsole services to log in using a domain account, you must modify the login parameters for the newly installed services to use the same domain login parameters that you used for version 2003.06.15 of the services.
2003.06.15 service name | 7.0.0.0 service name |
---|---|
Rational ProjectConsole Collection Server | IBM Rational ProjectConsole Collection Server |
Rational ProjectConsole Dashboard Server | IBM Rational ProjectConsole Dashboard Server |
Rational ProjectConsole Report Server | IBM Rational ProjectConsole Report Server |
Rational ProjectConsole no longer checks out a license for the ProjectConsole server. ProjectConsole clients still require one license per client.
Rational ProjectConsole tutorials are based on functionality and interfaces from version 2003.06.
Because of a change in the tools used to generate on line Help for this release, the search function supported by Help in earlier releases of Rational ProjectConsole is no longer supported.
Accessibility features help users who have a physical disability, such as restricted mobility or limited vision, to use information technology products successfully.
For more information about IBM's commitment to accessibility, go to http://www.ibm.com/able.
The IBM Rational ProjectConsole Installation and Upgrade Guide installed with this release does not meet accessibility guidelines. An accessible edition is available from the IBM Publications Center. Table 2 lists the information needed to locate accessible versions of Rational ProjectConsole documents.
To obtain documents from the Publications Center:
Title | Material ID (MID) |
---|---|
IBM Rational ProjectConsole Installation and Upgrade Guide | GI11-8261-00 |
IBM Rational ProjectConsole Release Notes | GC23-6215-00 |
This chapter describes noteworthy restrictions and guidelines that affect the use of Rational ProjectConsole. It is divided into three sections:
This section describes restrictions and guidelines that affect the use of Rational ProjectConsole.
If you are updating ProjectConsole from 7.0.2 and if you applied the work-around metioned in technote http://www-01.ibm.com/support/docview.wss?rs=0&q1=1389970&uid=swg21389970&loc=en_US&cs=utf-8&cc=us&lang=all, you need to delete those two files you added manually before proceeding with updating to 7.0.3 release.
If you are migrating from version 2005.05.00, any non-ASCII characters in the name of a Rational ProjectConsole repository that you are migrating will cause the migration to fail.
Workaround: Use ASCII names for your data repositories or 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.
This section describes special compatibility issues that affect the use of Rational ProjectConsole and Rational ProjectConsole Template Builder with other Rational products and vendor products.
This section describes the compatibility of Rational ProjectConsole with other Rational products.
Beginning with version 7.0, Rational ProjectConsole is installed as a stand-alone product. In earlier releases, installation was done as part of a suite of products. The new installation strategy facilitates more efficient updates to individual products.
For Rational ProjectConsole version 7.0 and 7.0.1, the Template Builder, Report Server, and collection agents can report on Rational products of the same version.
ProjectConsole's ability to collect from and report against earlier versions of Rational products is contingent on the backward compatibility of the individual Rational products. See the documentation for that product for more information.
This section describes Rational ProjectConsole compatibility with vendor products.
To start the Designer or Dashboard for Rational ProjectConsole, you must enable all cookie types for your browser. This is required for all supported browser types. If cookies are disabled, you will receive an authentication error.
Like Microsoft Word 2002, Word 2003 requires Markup to be turned on to display Word comments (and Rational ProjectConsole Template Builder commands). However, in this version of Template Builder, the default Markup is set to ON and the color is white, which makes markup invisible to the user. This does not affect comment functions for normal Word usage. Because Markup is now always set to ON in Template Builder, you can use the Show/Hide button in Microsoft Word to toggle the display of Template Builder commands. The placement of the cursor in relation to the marker is irrelevant in this version (this is different from Word 2002).
If you have questions about installing, using, or maintaining this product, contact IBM Customer Support as follows:
The IBM software support Internet site provides you with self-help resources and electronic problem submission. The IBM Software Support Home page for Rational products 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/.
You can submit a support request electronically. Click the Report Problems tab at http://www.ibm.com/software/rational/support/
The IBM Support Assistant (ISA) is a locally installed serviceability workbench that makes it both easier and simpler to resolve software product problems. ISA is a free, stand-alone application that you download from IBM and install on any number of machines. It runs on AIX, (RedHat Enterprise Linux AS), HP-UX, Solaris, and Windows platforms.
ISA includes these features:
For more information about ISA, including instructions for downloading and installing ISA and product plug-ins, go to the ISA Software Support page.
IBM Support Assistant: http://www.ibm.com/software/support/isa/
This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A.
For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:
IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106, Japan
The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.
This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.
Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.
IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.
Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:
IBM Corporation Department BCFB 20 Maguire Road Lexington, MA 02421 U.S.A.
Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.
The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.
Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurement may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.
Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.
COPYRIGHT LICENSE:
This information contains sample application programs in source language, which illustrates programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. You may copy, modify, and distribute these sample programs in any form without payment to IBM for the purposes of developing, using, marketing, or distributing application programs conforming to IBM's application programming interfaces.
Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows:
(c) (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. (c) Copyright IBM Corp. _enter the year or years_. All rights reserved.
Additional legal notices are described in the legal_information.html file that is included in your Rational software installation.
Trademarks
ClearCase, ClearQuest, DB2, DB2 Universal Database, Domino, IBM, Lotus Notes, MVS, Notes, OS/390, Passport Advantage, ProjectConsole Rational, Rational Rose, Rational Suite, Rational Unified Process, RequisitePro, RUP, SP1, SP2, and XDE are trademarks of International Business Machines Corporation in the United States, other countries, or both.
Java and all Java-based trademarks and logos are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.
Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Linux is a trademark of Linus Torvalds in the United States, other countries, or both.
Other company, product or service names may be trademarks or service marks of others.