Installing the Debian Packages: Difference between revisions

From IHRIS Wiki
No edit summary
 
(84 intermediate revisions by 4 users not shown)
Line 1: Line 1:
On this page I've listed two ways of installing the iHRIS Debian packages.  The first is easiest if you have Debian/Ubuntu system already running and just want to install the packages. The second is a fairly straight-forward way of building the binary packages from scratch. This is useful if you want to change something with the packaging.
'''DEPRECATED'''' This page is out of date.  Please see
  http://wiki.ihris.org/wiki/Installing_iHRIS_4.2


Finally, I describe the reasons for the decisions made in creating the packaging.  If you want to modify the packaging, read over this section.


== Before Installation ==


If you don't have the <tt>mysql-server</tt> package installed, you'll want to install it.  Alternatively, you can use mysql on another host (though this is not yet tested).  This package uses the <tt>[http://people.debian.org/~seanius/policy/examples/dbconfig-common/doc/dbconfig-common-design.html dbconfig-common]</tt> package to take care of database setup.
'''EXPERIMENTAL''' Directions for debian installation.   


== After Installation ==
Caveats:
*Tested on Ubuntu Lucid (10.04) and  Meerkat (10.10)


* Visit <tt>http://localhost/iHRIS/Manage</tt>
==Special Instructions for Ubuntu Lucid (10.04) and Maverick (10.10)==
* 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>.
<source lang='bash'>
sudo add-apt-repository ppa:chris-lea/php-pecl-extras
</source>


== Super Simple ==


* Add <tt>http://www.intrahealth.org/debian/</tt> to your <tt>/etc/apt/sources.list</tt> file.  Use a line like the following:
==Installing The Standard iHRIS Sites==
<pre>
deb http://www.intrahealth.org/debian ./
</pre>
* Run “<tt>aptitude install ihris-manage</tt>”.


== Easily Build Your Own ==
The are four possible sites you can install. 


* Install [http://bazaar-vcs.org/ Bazaar] and [https://edge.launchpad.net/bzr-builddeb bzr-builddeb] as well as the build dependencies dpatch and debhelper. (“<tt>apt-get install bzr-builddeb dpatch debhelper</tt>”)
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)
* Check out [http://code.launchpad.net/~hexmode my debian build scripts]. I suggest doing this in a separate directory.  For example:
 
<pre>
Once you are done the site administrator has username i2ce_admin with password the one chose when you installed the site.
$ mkdir build
 
$ cd build
===iHRIS Manage===
$ bzr co http://bazaar.launchpad.net/~hexmode/i2ce/debian-dev i2ce
The standard iHRIS Manage site.
$ bzr co http://bazaar.launchpad.net/~hexmode/ihris-common/debian-dev ihris-common
<source lang='bash'>
$ bzr co http://bazaar.launchpad.net/~hexmode/ihris-manage/debian-dev ihris-manage
echo "deb http://ppa.launchpad.net/intrahealth+informatics/ihris/ubuntu " `lsb_release -cs` " main"  | sudo tee  /etc/apt/sources.list.d/ihris.list
</pre>
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 6EC21546 
* In each directory, run “<tt>bzr builddeb</tt>”.
sudo apt-get update
<pre>
sudo apt-get install --install-recommends ihris+ihris-manage-site
$ (cd i2ce; bzr builddeb)
</source>
$ (cd ihris-common; bzr builddeb)
will install to http://localhost/iHRIS/manage
$ (cd ihris-manage; bzr builddeb)
===iHRIS Manage Demo===
</pre>
The standard iHRIS Manage site with demo data.
* You should now have a subdirectory named <tt>build-area</tt> with three .deb files in it.  Before installing them, you'll need to install the runtime dependencies: <tt>aptitude install dbcommon-config ucf libapache2-mod-php5 php-i18nv2 php-mdb2-driver-mysql php-text-password</tt>. At this time, some are only available from the IntraHealth Debian repository above.
<source lang='bash'>
* Install the Debian packages you created: <tt>sudo dpkg -i build-area/*.deb</tt>
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
 
[[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
Retrieved from "https://wiki.ihris.org/mediawiki/index.php?title=Installing_the_Debian_Packages&oldid=55167"