Before using this information, be sure to read the general information under Appendix. Notices.
This edition applies to version 7.0.2.0 of IBM Rational ProjectConsole and to all subsequent releases and modifications until otherwise indicated in new editions. This edition replaces GI11-8261-00.
This book provides requirements and instructions for installing, configuring, and licensing IBM(R) Rational(R) ProjectConsole(TM).
This book is intended for administrators of Rational ProjectConsole or users who want to install Rational ProjectConsole version 7.0.2.
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 chapter provides a high-level guide to planning the installation of IBM Rational ProjectConsole. Both administrators and users of the product should read this chapter before beginning the installation.
Beginning with release 7.0.2, Rational ProjectConsole uses the IBM Installation Manager for installation. IBM Installation Manager is a program for installing, updating, and modifying packages. The program helps you manage the IBM applications, or packages, that it installs on your computer. Installation Manager does more than install packages - it helps you keep track of what you have installed, determine what is available for you to install, and organize installation directories. For more information, see the IBM Installation Manager Information Center.
For the most current information about features and known issues, see the IBM Rational ProjectConsole Release Notes.
If you are upgrading from a previous version of the product, review the upgrade information before you install the current version.
If you are upgrading from a previous version of Rational ProjectConsole that was installed with the MSI installer, you must uninstall your product before beginning this installation. Beginning with version 7.0.2, installation is done with IBM Installation Manager.
For upgrade information, see Upgrading Rational ProjectConsole.
If you are installing Rational ProjectConsole integration with Rational Portfolio Manager as part of the metrics enablement feature for Rational Portfolio Manager, you must be sure to select the integration option from the Custom Setup menu for the Rational ProjectConsole installation.
Installing the integration installs a modified version of the Rational ProjectConsole Designer, which can be accessed from the Start menu. This version of the Designer authenticates against Rational Portfolio Manager and is not intended for use with a stand-alone version of Rational ProjectConsole.
For information about setting up the integration with Rational Portfolio Manager, see the IBM Rational Portfolio Manager IBM Rational ProjectConsole Integration Guide from the Rational Portfolio Manager documentation set.
To help you plan your environment, determine which computers will be servers. Servers need to be highly available and might need extra memory and disk space. Table 1 describes the types of servers you might need.
Type of server | Description |
---|---|
License server | If you purchased floating licenses, install and set up a server to administer the licenses. For more information, see the IBM Rational License Management Guide. |
Database server |
|
Web server | Web server components give users who do not have client
software on their desktops the opportunity to access project data.
|
In this release, the products formerly offered as part of IBM Rational Suite(R) can only be installed individually. You can no longer install a collection of Rational products as a single Rational Suite. The products are installed separately to support patching and upgrading.
If you are installing Rational products for the first time, follow the instructions in the installation guide for each product that you install.
If you have previously installed a Rational product that was a part of Rational Suite, review the upgrade section of this guide carefully. Version 7.0.2 is a major release that includes changes to installation and other operating processes, dependencies between products, and interoperability with product integrations. In some cases, tasks must be performed in a specific sequence, for example, upgrading server components before upgrading clients.
As of version 7.0.2, all Rational products installed on a computer must be the same version. Before installing Rational products with Installation Manager, you must use the rationaluninstalltool.exe tool to uninstall previous versions of Rational products that were installed with the MSI based installation technology. For more information about uninstalling Rational products, see Uninstalling Rational products in Upgrading Rational ProjectConsole.
If you have a license for a previous release of Rational Suite, that license is valid in the current release, but the search order for the license key has changed.
In releases prior to 7.0.x, when a product from Rational Suite was installed, the Rational License Key Administrator (LKAD) application tried to find a license key that corresponded to Rational Suite. If such a key was not available, LKAD searched for a key that corresponded to the product itself.
In version 7.0.x, LKAD looks for the product-specific license key first. You can still use the License Usage Mapper in LKAD to change this search order or have the application not search for a Rational Suite key. For more information about licensing, see the IBM Rational License Management Guide.
This section presents hardware and software system requirements for installation in addition to a list of supported vendor databases and server platforms.
The following list provides information about the hardware requirements for server installations of Rational ProjectConsole.
This section presents software requirements for the installation of Rational ProjectConsole features.
These features include:
Product feature | Requirements and guidelines |
---|---|
Rational ProjectConsole server | Microsoft Windows operating systems:
|
Repository databases |
See Supported vendor database server platforms for information about vendor databases that can be used for repository databases. |
Collection agents and 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. If you are collecting metrics or generating reports against Microsoft Project, you must use one of the following versions:
|
Template Builder |
|
Web clients |
|
Automated license key requests |
Internet connection to request and receive license key files. For more information, see the IBM Rational License Management Guide. |
Documentation | Adobe Acrobat Reader 4.x or higher to read online PDF files. Download a free version of Adobe Acrobat Reader from www.adobe.com. |
Table 3 lists the supported vendor databases for each server platform.
Operating system | Database |
---|---|
Microsoft Windows 2000:
|
|
Microsoft Windows 2003:
|
|
Microsoft Windows Server 2008 |
You can use vendor databases running on Linux(R) and the UNIX system with Rational ProjectConsole. Table 4 lists supported vendor databases for these platforms.
Operating system | Database version |
---|---|
Linux x86 RHEL 3 & 4 - AMD64, EM64T Linux x86 SUSE (SLES) 9 - AMD64, EM64T Linux x86 - Novell Linux Desktop |
|
Solaris 8, 9 and 10 on Sparc |
|
AIX 5.1, 5.2 and 5.3 on RISC |
|
This chapter describes the procedure for installing Rational ProjectConsole components.
Before installing Rational products with Installation Manager, you must use the rationaluninstalltool.exe tool to uninstall previous versions of Rational products that were installed with the MSI based installation technology.
The following products, which were installed with MSI based install technology, must be uninstalled:
The rationaluninstalltool.exe tool has two uninstall scenarios; a clean uninstallation and a user data preserved uninstallation.
The clean uninstallation completely removes the Rational installation directory in addition to Rational Software registry keys under both HKEY_LOCAL_MACHINE and HKEY_CURRENT_USER.
The user data preserved uninstallation does not remove files that are used to customize the environment. Use this method if you want to save customizations from your current deployment for your Installation Manager deployment. The following table identifies the files that are preserved for each of the products by this uninstallation method.
Rational ClearCase | Rational ClearQuest | Rational RequisitePro | Rational SoDA |
---|---|---|---|
|
|
|
|
The rationaluninstalltool.exe tool removes all Rational products listed above at the same time. It does not need to be rerun for each product.
To remove Rational products with the rationaluninstalltool.exe tool:
Use the rationaluninstalltool.exe command with the following subcommands:
Configuring deployment of your software product requires that you understand the types of deployment methods available for your product. You can then select the appropriate deployment type for your users and you can configure your software for the selected deployment method.
If you are installing a Rational ProjectConsole server, read Configuring the IBM Rational ProjectConsole server before proceeding.
If you are installing a Rational ProjectConsole client, read Setting up the IBM Rational ProjectConsole client before proceeding.
In all cases, you need a license key to start the product. Your license administrator can tell you which license key to use and where to obtain it.
The License Key Administrator (LKAD) is a tool that imports license keys to your license server. LKAD provides a wizard to simplify the process.
The Setup wizard installs LKAD with each IBM product. If the product is not already licensed, you can start the LKAD wizard when the installation process is finished. You can also start LKAD by clicking StartPrograms > IBM Rational > Rational License Key Administrator. The LKAD main window and wizard page open simultaneously. For more information, see the LKAD Help.
If you do not see the License Key Administrator (LKAD) start at the end of the installation, your product is already licensed.
Follow the instructions in Table 6 to license your product.
Type of license key | Where to request license key | How to install |
---|---|---|
Permanent node-locked |
AccountLink (www.ibm.com/software/ rational/support/licensing/) |
Import the key on your desktop with the License Key Administrator (LKAD) wizard. |
Permanent floating |
AccountLink (www.ibm.com/software/ rational/support/licensing/) |
To configure your client to point to the license server,
use the License Key Administrator (LKAD) wizard. Your administrator must
install and set up the license server first. (For instructions, see the .)
If your administrator has set up a release area, you might not have to specify the license server in the LKAD wizard. |
Evaluation floating | Your sales representative | Configure your desktop to point to the License Server
by using the License Key Administrator (LKAD) wizard. Your administrator
must install and set up the license server first. (For instructions, see
the .)
If your administrator has set up a release area, you might not have to specify the license server in the LKAD wizard. |
Evaluation node-locked | Your sales representative | Import the node-locked key on your desktop with the License Key Administrator (LKAD) wizard. |
To make Rational ClearCase Web, Rational ClearQuest Web, Rational RequisiteWeb, and Rational ProjectConsole available for use, your license administrator must install floating licenses on a License Server.
The Web server (Rational ClearQuest Web Application server or Rational Web Platform) requests a license key from the Rational License Server for each Web client. You do not have to install a license key on your desktop to use the Web client.
To use Rational products that support hosted development on Windows Terminal Servers, you must have floating licenses.
This chapter explains how to install and set up Rational ProjectConsole software on the Web server, report server, and collection agent computers. This information is intended for administrators who are responsible for setting up for use by the entire development team.
For the latest Rational ProjectConsole and Template Builder installation information, see the IBM Rational ProjectConsole Release Notes.
Use the checklist in Table 7 to help you set up and perform the required postinstallation tasks.
Done | Task |
---|---|
License your software. | |
Check the system and software requirements for the server computer and data warehouse. | |
Verify that you have administrator privileges on the server computers. | |
Determine whether you need additional report servers and collection agents. See the following sections: | |
Determine how you want to deploy the server, additional report servers and collection agents (if necessary), and Template Builder in your environment. These features are included by default in your ProjectConsole installation. | |
Select the data warehouse software. See Setting up the Rational ProjectConsole data warehouse. | |
Install and configure the vendor database software. For installation instructions, see documentation from individual vendors. For information about configuring vendor databases, see Configuring vendor databases. | |
Determine where you want to install the Template Builder software. See Installing Rational ProjectConsole Template Builder. | |
To learn procedures for installing Rational ProjectConsole software, see Installing Rational ProjectConsole. | |
Configure the server and additional report server and collection agents (optional). See After installation: Configuring Rational ProjectConsole. | |
Configure the data warehouse and repository. See After installation: Configuring Rational ProjectConsole. | |
Tell users to log in to the server.
Note:
To start either
the Designer or Dashboard, cookies need to be enabled. This is true for all
browser types. |
When you install the Rational ProjectConsole Web server components, the Rational ProjectConsole data warehouse, collection agent and report server, Template Builder, and Rational Web Platform (RWP) are also installed.
To set up the server:
A collection agent gives the server access to project data from products, Microsoft Project, and delimited text files. It collects artifacts from these data repositories and stores the artifacts in a data warehouse.
To set up and run an additional computer as a report server and collection agent:
You must set up a Rational ProjectConsole data warehouse in preparation for creating a Rational ProjectConsole data repository. The data repository is used to store metadata about the data warehouse and the security database. The Rational ProjectConsole security database is used to store the navigation tree structure information and user and group authentication and authorization information.
The security database is created from IBM Cloudscape(TM) version 10.1.2 software. Cloudscape is installed with the Rational ProjectConsole server components and requires no additional configuration or setup. It contains information about navigation tree structure and authentication information for all users and groups for Rational ProjectConsole.
The database requirements and configuration information for the Rational ProjectConsole data warehouse are described in Configuring vendor databases.
Create the repository only after you install the Rational ProjectConsole server and create your data warehouse. The data warehouse is the database server in which data collected from software development tools and other Rational products is stored. You manage the data warehouse with the Rational ProjectConsole Maintenance Tool.
If you want to start using Rational ProjectConsole in a production environment, create a new data warehouse by using SQL Server, Oracle, or IBM DB2. Microsoft Access (runtime files only) is provided for demonstration purposes. Microsoft Access is not suitable for use as an enterprise data warehouse; use of quickly exceeds the capabilities of Microsoft Access. SQL Server, Oracle, and DB2 are more robust and better suited for an enterprise-scale data warehouse.
General instructions for configuring secure access for Rational ProjectConsole are in Appendix A on the Rational Web Platform. In addition to the procedures described there, you must import the key that is created in the IBM keystore into the Java keystore.
This section describes how to set up a Rational ProjectConsole client on your desktop and how to install the Rational ProjectConsole Template Builder. This section is intended for team members who want to access the Rational ProjectConsole Web site from a Web browser to view current project information.
For the most current information about Rational ProjectConsole features and known issues, see the IBM Rational ProjectConsole Release Notes.
Use the checklist in Table 8 to help you set up the Rational ProjectConsole Web client and the Rational ProjectConsole Template Builder on your desktop. The procedures are in the sections following the checklist. There are no postinstallation tasks for the Rational ProjectConsole Web client.
Done | Task |
Check the system and software requirements for the Rational
ProjectConsole Template Builder and the supported Web browser that you need
to run the Rational ProjectConsole Web client.
The Rational ProjectConsole Template Builder software is included in your installation. |
|
Check with your administrator to ensure that the Rational ProjectConsole Web site is operating before you continue with this checklist. | |
Set the minimum screen area for your browser. | |
In your Web browser, enable cookies. | |
Log in to the Rational ProjectConsole Web site. | |
Install the Java(TM) plug-in (first-time installations only). The plug-in is installed automatically the first time you run either the Rational ProjectConsole Dashboard or Designer applets. | |
Determine if you want to install the Template Builder software on your desktop. |
To use the Rational ProjectConsole Web site, set the screen area for your monitor to at least 1024 x 768 pixels. Otherwise, you might have problems accessing key Rational ProjectConsole components.
To use the Rational ProjectConsole Web site, enable cookies in your Web browser. For information about how to enable cookies, see the Help in your Web browser.
To log in to the Rational ProjectConsole Web site for the first time:
http://server-name/ProjectConsole
where server-name is the name of the Rational ProjectConsole server.
The first time you log in to the Rational ProjectConsole Web site and run either the Dashboard or Designer applet, you are prompted to install the required Java plug-in, if it is not already installed on your computer.
To install the Java plug-in, follow the instructions that are displayed on your screen for installing the plug-in.
After you install the Java plug-in, close all browser windows and log in to the Rational ProjectConsole Web site. If you are prompted to install the Java plug-in again the next time you attempt to run either of the Rational ProjectConsole applets, you might need to restart your system.
You can install Template Builder on any computer on which you want to create or modify Rational ProjectConsole report templates. You can install the Rational ProjectConsole Template Builder on a computer regardless of whether other Rational ProjectConsole components are installed on that computer.
The Rational ProjectConsole Template Builder is an add-in for Microsoft Word. To run Template Builder, a supported version of Microsoft Word must be installed on the Template Builder computer.
All Rational ProjectConsole report templates must reside on the Rational ProjectConsole Web Server. If you install and run the Rational ProjectConsole Template Builder on another machine, you must copy the generated report templates to the proper location on the Rational ProjectConsole Web server.
Rational Project Console schema and database use is based on the model used by Rational ClearQuest. As such, Rational Project Console schema repositories and user databases are types of databases that are physically managed by a database management system. Depending on your platform, these systems might include Microsoft Access, Microsoft SQL Server, Oracle RDBMS, IBM DB2, or the set of DB2 functionality available as part of IBM DB2 UDB components for Rational
For information about configuring vendor databases for use with Rational ProjectConsole, see the Vendor database topics at the Rational ClearQuest Information Center at IBM Installation Manager Information Center For information about upgrading databases, see Upgrading data warehouse connections
Guidelines for choosing vendor databases are available in Choosing a vendor database and When to use Microsoft Access
You must consider what platforms support the vendor database you plan to use for your databases.
The following databases are supported:
DB2 Express is provided at no cost on a separate CD. If you are planning on deploying a DB2 Express data warehouse, you must install the DB2 Express software on your database server. This software is not installed with .
To choose the vendor database that best meets your needs, follow these general guidelines:
Do not use Microsoft Access databases for production use. The runtime files are supplied solely for evaluation purposes. These runtime files are not the full version of Microsoft Access.
If you choose to use Microsoft Access for evaluation purposes, when you first run Rational ProjectConsole and are prompted to create a schema repository, specify the path to the shared directory and provide a file name for the schema repository. The appropriate Microsoft Access databases in the shared directory are then created and initialized.
Database case-sensitivity settings must be consistent when you are moving a database to a different vendor database.
Table 9 summarizes the case-sensitivity properties of the supported vendor databases.
Vendor database | Default setting | Possible settings | Comments |
---|---|---|---|
Microsoft Access | Not case-sensitive | Not case-sensitive | None. |
DB2 | Case-sensitive | Case-sensitive | None. |
SQL Server | Not case-sensitive, Case-sensitive | Not case-sensitive, Case-sensitive | Case sensitivity can be specified with either the installation time option or database creation time option. Case sensitivity applies to database object names and to data. |
Oracle | Case-sensitive | Case-sensitive | Case sensitivity applies to data only. |
This chapter explains how to configure the Rational ProjectConsole software after installation. It describes how to set up Rational ProjectConsole on the Rational ProjectConsole Web server (including report server and collection agent software), the data repository, and, optionally, on separate report server and collection agent computers.
The sections that follow assume that you have completed the following tasks:
When the Rational ProjectConsole server components are installed, the Rational Setup wizard creates two Microsoft Access Rational ProjectConsole sample database files that are part of the Rational ProjectConsole repository:
After installing the Rational ProjectConsole Web server components, you can log in to the Rational ProjectConsole Web site without rebooting. If you cannot log in to the Rational ProjectConsole Web site, see another section.
You can log in to the Rational ProjectConsole Web site from a Rational ProjectConsole client and start browsing the sample repository data. For information about how to log in to the Rational ProjectConsole Web site from a client, see Logging in to the Rational ProjectConsole Web site.
After you install and set up the Rational ProjectConsole server, log in as a Rational ProjectConsole administrator by typing admin in the User ID field and changeit in the Password field. To ensure Rational ProjectConsole Web site security, set up users (with user IDs and passwords) and groups for your development team immediately after you set up the Rational ProjectConsole server. Change the password on the admin account immediately after you log in to the Rational ProjectConsole site for the first time.
For information about setting up users and groups and managing site security, see the Rational ProjectConsole Help.
This section describes how to use the Rational ProjectConsole Maintenance Tool to configure Rational ProjectConsole software on the Rational ProjectConsole server and on any separate computers on which you installed the report server and collection agents.
To configure the Rational ProjectConsole services on the server or on an additional report server and collection agent:
After you click HTTPS, the value displayed in the Web server port field changes from 80 to 443. Your Web server must be configured to accept HTTPS connections for Rational ProjectConsole applications to connect by using the HTTPS protocol.
If you install the ProjectConsole Web server behind a firewall, you should set the RMI server name to a hostname or IP address that can be resolved from outside the firewall, and ensure that your firewall software forwards incoming requests to the Rational ProjectConsole Web server machine.
These values are set in the server.ini file.
After you complete this procedure, HTTP requests are routed to the Rational Web Platform server components on the Rational ProjectConsole server, and RMI connections to the Dashboard and Designer are correctly routed to the Rational ProjectConsole server.
This section explains how to create a Rational ProjectConsole repository based on Microsoft Access, SQL Server, Oracle, and DB2 database types.
The Rational ProjectConsole Maintenance Tool helps you create a repository for each supported database type.
To create a Rational ProjectConsole repository:
If you use the PjC Sample Site to initiate a new repository, you can modify it for use with your own data later.
You can use the PjC Empty Site as a starting point for building a Rational ProjectConsole Web site.
The three repositories in the Copy from repository list that are preconfigured for the software are read-only and can be used only as starting points for a new repository.
For information about dimension tables and measure tables, see Rational ProjectConsole Designer Help. For information about metrics displays, see Rational ProjectConsole Dashboard Help.
Leave the SchemaRepository and DataWarehouse fields blank. A pair of new databases are created in your Rational ProjectConsole data repository folder.
SERVER_VER=X.X
CLIENT_VER=X.X
If the database server is a machine other than the Rational ProjectConsole server, the Rational ProjectConsole server is the client.
When the repository is created, you see the message: Operation complete. (This can take some time depending on whether you are creating an empty repository or one that contains data.)
If an error occurs, examine one of the following log files to find the source of the error. Open the log file in a text editor that allows you to access files that can be opened by another application such as Notepad:
installdir\Rational\Common\rwp\EmbeddedExpress\profiles\profile1\logs\ProjectConsole.log
installdir\Rational\Common\rwp\EmbeddedExpress\profiles\profile1\logs\profile1\systemOut.log
This chapter describes the process for upgrading to the current version of Rational ProjectConsole.
Version 7.0.x of the IBM Rational Team products contains some significant changes to consider when upgrading to this release:
Version 7.0.1 of Rational ProjectConsole also includes a required upgrade to feature level 6 for Rational ProjectConsole databases and schemas. The upgrade is done through the Rational ProjectConsole Maintenance Tool. The tool detects whether an upgrade is needed. See Help for the Rational ProjectConsole Maintenance Tool for more information.
The rest of this chapter describes the process of preparing for your upgrade, performing the upgrade, and verifying the upgrade.
Table 10 provides instructions for upgrading from earlier releases of Rational ProjectConsole.
Previous version | Upgrade steps |
---|---|
Rational ProjectConsole for IBM Rational Suite 2002.05.xx for Windows |
|
Rational ProjectConsole for IBM Rational Suite 2003.06.14 or earlier for Windows |
|
Rational ProjectConsole for IBM Rational Suite 2003.06.15 for Windows |
|
If you are upgrading from release earlier than 2003.06.15, you must convert your security database to use IBM Cloudscape. The tool to do this is available from the Rational ProjectConsole Maintenance Tool in the 2003.06.15 release. To upgrade from a release earlier than 2003.06.15:
Before upgrading Rational ProjectConsole (and other IBM Rational products), plan the upgrade process carefully.
Preparing a plan is important because the upgrade process can be complex, with a number of dependencies among tasks. The plan allows you to sort out these dependencies so that you can upgrade your environment smoothly and efficiently.
Every IBM Rational product has prerequisites that must be met before the product can run properly. These prerequisites include specific operating systems and versions, database vendors and versions, and other software and hardware. It usually makes sense to install these products or to upgrade to these versions before you upgrade the IBM Rational product. This approach allows you to perform the upgrade process in a series of smaller steps rather than all at once. Upgrading in phases allows you to control the risks of the upgrade process better and makes it easier to diagnose and fix problems that arise.
For Rational ProjectConsole, verify that these prerequisites have been met before you upgrade your installation.
When you have an upgrade plan and you have met the external requirements, test your upgrade plan. Test the plan on test systems with copies of your Rational ProjectConsole databases. Testing is the best way to see how long the process takes, to identify any problems in the plan, and to ensure that the plan is accurate before you upgrade your production databases.
After you meet the product requirements and test your upgrade plan, you are ready to start the upgrading process.
Before you begin, shut down the Rational ProjectConsole Web server and back up all databases and other repositories. This precaution allows you to restore your systems to the original state if something goes wrong. If multiple Rational ProjectConsole Web servers are deployed in your organization, you must backup each server. Perform the following steps:
The 2002.05.xx. version of all Rational products must be uninstalled manually before you upgrade to version 7.0.x. If you are upgrading from version 2003.06.xx of the Rational Suite, you might want to uninstall it manually before upgrading. If you do not uninstall version 2003.06.xx, the version 7.0.x installation automatically uninstalls this version.
To upgrade your Rational ProjectConsole Web server:
Migrate any data from 2003.05.xx repositories. Migrate your Rational ProjectConsole data from the old repositories to the new repositories. This task includes migrating the users and groups that were stored previously in the Rational ProjectConsole data warehouse into the new security database. It also includes migration of the Rational ProjectConsole explorer tree into the new security database.
To migrate the data:
This release of Rational ProjectConsole includes changes to the Rational Web Platform. The most visible change is the location to which the Rational ProjectConsole Web application is deployed. In version 2003.06, the Rational ProjectConsole Web application was stored in:
..\rational\common\rwp\webapps\ProjectConsole
In version 7.0.x, the Rational ProjectConsole Web application is stored in:
..\rational\common\rwp\EmbeddedExpress\Profiles\ InstalledApps\defaultNode\PJCWASAPP.ear\PJCWeb.war
The installation process moves your Rational ProjectConsole security database to the new folder, restoring the Rational ProjectConsole explorer tree. However, you must manually relocate all of the following items:
In this release, the PublishedViews folder has been moved to the installdir\Rational\ProjectConsole\webfiles folder. This move was required to accommodate the extended path name prefix for the new version of Rational Web Platform (RWP).
Therefore, the connection parameters stored for your DB2 database must be updated. When you run the Rational ProjectConsole Maintenance Tool and select Connect to a Data Repository, there is a check box that enables you to change the database configuration settings. You must obtain the updated parameters from your DB2 administrator.
2003.06.15 service name | 7.0.x 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 |
Upgrading the Rational ProjectConsole collection server is a simpler process than upgrading the Rational ProjectConsole Web Server. The version 2002.05.xx release of all Rational products must be uninstalled manually before upgrading to version 7.0.x. If you are upgrading from version 2003.06.xx of Rational Suite, you might want to uninstall it manually before upgrading to version 7.0.x. If you do not uninstall version 2003.06.xx, the version 7.0.x, installation automatically uninstalls this version.
To upgrade your Rational ProjectConsole collection servers:
Accept the default install options. Do not install the Rational ProjectConsole Web server components.
2003.06.15 service name | 7.0.x 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 |
After the Rational ProjectConsole Web server and Rational ProjectConsole collection servers are upgraded, restart the Web server and each collection server to verify that they are working properly.
After you restart the systems, log in to the Rational ProjectConsole Web server and verify that you can display your Rational ProjectConsole tree nodes, use the Designer and Dashboard applets, generate artifact reports, and run metrics collections.
After all Rational ProjectConsole servers and all applicable IBM Rational products are restarted, you can announce the availability of Rational ProjectConsole and the other products to your users. It should now be possible to access all upgraded databases using both version 7.0.x and earlier client versions.
The supported database vendors and versions have changed. See Table 11 for a complete list of the database vendors and versions for version 7.0.x. In some cases, the version of the database that you are using might no longer be supported.
One upgrade requirement is to upgrade to version 2003.06.15 first to convert the embedded SQL Anywhere security database to the IBM Cloudscape format. For every supported database vendor, there is a version supported by both version 2003.06.15 and version 7.0.x.
Upgrade your database to the version supported by both the 2003.06.15 and 7.0.x release while you still have the 2003.06.15 release installed. After you upgrade the database version, make sure that your 2003.06.15 version of Rational ProjectConsole is working properly before upgrading to the 7.0.x release.
Database version | Rational ProjectConsole v2002.05.20 | Rational ProjectConsole v2003.06.00 to v2003.06.12 | Rational ProjectConsole v2003.06.13 to v2003.06.15 | Rational ProjectConsole 7.0.x |
---|---|---|---|---|
IBM DB2 7.1 | Yes | No | No | No |
IBM DB2 7.2 | Yes | Yes | Yes | No |
IBM DB2 8.1 | No | Yes | Yes | Yes |
IBM DB2 8.2 | No | No | No | Yes |
IBM DB2 9.1 | No | No | No | Yes |
IBM DB2 9.5 | No | No | No | Yes |
Microsoft Access 97 | Yes | Yes | Yes | No |
Microsoft Access 2000 | Yes | Yes | Yes | No |
Microsoft Access 2003 | No | Yes | Yes | No |
Microsoft SQL Server 7.9 SP3 | Yes | No | No | No |
Microsoft SQL Server 7.0 SP4 | Yes | Yes | Yes | Yes |
Microsoft SQL Server 2000 SP1 | Yes | No | No | No |
Microsoft SQL Server 2000 SP2, SP3 | Yes | Yes | Yes | Yes |
Microsoft SQL Server 2005 | No | No | No | Yes |
Oracle 8.0.5 | Yes | No | No | No |
Oracle 8.1.6 and 8.1.7 | Yes | Yes | Yes | No |
Oracle 9i | No | No | Yes | Yes |
Oracle 10g | No | No | Yes | Yes |
Oracle 11g | No | No | No | Yes |
Sybase SQL Anywhere 5.5.04 | Yes | Yes | Yes | No |
Sybase SQL Anywhere 8.0.1 | No | Yes | Yes | No |
Sybase SQL Server 2005 SP2 | No | No | No | Yes |
The ODBC drivers used to connect to DB2 in the 2003.06 have been replaced. One benefit of using the new drivers is that DB2 client software is no longer required to connect to a DB2 database hosted on a remote DB2 server. However, to connect to the DB2 database using the new drivers, the connection parameters must be changed. Refer to Table 12 and Table 13 for a mapping between the connection parameters used in the 2003.06.15 release and the connection parameters used version 7.0.
After installing version 7.0.x, you must run the ProjectConsole Maintenance Tool and reconnect to your DB2 data repository. The connection screen of the ProjectConsole Maintenance Tool is populated with parameters used to connect to the 2003.06.15 version for the old ODBC driver. You must select the Edit Warehouse Information button and update the connection parameters to match the parameters given to you by your database administrator.
Parameter | Description |
---|---|
Schema repository name | DB2 alias for the schema repository |
Schema repository user name | User name for the schema repository database |
Schema repository password | Password for the schema repository database |
Data warehouse name | DB2 alias for the data warehouse |
Data warehouse user name | User name for the data warehouse database |
Data warehouse password | Password for the data |
Parameter | Description |
---|---|
Database server | Host name of the DB2 database server |
Connect options | Port=nnnnn; (required only if DB2 is not using port 500000). |
Schema repository name | DB2 database name for the schema repository |
Schema repository user name | User name for the schema repository |
Schema repository password | Password for the schema repository |
Data warehouse name | DB2 database name for the data warehouse |
Data warehouse user name | User name for the data warehouse |
Data warehouse password | Password for the data warehouse |
Although Rational ProjectConsole does not support Microsoft Access for production use, many people use it to create demos or for proof of concept. In the 2003.06.15 release of Rational ProjectConsole, when you created a Microsoft Access data repository, it was based on a Microsoft Access 97 schema. Beginning with version 7.0, Microsoft Access 97 is no longer supported, and you are required to upgrade your databases to a Microsoft Access 2000 (or later) file format.
All new ProjectConsole data repositories created in version 7.0.x are automatically generated in the Microsoft Access 2000 format.
If you have any Microsoft Access data repositories, you have the following upgrade options.
You must have Microsoft Access 2000 or a later version installed to use this procedure.
If you are using a version of Oracle supported by both the 2003.06.15 release and version 7.0.x, no changes are required in to connect to your SQL Server databases.
If you are using a version of Oracle supported by both the 2003.06.15 release and version 7.0, no changes are required in 7.0 to connect to your Oracle databases.
SQL Anywhere is no longer supported. If you are using SQL Anywhere for your Rational ProjectConsole data warehouse, you must convert each of your data repositories from SQL Anywhere to a supported database vendor.
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 might be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right might 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 might 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 might 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 might 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 might 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 might vary significantly. Some measurements might 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 might have been estimated through extrapolation. Actual results might 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, IBM, Passport Advantage, ProjectConsole, Rational, Rational Portfolio Manager, Rational Suite, SoDA, SP1, and SP2, 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 might be trademarks or service marks of others.