Skip to content

Guide to Upgrade (for all versions)

Prashant Shah edited this page Jul 20, 2021 · 1 revision

WARNING : Take full backup of website and database before starting any upgrade process.

Steps to upgrade from Webzash v2.x to Webzash v3.0

Step 1 : This is the most important step. Take a full backup of the website setup and database !

Step 2. This is again an important step. Make a copy of the "app/Plugin/Webzash/Database/webzash.sqlite" file somewhere safe outside of the webzash directory.

Step 3. This is again an important step. Make a copy of the "app/Config/core.php" file somewhere safe outside of the webzash directory. It contains the security hash strings.

Step 4. Delete the previous Webzash setup.

Step 5. Download and extract the latest release.

Step 6. Open Webzash in browser. It should open the installer page. Select the "Upgrade from 2.x" option.

Step 7. Create a new MySQL database (eg : "wz_setup") and in the installer enter the database details along with the "webzash.sqlite" file as backed up in Step 2 above and click on "Upgrade".

Step 8. Replace the "app/Config/core.php" file from backed taken in Step 3 above.

You are done !

Steps to upgrade from Webzash v2.x to Webzash v2.10

Step 1. This is the most important step. Make a copy of the app/Plugin/Webzash/Database/webzash.sqlite file somewhere safe outside of the webzash directory.

Step 2. This is again an important step. Make a copy of the app/Config/core.php file somewhere safe outside of the webzash directory. It contains the security hash strings.

Step 3. Delete the previous Webzash setup.

Step 4. Download and extract the latest release.

Step 5. Replace the app/Plugin/Webzash/Database/webzash.sqlite from backup taken in Step 1 above.

Step 6. Replace the app/Config/core.php from backup taken in Step 2 above.

You are done !

Steps to upgrade Webzash v2.x plugin using git

Step 1. This is the most important step. Make a copy of the app/Plugin/Webzash/Database/webzash.sqlite file somewhere safe outside of the webzash directory.

Step 2. Delete the app/Plugin/Webzash folder.

Step 3. Setup the git repository using

git clone https://github.com/prashants/webzash.git app/Plugin/Webzash

Step 4. Replace the app/Plugin/Webzash/Database/webzash.sqlite from backup taken in step 1

You are done !

Steps to upgrade from Webzash v1.x to v2.x

Step 1 : This is the most important step. Take a full backup of the setup and database !

Step 2 : Download Webzash v2 and extract it to a separate folder. Do no overwrite or delete existing Webzash v1 setup.

Step 3 : Setup the database connection from Administrator Dashboard > Manage accounts > Add Account Config for the existing Webzash v1 databases (do not use Create Account).

Step 4 : Create users from Administrator Dashboard > Manage users > Add users

Step 5 : Update each account database by running the following update script against it. If this step fails you will loose all your data, so better make sure you have a full backup of the database. The update process will take time, so please be patient with it. The script can be executed after selecting the database from command line or from phpMyAdmin panel - "SQL" tab (next to "Structure" tab).

Script file (Click on "RAW" button) :

https://github.com/prashants/webzash/blob/master/Config/Migrate/Migrate.v4.to.v5.MySQL.sql

Step 6 : Once the account database update is completed, you can activate the account and check whether everything works.

If you face any problems with the update, open a bug report at https://github.com/prashants/webzash/issues