Debian 8 

Before You Begin

Ensure that System Requirements have been met prior to proceeding with the Installation Guide.

Install Requirements

1) Upgrade your current packages

Upgrade your current packages.


   apt-get update
   apt-get upgrade

2) Install Required Packages

PHP

Installations of ProVision 7.x and newer require  PHP 7.1 (and related extensions). ProVision 7.x installations using Debian versions prior to Stretch 9 require updating to PHP 7.1. Debian Wheezy comes with PHP 5.4 by default. You can either add a repository which provides PHP 7.1 or install PHP manually. 

For this example, we are using Debian/Ubuntu installation instructions from:

https://ayesh.me/Ubuntu-PHP-7.1 , using  Ondřej Surý's PPA.

Another reference containing instructions for Debian 7, 8, CentOS / RHEL, MacOS X, and Windows is available here:

https://www.colinodell.com/blog/201612/installing-php-71

Depending on what repository you choose, installation instructions and syntax may differ. 


sudo apt install apt-transport-https lsb-release ca-certificates 
sudo wget -O /etc/apt/trusted.gpg.d/php.gpg https://packages.sury.org/php/apt.gpg 
sudo sh -c 'echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" > /etc/apt/sources.list.d/php.list' 
sudo apt update
And update the packages list:
   apt-get update
Install Apache2/PHP7/MySQL and development tools for pecl:


PHP 7.x / Apache2 / extensions

  • httpd 
  • php7.1w 
  • php7.1w-opcache 
  • php7.1w-mysqlnd 
  • php7.1w-pdo 
  • php7.1w-ldap 
  • php7.1w-pecl-memcache 
  • php7.1w-bcmath 
  • php7.1w-devel 
  • php7.1w-pear 
  • php7.1w-cli
  • php7.1-imap

Development tools for pecl / additional system packages:

  • curl 
  • openssl 
  • memcached 
  • mod_ssl
   apt-get install apache2 libapache2-mod-php7.1 php7.1 php7.1-cgi php7.1-cli php7.1-gd php7.1-curl php7.1-ldap php7.1-mysqlnd php7.1-ssh2 php-pear php7.1-dev php7.1-imap curl openssl memcached php7.1-memcache
 While installing you will be asked to set the MySQL root password.

MySQL

Install MySQL 5.7 to use a local database.
apt-get install mysql-server

You will be asked to enter a root password for the mysql server.

DNS and Additional Utilities

Install the DNS and other utilities:

 
  • curl 
  • openssl 
  • memcached 
  • php7.1-memcache 
  • nmap 
  • dnsutils 
  • bind9utils 
  • expect



apt-get install curl openssl memcached php7.1-memcache nmap dnsutils bind9utils expect

3) Configuring the requirements:

SSL

Enable the necessary apache modules with the following command:
a2enmod php7 ssl rewrite
In order to create self-signed certificates and to work properly, the hostname must be resolved properly. 

Open the hosts file for editing: 
    vi /etc/hosts
Add a record for your hostname
    yourhostname X.X.X.X
Create self-signed certificate:
    make-ssl-cert generate-default-snakeoil --force-overwrite


Apache

Please note that mod_rewrite is required! If it is not enabled in Apache, key elements will not work as expected.

Enable the default vhost for apache:
    a2ensite default-ssl
Allow overwrites in the apache vhosts:
    sed -i 's/AllowOverride None/AllowOverride All/g' /etc/apache2/sites-available/default* 
6. Reload apache:
    service apache2 reload

MySQL

MySQL Configuration:
    mysql -p -e "SET GLOBAL sql_mode='NO_ENGINE_SUBSTITUTION';SET SESSION sql_mode='NO_ENGINE_SUBSTITUTION';"

Then, enter the MySQL root password when prompted.


 We recommend setting the max_allowed_packet setting in the MySQL configuration file to 128MB (or similar) to account for the typical dataset size handled in ProVision. 

4) Optional configurations:

Radius (Optional)

This section only needs to be followed if the customer will be using Radius for authentication.


1. Install radius module:
Debian 7:


    pecl install radius
Debian 8:


    apt-get install php7-radius
Create module loading configuration:
(shown using the vi editor, though you may use the editor of your choice)


    vi /etc/php5/mods-available/radius.ini
  Add the following lines to radius.ini:


    ; configuration for php radius module
    ; priority=20
    extension=radius.so
  To enable the radius module, type the following command:


    php7enmod radius
  


5) Install 6connect ProVision Software:

1. Remove the current contents in the ProVision web folder (currently the www root) and after extract the archive contents (where 7.x.x is the version number for the build):

 	tar -xf productionBuild-7.x.x-php7.x.tar -C /var/www/

2. Change the permissions to be the web user permissions:

chown -R www-data.www-data /var/www

3. Go to http://﹤web root﹥/install/configTest.php.  Follow the provided instructions, correcting any configuration errors if they occur. Once all steps are completed, you are ready to use your ProVision instance!