Skip to main content

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


Technote (troubleshooting)


Problem(Abstract)

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.

Resolving the problem

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.

Workaround

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 http://technet.microsoft.com/en-us/sysinternals/bb896653.aspx.
  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.

    Note:     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 7.1.0.1, 7.1.0.2, 7.1.1, 7.1.1.1, 7.1.1.2, 7.1.1.3, 7.1.1.4, 7.1.1.5, 7.1.1.6, 7.1.1.7, 7.1.1.8, 7.1.1.9, 7.1.2, 7.1.2.1, 7.1.2.10, 7.1.2.2, 7.1.2.3, 7.1.2.4, 7.1.2.5, 7.1.2.6, 7.1.2.7, 7.1.2.8, 7.1.2.9, 8.0, 8.0.0.1, 8.0.0.2, 8.0.0.3, 8.0.0.4, 8.0.0.5, 8.0.0.6
Software Development Rational Common Licensing Installation Windows 7.1.1, 7.1.1.1, 7.1.1.2, 7.1.1.3, 7.1.1.4, 7.1.1.5, 7.1.1.6, 7.1.1.7, 7.1.1.8
Software Development Rational ProjectConsole Installation Windows 7.0.2.1, 7.0.2.2, 7.0.3, 7.0.3.1, 7.0.3.2, 7.0.3.3, 7.0.3.4, 7.0.3.5, 7.0.3.6, 7.0.3.7, 7.0.3.8, 7.0.3.9, 7.0.4, 7.0.4.1, 7.0.4.2, 7.0.4.3, 7.0.4.4, 7.0.4.5, 7.0.4.6
Software Development Rational RequisitePro Installation Windows 7.1.0.1, 7.1.0.2, 7.1.1, 7.1.1.1, 7.1.1.2, 7.1.1.3, 7.1.1.4, 7.1.1.5, 7.1.1.6, 7.1.1.7, 7.1.1.8, 7.1.1.9, 7.1.2, 7.1.2.1, 7.1.2.10, 7.1.2.2, 7.1.2.3, 7.1.2.4, 7.1.2.5, 7.1.2.6, 7.1.2.7, 7.1.2.8, 7.1.2.9, 7.1.3, 7.1.3.1, 7.1.3.2, 7.1.3.3, 7.1.3.4, 7.1.3.5, 7.1.3.6
Software Development Rational Robot Installation Windows 7.0.2.1, 7.0.2.2, 7.0.3, 7.0.3.1, 7.0.3.2, 7.0.3.3, 7.0.3.4, 7.0.3.5, 7.0.3.6, 7.0.3.7, 7.0.3.8, 7.0.3.9
Software Development Rational SoDA Installation Windows 7.0.2.1, 7.0.2.2, 7.0.3, 7.0.3.1, 7.0.3.2, 7.0.3.3, 7.0.3.4, 7.0.3.5, 7.0.3.6, 7.0.3.7, 7.0.3.8, 7.0.3.9, 7.0.4, 7.0.4.1, 7.0.4.2, 7.0.4.3, 7.0.4.4, 7.0.4.5, 7.0.4.6

Rate this page:

(0 users)Average rating

Copyright and trademark information

IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.

Rate this page:


(0 users)Average rating

Add comments

Document information

Rational ClearCase

Installation

Software version:
7.1, 7.1.0.1, 7.1.0.2, 7.1.1, 7.1.1.1, 7.1.1.2, 7.1.1.3, 7.1.1.4, 7.1.1.5, 7.1.1.6, 7.1.1.7, 7.1.1.8, 7.1.1.9, 7.1.2, 7.1.2.1, 7.1.2.2, 7.1.2.3, 7.1.2.4, 7.1.2.5, 7.1.2.6, 7.1.2.7, 7.1.2.8, 7.1.2.9, 7.1.2.10, 8.0, 8.0.0.1, 8.0.0.2, 8.0.0.3, 8.0.0.4, 8.0.0.5, 8.0.0.6

Operating system(s):
Windows

Reference #:
1412312

Modified date:
2013-03-20

Translate my page

Content navigation