Installation Guide

Choose your Platform

Installation Guide

Sentrifugo comes with its own web-installer to help guide you through the installation process. While the guide provides step by step guidance during the installation process, it's important and helpful for you to have knowledge about web servers, PHP and MySQL.

If you already have Apache HTTP Webserver (PHP loaded as an Apache module) and MySQL running, then you have everything you need.

If in case you don't have the pre-requisites setup, you can:

  • Use an AMP stack which has Apache, MySQL and PHP already configured.
  • Configure Apache, MySQL and PHP manually.

AMP Stack for Windows

The recommended AMP stack for windows is XAMPP Windows. Download the pack using http://www.apachefriends.org/download.html#641

Notice: Make sure you download the installer from Basic Package and not upgrades, developer packs, etc.

After downloading, start installing XAMPP for Windows.

  • You can choose the default installation location and click Next
  • When asked to "Install XAMPP Servers (Apache, MySQL,...) as service?", select Yes
  • When asked to "Install Apache 2 as service?", select Yes
  • When asked to "Install MySQL as service?", select Yes
  • You may skip the other services by selecting No since they are not required for Sentrifugo
  • Select Yes to start the XAMPP control panel too.

Notice:

  • If you use any firewall software (i.e.; Windows Firewall) if prompted, please make sure that XAMPP services (Apache Web Server, MySQL) are exempted from the blocked list
  • If you use Skype, this may result in a port conflict with Apache web-server included in XAMPP when installed. Therefore, make sure you re-start Windows to make sure that XAMPP services start before Skype (then Skype will go for an alternate port).

Copying Files

Move Sentrifugo zip file into the document root of Apache HTTP server.

If you used XAMPP for windows, document root is   <XAMPP installed location>\htdocs\

For example: C:\xampp\htdocs\

Extracting

Extract the Sentrifugo zip file in the document root of Apache HTTP server, which would extract everything needed to run Sentrifugo application.

Web Installation

XAMPP users; the Windows stack needs to be started manually.

Using a JavaScript enabled browser go to http://<webhost>/sentrifugo/

Where <webhost> is localhost if it is installed in the machine you are currently working on, IP address if it is remotely hosted (i.e. external to the machine you are using).

Pre-requisites

The system requirements for installing Sentrifugo are described below. Make sure your system meets these requirements.

  • PHP 5.3 or later

    You can download PHP 5.3 or later by visiting http://windows.php.net/download/

  • PDO MySQL (for MySQL connection)

    To install Sentrifugo on windows, you need to enable the PDO and PDO_MYSQL extensions in your php.ini file. You can add the following lines in your php.ini file:

    • extension=php_pdo.dll
    • extension=php_pdo_mysql.dll
  • Rewrite module (for working of MVC architecture)

    To activate the module, the following line in httpd.conf needs to be uncommented:

    • LoadModule rewrite_module modules/mod_rewrite.so

    To see whether it is already active, try putting a .htaccess file into a web directory containing the line

    • RewriteEngine on

    If this works without throwing a 500 internal server error, and the .htaccess file gets parsed, URL rewriting works.

    You also need to make sure that in your httpd.conf, AllowOverrides is enabled:

    • AllowOverride all

    This is important as many httpd.conf ship by default with allowoverride none

  • GD library (for images)

    You can add the following lines in your php.ini file:

    • extension = php_gd2.dll
  • Open SSL (For SSL and TSL Protocols)

    Download the installer for OpenSSL 1.0.1e from http://www.openssl.org/related/binaries.html

    If OpenSSL is already installed in your system, to enable this extension in your php.ini file, you can add the following line in your php.ini file:

    • extension=php_openssl.dll

Installation Guide

Sentrifugo comes with its own web-installer to help guide you through the installation process. While the guide provides step by step guidance during the installation process, it's important and helpful for you to have knowledge about web servers, PHP and MySQL.

If you already have Apache HTTP Webserver (PHP loaded as an Apache module) and MySQL running, then you have everything you need.

If in case you don't have the pre-requisites setup, you can:

  • Use an AMP stack which has Apache, MySQL and PHP already configured.
  • Configure Apache, MySQL and PHP manually.

AMP Stack for MAC

The recommended AMP stack for MAC is MAMP. Download the pack using http://www.mamp.info/en/

The System Installer for MAMP will guide you through the installation process in MAC.

  • If MAMP is previously installed, the installer will rename the MAMP folder to MAMP_current_date.
  • An existing htdocs folder will be moved to your new /Applications/MAMP folder.
  • Your /Applications/MAMP_current_date folder can now be deleted. You can keep it if you wish to fall back to your original setup.

