Note: XAMPP users, the Linux stack needs to be started manually. Refer to the stack documentation.
Using a JavaScript enabled browser go to http://hostname/orangehrm2/
Above hostname is "localhost" if it is installed in the machine you are currently working on or IP address if it is remotely hosted (i.e. external to the machine you are using).
Web installation will be briefly described bellow.
Welcome Screen
It will state which version of OrangeHRM will be installed.
Click [Next] button in the Welcome screen to proceed with the installation.
License Acceptance
Here you will be provided with a copy of the GNU GENERAL PUBLIC LICENSE and to continue the installation you will have to accept the license.
If you decline simply discontinue the installation and delete all OrangeHRM files you posses.
Click [I Accept] button if you accept the terms and
conditions of the license. Then you will be taken to the next page of
the Web Installer.
System Check
Here the Web Installer will check whether the pre-requirements are available.
If
all responses are green you can safely continue. You have installed
the correct versions of the pre-requisites and configured them to work.
See below for all the color codes in a sample situation.
Click [Next] button in the System Check screen to continue.
Notes
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.g c_maxlifetime = 1440)
Important
It is still possible that some other php application running in the same server 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.
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
.
.
.
(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)
Database Creation
Enter the relevant information about your MySQL database server and database users.
Click [Next] in Database Creation screen to continue.
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(username/password) as required by
you, and 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.
Admin User Creation
Type in the Admin Username, Password and Confirm Admin User Password.
Click [Next] button in Admin User Creation Screen to continue.
Confirmation
Confirm whether the installation details are correct and Click [Install] button in the Confirmation screen to install.
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.
Installing
Here you will be shown the progress of the installation. Once the installation is completed the [Next] button will be enabled. Click [Next] button in the Installing screen to continue.
If an error occurs during the installation the whole installation will be aborted.
Click [Clean Up Install] to go to previous pages to correct the error and restart the installation. See screenshots
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.
[Skip screen shots]
Following are sample screenshots of the Installing screen:
Installation has just started.
Installation in progress.
Installation has finished successfully.
Installation has been aborted due to an error.
Registration
If you want be Up-to-Date on news about OrangeHRM,
please provide your E-mail address and a name that the e-mails should
be addressed to. We would appreciate if you register here, then we
will know how many users have successfully installed OrangeHRM.
You can also provide your comments.
If you want to receive Updates or Newsletters select the tick box [Updates/Newsletter]. Click [Register] to send the information.
If the registration is successful you can click [Login to OrangeHRM] to Login to OrangeHRM.
If you don't want to register click [No thanks!].
Notes
If the sending of registration Information fails an error message will be shown. Click [Retry] to send the details again or [Skip] to skip this step an you will not be registered.