=== added file 'tools/dhis2deb/Readme.txt' --- tools/dhis2deb/Readme.txt 1970-01-01 00:00:00 +0000 +++ tools/dhis2deb/Readme.txt 2009-11-29 22:00:58 +0000 @@ -0,0 +1,31 @@ +Debian package of dhis2. A bit raw round the edges. Tested on ubuntu 9.10. + +To build a deb package: +1. modify 1st line of Makefile (if necessary) to point at dhis.war to be packaged. +2. Update version information in DEBIAN/control +3. type 'make clean' to cleanup up any old and temporary files +4. type 'make update' to bring in dhis.war and update log4j.properties +5. type 'make' to build deb package. + +Thats it. By default hibernate properties is setup to use h2 database in /opt/dhis2/database. This +can be changed to point to mysql, postgres or what have you. + +Logging and othe 'DHIS2_HOME' related stuff happens in /opt/dhis2. + +Everything is owned by tomcat user and password files are chmof 600. + +Two useful utility make targets are: +make uninstall - to uninstall the package +make install - to install the package. + +Useful one-liner to do a complete install of latest build (probably should make this a make target): +'make uninstall; make clean; make update; make; make install' + +Apologies to the trendy for using 'make'. Probably can do the same with maven but life is +too short :-) + +Bob Jolliffe. + +TODO: +More thoughtful upgrade/purge etc. +Automatically handle version info.