ManagedCloud Servers

High performance handled and monitored by us 24/7/365. A complete solution to provide you with our in house expertise 24/7 tailored to your specific needs. We'll setup a bespoke server for your site using the latest tehnologies so you can get the most out of your hardware and get your website loading quickly and reliably. Find out more..

cPanelCloud Servers

Recommended - High performance cloud servers with no technical knowledge required. If you're hosting multiple websites already and you're looking to consolidate, or if you're looking to isolate yourself from the shared hosting environment but you don't have the time or knoweldge to manage a server, then the Managed cPanel Servers are for you. Find out more..

UnmanagedCloud Servers

Our unmanaged range gives you complete control at rock bottom prices and our cloud platform boasts super fast multipath 40Gb/s network, the latest Intel Xeon V3 CPUs and enterprise grade redundant SSDs. If you're a sysadmin look no further, we offer some of the best specification to price ratio servers available. Find out more..

Want your very own server? Get our 1GB memory, Xeon V4, 20GB SSD VPS for £10.00 / month.

View Plans

How to Install OrangeHRM On Ubuntu 14.04

OrangeHRM is an open source Human Resource Management software or usually also known as Human Resource Information System. First released in January 2006, OrangeHRM grown into a full flegded HRM software.

OrangeHRM Inc, the company behind OrangeHRM also provide two additional edition of OrangeHRM, OrangeHRM Professional and OrangeHRM Enterprise edition for company that needs support from OrangeHRM Inc.

