update_cake5 [RADIUSdesk]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
<nav type="pills" justified="false">
  * [[:user_manuals|Back to Documentation]]
  * [[:update_cake5|Update to CakePHPv5]]
</nav>

----

====== Update to CakePHPv5 ======
===== 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)  

===== Instructions =====

  * 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.


-----------

===== 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>