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

title	Permissions

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

language	powershell

   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). You can either add a repository which provides PHP 7.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 7.1. We also provide an option to install PHP 5.7 through a third-party repository.

Expand

title	If you are installing PHP 7.x click here...

Note
If you are installing ProVision 7.x, or after, make sure that your build archive has "php7.x" as part of its name. For example "productionBuild-7.0.0-php7.1.tar".

1. Add PHP 7.1 package sources to your system:

Code Block

language	bash

 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

language	bash

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

2. Update packages:

Code Block

language	bash

apt-get update

3. Install PHP:

Code Block

language	bash

apt-get install php7.1

and confirm with “y” and ENTER.

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

To verify the installed version of PHP, run:

Code Block

language	bash

php7 -v

Install Apache2/PHP 7.x/MySQL 5.7 and development tools for pecl:

Expand

title	Click 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

language	bash

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

MySQL

Note
ProVision 7.x and above require requires MySQL 5.7 and above.

Expand

title	To install MySQL 5.6.20+, click here...

Add new repository for MySQL 5.7 distribution.

Code Block

language	bash

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

Update current packages.

Code Block

language	bash

apt-get update

Install MySQL 5.7 to use a local database.

Code Block

language	bash

apt-get install mysql-server-5.7

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

language	bash

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 dnsutils bind9utils expect

Code Block
apt-get install curl openssl nmap dnsutils bind9utils expect

3) Configuring the requirements:

SSL

Enable the necessary apache modules with the following command:

Code Block

language	bash

a2enmod php7 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

language	bash

    vi /etc/hosts

Add a record for your hostname:

Code Block

language	text

    X.X.X.X yourhostname

Create self-signed certificate:

Code Block

language	bash

    make-ssl-cert generate-default-snakeoil --force-overwrite

Apache

Note

title	mod 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

language	bash

    a2ensite default-ssl

Allow overwrites in the apache vhosts

:

Code Block

language	bash

    sed -i 's/AllowOverride None/AllowOverride All/g' /etc/apache2/apache2.conf

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

Code Block

language	bash

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

language	bash

    service apache2 restart

MySQL

MySQL Configuration:

Code Block

language	bash

    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

title	MySQL 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

title	If you are going to use radius authentication, click here.

Install radius module:

Code Block

language	bash
title	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)

Code Block

language	text

	vi /etc/php5/mods-available/radius.ini

Add the following lines to radius.ini:

Code Block

language	text

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

To enable the radius module, type the following command:

Code Block

language	bash

    php7enmod radius

SSH

Install ssh module:

Code Block

language	bash

	apt-get install libssh2-1-dev

then run:

Code Block

language	bash

	pecl install ssh2-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/php7/mods-available/ssh2.ini

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

Code Block

language	text

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

To enable, type the following command:

Code Block

language	bash

	phpenmod ssh2

Reload apache :

Code Block

language	bash

    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 7.x.x is the version number for the build):

Code Block

language	bash

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

2. Change the permissions to be the web user permissions

Code Block

language	bash

    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!

...

Page tree

Versions Compared

Old Version 1

New Version Current

Key

Ubuntu 18.04

Ubuntu 14.04 LTS

Before You Begin

Install Requirements

1) Upgrade your current packages

2) Install Required Packages

PHP

MySQL

DNS and Additional Utilities

3) Configuring the requirements:

SSL

Apache

MySQL

4) Optional configurations:

Radius (Optional)

SSH

5) Install 6connect ProVision Software:

Page tree

Page History

Versions Compared

Old Version 1

New Version Current

Key

Ubuntu 18.04

Ubuntu 14.04 LTS

Before You Begin

Install Requirements

1) Upgrade your current packages

2) Install Required Packages

PHP

MySQL

DNS and Additional Utilities

3) Configuring the requirements:

SSL

Apache

MySQL

4) Optional configurations:

Radius (Optional)

SSH

5) Install 6connect ProVision Software: