IBM Rational Quality Manager, Version 1.0

Installation Guide

Windows and Linux


Note

Before using this information and the product it supports, read the information in Notices.

Contents

Installing Rational Quality Manager
Introduction
Installation terminology
Available editions
Licenses
Installation requirements
User privilege requirements
Hardware and software requirements
Installation Manager overview
Planning features to install
Installing Installation Manager
Setting installation preferences
Specifying the repository
Installing Rational Quality Manager
Enabling Firefox 2.0 to accept cookies
Enabling cookies on Internet Explorer
Administrator's account
Logging on to and logging out of Rational Quality Manager
Configuring the Rational Quality Manager server
Starting and stopping the Rational Quality Manager server
Installing licenses
Project areas, team areas and user IDs
Creating an initial user account with admin privileges
Creating sample user accounts
Installing sample data
Configuring Rational Quality Manager for use with DB2 V9.1
Configuring Rational Quality Manager for use with WebSphere Application Server 6.1.0.15
Installing a security certificate
Disabling security certificate settings
Modifying the Apache Tomcat settings
Modifying the WebSphere Application Server settings
Integrations and migrations
Getting Started with IBM Rational Quality Manager
Providing feedback on the online help
Uninstalling Rational Quality Manager
Uninstalling Installation Manager
Notices
Trademarks and service marks

Installing Rational Quality Manager

Introduction

This installation guide provides instructions for installing, updating, and uninstalling Rational(R) Quality Manager.

An HTML copy of this Installation Guide is available in the documentation directory of the first product CD.

Note:
See http://www.ibm.com/software/rational/support/documentation/ for updated documentation and troubleshooting information.

Installation terminology

Understanding these terms can help you take full advantage of the installation information and yourIBM(R) Rational Quality Manager.

These terms are used in the installation topics.

Installation directory
The location of product artifacts after the package is installed.
Package
An installable unit of a software product. Software product packages are separately installable units that can operate independently from other packages of that software product.
Package group
A package group is a directory in which different product packages share resources with other packages in the same group. When you install a package using Installation Manager, you can create a new package group or install the packages into an existing package group. (Some packages cannot share a package group, in which case the option to use an existing package group is unavailable.)
Repository
A storage area where packages are available for download. A repository can be disc media, a folder on a local hard disk, or a server or Web location.
Shared directory
In some instances, product packages can share resources. These resources are located in a directory that the packages share.

Available editions

IBM Rational Quality Manager is available in two editions: Express and Standard. These editions offer a flexible solution to meet your current and future needs.

The editions vary in licensing and feature configurations. Depending on the edition that is licensed for your use, different features are available to you. In addition, the different editions include different numbers and kinds of Client Access Licenses.

Table 1. Editions of Rational Quality Manager Version 8.0
Feature Express Standard
Maximum number of users 5
The licenses include 3 tester Client Access Licenses
250
The licenses include 3 tester Client Access Licenses
Databases included.
Optional databases are listed between pparenthesis
Derby and DB2(R) Express
(DB2, Oracle)
Derby and DB2 Express
(DB2, Oracle)
Application Server included (optional) Tomcat
(IBM WebSphere(R) Application Server)
Tomcat
(IBM WebSphere Application Server)
Work item tracking Included Included
Server level permissions Included Included
LDAP authentication Included Included
Customizable work item attributes and workflow Included Included
Reports Included Included
Dashboards Included Included
ClearQuest(R) Connector Included Included
LDAP import Included Included

Licenses

Both IBM Rational Quality Manager editions operate under a 60 day trial server license. Both editions come with a set of included Client Access Licenses with a predefined configuration.

To update a trial server from operating under a trial period, the server activation key must be installed. The key for updating the Express and Standard editions is the same. The administrator installs the license keys through the License Key Management page. See Installing licenses for step-by-step directions.

The server activation kit must be installed prior to installing any of the unlocked Client Access Licenses.

The two tables show the number of licenses that each edition includes, as well as the number of evaluation licenses.

