| 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
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 |
|---|
|
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.
| Code Block |
|---|
| language | bash |
|---|
| title | Debian 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 |
|---|
|
apt-get update |
Install Apache2/PHP7/MySQL 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 |
|---|
|
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 |
|---|
|
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
- 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:
SSL
Enable the necessary apache modules with the following command:
| Code Block |
|---|
|
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:
Add a record for your hostname
| Code Block |
|---|
|
yourhostname X.X.X.X |
Create self-signed certificate:
| Code Block |
|---|
|
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 |
|---|
|
a2ensite default-ssl |
Allow overwrites in the apache vhosts:
| Code Block |
|---|
|
sed -i 's/AllowOverride None/AllowOverride All/g' /etc/apache2/sites-available/default* |
6. Reload apache :
| Code Block |
|---|
|
service apache2 reload |
MySQL
MySQL Configuration:
| Code Block |
|---|
|
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. |
|---|
|
1. Install radius module: Debian 7:
| Code Block |
|---|
| language | bash |
|---|
| title | Debian 7: |
|---|
| pecl install radius |
Debian 8:
| 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 |
|---|
| vi /etc/php5/mods-available/radius.ini |
Add the following lines to radius.ini:
| Code Block |
|---|
| ; configuration for php radius module
; priority=20
extension=radius.so |
To enable the radius module, type the following command:
| Code Block |
|---|
| php7enmod radius |
|
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):
...
2. Change the permissions to be the web user permissions
...
:
| Code Block |
|---|
|
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!
...
