Installing the Debian Packages: Difference between revisions

From IHRIS Wiki
m (reorg)
m (Make installation super-simple)
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.
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]]


==Ubuntu and Debian==
==Ubuntu and Debian==
First we need to add the repository information to our apt sources.  To do this, run
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.


  sudo gedit /etc/apt/sources.list.d/ihris.list
  wget -q -O - http://www.ihris.org/w/upload/Ihris-deb-install.txt | sudo sh
 
and add the following:
 
deb http://ppa.launchpad.net/intrahealth+informatics/ppa/ubuntu jaunty main
 
(Debian should be able to use this configuration without a problem.)
 
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
 
Finally, add the PPA's key:
 
wget 'http://keyserver.ubuntu.com:11371/pks/lookup?op=get&search=0x2380F43F6EC21546' | sudo apt-key add -
 
Now we can run:
 
sudo apt-get update
sudo apt-get install i2ce-ihris-manage-all


===After Installation===
===After Installation===
Line 53: Line 34:
  echo "GRANT ALL ON ihris.* to ihris@localhost \
  echo "GRANT ALL ON ihris.* to ihris@localhost \
       IDENTIFIED BY 'ihris'" | mysql -uroot -p
       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:
3. Symlink <tt>/etc/i2ce/ihris-manage-demo.apache</tt> to <tt>/etc/apache2/conf</tt> and restart apache:
Line 68: Line 47:


7. Explore!
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]]
[[Category:HowTo]]

Revision as of 10:31, 31 August 2009

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

Ubuntu and Debian

First we need to add the repository information to our apt sources. To do this, open a terminal and then copy the following line to run the installation script for iHRIS Manage.

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

After Installation

  • Visit http://localhost/iHRIS/Manage
  • You should have the bare-bones installation running. If you want to modify the apache setup, change /etc/apache2/conf.d/ihris-mananage.conf.

Trying the iHRIS Manage Demo

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

To complete the set up, follow these steps (also in /usr/share/i2ce-ihris-manage-site-demo/README.debian):

1. This package expects MySQL to be installed locally by default. Verify that it is, or add the MySQL host to /etc/i2ce/ihris-manage-demo.apache as the value of the environment variable I2CE_DB_PROTOCOL.

For example, if your MySQL host is reachable at “mysql-host”, you would put

       SetEnv I2CE_DB_PROTOCOL mysql-host

in /etc/i2ce/ihris-manage-demo.apache.

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

3. Symlink /etc/i2ce/ihris-manage-demo.apache to /etc/apache2/conf 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!