Table 2. Client Access Licenses of Rational Quality Manager Version 8.0, Express edition
Client Access Licenses Number of Available Licenses Included Number of Available Licenses for Evaluation
Tester 3 5
Viewer 0 10
Functional Connector 3 3
Table 3. Client Access Licenses of Rational Quality Manager Version 8.0, Standard edition
Client Access Licenses Number of Available Licenses Included Number of Available Licenses for Evaluation
Tester 3 250
Viewer 0 250
Functional Connector 250 250

Installation requirements

Installation requires the correct hardware, software, server environment, operating systems, and other factors.

User privilege requirements

You must have a user ID that meets specific requirements before you can install your product.

Verify that your user ID meets these requirements before you begin to install your product:

Hardware and software requirements

Verify that your hardware and software meet or exceed the minimum requirements. If your hardware and software do not meet the minimum requirements, you might be unable to install or run your product.

Hardware and software requirements specify the minimum hardware components and installed software for installing and running your product. If your computing environment does not meet or exceed the minimum requirements, you might be unable to install and run your product. Check for each item before you start the installation.

Before you can install the product, verify that your system meets the minimum hardware requirements.

Hardware requirements

Operating systems requirements

Desktop

One of the following operating systems:

Server

Note:
Although the server works on Windows XP and Windows Vista, these operating systems are not supported production environments. Windows XP and Windows Vista operates well enough to allow an individual or small team to explore the product and many of the features.

Application servers

One of the following application servers:

Relational databases

One of the following databases:

Eclipse

Java(TM)

Web browsers

Identity management systems

The following LDAP servers for identity management are supported:

Installation Manager overview

IBM Installation Manager is a program for installing, updating, and modifying packages. It 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.

Installation Manager provides tools that help you keep packages up to date, modify packages, manage the licenses for your packages, and uninstall packages.

Installation Manager includes six wizards that make it easy to maintain packages:

Planning features to install

You can customize Rational Quality Manager by selecting which features to install.

When you install the product package by using IBM Installation Manager, the installation wizard displays the features in the available product package. From the features list, you can select which to install. A default set of features is selected for you (including any required features). Installation Manager automatically enforces any dependencies between features and prevents you from clearing any required features.

Tip:
After you finish installing the package, you can still add or remove features from your software product by running the Modify Packages wizard in Installation Manager.

Installing Installation Manager

IBM Installation Manager is the tool that you use to install your software packages. It is installed automatically when you start the installation for your package.

If Installation Manager is not already installed, you must install it before you can install your package. The installation happens automatically in these circumstances:

The latest version of Installation Manager might be required for your package. Updates are discovered automatically if you have not cleared the Search service repositories for updates check box on the Installation Manager preference page.

Setting installation preferences

You can set preferences for IBM Installation Manager to customize the way it installs your software.

Use the Preferences window to set user preferences for Installation Manager. To open the Preferences window, click File -> Preferences.

Specifying the repository

A repository is a location for storing installation or update package data. By default, IBM Installation Manager uses an embedded URL in each product package to connect to a repository server through the Internet and search for available installation packages and new features. You can set these repository locations on the Repositories page of the Preferences window. Your organization might require that you redirect the repository to use intranet sites.

Note:
Before starting the installation process, be sure to obtain the installation package repository URL from your administrator or IBM.

To add, edit, or remove a repository location:

  1. On the Start page of Installation Manager, click File -> Preferences, and then click Repositories. The Repositories page opens, showing available repositories, their locations, and whether they are connected.
  2. On the Repositories page, click Add Repository.
  3. In the Add repository dialog box, type the URL of the repository location or use Browse to find a .zip or JAR file that contains a repository, a diskTag.inf file, or the repository.config file of an expanded repository; then click OK. The new repository location is listed. If the repository is not connected, a red x is displayed in the Connection column.
  4. Click OK to close the Preference page.

Note:
Updates to packages can be stored in service repositories, for example IBM support sites or local update repositories, which might be linked to the repositories that you have listed in the previous procedure. To search for updated packages in these linked service repositories, make sure Search service repositories during installation and updates is selected. This option is selected by default.

Installing Rational Quality Manager

This topic provides step-by-step instructions for installing IBM Rational Quality Manager.

Rational Quality Manageris made available as a compressed file and it includes a copy of IBM Installation Manager Version 1.2. Before starting the installation process, extract the compressed file to a temporary directory, and then start the installation process. The first application to be installed is Installation Manager. When Installation Manager has been installed, you continue by installing Rational Quality Manager.

The procedure guides you through the installation of Installation Manager and of Rational Quality Manager.

To install both applications on the Windows or Linux operating systems:

  1. Navigate to the temporary directory where you extracted the compressed files.
  2. Start the installation process by running install.exe. This starts Installation Manager and opens the Install Packages window. Installation Manager is automatically selected.
  3. Click Next.
  4. Accept the license agreement, and click Next.
  5. Accept any default values, and click Next until you see the Install Status window.
  6. Click Install to install Installation Manager.
  7. Upon completion of the installation, optionally click View Log File to review the Installation Manager installation log; then click Close when you are done.
  8. Click Restart Installation Manager. You now proceed to install Rational Quality Manager and IBM Rational Test Lab Manager.
  9. In the Installation Manager window, click Install.
  10. In the Install Packages window, select Rational Quality Manager and IBM Rational Test Lab Manager, and then click Next.
  11. Accept the license agreement, and click Next.
  12. Accept the default location for the shared resources, and click Next.
  13. Accept creating a new package group, and click Next.
  14. To install the software in a language other than English, select one or more languages to install, and click Next.
  15. Accept the installation of Rational Quality Manager and IBM Rational Test Lab Manager, and click Next.
  16. Click Install to start the installation process.
  17. Upon completion of the installation, optionally, click View Log File to review the installation log.
  18. Click Finish.
  19. Click File -> Exit to close Installation Manager.

Enabling Firefox 2.0 to accept cookies

To log on to IBM Rational Quality Manager, enable your Firefox Web browser to accept cookies.

To enable accepting cookies:

  1. Open the browser, and click Tools -> Options -> Privacy.
  2. Select Accept cookies from sites.
  3. Set Keep until to they expire.
  4. Click OK.

Enabling cookies on Internet Explorer

This topic provides directions to configure the Internet Explorer Web browser to accept cookies.

To enable accepting cookies:

  1. Open the browser, and click Tools -> Internet Options -> Privacy.
  2. Move the slider to Low or Accept all cookies.
  3. Click OK.

Administrator's account

The installation process creates one default administrator account.

You access the administrative functions by pointing your Web browser to one of these two URIs:

The default administrator's logon credentials are:

The username and password fields are case-sensitive.

Note:

For enhanced server security, create a new user account with administrative privileges and then

disable the default administrator account. This installation guide walks you through the process of creating a new user ID with administrative privileges, and how to disable the default administrator account.

Logging on to and logging out of Rational Quality Manager

This topic provides procedures for to logging on to and logging out of IBM Rational Quality Manager.

Logging on as administrator

When you log on to your product for the first time after installation, log on as administrator.

From the Admin's dashboard, you access Admin functions from the action bar. When you log on as a regular user, this icon and the admin functions are not available.

To log on to Rational Quality Manager as administrator:

  1. Open a Web browser.
  2. Start Rational Quality Manager by pointing your browser to one of these addresses:
  3. Log on as administrator. See Administrator's account to log on as an administrator. The browser will take a few minutes to respond to the first logon as administrator. Also note that the initial logon after subsequent server startup will take a minute or so as the system initializes.

Logging on as user

To log on to Rational Quality Manager as a regular user:

  1. Open your Web browser.
  2. Start Rational Quality Manager by pointing your browser to this address:
    https://localhost:9443/jazz/web/console/QM
  3. Log on using the user ID and password that the administrator created.

Logging out

To log out of Rational Quality Manager, click Log out.

Configuring the Rational Quality Manager server

Choose between Fast Path Setup andCustom Setup to configure the IBM Rational Quality Manager server.

The Setup wizard walks you through the various tasks that are required to configure the Rational Quality Manager server. These tasks include database configuration and connections, mail server setup, and user management. To start the Setup wizard:

  1. Point your Web browser to https://<localhost>:9443/jazz/setup
  2. Log on using the default Administrator's account credentials. The Setup wizard starts.
  3. Choose Fast Path Setup for using a default configuration or choose Custom Setup to configure your own databases and enable e-mail notifications.
  4. Follow the on-screen instructions and steps to complete the configuration.
  5. Click Finish.

