Installing the Debian Packages: Difference between revisions

From IHRIS Wiki
m (add note about jaunty/debian)
m (Complete the directions)
Line 35: Line 35:
  sudo apt-get update
  sudo apt-get update
  sudo apt-get install i2ce-ihris-manage-all
  sudo apt-get install i2ce-ihris-manage-all
===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 <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]]
[[Category:HowTo]]

Revision as of 15:56, 6 August 2009

This is experimental. These directions are for the experimental debian packages.

Before Installation

If you don't have the mysql-server 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

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

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:

deb http://open.intrahealth.org/debian . main
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.)

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

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

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

If you want to change any of these, then modify the file in /etc/i2ce/Demo/config.values.php.

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!