Upgrading to OrangeHRM Version 2.4.2
Compatibility
- OrangeHRM 2.4.2 upgrader only supports upgrading from version 2.2.2.2, 2.3, 2.4, 2.4.0.1 and 2.4.1
Prerequisites
- You need to create a folder called "newversion" under the root directory of your current OrangeHRM installation.
- The web server user needs to have write permission to the "newversion" folder.
- You need an empty MySQL database under the database user of your current OrangeHRM installation.
Procedure
2.4.2 upgrader does not affect your current installation. It will only import data from your current installation and will be installed as a separate installation at "newversion" folder. This will make it possible to try OrangeHRM 2.4.2 while having the old installation as it was. If you are comfortable with 2.4.2 then you can leave the old installation and move to the new installation (how to move is described below).
- Download OrangeHRM 2.4.2 and extract its content to "newversion" folder that you created in your current installation.
- Call the web path to "newversion/upgrade/" in your web browser to start the upgrader (e.g.: If your current installation is accessed at http://www.example.com/orangehrm then call http://www.example.com/orangehrm/newversion/upgrade/).
- Enter admin login details to proceed with the upgrade.
- Upgrader will have following steps (some may not be included based on your current installation).
- Version Check - checks the compatibility of your current version and any data incompatibilities.
- Database Information - place to provide the database name for new installation.
- Data Import - imports data from your current OrangeHRM database.
- Database Changes - applies new database changes.
- Value Changes - applies new value changes to imported data. If optional changes are available, you would be given the chance to include or exclude them.
- Configuration Files - copies necessary configuration files from existing installation and create required new ones.
- Login to New Installation - you can login to new installation and try its features out. Verify your previous data has not been misinterpreted in new installation.
Moving to New Installation
If you are satisfied with your new OrangeHRM installation, you can follow below steps to have the new installation in the same location as the current installation is.
- Let's assume your current OrangeHRM folder is called "orangehrm", then the folder of your new installation is "orangehrm/newversion".
- First move "newversion" folder one level up (i.e. to the same level where folder "orangehrm" is).
- Then rename the folder "orangehrm" to something else, for example "orangehrm-old".
- After that, rename "newversion" to "orangehrm".
- Make sure all the permissions applied to your old OrangeHRM installation also apply to renamed "orangehrm" folder.
- That's all! Now you should be able to access, new OrangeHRM installation at the same location, i.e. if previous installation was at http://www.example.com/orangehrm/ then you should be able to access new installation at the same location.