Starting and stopping the Rational Quality Manager server

After installing the software, you must start the IBM Rational Quality Manager server.

Starting the server

To start the server from the Windows Start menu:

To start the server from a command prompt, enter one of these commands:

Stopping the server

To stop the server from the Windows Start menu:

To stop the server from a command prompt, enter one of these commands:

Installing licenses

When the trial licenses expire, you need to install the permanent license keys using the License Key Management function. Installing the license keys updates trial licenses into valid operating licenses.

The License Key Management function requires that you log on as administrator.

To install the license keys:

  1. Point your Browser to the Jazz(TM) Admin address: https://localhost:9443/jazz/admin, where localhost is the name of the server where the IBM Rational Quality Manager server is running.
  2. Log on as administrator.
  3. Click Admin, and select License Key Management under Configuration.
  4. To install a locked activation key, under the Server Activation Key section, click Browse, and then point to the License Activation Key file.
  5. To install an unlocked activation key, under the Client Access License Activation Key section, click Browse, and then point to the License Activation key file.
  6. While installing the CAL activation key, you MUST input the required and purchased number of licenses in the Purchased field . Failing to complete this field will result in the license not being enabled even though you have purchased and installed the license.

The following items show examples of license activation key filenames:

Project areas, team areas and user IDs

When the Rational Quality Manager installation is completed, your next step is create a new user account with the necessary admin and licenses privileges.

The installation process creates a single default project area named Quality Manager which contains one team area called Quality Manager Team.

Note:
This version of Rational Quality Manager only supports one project area. However, you can add more team areas to the default project area.

After the installation process completes, log on as Administrator and create a user ID to which you assign administrative privileges. Once that account has been created, log out as Admin, and then log on again using the user ID with administrative privileges.

Use this newly created administrative account to create additional user IDs, assign a Client Access License to each user ID, and add these IDs to the Quality Manager's team area.

Note:
To maximize the learning experience using the tutorials, consider creating the two recommended sample user accounts instead of using real user IDs. When no longer needed, you can archive these sample accounts.

If the Rational Quality Manager server is running, stop the server first. Then create the user IDs and assign them a role-based license. When done, start the Rational Quality Manager server again. .

Creating an initial user account with admin privileges

For enhanced security, create a new user account with administrative privileges to replace the default administrator account.

You must first create a new user account that has the necessary administrator permissions and licenses, and then use that account to create user IDs, assign the client access licenses, and add these user IDs as members to the Quality Management Team area. .

To create an initial user account with admin privileges:

  1. If the RQM server is running, shut it down first. For instructions, see Starting and stopping the Rational Quality Manager server.
  2. Point your Web browser to the Jazz Admin URI:
    /jazz/admin#action=jazz.viewPage&id=com.ibm.team.repository.users
  3. Log on as Administrator using the logon credentials of the default Administrator's account.
  4. Select the User Management tab, and then click Create User.
  5. Type a user name, user ID and e-mail address.
  6. Under Repository Permissions ensure that the new user has been granted "JazzUsers" permissions. (This will make the user a regular user of the server and its applications.)
  7. Under Client Access Licenses ensure that the new user has been granted Tester licenses. Note that the product ships with a limited number of available licenses; the user interface will display the number currently available next to each type.
  8. Save the user by clicking Save.
  9. Log out from the Jazz Admin site.
  10. Log on again using the logon credentials of this new user account. The initial password for manually created users corresponds to their user ID.

Creating sample user accounts

To enhance the learning experience using the tutorials, create the following user accounts.

Make sure you have created a new user account with administrative privileges. For step-by-step instructions, see Creating an initial user account with admin privileges. Also make sure that the IBM Rational Quality Manager server is stopped.

Give each user account that you create the Rational Team Concert - Developer and the Rational Quality Manager - User client licenses. Based on the Rational Quality Manager edition that you install, a default number of licenses is available for assigning. For details on available licenses for your edition, see Licenses. The suggested sample user IDs and passwords to create are as follows:

