Installing the Debian Packages: Difference between revisions

From IHRIS Wiki
m (Make installation super-simple)
No edit summary
 
(65 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, or modify the demo site in any way, please see [[Customizing Packaged iHRIS]]
'''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, [https://help.ubuntu.com/community/UsingTheTerminal#Starting%20a%20Terminal open a terminal] and then copy the following line to run [http://www.ihris.org/w/upload/Ihris-deb-install.txt the installation script] for iHRIS Manage.


wget -q -O - http://www.ihris.org/w/upload/Ihris-deb-install.txt | sudo sh


===After Installation===
'''EXPERIMENTAL''' Directions for debian installation. 


* Visit <tt>http://localhost/iHRIS/Manage</tt>
Caveats:
* 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>.
*Tested on Ubuntu Lucid (10.04) and Meerkat (10.10)


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


sudo apt-get install i2ce-ihris-manage-site-demo
==Installing The Standard iHRIS Sites==


To complete the set up, follow these steps (also in <tt>/usr/share/i2ce-ihris-manage-site-demo/README.debian</tt>):
The are four possible sites you can install.


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>.
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)


For example, if your MySQL host is reachable at “mysql-host”, you would put
Once you are done the site administrator has username i2ce_admin with password the one chose when you installed the site.


        SetEnv I2CE_DB_PROTOCOL mysql-host
===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


in <tt>/etc/i2ce/ihris-manage-demo.apache</tt>.
==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


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”.
===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>


To create the database, use the following commands:
Now browse to http://localhost/mali-manage


  mysqladmin -uroot -p create ihris
===Manage for MOH Zanzibar===
echo "GRANT ALL ON ihris.* to ihris@localhost \
<source lang='bash'>
      IDENTIFIED BY 'ihris'" | mysql -uroot -p
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


3. Symlink <tt>/etc/i2ce/ihris-manage-demo.apache</tt> to <tt>/etc/apache2/conf</tt> and restart apache:
==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


sudo ln -s /etc/i2ce/ihris-manage-demo.apache /etc/apache2/conf.d
[[Category:Installation]][[Category:Review2013]]
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!
 
[[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"