Installing the Debian Packages: Difference between revisions

From IHRIS Wiki
m (reorg)
No edit summary
 
(66 intermediate revisions by 4 users not shown)
Line 1: Line 1:
These directions are for the stable packages.  If you would like to test the experiemental packages, see the end of the page.
'''DEPRECATED'''' This page is out of date.  Please see
  http://wiki.ihris.org/wiki/Installing_iHRIS_4.2


==Ubuntu and Debian==
First we need to add the repository information to our apt sources.  To do this, run


sudo gedit /etc/apt/sources.list.d/ihris.list


and add the following:
'''EXPERIMENTAL''' Directions for debian installation. 


deb http://ppa.launchpad.net/intrahealth+informatics/ppa/ubuntu jaunty main
Caveats:
*Tested on Ubuntu Lucid (10.04) and  Meerkat (10.10)


(Debian should be able to use this configuration without a problem.)
==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>


If you prefer, you can add these with two command lines that you can cut-and-paste from here:


echo "deb http://ppa.launchpad.net/intrahealth+informatics/ppa/ubuntu jaunty main" | sudo tee -a /etc/apt/sources.list.d/ihris.list
==Installing The Standard iHRIS Sites==


Finally, add the PPA's key:
The are four possible sites you can install. 


  wget 'http://keyserver.ubuntu.com:11371/pks/lookup?op=get&search=0x2380F43F6EC21546' | sudo apt-key add -
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)


Now we can run:
Once you are done the site administrator has username i2ce_admin with password the one chose when you installed the site.


  sudo apt-get update
===iHRIS Manage===
  sudo apt-get install i2ce-ihris-manage-all
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


===After Installation===
==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


* Visit <tt>http://localhost/iHRIS/Manage</tt>
===Manage for MOH Mali===
* You should have the bare-bones installation running.  If you want to modify the apache setup, change <tt>/etc/apache2/conf.d/ihris-mananage.conf</tt>.
(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>


===Trying the iHRIS Manage Demo===
Now browse to http://localhost/mali-manage


If you'd like to install the complete demonstration site, you can grab the i2ce-ihris-manage-site-demo from Launchpad:
===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


sudo apt-get install i2ce-ihris-manage-site-demo
==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


To complete the set up, follow these steps (also in <tt>/usr/share/i2ce-ihris-manage-site-demo/README.debian</tt>):
[[Category:Installation]][[Category:Review2013]]
 
1. This package expects MySQL to be installed locally by default. Verify that it is, or add the MySQL host to <tt>/etc/i2ce/ihris-manage-demo.apache</tt> as the value of the environment variable <tt>I2CE_DB_PROTOCOL</tt>.
 
For example, if your MySQL host is reachable at “mysql-host”, you would put
 
        SetEnv I2CE_DB_PROTOCOL mysql-host
 
in <tt>/etc/i2ce/ihris-manage-demo.apache</tt>.
 
2. Create the database for the iHRIS demonstration.  By default, the demo expects to use a database named “ihris” with the user “ihris” and the password “ihris”.
 
To create the database, use the following commands:
 
mysqladmin -uroot -p create ihris
echo "GRANT ALL ON ihris.* to ihris@localhost \
      IDENTIFIED BY 'ihris'" | mysql -uroot -p
 
If you want to change any of these, then modify the file in <tt>/etc/i2ce/Demo/config.values.php</tt>.
 
3. Symlink <tt>/etc/i2ce/ihris-manage-demo.apache</tt> to <tt>/etc/apache2/conf</tt> and restart apache:
 
sudo ln -s /etc/i2ce/ihris-manage-demo.apache /etc/apache2/conf.d
sudo /etc/init.d/apache2 restart
 
4. Point your browser to the URL.  By default, an alias is created at http://YOUR_SERVER/ihris/manage/Demo/. If you're installing this on your local machine, then you would probably use http://127.0.0.1/ihris/manage/Demo/.
 
5. You will be prompted to update the site.  Click “OK”.
 
6. When this completes, you'll get another prompt to procede to the site.  Click “OK” again.
 
7. Explore!
 
== Experimental Packages ==
 
To install snapshots of the current development — which may or may not work — add the following line to <tt>/etc/apt/sources.list.d/ihris.list</tt>:
 
deb http://ihrisdev.intrahealth.org/debian . main
 
[[Category:HowTo]]

Latest revision as of 11: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
Retrieved from "https://wiki.ihris.org/mediawiki/index.php?title=Installing_the_Debian_Packages&oldid=55167"