Versions Compared

Key

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

Ubuntu 18.04

Table of Contents


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>

Ubuntu 14.04 LTS

Table of Contents

 

Before You Begin

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

Info
titlePermissions

Before installing, verify that you have appropriate install permissions. Depending on your permissions and system setup, commands may need to be run as superuser by prepending "sudo" to the listed commands.

 

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

All installations Installations of ProVision versions 5.2.0 or later require PHP 5.6 7.x and newer require  PHP 7.1 (and related extensions). You  You can either add a repository which provides PHP 57.6 1 or install PHP manually. In this example, we use the default package sources for Ubuntu 1418.04 to install Apache 2.4 and PHP 57.61. We also provide an option to install PHP 5.6 7 through a third-party repository.


 

Expand
titleIf you are installing PHP 57.6 x click here...
Note

 If you are installing ProVision 57.2.0x, or after, make sure that your build archive has "php5php7.6x" as part of its name. For example "productionBuild-57.20.0-php5php7.61.tar".

1. Add PHP 57.6 1 package sources to your system:

Code Block
languagebash
 add-apt-repository ppa:ondrej/php

and confirm with ENTER to continue.

 


Info

If you get an error here, you may need to install python-software-properties first and then repeat the repository add as follows:

Code Block
languagebash
apt-get update 
apt-get install python-software-properties
 
add-apt-repository ppa:ondrej/php

 


2. Update packages:

Code Block
languagebash
apt-get update

 


3. Install PHP:

Code Block
languagebash
apt-get install php5php7.61

and confirm with “y” and ENTER.

You’ll now see “PHP 57.61.x” in the scrolling installation logs.

To verify the installed version of PHP, run:

Code Block
languagebash
php5php7 -v
 

Install Apache2/PHP5PHP 7.x/MySQL 5.7 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 

  • 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 
    • mod_ssl
    Code Block
    languagebash
    apt-get install apache2 libapache2-mod-php5 php5 php5php7.1 php7.1 php7.1-cgi php5php7.1-cli libssh2-php php5-ssh2 php5php7.1-gd php5php7.1-curl php5php7.1-ldap php5-mysqlphp7.1-mysqlnd php7.1-ssh2 php-pear php5php7.1-dev php7.1-imap curl openssl

     

     memcached php7.1-memcache

    MySQL

    Note

    ProVision 57.2 x and above require requires MySQL 5.6.20 7 and above.


    Expand
    titleTo install MySQL 5.6.20+, click here...

    Add new repository for MySQL 5.6 7 distribution.


    Code Block
    languagebash
    apt-key adv --keyserver pgp.mit.edu --recv-keys 5072E1F5
    echo "deb http://repo.mysql.com/apt/ubuntu/ trusty mysql-5.67" >> /etc/apt/sources.list.d/mysql.list


    Update current packages.

     


    Code Block
    languagebash
    apt-get update

     


    Install MySQL 5.6 7 to use a local database.


    Code Block
    languagebash
    apt-get install mysql-server-5.67

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


    MySQL is now installed. You can proceed to next section DNS And Additional Utilities

     


    Install MySQL 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 
    • nmap nmap
    • dnsutils dnsutils
    • bind9utils bind9utils
    • dnssec-tools 
    • expect


    Code Block
    apt-get install curl openssl 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 headers
    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
        X.X.X.X yourhostname
     

    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/apache2.conf

     

    Update site configurations to use /var/www for docroot :

    Code Block
    languagebash
    sed -i 's/\/var\/www\/html/\/var\/www/' /etc/apache2/sites-available/000-default.conf
    sed -i 's/\/var\/www\/html/\/var\/www/' /etc/apache2/sites-available/default-ssl.conf

     

    Restart apache:

     

    Code Block
    languagebash
        service apache2 restart

    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.


    Install radius module:


     

    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  php7enmod radius
     
      

    SSH

    Install ssh module:
     
    Code Block
    languagebash
    	apt-get install libssh2-1-dev

     then run:
     
    Code Block
    languagebash
    	pecl install -f ssh2ssh2-1.1.2

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

     

    Code Block
        vi /etc/php5php7/mods-available/ssh2.ini

     

     

    Add the following lines to ssh2.ini (adding extension=ssh2.so to your ssh2.ini):

     

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

    To enable, type the following command:

     

     

    Code Block
    languagebash
        php5enmod	phpenmod ssh2

    Reload apache:

     

    Code Block
    languagebash
        service apache2 reload
     

     


    5) Install 6connect ProVision Software:

    Info

    The latest version of ProVision can be found at https://cloud.6connect.com/Download/Latest/ and downloaded using the credentials provided to you.

    If you need credentials provided to you, or any other assistance, please contact our support team atsupport@6connect.com.

     

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

    Code Block
    languagebash
     	tar -xf productionBuild-57.x.x-php5php7.6x.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. Once all steps are completed, you are ready to use your ProVision instance!

     

    ...