Ubuntu 14.04 LTS

 

Before You Begin

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

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.

 

   apt-get update
   apt-get upgrade

 

2) Install Required Packages

PHP

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

 

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

1. Add PHP 5.6 package sources to your system:

 add-apt-repository ppa:ondrej/php

and confirm with ENTER to continue.

 

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

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

 

2. Update packages:

apt-get update

 

3. Install PHP:

apt-get install php5.6

and confirm with “y” and ENTER.

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

To verify the installed version of PHP, run:

php5 -v

 

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

 

PHP5 / Apache2 / extensions

  • apache2 

  • libapache2-mod-php5 

  • php5 

  • php5-cgi 

  • php5-cli 

  • php5-gd 

  • php5-curl 

  • php5-ldap 

  • php5-mysqlnd 

  • php-pear 

  • php5-dev 

Development tools for pecl / additional system packages:

  • curl 

  • openssl 

apt-get install apache2 libapache2-mod-php5 php5 php5-cgi php5-cli libssh2-php php5-ssh2 php5-gd php5-curl php5-ldap php5-mysql php-pear php5-dev curl openssl

 

MySQL

ProVision 5.2 and above require MySQL 5.6.20 and above.

Add new repository for MySQL 5.6 distribution.


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


Update current packages.

 

apt-get update

 

Install MySQL 5.6 to use a local database.


apt-get install mysql-server-5.6

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.

 

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


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:

 

a2enmod php5 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: 

 

    vi /etc/hosts

 

    Add a record for your hostname

 

    X.X.X.X yourhostname

 

Create self signed certificate:

 

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

Apache

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

 

    a2ensite default-ssl

 

Allow overwrites in the apache vhosts

 

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

 

Update site configurations to use /var/www for docroot

 

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

 

    service apache2 restart

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.

 

4) Optional configurations:

 

Radius (Optional)

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


Install radius module:

 

Debian 8:
    apt-get install php5-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:

 

    php5enmod radius

 

  

SSH

Install ssh module:
 
	apt-get install libssh2-1-dev
 then run
 
	pecl install -f ssh2

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

 

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

 

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

 

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

 

 
To enable, type the following command:
 

 

    php5enmod ssh2

Reload apache

 

    service apache2 reload

 

 


5) Install 6connect ProVision Software:

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

 	tar -xf productionBuild-5.x.x-php5.6.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!

 

 


  • No labels