Versions Compared

Old Version 3

changes.mady.by.user The Force

Saved on

compared with

New Version Current

changes.mady.by.user The Force

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from this space and version 8.0.0


HTML
<div id="google_translate_element"></div>
<script type="text/javascript">
function googleTranslateElementInit() {
  new google.translate.TranslateElement({pageLanguage: 'en'}, 'google_translate_element');
}
</script>
<script type="text/javascript" src="//translate.google.com/translate_a/element.js?cb=googleTranslateElementInit"></script>

Debian 8 

Table of Contents

Debian 7/ Debian 8 

Table of Contents

 

Note
titleDebian 8 Users

Debian 8 currently uses PHP 5.6 and is not supported. However, it will be supported in a future release.

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. 


Code Block
languagepowershell
   apt-get update
   apt-get upgrade
 


2) Install Required Packages
PHP
 Info
This step is only applicable to Debian 7 users. If you are using Debian 8, please skip this step.
 
All installations of ProVision require at least PHP 5.5 
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 
 5
7.
5 
1 or install PHP manually. 


 Info
For 
 In 
 this example, we are 
 going to use 3rd party repository that also upgrades the Apache to 2.4 as well as some other packages.
 
Edit sources.list:
(shown using the vi editor, though you may use the editor of your choice)
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  vi /etc/apt/sources.list
Add the following lines to sources.list:
 
 Code Block
languagetext
  deb httptrusted.gpg.d/php.gpg https://packages.dotdeb.org wheezy-php55 all
  deb-src http.sury.org/php/apt.gpg 
sudo sh -c 'echo "deb https://packages.dotdeb.org wheezy-php55 all
Install the GPG key:
 
 Code Block
languagebash
  wget https://www.dotdeb.org/dotdeb.gpg
  apt-key add dotdeb.gpg
 
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/PHP5PHP7/MySQL and development tools for pecl: 


 Expand
titleClick here for the list of extensions...
PHP5 
PHP 7.x / Apache2 / extensions
  • httpd 
  • apache2 
  • libapache2-mod-php5 
  • php5 
  • php5-cgi 
  • php5-cli 
  • php5-gd 
  • php5-curl 
  • php5-ldap 
  • php5-mysqlnd 
  • php5-ssh2 
  • php-pear 
    • php5-dev 
    • 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 
    php5-memcache
    • mod_ssl

     Code Block
    languagebash
       apt-get install apache2 libapache2-mod-php5 php5 php5php7.1 php7.1 php7.1-cgi php5php7.1-cli php5php7.1-gd php5php7.1-curl php5php7.1-ldap php5php7.1-mysqlnd php5php7.1-ssh2 php-pear php5php7.1-dev php7.1-imap curl openssl memcached php5php7.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
    Install the DNS and other utilities:

     
     Expand
    • curl 
    • openssl 
    • memcached 
    • php5php7.1-memcache 
    • nmap 
    • dnsutils 
    • bind9utils 
    • dnssec-tools 
    • expect
     


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

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

     Code Block
    languagebash
    a2enmod php5php7 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 php5php7-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
        php5enmod radius
     
      
    Source Guardian
     Note
     Source Guardian is only required for ProVision versions 5.1.2 and earlier. If installing ProVision 5.1.3 or later, skip this step.
    ...
    titleClick here for Source Guardian installation instructions (applies only to ProVision 5.1.2 and earlier)...
    Install the Source Guardian php extension 
     
     Info
    Download and find additional details from http://www.sourceguardian.com/ixeds/.  Choose either Linux 32 or Linux 64 .tar.gz depending on architecture.
    Download the loader and put it in the appropriate place. 
    Place the file in your php extension directory as specified in your php.ini
    ...
     
     Code Block
    languagebash
        wget https://www.sourceguardian.com/loaders/download/loaders.linux-x86_64.tar.bz2
    tar -xjf loaders.linux-x86_64.tar.bz2
    cp -rpPf ixed.5.5.lin /usr/lib/php5/20121212/
     
     
    Create module loading configuration:
     (shown using the vi editor, though you may use the editor of your choice)
     
     Code Block
        vi /etc/php5/mods-available/ixed.ini
     
      Add the following lines to ixed.ini (adding extension=ixed.x.x.y.y to your php.ini):
     
     Code Block
    languagetext
        ; configuration for php ixed module
    ; priority=20
    extension=ixed.5.5.lin
     
    To enable the radius module, type the following command:
     
     
     Code Block
    languagebash
        php5enmod ixed
     
    Reload apache
      php7enmod radius

      

       
     Code Block
    languagebash
    service apache2 reload
     Info
    titlePRO TIP - Loader Assistant for Source Guardian
    If you have any issues with getting Source Guardian installed, and the instructions are not working in your case, please check out http://www.sourceguardian.com/loaders/download.php - this page allows you paste in the output of your phpinfo page and then it will tell you the steps that need to be taken for your particular use case. If you are still having issues, please contact 6connect at support@6connect.com so one of our engineers can assist you.
     
    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):
     Code Block
    languagebash
     	tar -xf productionBuild-57.1x.2x-php5php7.5x.tar -C /var/www/
    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.
    ...
    4. Run configDir.sh ﹤web user﹥ from the command line as root in the web root.  This will setup the directories apache user needs read/write access to.
     Code Block
    languagebash
         cd /var/www/
     /var/www/configDir.sh www-data
    5. Create the default database and initial user in MySQL
    6. Go to http://﹤web root﹥/configBootstrap.php.  Fill in the requested information, noting any login credentials.
    7.  Create a secure directory and run configSecureKeys.sh ﹤web user﹥ ﹤path to secure directory﹥ from the command line as root.  This sets up the secure directory where your key file for password management will be stored.  The secure directory should be a location outside of the web root that is only accessible by appropriate users.
     Code Block
    languagebash
         mkdir /secure
     ./configSecureKeys.sh www-data /secure 
    ...
     Once all steps are completed, you are ready to use your ProVision instance!