Cookies help us deliver our services. By using our services, you agree to our use of cookies.
Views

Development Installation Instructions

From IHRIS Wiki

Jump to: navigation, search

You can run the current in development version of iHRIS as well for testing or to add new features. You will need to check out the latest version from launchpad using bazaar (bzr).

Install Supporting Software

First you will need to install the supporting software required by iHRIS. You can follow the instructions here based on your version of Ubuntu: Linux (Ubuntu) Installation - Supporting Software

Install Bazaar (bzr)

First you need to install the bzr package it if isn't already installed. Run the following in a terminal to install bazaar.

sudo apt-get install bzr bzrtools

Download Source Packages (4.2)

Now you need to download all the source packages for iHRIS. Some will be required and some will depend on what you want to run. First create a directory in /var/lib/iHRIS/lib for the development packages. For example, for 4.2 we can call it 4.2-dev. If you don't already have a /var/lib/iHRIS/lib directory you will need to create it and make sure you have permissions to modify files there.

cd /var/lib/iHRIS/lib
mkdir 4.2-dev

To download any of the application packages you will want to be sure to be in the development directory you just created.

cd /var/lib/iHRIS/lib/4.2-dev

Download Base Packages

First you download the base packages. This includes I2CE, textlayout and iHRIS Common.


bzr branch lp:i2ce/4.2 I2CE
bzr branch lp:textlayout/4.2 textlayout
bzr branch lp:ihris-common/4.2 ihris-common

Download Application Packages

iHRIS Manage

bzr branch lp:ihris-manage/4.2 ihris-manage

iHRIS Qualify

bzr branch lp:ihris-qualify/4.2 ihris-qualify

iHRIS Train

bzr branch lp:ihris-train/4.2 ihris-train

Unganisha (Graduate Tracker)

bzr branch lp:ihris-graduate/4.2 ihris-graduate

Updating Packages

When updates are made, you can change into any of the previously created directories and pull down those updates with bzr pull. For example, for I2CE you can do this:

cd /var/lib/iHRIS/lib/4.2-dev/I2CE
bzr pull

Configuring a Site

Once you've downloaded the packages for your application, you will need to configure a site. You can use a site you've created or a demo site which you can find in the particular application you're working on in sites/Demo.

Create a Database

First you'll need to create a database and user for your site. Run this command from the terminal and then enter the password for the root database user you created when installing MySQL.

mysql -u root -p

Then at the mysql> prompt type these commands replacing DATABASE with your database and PASSWORD with the password you'd like to use for this connection.

create database DATABASE;
grant all privileges on DATABASE.* to ihris@localhost identified by 'PASSWORD';
exit

Configure Site

Next you'll need to configure the config.values.php file for your site. Run these commands after you've changed into the site pages directory. For example if you're working with the iHRIS Manage Demo site you would run: cd /var/lib/iHRIS/lib/4.2-dev/ihris-manage/sites/Demo/pages.

mkdir local/
cp config.values.php local/
cp htaccess.TEMPLATE .htaccess
gedit local/config.values.php

Now find the configuration variables in the file that opens and change to the appropriate values. Again for this example using iHRIS Manage, but replace with appropriate values for the application and site you're using.

Variable Name Value
$i2ce_site_i2ce_path /var/lib/iHRIS/lib/4.2-dev/I2CE
$i2ce_site_dsn mysql://ihris:PASWORD@localhost/DATABASE
$i2ce_site_module_config var/lib/iHRIS/lib/4.2-dev/ihris-manage/sites/Demo/iHRIS-Manage-Demo.xml

Now edit the .htaccess file to set the RewriteBase:

gedit .htaccess

Change the RewriteBase line to be the path in the web server for your site.

    RewriteBase /manage-demo

Set Up the Site in the Web Server

The last step is to create a symbolic link in the web root directory for your site. For our example we'll use /manage-demo. For Ubuntu 14.04 and later the web root is /var/www/html. Prior to 14.04 it is just /var/www. Be sure to use the correct directory in the following steps.

cd /var/www/html
sudo ln -s /var/lib/iHRIS/lib/4.2-dev/ihris-manage/sites/Demo/pages manage-demo