Upgrade from 2.0.6

From Webuzo Wiki
Jump to: navigation, search

Overview

Webuzo 2.1.0 and higher adopts a completely new architecture wherein System Apps like Nginx, Apache, MySQL, Pure-FTPd, PHP, MongoDB, etc. and wide range of applications can be installed by a click of a button from the Webuzo Enduser Panel.

List of Systems Applications : http://webuzo.com/sysapps

Upgrade from Webuzo 2.0.6 and lower, to Webuzo 2.1.0 and higher (which adopts the new architecture) was not available 
from the Webuzo Admin Panel and hence Webuzo 2.0.6 was the latest version of it's branch.

This guide aims to assist users in upgrading from Webuzo 2.0.6 to the latest version of Webuzo , thus providing the benefit to experience the new features and feasibility of Webuzo which includes multiple webservers, multiple php versions, one-click to system applications, CSF Firewall, etc.


Note

Note : Running the Upgrade Tool on Webuzo version other than Webuzo 2.0.6 can cause the server to crash.

*** Very Important Note ***

It is strongly recommended that a backup of the entire machine is taken. (VPS Backup, etc)

Also, take a backup of configuration changes if any (e.g Apache Conf, PHP Conf, MySQL conf).

Webuzo Upgrade Tool cleans up the older AMP(Apache/MySQL/PHP) Stack and sets up the latest Webuzo AMP Stack.


Requirements

1) Current Webuzo Version should be 2.0.6. If it is lower than Webuzo 2.0.6 , kindly upgrade to the latest version of it's branch i.e Webuzo 2.0.6

2) Root privileges required.


Getting Started

Webuzo can be upgraded from 2.0.6 to the latest version using the following steps:


Fetch the Upgrader

Upload the contents of the File:Webuzo 2.0.6 upgrade.zip to the server which includes the files upgrade.sh and wupgrade.inc


Upgrading

Assuming a Backup of the required files from the server is downloaded.

Open a Shell Terminal (e.g. PuTTY) and SSH to your server. Run the following commands:

chmod 0755 upgrade.sh
./upgrade.sh
The upgrade process will begin immediately. It may seem that the upgrade process has stopped, if your network speed is slow,
 but please let it continue.

Note : A log file of the installation process will be created - /root/webuzo-upgrade.log
On Success, restart the Webuzo Service as follows to avoid any Startup failures.

Root > service webuzo restart


Additional Steps

If Tomcat (Java) is installed through Webuzo the following steps will guide to migrate to the latest Apache Tomcat deployment.

Execute the following commands from the terminal:

service tomcat stop

// Clean Up
rm -rf /usr/share/apache-tomcat/webapps/ROOT/
rm -rf /usr/share/apache-tomcat/webapps/docs/
rm -rf /usr/share/apache-tomcat/webapps/examples/
rm -rf /usr/share/apache-tomcat/webapps/host-manager/
rm -rf /usr/share/apache-tomcat/webapps/manager/ 

// Temporary Backup
mv /usr/share/apache-tomcat/webapps/ /tmp/

rm -rf /home/USERNAME/webapps
rm -rf /usr/share/apache-tomcat

// Remove Java
rpm -e --nodeps jdk
rpm -e --nodeps jre

Login to your Webuzo Enduser Panel and install Apache Tomcat from the Apps >> Java Containers Category >> Tomcat. Guide : http://www.webuzo.com/wiki/Install_System_Apps

cp -a /tmp/webapps/* /home/USERNAME/webapps
chown -R USERNAME:USERNAME /home/USERNAME/webapps/

service tomcat restart 

That's it !!! Enjoy the new Webuzo.


Verify Upgrade

Check for the Service from the Webuzo Enduser Panel >> Services Menu. Guide : http://webuzo.com/wiki/Restart_services

It is recommended that the services are restarted either from the Panel itself or from the terminal.


Support

Open a Support Ticket with the server details if you face any issue. Support : https://www.softaculous.com/support/open.php?