V6 Core to V6 Professional upgrade guide

30 mins

V6 ProV6 MSPV6 Core

Upgrading from V6 Core to V6 Professional

rConfig V6 Core is our open source free version of rConfig. It does not have all enterprise features of rConfig V6 Professional, but it has the core capabilities and config backup features. Many users transition from V6 Core to V6 Professional to take advantage of the additional features. This guide will walk you through the upgrade process.

ℹ️ You are required to have a valid V6 professional license to upgrade to V6 Professional. If you do not have a license, please visit https://www.rconfig.com/#pricing to purchase a license.

This guide assumes your running V6 Core and you have a valid V6 Professional license. Throughout this guide we may refer you to other parts of the documentation for specific instructions. Please follow the instructions carefully.

Backup rConfig V6 Core

✅ Ensure you have a full system backup of rConfig V6 Core database, and storage folders.

Update your OS

✅ This may take a few minutes, but let it finish for both commands below.

yum -y update
yum -y upgrade

ℹ️ If you get a MariaDB error during the update, please see the note below.

rm -fr /etc/yum.repos.d/MariaDB*

Run the V6 Pro Installer

✅ On the same server where you have rConfig V6 Core installed, install rConfig V6 Professional. Follow the instructions in the V6 Pro Installation Guide. ONce this is completed, you should try to access the UI, and the new V6 Professional UI should be displayed with a blank default data set (i.e. no devices or configs).

Update ENV File

✅ Copy the following .env file parameters from V6 Core to V6 Pro .env file (comment out the V6 Core parameters). Take care in updating the DB_PASSWORD parameter. When upgrading from Core to Pro, this value is always going to be 'rconfig'.

```bash
vi /var/www/html/rconfig6/current/.env

#APP_KEY=[Title](base64:xxxxxxxxxxxxxxxxxV6PROKEYxxxxxxxxxxxxxxxxxxx%253D)
APP_KEY=base64:xxxxxxxxxxxxxxxV6COREKEYxxxxxxxxxxxxxxxxxxxxxxxx=
#APP_URL=https://rconfig.yourdomain.com
APP_URL=https://rconfig.yourdomain.com
#DB_DATABASE=rConfig123
DB_DATABASE=rconfig
#DB_USERNAME=
DB_USERNAME=root
#DB_PASSWORD==
DB_PASSWORD=xxxxxxxxxxxxxxxV6COREDBPASSxxxxxxxxxxxxxxxxxxxxxxxx=
#DB_HOST=
DB_HOST=localhostOrOtherHost

Migrate the database

✅ Now migrate the database from V6 Core to V6 Pro. You should see several tables being created in the output.

cd /var/www/html/rconfig6/current
php artisan rconfig:clear-all
php artisan migrate --force

Copy the V6 Core backup files to V6 Pro

✅ Copy the files from V6 Core to V6 Pro. This will ensure you have all your backups in V6 Pro.

yes| cp -R /var/www/html/rconfig/storage/* /var/www/html/rconfig6/current/storage

Clear the application cache

✅ Clear the application cache to ensure you are using the V6 Pro codebase.

cd /var/www/html/rconfig6/current
php artisan rconfig:clear-all

Verify Backup Storage directory and permissions

✅ Run the following scripts to ensure the backup storage directory is created and has the correct permissions.

cd /var/www/html/rconfig6/current
mkdir /var/www/html/rconfig6/current/storage/app/rconfig/backups
chmod 0755 /var/www/html/rconfig6/current/storage/app/rconfig/backups
chown -R apache storage
php artisan rconfig:clear-all

Open rConfig URL in your browser. CTRL+SHIFT+r to hard refresh the browser

ℹ️ Contact support if you run into any problems.