A manual Windows uninstall of the ElectricCommander Server and Agents may be required when:
- The installer user is different from the uninstall user.
- The Windows registry keys are preventing ElectricCommander install or triggering an ElectricCommander upgrade.
- Commander configuration data from previous installs prevents the installer from completing during the "could take 10 minutes" registry install.
Occasionally on Windows, ElectricCommander is not displayed as installed software in the Control Panel - Add or Remove Programs on the agent host. The reason for this could be because Commander was installed as another user, or possibly because Commander has been installed/uninstalled repeatedly and the Windows installer database has gotten corrupted. If corruption occurs, Commander does not completely uninstall itself. The most common symptom is one or more Commander services still running after the uninstall. These running services interfere with future attempts to install ElectricCommander on the machine.
What is the general approach (strategy)?
- stop agent service
- delete the service
- delete ElectricCommander software directories
- remove the current Commander configuration
- remove the Window registry entry
After you determine there is no agent to remove from Control Panel - Add or Remove Programs, follow these steps:
- Stop all Commander agent services in cmd or Cygwin:
- Delete the service with the following commands:
- Delete or rename the ElectricCommander installed directories (typically the contents of C:\Program Files\Electric Cloud\ElectricCommander). Do not delete data files in workspaces!
- Delete or rename the ElectricCommander configuration file configure.exe (typically found in C:\Documents and Settings\All Users\Application Data\Electric Cloud\ElectricCommander).
- Delete the ElectricCommander keys in the Windows Registry
In release 3.2 and after there is an installer undocumented command line argument "--cleanECRegistry". Try it first on the installer commandline to remove the registry keys.
- From the Windows Run prompt, invoke "regedit" and navigate to any of the following registry keys (registry keys are unique to ElectricCommander). The registry keys list below is ordered with the most-likely-to-find key listed first:
- Right-click on the key and select "Delete".
At this point, enough cleanup has occurred so you can install ElectricCommander cleanly or if you are doing an ElectricCommander server upgrade, use the --recover option to continue the upgrade process.
On window, by default, the Commander data file can be read by the installer and hang at the "this could take up to 10 minutes" portion of the install.
Rename the following directory and retry the Commander install again.
If you receive errors when restarting the ElectricCommander Agent, you can check the servicerunner.log file. Some users have reported that the agent.crt file is not readable by the new user. Changing ownership (or adding a read filesystem privilege) can resolve the issue.