Stop processes and services for Rational products on Windows before updating

Resolving The Problem

Note: This applies only to Windows machines.


This is no longer an issue starting with version 7.1.1.1 of IBM Rational ClearCase, IBM Rational ClearQuest, and IBM Rational RequisitePro and version 7.0.3.1 of IBM Rational SoDA, IBM Rational ProjectConsole, and IBM Rational Robot. The installation will automatically stop processes and services as of those releases.

For earlier releases, you must stop all processes and services for any Team Product before updating or installing another Team Product. This is by design to avoid potential installation problems, since our products share many common components.

Services are displayed in a list and without extensions.

To shut down a service:

1. Go to Start > Control Panel.
2. Double-click Administrative Tools.
3. Double-click Services.
4. Right-click on the service you wish to stop and select Stop.

To stop a WebSphere Application Server shown as any of the following:

• CM Server
• Report Server for ClearQuest
• Full-Text Search Server
• RequisiteWeb Server
• ProjectConsole Web Server
  

1. If security is enabled, run the command: <profiledir>/bin/stopserver.bat server1 -username <user> -password <pass>.
2. If the service is running and you have modified the service to include the username and password to use when stopping the server using WASService.exe, right-click on the service in the Service Control Manager and click Stop.
3. If security is disabled, run the command: <profiledir>/bin/stopserver.bat server1, or in the Service Control Manager right-click on the service and click Stop.

• CM Server: <installdir>/common/CM/profiles/cmprofile
• Report Server for ClearQuest: <installdir>/common/CM/profiles/reportalprofile
• Full-Text Search Server: <installdir>/common/CM/profiles/cqsearchprofile
• RequisiteWeb Server: <installdir>/profiles/profile2
• ProjectConsole Web Server: <installdir>/profiles/profile1

Please note that some services may require a reboot to properly stop them. If Installation Manager continues to present the warning stating that services are still running, perform the following steps:

1. Go to Start > Control Panel.
2. Double-click Administrative Tools.
3. Double-click Services.
4. Right-click on the service that must be stopped, and select Properties.
5. Change the Startup Type to "Manual", and press OK.
6. Reboot the machine.
7. Launch Installation Manager, and proceed with the update.

To stop the process krcagent.exe, use one of the following two methods:

Method 1: Service Control Manager

1. Go to Start > Run.
2. Type Services.msc.
3. Locate the service labeled: "Monitoring Service for *". This service launches krcagent.exe.
   Note: There might be more than one service labeled: "Monitoring Service for *".
4. Double-click the service name. On the General tab, look at the Path to executable field to determine which service is the correct one.
5. If you are in the service properties panel, click Stop.
6. If you are in the service control manager, right-click on the service and click Stop.

Method 2: Tivoli Service Configuration Wizard

1. In the start menu, locate the Tivoli shortcuts under the programs menu.
2. Launch the service configuration tool. The services are listed here.
3. Right-click and click Stop.

Processes are usually associated with an open executable or application. To stop these processes, shut down the executable or application as you normally do.

To shut down a process that is not associated with an open window:

1. Start Task Manager.
2. Click the Processes tab.
3. Right-click on the process name you wish to stop and select End Process.

In addition, you can use the following command on Windows XP, 2003 Server, Vista, and 2008 Server operating systems to shut down a process from the command line:

Note: The executable ccperl.exe is a special case. Before you can stop ccperl.exe through Task Manager, you must perform the following actions:

1. Go to Start > Control Panel.
2. Double-click Administrative Tools.
3. Double-click Services.
4. Right-click on the service "Monitoring Agent for ClearCase - Primary" and select Stop.
5. Open Task Manager.
6. Click the Processes tab.
7. Right-click on each ccperl.exe process and select End Process.

Note: When upgrading CCRC on a machine with a pre-7.1.0.0 version of ClearCase installed as well, you may be asked to stop the ClearCase services. Following the completion of the CCRC update, you will have to restart ClearCase manually.

Please note that the NUTCRACKER service requires the following services to be stopped as well:

• MKS Rlogind
• MKS Secure Shell Service
• MKS Telnetd
• MKSAUTH
• REXECD
• RSHD

For example, the following error message indicates that the Atria Location Broker, IBM Rational Lock Manager, and Rational Cred Manager services should be shut down and the ClearCase Doctor application should be closed.

Processes or services associated with the products you are attempting to upgrade have been found. These must be stopped or shut down before continuing. Please see the following document for information on stopping services and processes: http://www-01.ibm.com/support/docview.wss?uid=swg21385993. The following processes or services are running: Atria Location Broker, IBM Rational Lock Manager, Rational Cred Manager, ccdoctor.exe.

You must stop the listed IBM Rational products processes and services before the update can continue.