IBM Support

How to prevent file deletion errors when installing, upgrading, rolling back, or uninstalling a Rational Team product

Technote (FAQ)


How do you prevent file deletion errors when installing, upgrading, rolling back, or uninstalling an IBM Rational Team product?


During an install, upgrade, rollback, or uninstall operation for an IBM Rational Team product, IBM Installation Manager checks for running processes.

If the running processes are using files located in the installation directory, Installation Manager blocks the install, upgrade, rollback, or uninstall operation.

You see a warning message telling you to stop running processes so that the operation can continue. In some cases, Installation Manager cannot detect that a file is in use.

As a result, the installation, upgrade, rollback, or uninstallation fails because one of the files to be deleted is still in use.


Preventive Steps

To prevent failures during install, upgrade, rollback, and uninstall operations for IBM Rational Team products, confirm that no files are in use before starting the operation.

  1. On Windows Server machines, disable terminal services.

    Terminal services allow you to establish multiple sessions on the same machine. Multiple sessions make it difficult to verify that all conflicting processes are stopped and remain stopped. Instructions for disabling these services are provided in Technote #1407537 Disable Terminal Services prior to updating, rolling back, modifying, or uninstalling an Rational Team Product via Installation Manager.

  2. Close all running Graphical User Interface (GUI) applications.

    These applications include Operating System Management applications such as the Service Control Manager and Event Viewer. Installation Manager must be the only running application. Closing the GUI applications ensures that no resource files are loaded when you start Installation Manager and perform the install, upgrade, rollback, or uninstall operation.


If you receive a file deletion error after an install, upgrade, rollback or uninstall operation starts, use the Process Explorer utility from SysInternal to determine which process is locking the file. For each file that Installation Manager could not delete, take the following steps to remove the operating system lock.

  1. Download Process Explorer from
  2. Uncompress Process Explorer onto the machine.
  3. Run procexp.exe.
  4. After the Process Explorer opens, click Find > Find Handle or DLL.
  5. Type the name of the file that Installation Manager could not delete and click Search.

    You do not need to enter the file path.
  6. Process Explorer displays the process and process ID of processes that are currently locking the file.

    Note: The process ID is listed in the PID column.
  7. Use Task Manager to stop any processes that are locking files and preventing them from being removed during a product installation or update operation.
    1. In the Start Menu for Windows, click Run. Then, type taskmgr.exe and press Enter to open the Task Manager.
    2. Click the Processes tab.
    3. To display process IDs for the running processes, click View > Select Columns from the Task Manager menu. Then, select PID (Process Identifier) and click OK.
    4. Click the PID column header to sort the processes by Process ID.
    5. Locate the process ID that is using the file. Then, right-click on the process name and click End Process.
  8. Repeat steps 5 - 8 for each file that is preventing the install, rollback, update, or uninstall operation.
  9. Close Task Manager and Process Explorer

After terminating all conflicting processes, start Installation Manager and perform the install, upgrade, rollback, or uninstall operation again.

If the error still occurs after following the preventive steps or work around, reboot the computer, and delete the files that Installation Manager could not delete.

Related information

Disable Terminal Services

Cross reference information
Segment Product Component Platform Version Edition
Software Development Rational ClearQuest Installation Windows, 9.0.1,,,,,, 9.0,,,,,,,,,,,,,,,, 8.0.1,,,,,,,,,,,,,,,,,,,,,, 8.0,,,,,,,,,,,,,,,,,,,, 7.1.2,,,,,,,,,, 7.1.1,,
Software Development Rational License Key Server Windows 7.1.1,,,,,,,,
Software Development Rational ProjectConsole Installation Windows,, 7.0.3,,,,,,,,,, 7.0.4,,,,,,
Software Development Rational RequisitePro Installation Windows,, 7.1.1,,,,,,,,,, 7.1.2,,,,,,,,,,,,,,,,,,,, 7.1.3,,,,,,,,,,,,,,,,,, 7.1.4,,,,,,,,,,
Software Development Rational Robot Installation Windows,, 7.0.3,,,,,,,,,
Software Development Rational SoDA Installation Windows,, 7.0.3,,,,,,,,,, 7.0.4,,,,,,

Document information

More support for: Rational ClearCase

Software version: 7.1,,, 7.1.1,,,,,,,,,, 7.1.2,,,,,,,,,,,,,,,,,,,, 8.0,,,,,,,,,,,,,,,,,,,,,, 8.0.1,,,,,,,,,,,,,,,, 9.0,,,,,, 9.0.1,

Operating system(s): Windows

Reference #: 1412312

Modified date: 09 September 2013

Translate this page: