KBEC-00036 - Manual Windows upgrade for ElectricCommander versions prior to 2.2.x

Summary

The upgrade process described in the ElectricCommander Installation and Configuration Guide does not support ElectricCommander versions prior to 2.2.x. This article describes how to upgrade from ElectricCommander 2.0.x or 2.1.x to the current Commander version.

Approach

• Backup all important data
• Uninstall the existing Commander version
• Install the new Commander version
• Restore/integrate all necessary data from the backup

Solution

Naming conventions:

• installDirectory - program files and other read-only information. The default location is C:\Program Files\Electric Cloud\ElectricCommander
• dataDirectory - data files, database, logs, and configuration information. The default location is C:\Documents and Settings\All Users\Application Data\Electric Cloud\ElectricCommander
• backupDirectory - user-defined location for storing important data

The procedure is:

1. Copy Apache, conf, and log file subdirectories from dataDirectory to backupDirectory
2. Copy server\conf subdirectory from installDirectory to backupDirectory
3. If you have any custom files, copy them to the backupDirectory also
4. Export the database

   
   ectool export backupDirectory\myExport.xml
   

5. Uninstall ElectricCommander
   • Follow instructions for "Uninstalling ElectricCommander" in the ElectricCommander Installation and Configuration Guide. Note: If this step did not work, skip the rest of this article and follow the procedure described in Manual uninstall of ElectricCommander Server and Agent on Windows
   • Delete the installDirectory
   • Delete the following registry keys if they exist:

     
     HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{E1E048B1-D468-49DF-8A61-23A5813001FD
     HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{E0F91366-2FE0-4EBB-A2A1-5B20F9D5F2AB}
     HKEY_CLASSES_ROOT\Installer\Features\66319F0E0EF2BBE42A1AB5029F5D2FBA
     HKEY_CLASSES_ROOT\Installer\Products\66319F0E0EF2BBE42A1AB5029F5D2FBA
     HKEY_CLASSES_ROOT\Installer\UpgradeCodes\3A593D89B2D7874448D56C78C7111253
     HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Installer\Features\66319F0E0EF2BBE42A1AB5029F5D2FBA
     HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Installer\Products\66319F0E0EF2BBE42A1AB5029F5D2FBA
     HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Installer\UpgradeCodes\3A593D89B2D7874448D56C78C7111253
     HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\App Management\ARPCache\{E0F91366-2FE0-4EBB-A2A1-5B20F9D5F2AB}
     HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Installer\UpgradeCodes\3A593D89B2D7874448D56C78C7111253
     HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Installer\UserData\S-1-5-18\Products\66319F0E0EF2BBE42A1AB5029F5D2FBA
     HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Installer\UserData\S-1-5-21-92094854-593444704-1842496168-1003\Products\66319F0E0EF2BBE42A1AB5029F5D2FBA
     

6. If SavedMySQLData directory exists in dataDirectory, move it to the backupDirectory.
7. Install and configure ElectricCommander as described in the ElectricCommander Installation and Configuration Guide.
8. Copy server\conf\passkey and server\conf\keystore files from the backupDirectpry to the installDirectory.
   See Moving ElectricCommander data from one server to another for more information about other files you may want to move.
9. Import database data.

   
   ectool import backupDirectory\myExport.xml
   

10. Restore your custom changes.

See Also

Manual uninstall of ElectricCommander Server and Agent on Windows
Moving ElectricCommander data from one server to another

Applies to

• Product versions: 2.0.x 2.1.x
• OS versions: Windows