Friday, April 22, 2016

Upgrading Uniform Server

As there is no official guide on how to upgrade Uniform Server from one version to another I decided to compile one myself, keep in mind that I might miss something and update this guide from time to time when I run into an issue:
  1. Export Your databases using phpMyAdmin
  2. Export Your databases users using phpMyAdmin because databases export does not do that
  3. Stop Apache and MySQL, if You are running them as Windows services - uninstall them
  4. Rename Your UniServerZ folder to UniServerZ-backup or something
  5. Put Your new UniServerZ folder where Your old one used to be
  6. Check .httaccess files for stuff that might conflict
  7. If everything is OK copy www folder from UniServerZ-backup to UniServerZ
  8. If You use VHosts copy vhosts folder from UniServerZ-backup to UniServerZ compare \core\apache2\conf\extra\httpd-vhosts.conf files and copy extra lines at the end from UniServerZ-backup to UniServerZ - this one did not work for me, I had to recreate vhosts in UniController and after that do the copying, might have something to do with hosts file
  9. If You use SSL copy ssl folder from UniServerZ-backup to UniServerZ, compare \core\apache2\conf\extra\httpd-ssl.conf files and copy extra lines at the end from UniServerZ-backup to UniServerZ
  10. Compare \core\mysql\my.ini files and copy settings from UniServerZ-backup to UniServerZ if needed
  11. Compare \core\php70\php_production.ini files and copy settings from UniServerZ-backup to UniServerZ if needed
  12. Start the new UniController.exe (as administrator if You need to edit start-up settings)
  13. Enter the root MySQL password, preferably same as the old one for simplicity
  14. Edit start-up settings if needed
  15. Reinstall Windows services if needed, start the Apache and MySQL
  16. Import (or recreate) Your databases users using phpMyAdmin
  17. Import Your databases using phpMyAdmin
Bonus:
  • If You need to access Your databases from outside:
    1. Comment the "bind-address=127.0.0.1" line in UniServerZ\core\mysql\my.ini file (it might be already done in 10th step)
    2. Change the hostname for database users using phpMyAdmin