IBM Support

Stop processes and services for Rational products on Windows before updating

Troubleshooting


Problem

During an update on a Windows machine, you may receive a message stating that certain IBM Rational processes or services are running. The message text is the following: []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: You must stop the listed IBM Rational products processes and services before the update can continue.[] Note: The link in the message text is to this technote.

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.

In the stop the server commands, <profiledir> is one of the following:
  • 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:



taskkill /IM <process name>

For Windows 2000 Advanced Server, the "kill" tool is available in the Windows 2000 Resource kit. Install this tool, and then use the following command line to terminate the processes:

kill <process name>

Note: In both cases, <process name> is the name as shown by the Windows Task Manager, not necessarily the name shown by Installation Manager.

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.

[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Installation","Platform":[{"code":"PF033","label":"Windows"}],"Version":"7.1;7.1.0.1;7.1.0.2;7.1.1","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}},{"Product":{"code":"SSSH5A","label":"Rational ClearQuest"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Installation","Platform":[{"code":"PF033","label":"Windows"}],"Version":"7.1;7.1.0.1;7.1.0.2;7.1.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSSHCT","label":"Rational RequisitePro"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Installation","Platform":[{"code":"PF033","label":"Windows"}],"Version":"7.1;7.1.0.1;7.1.0.2;7.1.1","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}},{"Product":{"code":"SSSH6V","label":"Rational ProjectConsole"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Installation","Platform":[{"code":"PF033","label":"Windows"}],"Version":"7.0.2;7.0.2.1;7.0.2.2;7.0.3","Edition":"","Line of Business":{"code":"","label":""}},{"Product":{"code":"SSSHVH","label":"Rational TestManager"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Installation","Platform":[{"code":"PF033","label":"Windows"}],"Version":"7.0.2;7.0.2.1;7.0.2.2","Edition":"","Line of Business":{"code":"","label":""}},{"Product":{"code":"SSSHDX","label":"Rational Robot"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Installation","Platform":[{"code":"PF033","label":"Windows"}],"Version":"7.0.2;7.0.2.1;7.0.2.2;7.0.3","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSSHLQ","label":"Rational SoDA"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Installation","Platform":[{"code":"PF033","label":"Windows"}],"Version":"7.0.2;7.0.2.1;7.0.2.2;7.0.3","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Product Synonym

ClearCase;CC;ClearQuest;CQ;RequisitePro;RP;ProjectConsole;PjC;Robot;SoDA;TestManager;TM

Document Information

Modified date:
16 June 2018

UID

swg21385993