OrangeHRM shipped with the following modules:

  • Personnel Information Management (PIM)
  • System Administration & User Roles
  • Leave & Time Off Management
  • Time & Attendance Management
  • Recruiting & On-boarding (including Applicant Tracking System (ATS)
  • Performance & Training
  • Travel & Expense Tracker
  • Employment Compliance
  • Discipline Tracker
  • Insurance Benefits
  • Document Manager

OrangeHRM also have corporate directory mobile application, it's available for Android and iOS. You can learn more about OrangeHRM on orangehrm.com

Objective

In this tutorial we'll learn how-to Orange HRM on Ubuntu 14.04. We will also install and configure its prerequisites

Prerequisites

We need to install these applications before we can install OrangeHRM:

  • Fresh install of Ubuntu Server 14.04. You can use any ubuntu flavors but using ubuntu server will make sure your server have minimalist ubuntu installation so your system will not be loaded by unnecessary softwares.
  • Apache 2
  • MySQL 5.6 (Minimum MySQL 5.0.3)
  • PHP > 5.5.0

Update Base System

Before we install OrangeHRM and its prerequisites let's update the system to the latest update.

$ sudo apt-get update
$ sudo apt-get -y upgrade

Install Apache 2

After applying latest update to our base system, let's start installing Apache 2 and its required libraries.

$ sudo apt-get -y install apache2 apache2-bin apache2-data apache2-mpm-prefork libaio1 libapache2-mod-php5 libapr1 libaprutil1 libdbd-mysql-perl libdbi-perl libhtml-template-perl libmysqlclient18 libterm-readkey-perl libwrap0 ssl-cert tcpd

We can check Apache 2 service status using command below:

sudo service apache2 status
 * apache2 is running

We can also check whether Apache 2 is listening and on which port using command below.

 sudo netstat -naptu | grep apache
tcp6       0      0 :::80                   :::*                    LISTEN      14873/apache2

Install MySQL 5.6

We will install and use MySQL 5.6 as database for orangehrm. We will use MySQL Server 5.6 since MySQL 5.6 is the most up to date version of MySQL shipped with Ubuntu 14.04 Trusty Tahr.

$ sudo apt-get -y install mysql-server-5.6

We need to setup MySQL root password. Please input password for MySQL root user.

Verify root password.

Securing MySQL Installation.

We will secure MySQL installation by running mysql_secure_installation.

Enter root password that we set on installation:

$ mysql_secure_installation 
NOTE: RUNNING ALL PARTS OF THIS SCRIPT IS RECOMMENDED FOR ALL MySQL
      SERVERS IN PRODUCTION USE!  PLEASE READ EACH STEP CAREFULLY!

In order to log into MySQL to secure it, we'll need the current password for the root user. If you've just installed MySQL, and you haven't set the root password yet, the password will be blank, so you should just press enter here.

Enter current password for root (enter for none): OK, successfully used password, moving on...

Since we already have root password set, answer this part with n.

Setting the root password ensures that nobody can log into the MySQL
root user without the proper authorisation.

You already have a root password set, so you can safely answer 'n'.

Change the root password? [Y/n] n ... skipping.

Remove anonymous user to improve security. This will make sure people or application have correct username and password to login to MySQL. Answer with Y

By default, a MySQL installation has an anonymous user, allowing anyone
to log into MySQL without having to have a user account created for
them.  This is intended only for testing, and to make the installation
go a bit smoother.  You should remove them before moving into a
production environment.

Remove anonymous users? [Y/n] Y ... Success!

We also want remove root login from remote machine. Answer with Y

Normally, root should only be allowed to connect from 'localhost'.  This
ensures that someone cannot guess at the root password from the network.

Disallow root login remotely? [Y/n] Y ... Success!

Previously the test database created automatically by MySQL installation, but MySQL 5.6 does not create test database. We can still choose Y, it will throw error but that's fine.

By default, MySQL comes with a database named 'test' that anyone can
access.  This is also intended only for testing, and should be removed
before moving into a production environment.

Remove test database and access to it? [Y/n] Y - Dropping test database... ERROR 1008 (HY000) at line 1: Can't drop database 'test'; database doesn't exist ... Failed! Not critical, keep moving... - Removing privileges on test database... ... Success!

The last step is to reload MySQL privilege table:

Reloading the privilege tables will ensure that all changes made so far
will take effect immediately.

Reload privilege tables now? [Y/n] Y ... Success!

All done! If you've completed all of the above steps, your MySQL installation should now be secure.

Thanks for using MySQL!

Cleaning up...

Create the Database for OrangeHRM

Now we have a secure MySQL installation, it's time to create database and user for orangehrm itself.

Login to MySQL using root credential.

$ mysql -u root -p
Enter password: 
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 58
Server version: 5.6.30-0ubuntu0.14.04.1 (Ubuntu)

Copyright (c) 2000, 2016, Oracle and/or its affiliates. All rights reserved.

Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql>

Create a new database named orangehrm using command below:

mysql> CREATE DATABASE orangehrm;
Query OK, 1 row affected (0.00 sec)

Create a User for OrangeHRM

The database for OrangeHRM is ready, let's create a username and password then grant privileges to orangehrm database.

Don't forget to change the password orangehrm123secret below for a better password.

mysql> GRANT ALL PRIVILEGES ON `orangehrm`.* TO 'orangehrm'@'localhost' IDENTIFIED BY 'orangehrm123secret';
Query OK, 0 rows affected (0.00 sec)

We need to run the FLUSH PRIVILEGES command so that the privileges table will be reloaded by MySQL and we can use new credential.

mysql> FLUSH PRIVILEGES;
Query OK, 0 rows affected (0.00 sec)

Exit from the MySQL console by typing \q:

mysql> \q

Install PHP 5

The last component that we have to install before we can install OrangeHRM is PHP 5. We will install PHP 5 and several common PHP libraries.

$ sudo apt-get -y install php5-cli php5-common php5-json php5-mysql php5-readline

Install OrangeHRM

All prerequisites are already installed. We're now ready to install OrangeHRM. The latest stable version of OrangeHRM is available from Sourceforge.net.

At the time of this writing, the latest stable version is version 3.3.3, let's download OrangeHRM compressed file using wget.

$ wget -c https://nchc.dl.sourceforge.net/project/orangehrm/stable/3.3.3/orangehrm-3.3.3.zip

Extract the downloaded file using unzip. If your system don't have unzip yet, you can install unzip using command below:

$ sudo apt-get -y install unzip

Extract OrangeHRM using unzip

$ unzip orangehrm-3.3.3.zip

Rename the extracted directory to orangehrm

$ mv orangehrm-3.3.3 orangehrm

Move orangehrm folder to Apache directory:

$ sudo mv orangehrm /var/www

Change ownership of orangehrm directory to www-data user and group:

$ sudo chown -R www-data:www-data /var/www/orangehrm

The OrangeHRM files are ready, now let's create Apache Virtual Host configuration to serve orangehrm.

Configure Apache Virtual Host for http Only

Create new apache configuration file on /etc/apache2/sites-available/orangehrm.conf with contents below.

<VirtualHost *:80>
    ServerName orangehrm.exampleserver.xyz

DocumentRoot /var/www/orangehrm

<Directory /var/www/orangehrm> Options -Indexes +FollowSymLinks +MultiViews AllowOverride All Require all granted </Directory>

ErrorLog ${APACHE_LOG_DIR}/orangehrm.exampleserver.xyz-error.log CustomLog ${APACHE_LOG_DIR}/orangehrm.exampleserver.xyz-access.log combined

</VirtualHost>

Don't forget to change orangehrm.exampleserver.xyz above with the domain name that you use for your orangehrm installation.

Enable the site using a2ensite command.

$ sudo a2ensite orangehrm

Reload apache2 process so it read the new virtualhost configuration:

$ sudo service apache2 reload

OrangeHRM Setup Wizard

The OrangeHRM installation is ready, Let's point our browser to orangehrm installation address. In this tutorial the address is http://orangehrm.exampleserver.xyz/ we will be redirected to install wizard.

Click Next.

Step 1 is license acceptance. OrangeHRM release under GNU GPL version 2. You can read the rest of the license and click I accept Step 2 is database configuration. Choose Existing Empty Database, input database credential that we already created and choose Enable Data Encryption. Click Next. Step 3 is system check. Most of the status is already OK except MySQL event scheduler status. We need to enable this setting first on MySQL.

Open mysql configuration on /etc/mysql/my.cnf. Find the line:

skip-external-locking

Add this line below line above:

event_scheduler = on

Restart mysql servive to apply new config:

$ sudo service mysql restart

Click Re-check on System check page. Now, all the status is OK.

Step 4 is admin user creation. Input username and password for OrangeHRM admin user.Step 5 is confirmation from OrangeHRM installer before we start the installation. Click InstallStep 6 this is the installation process. It might take sometime to finish. The page will reload automatically.Step 7 This step is related to submitting usage data to OrangeHRM to contribute back to OrangeHRM. If you are not sure you can uncheck "I would like to send usage data to OrangeHRM" and click finish.

OrangeHRM is ready. Login using admin username and password that we created on Step 4

After successfully login we will get the OrangeHRM dashboard.

You can learn more detail on how-to use OrangeHRM by following OrangeHRM Administrator's User Manual.

Configure https only site for OrangeHRM

Secure connection is now a requirement for web application. Last step that we will do in this tutorial is changing the connection to only use https. We assume that you already have SSL certificate and private key.

Let's create new apache virtual host configuration on /etc/apache2/sites-available/orangehrm-ssl.conf with contents below. Don't forget to change:

  • ServerName
  • SSLCertificateFile
  • SSLCertificateChainFile
  • SSLCertificateKeyFile
<VirtualHost *:80>
   ServerName orangehrm.exampleserver.xyz
   Redirect permanent / https://orangehrm.exampleserver.xyz/
</VirtualHost>

<VirtualHost *:443>

ServerName orangehrm.exampleserver.xyz

DocumentRoot /var/www/orangehrm

<Directory /var/www/orangehrm> Options -Indexes +FollowSymLinks +MultiViews AllowOverride All Require all granted </Directory>

ErrorLog ${APACHE_LOG_DIR}/orangehrm.exampleserver.xyz-error.log CustomLog ${APACHE_LOG_DIR}/orangehrm.exampleserver.xyz-access.log combined

SSLEngine on SSLCertificateFile /etc/apache2/ssl/orangehrm.exampleserver.xyz.crt SSLCertificateChainFile /etc/apache2/ssl/orangehrm.exampleserver.xyz.crt SSLCertificateKeyFile /etc/apache2/ssl/orangehrm.exampleserver.xyz.key

# Uncomment the following directive when using client certificate authentication #SSLCACertificateFile /path/to/ca_certs_for_client_authentication

# HSTS (mod_headers is required) (15768000 seconds = 6 months) Header always set Strict-Transport-Security "max-age=15768000"

</VirtualHost>

# intermediate configuration, tweak to your needs SSLProtocol all -SSLv2 -SSLv3 SSLCipherSuite ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-RSA-AES256-SHA:DHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA:DHE-RSA-AES256-SHA256:DHE-RSA-AES256-SHA:ECDHE-ECDSA-DES-CBC3-SHA:ECDHE-RSA-DES-CBC3-SHA:EDH-RSA-DES-CBC3-SHA:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA:AES256-SHA:DES-CBC3-SHA:!DSS SSLHonorCipherOrder on

We will also disable orangehrm http only virtual host and enable the new virtual host config.

$ sudo a2dissite orangehrm
$ sudo a2ensite orangehrm-ssl

The new virtual host configuration need ApacheĀ mod_ssl and mod_headers modules. We need to enable those modules.

$ sudo a2enmod ssl
$ sudo a2enmod headers

Now, restart Apache 2 service so it will reload its configuration. We need to restart instead of reload since we enable new module.

$ sudo service apache2 restart

Summary

In this tutorial we learned how to install orangehrm on Ubuntu 14.04.

We installed all the prerequisites, created a user and database on MySQL for orangehrm and also configured Apache 2 virtual hosts to be able to serve OrangeHRM.

Hopefully OrangeHRM will enable your Human Resource Development, People Operations or any other names of the division that manage people on your company to better support employees.

Want your very own server? Get our 1GB memory, Xeon V4, 20GB SSD VPS for £10.00 / month.

View Plans