User User ID Initial password Client Access License
Amy, Test Architect amy amy Tester
Mary, Test Manager mary mary Tester
Carmen, Test Lead carmen carmen Tester
Tony, Tester tony tony Tester
Larry, Lab Manager larry larry Tester

To create the sample account "Amy":

  1. Click the Admin tab; then click Users.
  2. Click Create New User.
  3. Edit the following fields:
  4. In the Repository Permissions pane, select the Rational Quality Manager - User license.
    Note:
    Passwords and repository permissions are valid only if the server is running with a secure connection. When you create a new user, the default password is the same as the user ID.
  5. Click Save.
  6. Repeat for the remaining sample user accounts, using the credentials and permissions shown in the table.

Installing sample data

Run this command to install sample data and to create artifacts in the repository for use with the tutorials.

To install the sample data:

  1. If the RQM server is not running, start it now.
  2. Change to the directory that contains the sample script:
    1. On Windows, go to C:\Program Files\IBM\RQM80\samples\classics
    2. On Linux, go to /opt/IBM/RQM80\samples\classics
  3. Run the install script:
    1. In Windows, type install_samples.bat /s https://localhost:9443/ /u ADMIN /p ADMIN

      where localhost is the host name of your Quality Manager server and 9443 is the port number.

    2. In Linux, type install_samples.sh -s https://localhost:9443/ -u ADMIN -p ADMIN

      where localhost is the host name of your Quality Manager server and 9443 is the port number.

    The artifacts are created in the repository.
  4. To validate that the samples were installed successfully, click Start > All Programs > IBM Rational Quality Manager > IBM Rational Quality Manager to start the Quality Manager client.
  5. From the left navigation, point to the Planning icon and click All Test Plans. At minimum, you should see the Classics Java and classics Java II test plans.

Configuring Rational Quality Manager for use with DB2 V9.1

Follow these instructions to install DB2, create a DB2 database, and configure Rational Quality Manager for use with DB2

