Versions Compared

Old Version 19

changes.mady.by.user The Force

Saved on

compared with

New Version 20

changes.mady.by.user The Force

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Upgrade your current packages.


 

Code Block
languagepowershell
   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. 


Info

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.


Code Block
languagebash
titleDebian 8 Install Package
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: 


Code Block
languagebash
   apt-get update

 


Install Apache2/PHP7/MySQL and development tools for pecl:

 


Expand
titleClick here for the list of extensions...

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


Code Block
languagebash
   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.


 

Code Block
languagebash
apt-get install mysql-server


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



 

DNS and Additional Utilities

...

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



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


3) Configuring the requirements:
...
Enable the necessary apache modules with the following command:

 
 Code Block
languagebash
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:  

 Code Block
languagebash
    vi /etc/hosts
 

    Add a record for your hostname

 
 Code Block
languagetext
    yourhostname X.X.X.X
 

Create self signed certificate:

 
 Code Block
languagebash
    make-ssl-cert generate-default-snakeoil --force-overwrite
Apache
 Note
titlemod rewrite REQUIRED
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

 
 Code Block
languagebash
    a2ensite default-ssl
 

Allow overwrites in the apache vhosts 

 Code Block
languagebash
    sed -i 's/AllowOverride None/AllowOverride All/g' /etc/apache2/sites-available/default* 
 

6. Reload apache 

 Code Block
languagebash
    service apache2 reload
MySQL
MySQL Configuration:

 
 Code Block
languagebash
    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.
 

 Note
titleMySQL Packet Size Configuration
 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.
 Expand
titleIf you are going to use radius authentication, click here.

1. Install radius module:
Debian 7:

 
 Code Block
languagebash
titleDebian 7:
    pecl install radius
 

Debian 8: 

 Code Block
languagebash
titleDebian 8:
    apt-get install php7-radius
 

Create module loading configuration:
(shown using the vi editor, though you may use the editor of your choice) 

 Code Block
languagetext
    vi /etc/php5/mods-available/radius.ini
 

  Add the following lines to radius.ini:

 
 Code Block
languagetext
    ; configuration for php radius module
    ; priority=20
    extension=radius.so

    To enable the radius module, type the following command:

 
 Code Block
languagebash
    php7enmod radius

   
5) Install 6connect ProVision Software:
...
2. Change the permissions to be the web user permissions
   
 
 Code Block
languagebash
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!
...