This is an old revision of the document!

Upgrading From CakePHP3 Based Install

Introduction

• This page can be used as a reference when upgrading an older install of RADIUSdesk that is still using CakePHPv3 to the latest one using CakePHPv4.
• There has been substantial changes in the database structure between the RADIUSdesk releases that use CakePHPv3 and those that user CakePHPv4.
• We have created a script that will do a best effort in porting the older database structure to the new database structure.

Preparing A Fallback

• You are advised to do these first on a clone / copy of the production system in order to establish everything will work as intended after the porting action.
• As with any upgrade you need to prepare the fallback if things does not work out as intended.
• Fallback points
  • Make a backup/sql dump of the CakePHPv3 based database.
  • Make a copy of the old /var/www/rdcore folder and all of its sub-folders.
  • Make a copy of the /etc/freeradius folder and all of its sub-folders.
• Once this is taken care of we can start our migration attempt.

Install CakePHP 8.1

• If you are still running a Ubuntu install prior to 22.04 you will need to install CakePHPv8.1 for the latest RADIUSdesk to work.
• You can follow these instructions: https://www.cloudbooklet.com/how-to-install-or-upgrade-php-8-1-on-ubuntu-20-04/
• You can then consult the current install instructions to see which extensions you have to install.

#Add php8.1-extension_name
sudo apt-get -y install php8.1-cli php8.1-mysql php8.1-gd php8.1-curl php8.1-xml php8.1-mbstring php8.1-intl php8.1-sqlite3 

• Also remember to update the Nginx config file to use 8.1

# pass PHP scripts to FastCGI server
#
location ~ \.php$ {
    include snippets/fastcgi-php.conf;
    #
    #       # With php-fpm (or other unix sockets):
    fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
    #       # With php-cgi (or other tcp sockets):
    #       fastcgi_pass 127.0.0.1:9000;
}