Creating Debian Packages: Difference between revisions
From IHRIS Wiki
No edit summary |
No edit summary |
||
| Line 1: | Line 1: | ||
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. | 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 the packaging. If you want to modify the packaging, read over this section. | 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 == | == 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. | 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 == | == Super Simple == | ||
| Line 14: | Line 19: | ||
</pre> | </pre> | ||
* Run “<tt>aptitude install ihris-manage</tt>”. | * Run “<tt>aptitude install ihris-manage</tt>”. | ||
== Not So Hard Way == | == Not So Hard Way == | ||
| Line 34: | Line 37: | ||
$ (cd ihris-manage; bzr builddeb) | $ (cd ihris-manage; bzr builddeb) | ||
</pre> | </pre> | ||
* You should now have a subdirectory named build-area 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. | * 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> | * Install the Debian packages you created: <tt>sudo dpkg -i build-area/*.deb</tt> | ||
== From Scratch == | |||
This part of the document, describes the decisions made in packaging and descrbes the steps taken. | |||
Revision as of 18:34, 6 October 2007
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 mysql-server 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 dbconfig-common package to take care of database setup.
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.
Super Simple
- Add http://www.intrahealth.org/debian/ to your /etc/apt/sources.list file. Use a line like the following:
deb http://www.intrahealth.org/debian ./
- Run “aptitude install ihris-manage”.
Not So Hard Way
- Install Bazaar and bzr-builddeb as well as the build dependencies dpatch and debhelper. (“apt-get install bzr-builddeb dpatch debhelper”)
- Check out my debian build scripts. I suggest doing this in a separate directory. For example:
$ 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
- In each directory, run “bzr builddeb”.
$ (cd i2ce; bzr builddeb) $ (cd ihris-common; bzr builddeb) $ (cd ihris-manage; bzr builddeb)
- You should now have a subdirectory named build-area with three .deb files in it. Before installing them, you'll need to install the runtime dependencies: aptitude install dbcommon-config ucf libapache2-mod-php5 php-i18nv2 php-mdb2-driver-mysql php-text-password. At this time, some are only available from the IntraHealth Debian repository above.
- Install the Debian packages you created: sudo dpkg -i build-area/*.deb
From Scratch
This part of the document, describes the decisions made in packaging and descrbes the steps taken.
