Overview
This guide explains you how to upgrade to the v4 Branch of Webuzo from v2. We recommend all v2 users to upgrade to v4 as its the only branch which is being maintained. All new features are added only to v4. v4 is also a multi user system and has much more features.
Procedure
NOTE : Make sure you have upgraded to the latest version of v2 first i.e. 2.9.6 and above. Also we strongly recommend you to take backup of your data before proceeding upgrade.
If you are using an OS from the list below, then upgrade to Webuzo v4.
If you have a lower OS version, you will need to upgrade the OS first then you can proceed for the webuzo upgrade.
- CentOS 7.x / 8.x
- AlmaLinux 8.x / 9.x
- Ubuntu LTS 18.04 / 20.04 / 22.04
- Red Hat Enterprise Linux 7.x / 8.x
- Scientific Linux 7.x / 8.x
- Rocky Linux 8.x
- CloudLinux 8.x / 9.x
Then go to the Admin Panel -> Settings -> General and scroll down to the Update Settings section. There you will need to choose the Release stage and save the settings. Following is the screenshot :
![image image](https://webuzo.com/sitepad-data/uploads/2022/02/image-6.png)
CLI Option
This is the preferred way to upgrade. SSH as root to the server and run the following command :
/usr/local/emps/bin/php /usr/local/webuzo/cron.php debug=4
GUI Option
If you dont know how to upgrade via CLI, you can also upgrade via the Admin Panel. Go to the Admin Panel -> Updates section and you should see the new version updates. Scroll to the bottom of the page and you will see the Update Webuzo button. Click on it. The upgrade procedure will start running. The Admin panel might go offline for a while. The upgrade logs are stored at : /var/log/webuzo_update_3.1.8 . Following are the screenshot of the update procedure :
![image image](https://webuzo.com/sitepad-data/uploads/2022/02/image-7.png)
![image image](https://webuzo.com/sitepad-data/uploads/2022/02/image-8.png)
That's it you’re done.