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. 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
  2. Unzip the Installer zip package and locate the “libs” subfolder and move the “libs” folder to your desktop.
  3. 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).

    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. Execute the c:\xampplite\ds-plugins\ds-cli-win.exe file (double click) to unpack the ds-cli plugin (you can then delete the ds-cli-win.exe file).
  8. Restore your database. Please make sure that DesktopServer is running by starting the application via right-clicking (ctrl+click) the DesktopServer application icon in your c:\xampplite folder and selecting “Open” from the popup context menu.
  9. Start the Apache Web and MySQL database services.
  10. Using the Command line (from step #3), copy and paste the command below followed by pressing enter inside the Command line window (the db-upgrade folder will disappear from your desktop).

move %USERPROFILE%\desktop\db-upgrade c:\xampplite\tmp&& c:\xampplite\php\php.exe %USERPROFILE%\desktop\libs\db-upgrade\reload.php

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