View source for Installing the Debian Packages

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.

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.

== After Installation ==

* Visit <tt>http://localhost/iHRIS/Manage</tt>
* 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>.

== 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:
<pre>
deb http://www.intrahealth.org/debian ./
</pre>
* Run “<tt>aptitude install ihris-manage</tt>”.

== Easily Build Your Own ==

* 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>”)
* Check out [http://code.launchpad.net/~hexmode my debian build scripts].  I suggest doing this in a separate directory.  For example:
<pre>
$ mkdir build
$ cd build
$ bzr co http://bazaar.launchpad.net/~hexmode/i2ce/debian-dev i2ce
$ bzr co http://bazaar.launchpad.net/~hexmode/ihris-common/debian-dev ihris-common
$ bzr co http://bazaar.launchpad.net/~hexmode/ihris-manage/debian-dev ihris-manage
</pre>
* In each directory, run “<tt>bzr builddeb</tt>”.
<pre>
$ (cd i2ce; bzr builddeb)
$ (cd ihris-common; bzr builddeb)
$ (cd ihris-manage; bzr builddeb)
</pre>
* 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.
* Install the Debian packages you created: <tt>sudo dpkg -i build-area/*.deb</tt>

[[Category:Help]]