How to Manually Upgrade DesktopServer for Windows

WARNING:

This document describes how to upgrade your DesktopServer installation manually. It is important that you follow these directions carefully to preserve existing website content. Failure to follow these directions carefully may result in data loss.

  1. Follow these steps to export your database. (Please first make sure that your current version of DesktopServer is running and that the mysqld process is present; here is how:Find Existing Apache Web and MySQL Services on Windows.)
    1. Unzip the Installer zip package and locate the “libs” subfolder and move the “libs” folder to your desktop.
    2. Copy the db-upgrade.zip file into the newly created libs folder on your desktop
    3. Using a non-native archive program such as 7-zip unzip the db-upgrade.zip file by right-clicking on it and selecting, “7-zip → Extract Here,” from the context menu
    4. Delete the db-upgrade.zip file
  2. Start the Command line by pressing the Windows Start button and typing cmd.exe (followed by the enter/return key) and type the following command (a new folder called db-upgrade will appear on your desktop).
  3. c:\xampplite\php\php.exe %USERPROFILE%\desktop\libs\db-upgrade\dump.php&& move c:\xampplite\tmp\db-upgrade %USERPROFILE%\desktop\
  4. Stop DesktopServer and backup your existing installation following the directions here: How to Backup Your DesktopServer Installation
  5. Delete your existing DesktopServer installation by dragging the c:\xampplite folder to the trash bin.
  6. Drag the xampplite folder from your desktop’s “libs” folder (from step #2) to your root c:\ drive.
  7. Open File Explorer and navigate to c:\xampplite\ds-plugins
  8. Right-click on the ds-cli-win.zip file
  9. Click on 7-zip → Extract Here
  10. Delete ds-cli-win.zip
  11. Navigate to c:\xampplite\mysql
  12. Right-Click on backup-zip
  13. Click on 7-zip → Extract Here. This will result in a c:\xampplite\mysql\data folder
  14. Restore your database following these steps:
    1. Start DesktopServer by right-clicking (ctrl+click) the DesktopServer application icon in your c:\xampplite folder and selecting “Open” from the popup context menu.
    2. Start DesktopServer with Privileges
    3. Start the Apache Web and MySQL database services (be sure that the DS-CLI Developer Plugin is activated).

Your websites should now be accessible and you may then quit the Command line application and delete the libs folder from your desktop.