IBM Support

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

Question & Answer


Question

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

Cause

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.

Answer

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

[{"Line of Business":{"code":"LOB36","label":"IBM Automation"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSSH27","label":"Rational ClearCase"},"ARM Category":[{"code":"a8m50000000L0i5AAC","label":"ClearCase"}],"ARM Case Number":"","Platform":[{"code":"PF033","label":"Windows"}],"Version":"7.1.1;7.1.2;8.0.1;9.0.1;9.0.2;9.1.0"},{"Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSSH5A","label":"Rational ClearQuest"},"ARM Category":[{"code":"a8m50000000L0iAAAS","label":"ClearQuest"}],"Platform":[{"code":"PF033","label":"Windows"}],"Version":"7.1.1;7.1.2;8.0.1;9.0.1;9.0.2;9.1.0"},{"Product":{"code":"SSTMW6","label":"Rational License Key Server"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":" ","Platform":[{"code":"PF033","label":"Windows"}],"Version":"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","Edition":"","Line of Business":{"code":"LOB45","label":"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.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","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSSHCT","label":"Rational RequisitePro"},"Component":"Installation","Platform":[{"code":"PF033","label":"Windows"}],"Version":"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.11;7.1.2.12;7.1.2.13;7.1.2.14;7.1.2.15;7.1.2.16;7.1.2.17;7.1.2.18;7.1.2.19;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.10;7.1.3.11;7.1.3.12;7.1.3.13;7.1.3.14;7.1.3.15;7.1.3.16;7.1.3.17;7.1.3.2;7.1.3.3;7.1.3.4;7.1.3.5;7.1.3.6;7.1.3.7;7.1.3.8;7.1.3.9;7.1.4;7.1.4.1;7.1.4.10;7.1.4.2;7.1.4.3;7.1.4.4;7.1.4.5;7.1.4.6;7.1.4.7;7.1.4.8;7.1.4.9","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}},{"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.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","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.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","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
30 November 2020

UID

swg21412312

Page Feedback