Installation Guide

Notes

If you used XAMPP for Windows, document root is

<XAMPP Installed Location>\htdocs\

ex. C:\Program Files\xampp\htdocs

If you used XAMPP Linux AMP stack, document root is

<XAMPP Installed Location>/htdocs/

Recommended Browsers

• Mozilla Firefox 12.
• Microsoft^® Internet Explorer 9.

OrangeHRM Configuration File Writeable

The web installer will create a configuration file to keep the setup information. This file is written to the file system at the end of the installation process. Therefore adequate permission should be set for the web server to write to the file.

In case the status is shown as "Not Writeable" you should set the permissions such that the user-id set for the web server could write to the directory [orangehrm-dir]/lib/confs. This can be done by using the commands

$ chown -R nobody.nobody [orangehrm-dir]/lib/confs
$ chmod -R 755 [orangehrm-dir]/lib/confs

You can replace user/user-group "nobody" with the relevant user/user-group of your web server.

Maximum Session Idle Time before Timeout

Maximum Session Idle Time before Timeout is checked to ensure that users don't get logged out within a short period such as less than 15 minutes. As a precaution it's not possible to continue installing OrangeHRM if the session times out in less than 2 minutes.

How to Fix

You will have to change session.gc_maxlifetime in the php.ini file. (Default session.gc_maxlifetime = 1440)

Important

It is still possible that some other php application running in the same server is overriding session.gc_maxlifetime value in the php.ini file at runtime. This will be the case if you are running OrangeHRM in a shared host. Workaround is available but beyond the scope of this document.

Memory allocated for PHP script

OrangeHRM recommends 16MB memory to be allocated for running PHP scripts. If you are warned of having any less allocation than that, you fix the issue by opening your PHP.INI file and setting the memory_limit value

memory_limit = 16M;

How to enable InnoDB support in MySQL

To enable "InnoDB" please open "my" (or "my.cnf") file in a text editor and search for "skip-innodb" and add the leading "#" and restart the MySQL database server to enable InnoDB.

ex:
.
.
.
skip-innodb
.
.
.
should read as
.
.
.
#skip-innodb
.
.
.

How to enable event scheduler in MySQL

To enable "event_scheduler" please open "my" (or "my.cnf") file in a text editor and add the text "event_scheduler=ON" under "Basic Settings" section and restart the MySQL server.

[mysqld]
#
# * Basic Settings
#
event_scheduler=ON#
#

(in XAMPP for windows my.cnf is found in C:\xampp\mysql\bin\my.cnf)
(in XAMPP for linux my.cnf is found in /opt/lampp/etc/my.cnf)

Notes

Privileged Database Users and OrangeHRM Database Users

Database Server users could be assigned different rights. For the web installer to create the OrangeHRM Database, you need to give a Database user account details (user-name/password) with permissions CREATE, ALTER, DROP, INSERT under the field Privileged Database User/Password.

Since OrangeHRM requires only permissions INSERT, UPDATE, SELECT and DELETE to interact with database, the web installer could create a separate database user account to for OrangeHRM. It is always recommended that you create a separate user account for OrangeHRM. To do so fill in OrangeHRM User details(user-name/password) as required and the web-installer would create the account for you.

Note: Since the database user account details used by OrangeHRM are stored in plain text, it would be a security threat to have OrangeHRM use Privileged user account.

Notes

Installation will begin immediately. Once you click [install] there is no way that you can stop the installation from starting. You cannot roll back the installation as well. Click [Install] only if you are sure that you want to install with the given configuration

Notes

If the installation is aborted you will have to either DROP the database with the name you provided in the Database Creation page if it exists or key in another name for the database.