Note: Make sure that all data has been transferred correctly before starting MAMP. When installing MAMP, an /Applications/MAMP Pro folder will be installed in addition to your /Applications/MAMP folder. You can ignore this folder if you choose not to use MAMP PRO.

Copying Files

Move Sentrifugo zip file into the document root of Apache HTTP server.

If you used MAMP, document root is

<MAMP installed location>\htdocs\

Extracting

Extract the Sentrifugo zip file in the document root of Apache HTTP server, which would extract everything needed to run Sentrifugo application.

Web Installation

MAMP users; the AMP stack for MAC needs to be started manually.

Using a JavaScript enabled browser go to http://<webhost>/sentrifugo/

Where <webhost> is localhost if it is installed in the machine you are currently working on, IP address if it is remotely hosted (i.e. external to the machine you are using).

Pre-requisites

The system requirements for installing Sentrifugo are described below. Make sure your system meets these requirements.

  • PHP 5.3 or later

    You can download PHP 5.3 or later by visiting http://php.net/downloads.php

  • PDO MySQL (for MySQL connection)

    To install Sentrifugo on MAC, you need to enable the PDO and PDO_MYSQL extensions in your php.ini file. You can add the following lines in your php.ini file:

    • extension=php_mysqli.so
    • extension=php_pdo_mysql.so
  • Rewrite module (for working of MVC architecture)

    To activate mod_rewrite module in MAC, add the below line to httpd.conf file

    • LoadModule rewrite_module libexec/apache2/mod_rewrite.so
    • LoadModule php5_module libexec/apache2/libphp5.so

    Also, make sure that AllowOverride is set to All within the <Directory "/Library/WebServer/Documents"> section.

  • GD library (for images)

    You can add the following lines in your php.ini file:

    • extension = gd.so
  • Open SSL (For SSL and TSL Protocols)

    Download the installer for OpenSSL from http://www.openssl.org/source/

Installation Guide

Sentrifugo comes with its own web-installer to help guide you through the installation process. While the guide provides step by step guidance during the installation process, it's important and helpful for you to have knowledge about web servers, PHP and MySQL.

If you already have Apache HTTP Webserver (PHP loaded as an Apache module) and MySQL running, then you have everything you need.

If in case you don't have the pre-requisites setup, you can:

  • Use an AMP stack which has Apache, MySQL and PHP already configured.
  • Configure Apache, MySQL and PHP manually.

AMP Stack for Linux

The recommended AMP stack for Linux is XAMPP Linux 1.6. Download the pack using http://www.apachefriends.org/download.html#374

Notice: Make sure you download the complete stack and not the upgrades, developers pack, etc.

After downloading, start installing XAMPP Linux following the instructions given in the XAMPP site.

Note: Start the stack manually every time you reboot.

Notes: You will have to change the ownership of Sentrifugo files to nobody.nobody Type the following in the shell. is the path where the Sentrifugo files are located. Ex: /opt/xampp/htdocs/sentrifugo/ $ chown -R nobody.nobody

Copying Files

Move Sentrifugo zip file into the document root of Apache HTTP server.

If you used XAMPP Linux AMP stack, document root is

<XAMPP installed location>\htdocs\

Extracting

Extract the Sentrifugo zip file in the document root of Apache HTTP server, which would extract everything needed to run Sentrifugo application.

Web Installation

XAMPP users; the Linux stack needs to be started manually.

Using a JavaScript enabled browser go to http://<webhost>/sentrifugo/

Where <webhost> is localhost if it is installed in the machine you are currently working on, IP address if it is remotely hosted (i.e. external to the machine you are using).

Pre-requisites

The system requirements for installing Sentrifugo are described below. Make sure your system meets these requirements.

  • PHP 5.3 or later

    To install PHP 5.3 on Linux, please follow the below links:

  • PDO MySQL (for MySQL connection)

    To install Sentrifugo on Linux, you can compile php with --with-pdo-mysql in your php.ini, and add the following lines:

    • extension=pdo.so
    • extension=pdo_mysql.so
  • Rewrite module (for working of MVC architecture)

    To activate mod_rewrite in linux, open the terminal and add the below line:

    • sudo a2enmod rewrite
    You also need to make sure that in your httpd.conf, AllowOverride is enabled:
    • AllowOverride All
  • GD library (for images)

    To install GD library in Linux, open the terminal and add the below lines:

    • # apt-get install php5-gd
  • Open SSL (For SSL and TSL Protocols)

    Download the OpenSSL 1.0.1c tarball archive from the OpenSSL web site at http://www.openssl.org/source/