How to Manually Upgrade DesktopServer for Mac

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 Macintosh
  2. Unzip the Installer zip package and locate the “libs” subfolder and move the “libs” folder to your desktop.
  3. Start the Terminal.app from your Applications/Utilities folder and copy and paste the command below followed by pressing enter inside the Terminal window (a new folder called db-upgrade will appear on your desktop).
  4. /Applications/XAMPP/xamppfiles/bin/php ~/desktop/libs/db-upgrade/dump.php&& mv /Applications/XAMPP/xamppfiles/temp/db-upgrade ~/desktop/
  5. Stop DesktopServer and backup your existing installation following the directions here: How to Backup Your DesktopServer Installation
  6. Delete your existing DesktopServer installation by dragging the /Applications/XAMPP folder to the trash bin.
  7. Drag the XAMPP folder from your desktop’s “libs” folder (from step #2) to your Application folder.
  8. Execute the /Applications/XAMPP/ds-plugins/ds-cli-mac binary to unpack the ds-cli plugin. In Terminal.app, type:
    cd /Applications/XAMPP/ds-plugins;chmod +x ds-cli-mac;./ds-cli-mac;rm ds-cli-mac
  9. 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 /Applications/XAMPP folder and selecting “Open” from the popup context menu.
  10. Start the Apache Web and MySQL database services.
  11. Using the Terminal.app from your Applications/Utilities folder, copy and paste the command below followed by pressing enter inside the Terminal window (the db-upgrade folder will disappear from your desktop).
  12. mv ~/desktop/db-upgrade /Applications/XAMPP/xamppfiles/temp/&& /Applications/XAMPP/xamppfiles/bin/php ~/desktop/libs/db-upgrade/reload.php

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