rConfig - V7 Pro Installation

15 mins V7 Pro

This is the main installation guide rConfig V7 Professional on all Distros. See last section on this page for specific Ubuntu Installation steps.

Complete the rConfig Professional installation by following three steps. Please run all steps as root

Setup a new MySql or MariaDb User account
Download the deployer script
First run Initialization of the deployer script
Deploy rConfig and verify installation

Setup a MariaDB/ MYSQL User

Ubuntu users will need to create a new user and password for the database. Login to the MariaDB/Mysql Database server using the root user. The root user password is the same as the one you used in the OS install script.

sudo mariadb -u root -p

Create the user and password for the database. And example is below, but you will need to change the username/password to something more secure.

GRANT ALL PRIVILEGES ON *.* TO 'user1'@localhost IDENTIFIED BY 'password1';
FLUSH PRIVILEGES;
quit;

Download the deployer script

mkdir /var/www/html/rconfig7
cd /var/www/html/rconfig7
wget https://www.rconfig.com/downloads/rconfig7-envoy.blade.php -O /var/www/html/rconfig7/Envoy.blade.php

First run Initialization of the deployer script

You need to have the follow details ready before you run the next command.

Database host name - ‘localhost’ if you followed all the instructions to this point
Database user name - ‘root’ unless you specify otherwise
Database password - per the previous steps in OS Setup
Hostname - The DNS Hostname for your machine, please create one if you do not have one already prepared
API Token - This can be retrieved from the license keys section rConfig.com portal (remove the angel brackets < >)

Once you have the above details, run the following command to initialize the rConfig installation.

envoy run init --dbhost=localhost --dbuser=root --dbpass="SomePassword" --hostname=rconfig7vm.domain.local --apitoken=<someCode>

Note: We use Laravel Envoy as the deployment tool. If the envoy command fails for any reasons, first check that your system does not have https://www.getenvoy.io/ installed. You can check this by running the following;

[root@homedev html]# which envoy
/root/.composer/vendor/bin/envoy

Anything other than /root/.composer/vendor/bin/envoy returned and you need to uninstall the ‘other’ envoy, or update the environment variable to the correct Laravel Envoy path.

Deploy rConfig and verify installation

Next, run the following command to deploy rConfig.

 envoy run deploy --apitoken=<someCode>

Once the process has completed without errors you may login to the server IP address or hostname with the following credentials

Username: [email protected] Password: admin

Ubuntu Installation

The rConfig V7 installation is available for Ubuntu. But the install steps are a little different. FOLLOW THE INSTRUCTIONS BELOW. If not done already, install a new Ubuntu server, and run the OS install script per the instructions per Ubuntu Setup Script.

Install composer

Though the below envoy install script has been tested on Ubuntu 18.04, we recommend you install composer on your own.

composer global require laravel/envoy
echo 'export PATH="$PATH:$HOME/.config/composer/vendor/bin"' >> ~/.bashrc
source ~/.bashrc
envoy --version

If the envoy --version returns valid output per below, this step has been completed. The composer version can be any variant of the 2.x version.

users1@devtextubuntu2004:/var/www/html$ envoy --version
Laravel Envoy 2.8.2