Sentrifugo

Sentrifugo is a free and powerful new-age Human Resource Management System that can be easily configured to adapt to your organizational processes.

Installing Sentrifugo Version 3.1.1

Sentrifugo comes with its own web-installer to help guide you through the installation process.

Note: You can also find these steps in http://www.sentrifugo.com/home/installationguide

Table of Contents:

What server Sentrifugo works on?
Windows installation Guide
Linux installation Guide
MAC installation Guide
Upgrading your application code with patches
1. What server does Sentrifugo work on? ======================================= Sentrifugo works only on Apache Server
2. Windows Installation Guide ============================= AMP stack for Windows
  - The recommended AMP stack for Windows is XAMPP (Download the installer from basic package)
  - The system installer for XAMPP will guide you through the installation process
  Copying files
  - Move Sentrifugo zip file into the document root of Apache HTTP server.
  - If you used XAMPP for windows, document root is \htdocs\
  - For example: C:\xampp\htdocs\
  Extracting
  - Extract the Sentrifugo zip file in the document root of Apache HTTP server
  Web Installer
  - XAMPP users; the AMP stack for Windows needs to be started manually.
  - Using a JavaScript enabled browser go to http:///sentrifugo/; Where is localhost if it is installed in the machine you are currently working on, IP address if it is remotely hosted
  Pre-requisites
  
  The system requirements for installing Sentrifugo are described below. Make sure your system meets these requirements.
  
  a. PHP 5.3 or later You can download PHP 5.3 or later by visiting http://windows.php.net/download/
  
  b. 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:
```
 1. extension=php_pdo.dll
 2. extension=php_pdo_mysql.dll
```
  c. Rewrite module (for working of MVC architecture) To activate the module, the following line in httpd.conf needs to be uncommented:
```
 1. 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

 2. 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:

 3. AllowOverride all
 This is important as many httpd.conf ship by default with allowoverride none
```
  d. GD library (for images) You can add the following lines in your php.ini file:
```
 1. extension = php_gd2.dll
```
  e. 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:

 1. extension=php_openssl.dll
```
3. Linux Installation Guide =========================== AMP stack for Linux
  - The recommended AMP stack for Linux is XAMPP Linux 1.6 (Download the complete stack and not the upgrades)
  - The system installer for XAMPP in the XAMPP site will guide you through the installation process
  - Start the stack manually every time you reboot.
  - Change the ownership of Sentrifugo files (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 for windows, document root is \htdocs\
  - For example: C:\xampp\htdocs\
  Extracting
  - Extract the Sentrifugo zip file in the document root of Apache HTTP server
  Web Installer
  - XAMPP users; the AMP stack for Linux needs to be started manually.
  - Using a JavaScript enabled browser go to http:///sentrifugo/; Where is localhost if it is installed in the machine you are currently working on, IP address if it is remotely hosted
  Pre-requisites
  
  The system requirements for installing Sentrifugo are described below. Make sure your system meets these requirements.
  
  a. PHP 5.3 or later To install PHP 5.3 on Linux, please follow the below links:
```
 For Ubuntu: https://www.digitalocean.com/community/tutorials/how-to-install-linux-apache-mysql-php-lamp-stack-on-ubuntu
 For Redhat and CentOS: http://www.thetechnicalstuff.com/install-php5-3-in-centos-and-redhat/
```
  b. 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:
```
 1. extension=pdo.so
 2. extension=pdo_mysql.so
```
  c. Rewrite module (for working of MVC architecture) activate mod_rewrite in linux, open the terminal and add the below line:
```
 1. sudo a2enmod rewrite
 
 You also need to make sure that in your httpd.conf, AllowOverride is enabled:
 2. AllowOverride All
```
  d. GD library (for images) To install GD library in Linux, open the terminal and add the below lines:
```
 1. #apt-get install php5-gd
```
  e. 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/
4. MAC Installation Guide ========================= AMP stack for MAC
  - The recommended AMP stack for MAC is MAMP
  - The system installer for XAMPP will guide you through the installation process
  - If MAMP is previously installed, the installer will rename the MAMP folder to MAMP_current_date.
  - An existing 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.
  Copying files
  - Move Sentrifugo zip file into the document root of Apache HTTP server.
  - If you used XAMPP for windows, document root is \htdocs\
  - For example: C:\xampp\htdocs\
  Extracting
  - Extract the Sentrifugo zip file in the document root of Apache HTTP server
  Web Installer
  - MAMP users; the AMP stack for MAC needs to be started manually.
  - Using a JavaScript enabled browser go to http:///sentrifugo/; Where is localhost if it is installed in the machine you are currently working on, IP address if it is remotely hosted
  Pre-requisites
  
  The system requirements for installing Sentrifugo are described below. Make sure your system meets these requirements.
  
  a. PHP 5.3 or later You can download PHP 5.3 or later by visiting http://php.net/downloads.php
  
  b. 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:
```
 1. extension=php_mysqli.so
 2. extension=php_pdo_mysql.so
```
  c. Rewrite module (for working of MVC architecture) To activate mod_rewrite module in MAC, add the below line to httpd.conf file
```
 1. LoadModule rewrite_module libexec/apache2/mod_rewrite.so
 2. LoadModule php5_module libexec/apache2/libphp5.so
 
 Also, make sure that AllowOverride is set to All within the <Directory "/Library/WebServer/Documents"> section.
```
  d. GD library (for images) You can add the following lines in your php.ini file:
```
 1. extension = gd.so
```
  e. Open SSL (For SSL and TSL Protocols) Download the installer for OpenSSL from http://www.openssl.org/source/
5. Upgrading your application code with patches =====================================================
MANUAL
1. Download Sentrifugo.zip
2. Extract the zip file
3. Check for patches folder in the extracted Sentrifugo folder
4. Check your application code version in index.php Ex: defined('CODEVERSION')|| define('CODEVERSION', '3.1');
5. If your code version is not 3.1, take patches till patches 3.1.1
  Eg: If CODEVERSION is 3.0, take patches from 3.0 to patches 3.1.1
6. If your code version is 3.1, consider patches_3.1.1 folder
AUTOMATION
1. Login into your application as 'Super Admin'
2. Click on Profile pop-up on the right hand-side
3. Select Upgrade application
4. Current application version will be displayed. Choose version to upgrade as 3.1.1
5. On clicking 'Upgrade' button, patches_3.1.1 will be downloaded
To install patch 3.1.1
1. Extract the patches_3.1.1 .zip file
2. Copy and replace the files to your current application folder
3. Execute the queries in sql/queries.txt file, if any (commands are mentioned at the bottom of this document)
NOTE: Once you login to the application, update any role in Human Resources -> User Management -> Roles and Privileges page.

Refer UPGRADE document for a detailed description of the installation process of patches.

Sentrifugo

Installing Sentrifugo Version 3.1.1

Windows Installation Guide ============================= AMP stack for Windows

Copying files

Extracting

Web Installer

Pre-requisites

Linux Installation Guide =========================== AMP stack for Linux

Copying files

Extracting

Web Installer

Pre-requisites

MAC Installation Guide ========================= AMP stack for MAC

Copying files

Extracting

Web Installer

Pre-requisites