To install and configure Rational Quality Manager for use with DB2:

  1. Review the Rational Team Client documentation fully before proceeding. The documentation is available from jazz.net at https://jazz.net/jazzdocs/index.jsp?topic=/com.ibm.team.concert.doc/helpindex_rtc.htm. then open topic: Installing and upgrading > Installing Rational Team Concert > Installing Rational Team Concert Standard edition > Setting up the database
  2. Follow the instructions outlined in the topic: Installing and upgrading > Installing Rational Team Concert > Installing Rational Team Concert Standard edition > Setting up the database
  3. If DB2 has not yet been installed, do so now. Follow the instructions in the DB2 installation guide.
  4. Install fix pack FP4 for DB2 v9.1.
  5. Install the license for DB2. Use DB2_Enterp_Svr_CPU_Activation.zip.
  6. Copy DB2_Enterp_Svr_CPU_Activation.zip to a temporary folder on the DB2 Server; for example: C:\temp dir
  7. Extract the compressed file.
  8. Run the db2cmd and the following command: db2licm -a C:\temp\db2\license\db2ese_c.lic Note that during the DB2 installation, the installer requests a user name and password to be used for DB2 administration. Remember these credentials as you will need them later for including them in the teamserver.properties file
  9. On the DB2 server machine, start the DB2 Control Center.
  10. Right-click on All Databases, select Create Database, and then select Standard. The Create Database Wizard starts.
  11. On page 1 of the Create Database Wizard do the following:
    1. As database name, type: RQM
    2. Specify the default path. For example: C:\
    3. Select the option Let DB2 manage my storage (automatic storage)
    4. Specify 16K as the value for bufferpool and tablespace
    5. Click Next.
  12. On page 2 of the Create Database Wizard, do the following:
    1. Accept the default values.
    2. Click Next.
  13. On page 3 of the Create Database Wizard, make sure the following are set as indicated below:
    1. Country/Region is set to default.
    2. Territory is set to :US.
    3. Code Set is set to: UTF-8.
    4. Collating Sequence is set to System
    5. Click Next.
    6. Click Finish. The next series of steps are completed on the Rational Quality Manager server.
  14. Configure RQM database properties. RQM uses a file called teamserver.properties to specify various properties including database settings. By updating the teamserver.properties file you are able to use the DB2 database instead of the Derby database.
  15. To configure teamserver.properties for DB2, perform these steps:
    1. In the teamserver.db2.properties; change database host name (or IP), database name, DB2 user name and passwordd as shown in the graphic below.
      Example of teamserver.db2.properties file highlighting the location of the hostname, database name, admin user ID and password, and db2 table space size within the file.
    2. Add the following lines to the "teamserver.db2.properties" file (change the port numbers to match your WAS configuration): //websphere port configurationcom.ibm.team.repository.server.repourl.port.http=9081com.ibm.team.repository.server.repourl.port.https=9444
    3. Rename the existing file named teamserver.properties to teamserver.propertiesBAK
    4. Rename teamserver.db2.properties to teamserver.properties.
  16. Edit provision profiles. Jazz uses provision profiles to specify the plugin path for future fix pack and release updates. These profiles are also used when database tables are created. The provision profiles need to have a complete path for the update directory to function correctly. There are currently 3 provision profiles (C:\RQM\server\provision_profiles); edit each to include full path as follows: :
    1. profile.ini: url=file:///C:/RQM/server/update-site featureid=com.ibm.team.rtc.server.feature
    2. rqm-license-profile.ini: url=file:///C:/RQM/server/rqm-license-update-site featureid=com.ibm.rqm.licensing.standard.feature
    3. rqm-profile.ini: url=file:///D:/RQM/server/rqm-update-site featureid=com.ibm.rqm.server.feature
    1. For RHEL5: url=file:/opt/IBM/RQM/server/ OR url=file:///opt/IBM/RQM/server/
    2. For SLES10: url=file:/opt/IBM/RQM/server/
  17. Create database tables. nNow that the teamserver.properties and provision profiles have been changed, a Jazz utility called repotools must be run to create the database tables. The repotools.bat utility file is located in [RQM install path]\RQM\server\repotools.bat.
    1. Open a command window.
    2. Run repotools.bat: repotools -createTables logFile=/tmp/repotools.log
  18. Save a copy of the teamserver.properties and provision profiles files to use for next time you install a build.
  19. DB2 database backup: On the DB2 server, make a backup a copy of the database after initial creation (including users) to be able to quickly refresh the database for testing purposes. In DB2, right-click on the database and select "Backup ...". To restore, right-click on the database and select "Restore ..."

Configuring Rational Quality Manager for use with WebSphere Application Server 6.1.0.15

Follow these instructions to install WebSphere Application Server, and configure Rational Quality Manager for use with WebSphere Application Server

Planning for the configuration

Review the Rational Team Client documentation fully before proceeding using the documentation from jazz.net which you can find at: https://jazz.net/jazzdocs/index.jsp?topic=/com.ibm.team.concert.doc/helpindex_rtc.htm Then open the topic Installing and upgrading > Installing Rational Team Concert > Installing Rational Team Concert Express edition > Starting the server

With this information as a base, perform remaining steps in this section

