Installing the Debian Packages: Difference between revisions

From IHRIS Wiki
No edit summary
 
(35 intermediate revisions by 3 users not shown)
Line 1: Line 1:
'''DEPRECATED'''' This page is out of date.  Please see
  http://wiki.ihris.org/wiki/Installing_iHRIS_4.2
'''EXPERIMENTAL''' Directions for debian installation.   
'''EXPERIMENTAL''' Directions for debian installation.   


Caveats:
Caveats:
*This is for testing purposes on only
*Tested on Ubuntu Lucid (10.04) and Meerkat (10.10)
*Tested on meerkat, it may work with Lucid.  I doubt it will work with anything earlier
*Does not include any translations whatsoever.


==Adding sources==
==Special Instructions for Ubuntu Lucid (10.04) and Maverick (10.10)==
Before we begin we need to make sure that we have the most recent version of APC available (not the one that comes with Meerkat or Lucid). We also want to add in our iHRIS packages.  This can be done by:
<source lang='bash'>
<source lang='bash'>
sudo add-apt-repository ppa:chris-lea/php-pecl-extras  
sudo add-apt-repository ppa:chris-lea/php-pecl-extras  
sudo add-apt-repository ppa:litlfred/ihris-test2
sudo apt-get update
</source>
</source>


==Installing Sites==
The are four possible sites you can install:
*sudo apt-get install ihris+ihris-manage-site
**will install to http://localhost/iHRIS/manage
*sudo apt-get install ihris+ihris-manage-site-demo
**will install to http://localhost/iHRIS/manage-demo
*sudo apt-get install ihris+ihris-qualify-site
**will install to http://localhost/iHRIS/qualify
*sudo apt-get install ihris+ihris-qualify-site-demo
**will install to http://localhost/iHRIS/qualify-demo


The site administrator has username i2ce_admin with password manage (we'll make it so you can choose it a bit later on)
==Installing The Standard iHRIS Sites==
 
The are four possible sites you can install. 


When you install your site you will be asked to enter the administrative password for mysql.  This is probably the same password of the account you logged into the computer with)
When you install your site you will be asked to enter the administrative password for mysql.  This is probably the same password of the account you logged into the computer with)


Once you are done the site administrator has username i2ce_admin with password the one chose when you installed the site.


'''Your Done!'''  Just see the cleanup section below.
===iHRIS Manage===
The standard iHRIS Manage site.
<source lang='bash'>
echo "deb http://ppa.launchpad.net/intrahealth+informatics/ihris/ubuntu " `lsb_release -cs` " main"  | sudo tee  /etc/apt/sources.list.d/ihris.list
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 6EC21546 
sudo apt-get update
sudo apt-get install --install-recommends ihris+ihris-manage-site
</source>
will install to http://localhost/iHRIS/manage
===iHRIS Manage Demo===
The standard iHRIS Manage site with demo data.
<source lang='bash'>
echo "deb http://ppa.launchpad.net/intrahealth+informatics/ihris/ubuntu " `lsb_release -cs` " main"  | sudo tee  /etc/apt/sources.list.d/ihris.list
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 6EC21546 
sudo apt-get update
sudo apt-get install --install-recommends ihris+ihris-manage-site-demo
</source>
will install to http://localhost/iHRIS/manage-demo
===iHRIS Qualify===
The standard iHRIS Qualify site.
<source lang='bash'>
echo "deb http://ppa.launchpad.net/intrahealth+informatics/ihris/ubuntu " `lsb_release -cs` " main"  | sudo tee  /etc/apt/sources.list.d/ihris.list
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 6EC21546 
sudo apt-get update
sudo apt-get install --install-recommends ihris+ihris-qualify-site
</source>
will install to http://localhost/iHRIS/qualify
===iHRIS Qualify Demo===
The standard iHRIS Qualify site with demonstration data.
<source lang='bash'>
echo "deb http://ppa.launchpad.net/intrahealth+informatics/ihris/ubuntu " `lsb_release -cs` " main" | sudo tee  /etc/apt/sources.list.d/ihris.list
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 6EC21546 
sudo apt-get update
sudo apt-get install --install-recommends ihris+ihris-qualify-site-demo
</source>
will install to http://localhost/iHRIS/qualify-demo


