Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
update_cake5 [2026/09/03 15:46] – created systemupdate_cake5 [2026/09/03 17:36] (current) – [Instructions] system
Line 7: Line 7:
  
 ====== Update to CakePHPv5 ====== ====== Update to CakePHPv5 ======
-===== Skills required for the installation =====+===== Background ===== 
 +  * RADIUSdesk has been under constant development for more than a decade. 
 +  * It uses CakePHP as a web app that generates JSON data which in turn is displayed on an ExtJs GUI. 
 +  * Over the years the CakePHP framework also has been under constant development. 
 +  * We started out probably on version 2 and then moved to version 3 and version 4 as time went on. 
 +  * As of September 2026 CakePHPv4 will stop getting security updates (https://github.com/cakephp/cakephp/wiki) 
 +  * Since we are committed to provide a stable and current system, we are moving on to CakePHPv5. 
 +  * This will be a drop-in replacement of the CakePHPv4 web app and should be transparent to your users and systems. (API remains the same)  
  
-To install RADIUSdesk, you need sufficient knowledge and experience with Linux: +===== Instructions =====
-  * Installing the Linux operating system. +
-  * Editing text files via the terminal with a text editor such as Vi or Nano. +
-  * Installing packages from a repository. +
-  * You must be familiar with how TCP/IP networks work.+
  
-===== Background =====+  * These instructions are applicable for systems that has RADIUSdesk already installed on Ubuntu version 24.04 and 26.04. 
 +  * Check out the CakePHPv5 API back-end application 
 +<code bash> 
 +cd /var/www/ 
 +sudo git clone https://github.com/RADIUSdesk/rd_cake5.git 
 +</code> 
 +  * Remove the old soft links: 
 +<code bash> 
 +cd /var/www/html 
 +sudo rm ./cake4 
 +sudo rm ./reporting 
 +</code> 
 +  * Create the new soft links: 
 +<code bash> 
 +sudo ln -s ../rd_cake5 ./cake4 
 +sudo ln -s ../rd_cake5/rd_cake/setup/scripts/reporting ./reporting 
 +</code> 
 +  * Create directories: 
 +<code bash> 
 +sudo mkdir -p  /var/www/html/cake4/rd_cake/logs 
 +sudo mkdir -p /var/www/html/cake4/rd_cake/webroot/files/imagecache 
 +sudo mkdir -p /var/www/html/cake4/rd_cake/tmp 
 +</code> 
 +  * Copy the old images over: 
 +<code bash> 
 +sudo cp -R /var/www/rdcore/cake4/rd_cake/webroot/img/realms/* /var/www/html/cake4/rd_cake/webroot/img/realms/ 
 +sudo cp -R /var/www/rdcore/cake4/rd_cake/webroot/img/dynamic_details/* /var/www/html/cake4/rd_cake/webroot/img/dynamic_details/ 
 +sudo cp -R /var/www/rdcore/cake4/rd_cake/webroot/img/dynamic_photos/* /var/www/html/cake4/rd_cake/webroot/img/dynamic_photos/ 
 +sudo cp -R /var/www/rdcore/cake4/rd_cake/webroot/img/access_providers/* /var/www/html/cake4/rd_cake/webroot/img/access_providers/ 
 +sudo cp -R /var/www/rdcore/cake4/rd_cake/webroot/img/hardwares/* /var/www/html/cake4/rd_cake/webroot/img/hardwares/ 
 +</code> 
 +  * Change the ownership: 
 +<code bash> 
 +sudo chown -R www-data:www-data /var/www/html/cake4/rd_cake/tmp 
 +sudo chown -R www-data:www-data /var/www/html/cake4/rd_cake/logs 
 +sudo chown -R www-data:www-data /var/www/html/cake4/rd_cake/webroot/img/realms 
 +sudo chown -R www-data:www-data /var/www/html/cake4/rd_cake/webroot/img/dynamic_details 
 +sudo chown -R www-data:www-data /var/www/html/cake4/rd_cake/webroot/img/dynamic_photos 
 +sudo chown -R www-data:www-data /var/www/html/cake4/rd_cake/webroot/img/access_providers 
 +sudo chown -R www-data:www-data /var/www/html/cake4/rd_cake/webroot/img/hardwares 
 +sudo chown -R www-data:www-data /var/www/html/cake4/rd_cake/webroot/files/imagecache 
 +</code> 
 +  * That brings us to the end of the upgrade instructions to migrate from CakePHPv4 to CakePHPv5.
  
-  * Nginx is a web server that seems to have overtaken Apache in terms of popularity and number of active websites on the Internet. 
-  *  It is new, lightweight, fast, highly scalable and capable of handling a large load without overloading your system. 
-  * Nginx is the new Apache so to speak. 
-  * This section describes the steps you need to take to get RADIUSdesk up and running with a LEMP stack on Ubuntu 26.04 
-     * A LEMP stack is one of those acronyms you can use to impress your friends. It stands for Linux NginX MySQL and PHP. 
  
 ----------- -----------
 +
 +===== Remember to patch =====
 +  * RADIUSdesk is under active development and sometimes we add SQL patches.
 +  * The SQL patches are located under **/var/www/html/cake4/rd_cake/setup/db/**.
 +  * These patches are non-destructive and you can run them against the database
 +  * See the example below
 +<code bash>
 +sudo mysql -u root rd < /var/www/html/cake4/rd_cake/setup/db/8.068_add_email_sms_histories.sql
 +</code>
 +  * Some of these patches may add new columns to existing database tables. 
 +  * In this case, it is recommended to clear the CakePHP models (tables) cache to ensure that the latest changes are also applied there:
 +<code bash>
 +sudo su
 +cd /var/www/html/cake4/rd_cake/tmp/cache/models
 +rm *
 +exit
 +</code>
 +
  
  • update_cake5.1788443213.txt.gz
  • Last modified: 2026/09/03 15:46
  • by system