Installing the Debian Packages: Difference between revisions

From IHRIS Wiki
m (Complete the directions)
No edit summary
 
(67 intermediate revisions by 4 users not shown)
Line 1: Line 1:
'''This is experimental.''' These directions are for the experimental debian packages.
'''DEPRECATED'''' This page is out of date.  Please see
  http://wiki.ihris.org/wiki/Installing_iHRIS_4.2


== Before Installation ==


If you don't have the <tt>mysql-server</tt> package installed, you'll want to install it.    This package uses a MySQL server to store the data but does not install one by default — allowing you to set up your infrastructure as you see fit.


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


===Ubuntu and Debian===
==Special Instructions for Ubuntu Lucid (10.04) and Maverick (10.10)==
First we need to add the repository information to our apt sources.  To do this, run
<source lang='bash'>
sudo add-apt-repository ppa:chris-lea/php-pecl-extras
</source>


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


and add the following:
==Installing The Standard iHRIS Sites==


deb http://open.intrahealth.org/debian . main
The are four possible sites you can install.   
  deb http://ppa.launchpad.net/intrahealth+informatics/ppa/ubuntu intrepid main


(Note that you can specify “jaunty” if you want for the PPA.  Also, Debian should be able to use this configuration without a problem.)
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)


If you prefer, you can add these with two command lines that you can cut-and-paste from here:
Once you are done the site administrator has username i2ce_admin with password the one chose when you installed the site.


  echo "deb http://open.intrahealth.org/debian . main" | sudo tee /etc/apt/sources.list.d/ihris.list
===iHRIS Manage===
  echo "deb http://ppa.launchpad.net/intrahealth+informatics/ppa/ubuntu intrepid main" | sudo tee -a /etc/apt/sources.list.d/ihris.list
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


Finally, add the PPA's key:
==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


wget 'http://keyserver.ubuntu.com:11371/pks/lookup?op=get&search=0x2380F43F6EC21546' | sudo apt-key add -
===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 we can run:
Now browse to http://localhost/mali-manage


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


===Trying the iHRIS Manage 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


If you'd like to install the complete demonstration site, you can grab the i2ce-ihris-manage-site-demo from Launchpad:
[[Category:Installation]][[Category:Review2013]]
 
sudo apt-get install i2ce-ihris-manage-site-demo
 
To complete the set up, follow these steps (also in <tt>/usr/share/i2ce-ihris-manage-site-demo/README.debian</tt>):
 
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!
 
[[Category:HowTo]]

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"