==Troubleshooting==
==Installing Other Sites==
===Qualify for Nursing and Midwifery Council of Nigeria===
<source lang='bash'>
echo "deb http://ppa.launchpad.net/intrahealth+informatics/ihris/ubuntu " `lsb_release -cs` " main"  | sudo tee  /etc/apt/sources.list.d/ihris.list
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 6EC21546 
sudo apt-add-repository ppa:ihris-nigeria/ihris
sudo apt-get update
sudo apt-get install --install-recommends ihris+ihris-qualify-nmcn
</source>
Now browse to http://localhost/NMCN


===Possible Password Problem===
===Manage for MOH Mali===
If you at first give an error about the mysql root/administative password not being set then:
(Not tested)
*Please select to <Retry>
<source lang='bash'>
*Use dbconfig-common tools to configure the debian package
echo "deb http://ppa.launchpad.net/intrahealth+informatics/ihris/ubuntu " `lsb_release -cs` " main"  | sudo tee  /etc/apt/sources.list.d/ihris.list
*Enter the mysql administrator password (this is probably the same password of the account you logged into the computer with)
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 6EC21546 
*For the "app" password make sure it is 'manage'
echo "deb http://ppa.launchpad.net/ihris+mali/ihris/ubuntu " `lsb_release -cs` " main" | sudo tee  /etc/apt/sources.list.d/ihrismali.list
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys D498888F
sudo apt-get update
sudo apt-get install --install-recommends ihris+ihris-manage-mali-site
</source>


==Cleanup==
Now browse to http://localhost/mali-manage
===PHP===
You may need to increase the memory limit for PHP. You can do this by editing the /etc/php5/apache2/php.ini.
<source lang="bash">
sudo gedit /etc/php5/apache2/php.ini
</source>


Change the following line:
===Manage for MOH Zanzibar===
<source lang="ini">
<source lang='bash'>
memory_limit = 32M
echo "deb http://ppa.launchpad.net/intrahealth+informatics/ihris/ubuntu " `lsb_release -cs` " main"  | sudo tee  /etc/apt/sources.list.d/ihris.list
</source>
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 6EC21546 
to:
echo "deb http://ppa.launchpad.net/ihris+zanzibar/ihris/ubuntu " `lsb_release -cs` " main"  | sudo tee  /etc/apt/sources.list.d/ihris_zanzibar.list
<source lang="ini">
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 67A06201
memory_limit = 128M
sudo apt-get update
sudo apt-get install --install-recommends ihris+ihris-manage-site-zanzibar
</source>
</source>
 
Now browse to http://localhost/iHRIS/zanzibar
===APC===
Just make sure that you have 'etc/php5/apache2/conf.d/apc.ini' looking something like this:
<pre>
; configuration for php apc module
extension=apc.so
apc.shm_size=150
apc.slam_defense = Off
</pre>
The important thing being that the slam_defense is off and that the shm_size is at least 100.


==Details==
==Details==
Line 71: Line 99:
*All sites are installed under /var/lib/iHRIS/sites/4.0, for example /var/lib/iRHIS/sites/4.0/ihris-manage-site-demo
*All sites are installed under /var/lib/iHRIS/sites/4.0, for example /var/lib/iRHIS/sites/4.0/ihris-manage-site-demo
*There is no link (ln -s) under /var/www to the pages directory, instead the site is made available by /etc/apache2/conf.d/ihris-manage-site-demo.conf
*There is no link (ln -s) under /var/www to the pages directory, instead the site is made available by /etc/apache2/conf.d/ihris-manage-site-demo.conf
[[Category:Installation]][[Category:Review2013]]

Latest revision as of 10:04, 19 February 2016

DEPRECATED' This page is out of date. Please see

  http://wiki.ihris.org/wiki/Installing_iHRIS_4.2


EXPERIMENTAL Directions for debian installation.

Caveats:

  • Tested on Ubuntu Lucid (10.04) and Meerkat (10.10)

Special Instructions for Ubuntu Lucid (10.04) and Maverick (10.10)

<source lang='bash'> sudo add-apt-repository ppa:chris-lea/php-pecl-extras </source>


Installing The Standard iHRIS Sites

The are four possible sites you can install.