Installing WebSphere Application Server

  1. If you don't have WebSphere Application Server (WAS) installed, do so now. See the WebSphere Application Server installation guide for step-by-step directions.
  2. Install the WAS FixPacks WASSDK FP13 and WASSDK FP15. WAS 6.1 requires Java SDK 1.5 SR6 Cumulative Fix for WebSphere Application Server for proper Jazz support. To install the fixpack, you must first install the "Update Installer". At a minimum, WASSDK FP13 (which corresponds to IBM JDK SR6) must be applied. The Jazz WebSphere installation instructions point to this very fixpack. Reference the Jazz Infocenter (https://jazz.net/jazzdocs/index.jsp?topic=/com.ibm.team.concert.doc/helpindex_rtc.htm) and see the section called 'Installing & Upgrading > Installing RTC > Installing Standard Edition > Starting the Server > Setting up a WAS server'. Here are the direct links to the fixpacks (13 and 15, either works).
    Note:
    Be sure to install the SDK Fixpack, not the regular Fixpack.
  3. Update JVM Arguments: The JVM arguments mentioned in the jazz.net document above are Rational Team Client specific and do not contain the full JVM arguments needed for proper deployment of Rational Quality Manager. Be sure to add the JVM arguments all on one line.
    -Dcom.ibm.team.server.configURL=file:///D:/RQM80/server/teamserver.properties -Dlog4j.configuration=file:///D:/RQM80/server/log4j.properties -Djava.awt.headless=true -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -Xmx1000M -Dcom.ibm.team.repository.provision.profile=/RQM80/server/provision_profiles -Dcom.ibm.rqm.create.samples=true -Xss768k

    If the JVM arguments values are entered incorrectly, the WAS server will not start. If this happens, you cannot use the WAS Web UI to correct this; you must locate the server.xml file, edit the file, and then start WAS. The file is typically found in this location:

    c:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\config\cells\qwin268Node01Cell\nodes\qwin268Node01\servers\server1\server.xml

Setting up the WAS custom registry

Set up the user credentials using the WAS custom registry by following these steps:

  1. Create directory called WAS_Security and add the users.props and groups.props files to the root of the drive where WAS is installed.
  2. From the Security-> Secure administration, applications, and infrastructure page, select Standalone custom registry from the User Account Repository section; then click the Security Configuration Wizard button.
  3. In Step 1 of Security Configuration Wizard, select Enable application security
  4. In Step 2, select Standalone custom registry
  5. In Step 3, add primary admin user name, name and value for both usersFile (users.props) and groupsFile (groups.props):
    Step 3 of Configure Security Wizard showing completed fields for admin username and location for usersFile and groupsFile
  6. Step 4: review summary, then click "Finish" button.
  7. - Save changes by clicking on "Save directly to the master configuration" - From Applications->Enterprise Applications, select the checkbox next to jazz.war, then click the Stop button (unless already stopped as indicated as red x)
  8. Select jazz.war link then select "Security role to user/group mapping".
  9. Select checkbox next to first role (JazzAdmins), then click on "Look up groups":
    Security role to user/group mapping
  10. Click the Look up groups button, then select "admins" from available list; add to selected list. Repeat for JazzDWAdmins, again selecting "admins". For JazzUsers and JazzGuests roles, select "users".
  11. Save the changes by clicking Save directly to the master configuration
  12. Complete the WAS configuration as documented by restarting the WAS server.

Staring WAS as a Windows service

By default, when WAS runs as a Windows service, it logs in as a local system account. As a result, it is possible that Quality Manager will be unable to access UNC shares because the local system account lacks security credentials. Therefore, be sure to set the WAS Windows service to log in as a specific user account with security credentials. This allows the service to connect to any UNC shares that match these security credentials.

Installing a security certificate

Replace the self-signed certificate with a certificate that belongs to your company.

Disabling security certificate settings

If you do not require secure connections, the security settings can be disabled.

Important:
The information below explains how to disable the SSL certificate. Following these steps allows unencrypted connections to the server, including user login credentials. If you require secure connections, create your own self-signed certificate identifying the host by its proper network name, or request a certificate signed by a trusted certificate authority (CA).

Modifying the Apache Tomcat settings

  1. Make sure you have started Apache Tomcat at least once already.
  2. Go to the JazzInstallDir/server/tomcat/webapps/jazz/WEB-INF directory.
  3. Edit the web.xml file in this directory and change all occurences of "CONFIDENTIAL" to "NONE".
  4. Go to the JazzInstallDir/server/tomcat/conf directory and edit server.xml.
  5. Remove the redirectPort attribute from the 9080 Connector element.
    <Connector port="9080" maxHttpHeaderSize="8192" 
      maxThreads="150" minSpareThreads="25" maxSpareThreads="75" 
      enableLookups="false" acceptCount="100" 
      connectionTimeout="20000" disableUploadTimeout="true" 
      URIEncoding="UTF-8"/>
  6. Restart Apache Tomcat.
  7. Verify that you can login using http://localhost:9080/jazz/admin and do not get redirected to https://localhost:9443/jazz/admin.

Modifying the WebSphere Application Server settings

  1. Modify the web.xml from the jazz .war file that was installed into WebSphere Application Server. You may need to extract the jazz .war file into a temporary area first to get to the file.
  2. Change all occurrences of "CONFIDENTIAL" to "NONE" (There should be 3).
  3. Make sure WebSphere Application Server is running and goto https://localhost:9043/ibm/console/logon.jsp.
  4. Goto the Applications -> Enterprise Applications page.
  5. Select the jazz_war application and click the Update button.
  6. Select the "Replace or add a single file" radio button option.
  7. In the "Specify the path beginning with the installed application archive file to the file to be replaced or added." entry field, enter "jazz.war/WEB-INF/web.xml".
  8. Click the browse button and select the same web.xml that was modified in an earlier step.
  9. Click next and follow through until the application has been saved.
  10. Go back to the Applications->Enterprise Applications page and stop and start the jazz_war application.
  11. Verify that you can login using http://localhost:9080/jazz/admin and not get redirected to https://localhost:9443/jazz/admin.

Integrations and migrations

The scope and function of IBM Rational Quality Manager can be extended through integrating and migrating test assets. The integration or migration of test assets is optional and is carried out after completing the Rational Quality Manager installation.

Integrating with Rational Quality Manager

Rational Quality Manager can be integrated with the following applications:

See the Integrating section in the online help for an overview and detailed step-by-step instructions on integrating Rational Quality Manager with any of these applications.

Migrating test assets into Rational Quality Manager

The following test assets created in these products can be migrated into Rational Quality Manager

See the Migrating section in the online help for an overview and detailed step-by-step instructions on integrating Rational Quality Manager with any of these applications.

Getting Started with IBM Rational Quality Manager

Consult the tutorials and online help to get started with Rational Quality Manager.

To help you get started with Rational Quality Manager, tutorials are available in the online help.

Click the Help button in the Global Navigation Bar to open the online help and access the tutorials.

Providing feedback on the online help

Make use of the built-in feedback link to report inaccurate or incomplete installation help.

The online help, including the installation topics, includes a feedback link at the bottom of each help topic.

To provide feedback on inaccurate, missing, or incomplete information for a given help topic:

  1. In the Page Control area, click Help to open the online help.
  2. Double-click a help topic in the Navigation pane to display the contents.
  3. Click Feedback at the bottom of the topic, and type your comments.

Your feedback is recorded in a central database that is monitored by to the documentation team.

Uninstalling Rational Quality Manager

You can uninstall IBM Rational Quality Manager.

With the Uninstall Packages option in IBM Installation Manager, you can uninstall the packages from a single installation location. To uninstall Rational Quality Manager:

  1. Log into the computer using the same user account that you used to install the product packages.
  2. Start Installation Manager.
  3. Click Uninstall Packages.
  4. Select the packages that you wan to remove, and click Uninstall.

Uninstalling Installation Manager

Follow these steps to remove IBM Installation Manager from your workstation.

Before you can uninstall IBM Installation Manager, you must uninstall all of the packages and products that were installed with Installation Manager. Close the Installation Manager before attempting to uninstall the program.

You must be logged onto your workstation with a user account that has the same privileges as the one used to install Installation Manager.

To uninstall Installation Manager, complete the following steps:

Note:
If you receive an error after uninstalling Installation Manager on Solaris, close the dialog box with the error message and manually delete the following empty directories: /var/ibm/InstallatoinManager/uninstall and /var/ibm/InstallationManager.

You have removed IBM Installation Manager from your workstation.

Notices

(C) Copyright IBM Corporation 2000, 2008. All rights reserved.

U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

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 documentation 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-0032, 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:

Intellectual Property Dept. for Rational Software
IBM Corporation
20 Maguire Road
Lexington, Massachusetts 02421-3112
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 measurements 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.

All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.

If you are viewing this information softcopy, the photographs and color illustrations may not appear.

Trademarks and service marks

IBM, the IBM logo, and ibm.com(R) are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. If these and other IBM trademarked terms are marked on their first occurrence in this information with a trademark symbol ((R) or (TM)), these symbols indicate U.S. registered or common law trademarks owned by IBM at the time this information was published. Such trademarks may also be registered or common law trademarks in other countries. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at http://www.ibm.com/legal/copytrade.shtml.

Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.

Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both.

Other company, product, or service names may be trademarks or service marks of others.