When you install your site you will be asked to enter the administrative password for mysql. This is probably the same password of the account you logged into the computer with)

Once you are done the site administrator has username i2ce_admin with password the one chose when you installed the site.

iHRIS Manage

The standard iHRIS Manage site. <source lang='bash'> echo "deb http://ppa.launchpad.net/intrahealth+informatics/ihris/ubuntu " `lsb_release -cs` " main" | sudo tee /etc/apt/sources.list.d/ihris.list sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 6EC21546 sudo apt-get update sudo apt-get install --install-recommends ihris+ihris-manage-site </source> will install to http://localhost/iHRIS/manage

iHRIS Manage Demo

The standard iHRIS Manage site with demo data. <source lang='bash'> echo "deb http://ppa.launchpad.net/intrahealth+informatics/ihris/ubuntu " `lsb_release -cs` " main" | sudo tee /etc/apt/sources.list.d/ihris.list sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 6EC21546 sudo apt-get update sudo apt-get install --install-recommends ihris+ihris-manage-site-demo </source> will install to http://localhost/iHRIS/manage-demo

iHRIS Qualify

The standard iHRIS Qualify site. <source lang='bash'> echo "deb http://ppa.launchpad.net/intrahealth+informatics/ihris/ubuntu " `lsb_release -cs` " main" | sudo tee /etc/apt/sources.list.d/ihris.list sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 6EC21546 sudo apt-get update sudo apt-get install --install-recommends ihris+ihris-qualify-site </source> will install to http://localhost/iHRIS/qualify

iHRIS Qualify Demo

The standard iHRIS Qualify site with demonstration data. <source lang='bash'> echo "deb http://ppa.launchpad.net/intrahealth+informatics/ihris/ubuntu " `lsb_release -cs` " main" | sudo tee /etc/apt/sources.list.d/ihris.list sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 6EC21546 sudo apt-get update sudo apt-get install --install-recommends ihris+ihris-qualify-site-demo </source> will install to http://localhost/iHRIS/qualify-demo

Installing Other Sites

Qualify for Nursing and Midwifery Council of Nigeria

<source lang='bash'> echo "deb http://ppa.launchpad.net/intrahealth+informatics/ihris/ubuntu " `lsb_release -cs` " main" | sudo tee /etc/apt/sources.list.d/ihris.list sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 6EC21546 sudo apt-add-repository ppa:ihris-nigeria/ihris sudo apt-get update sudo apt-get install --install-recommends ihris+ihris-qualify-nmcn </source> Now browse to http://localhost/NMCN

Manage for MOH Mali

(Not tested) <source lang='bash'> echo "deb http://ppa.launchpad.net/intrahealth+informatics/ihris/ubuntu " `lsb_release -cs` " main" | sudo tee /etc/apt/sources.list.d/ihris.list sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 6EC21546 echo "deb http://ppa.launchpad.net/ihris+mali/ihris/ubuntu " `lsb_release -cs` " main" | sudo tee /etc/apt/sources.list.d/ihrismali.list sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys D498888F sudo apt-get update sudo apt-get install --install-recommends ihris+ihris-manage-mali-site </source>

Now browse to http://localhost/mali-manage

Manage for MOH Zanzibar

<source lang='bash'> echo "deb http://ppa.launchpad.net/intrahealth+informatics/ihris/ubuntu " `lsb_release -cs` " main" | sudo tee /etc/apt/sources.list.d/ihris.list sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 6EC21546 echo "deb http://ppa.launchpad.net/ihris+zanzibar/ihris/ubuntu " `lsb_release -cs` " main" | sudo tee /etc/apt/sources.list.d/ihris_zanzibar.list sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 67A06201 sudo apt-get update sudo apt-get install --install-recommends ihris+ihris-manage-site-zanzibar </source> Now browse to http://localhost/iHRIS/zanzibar

Details

  • The i2ce/ihris library is installed under /usr/lib/iHRIS/lib/4.0
  • All sites are installed under /var/lib/iHRIS/sites/4.0, for example /var/lib/iRHIS/sites/4.0/ihris-manage-site-demo
  • There is no link (ln -s) under /var/www to the pages directory, instead the site is made available by /etc/apache2/conf.d/ihris-manage-site-demo.conf