Author: e2jk-guest Date: 2013-05-03 21:15:49 +0000 (Fri, 03 May 2013) New Revision: 13477
Modified: trunk/packages/gnuhealth/trunk/debian/README.Debian trunk/packages/gnuhealth/trunk/debian/TODO.Debian trunk/packages/gnuhealth/trunk/debian/changelog Log: Update documentation Modified: trunk/packages/gnuhealth/trunk/debian/README.Debian =================================================================== --- trunk/packages/gnuhealth/trunk/debian/README.Debian 2013-05-03 21:10:48 UTC (rev 13476) +++ trunk/packages/gnuhealth/trunk/debian/README.Debian 2013-05-03 21:15:49 UTC (rev 13477) @@ -1,88 +1,41 @@ GNU Health for Debian --------------------- -Setting up the Operating System -=============================== +The Debian package takes care of creating the "gnuhealth" system user, the +"gnuhealth" PostgreSQL role (i.e. database user) and the "gnuhealth" database, +which is initialized and ready to use. -Creating the Operating System User ----------------------------------- +The GNU Health package introduces a new service (gnuhealth-server), which is +a Tryton server running on a dedicated port (8482). -It is highly recommended that you use a dedicated user for the GNU Health -installation: +Configuring GNU Health +====================== - $ sudo adduser gnuhealth - - -Create a database user ----------------------- - -Execute the following command to create your database administrator - $ su - postgres -c "createuser --createdb --no-createrole --no-superuser \ - --pwprompt gnuhealth" - -Note: If you need to change PostgreSQL user's default password, run: - $ sudo passwd postgres - - -Configure the Tryton server ---------------------------- - -Uncomment and adapt the following lines: - $ sudo nano /etc/trytond.conf -db_type = postgresql -db_user = <user created in previous step> -db_password = <password set in previous step> - -Restart the Tryton server: - $ sudo /etc/init.d/tryton-server restart - - -Configure PostgreSQL --------------------- - -By default, Tryton might have issues connecting to the PostgreSQL database. If -that's the case, change the values "peer" and "md5" to "trust": - $ sudo nano /etc/postgresql/9.1/main/pg_hba.conf - -# Database administrative login by Unix domain socket -local all postgres peer - -# IPv4 local connections: -host all all 127.0.0.1/32 md5 - -Restart the PostgreSQL server: - $ sudo /etc/init.d/postgresql* restart - - -Creating the GNU Health database -================================ - Note: Instructions including screenshots are available on the project's wiki page: http://en.wikibooks.org/wiki/GNU_Health/Installation -The first step is to create a database that will hold all the information for -your GNU Health system. +You will need to install the tryton-client package, either on the same machine +as where you installed gnuhealth-server, or on a separate machine. -All GNU Health information is stored in a PostgreSQL database, and processed by -the Tryton kernel. No action is needed at the operating system level to create -or manage the database, as all can be done via the Tryton / GNU Health frontend. -To create a Database, open your Tryton client. You will be presented with the -Login popup window. +Creating a Connection Profile +----------------------------- +Open the Tryton client (run the `tryton-client` command) + Click on Manage profiles, then click on Add. Give your new connection a name -on the left side, and fill the fields on the right side. If you're doing the -installation on the same machine, choose localhost as the hostname. +on the left side, and fill the fields on the right side: +* Hostname: localhost (if running the client on the same machine as the server) + or the IP address/hostname of the machine where you installed gnuhealth-server. +* Port: 8482 +The "gnuhealth" database should then automatically appear, as it was created +when installing the gnuhealth-server package. +You will first need to log in as "admin", so enter that in the Username field. -Click on the Create button. The default Tryton Server Password is admin (you -can change it later). Give your database a name, and enter a new admin password -twice. Note: this will be the password of the super-user for your new database, -so use a strong password when dealing with production servers. +You're now ready to log in! -After the database is created, click OK. You're now ready to log in! - Logging into the application ---------------------------- @@ -90,8 +43,9 @@ Profile is the one you've just created. Fill in the login form: User name: The one you used previously usually, admin - Password: the one entered twice in the previous section + Password: the one entered while installing the gnuhealth-server package. + Installing the default modules ------------------------------ @@ -138,7 +92,8 @@ There are many more. Just check on the module list and select those that fit best your health center. -Congratulations! You have completed the initial installation of GNU Health. +Congratulations, you have completed the initial installation of GNU Health! - -- Emilien Klein <emilien+deb...@klein.st> Tue, 27 Nov 2012 23:37:01 +0100 + -- Emilien Klein <emilien+deb...@klein.st> Fri, 03 May 2013 22:59:28 +0200 + Modified: trunk/packages/gnuhealth/trunk/debian/TODO.Debian =================================================================== --- trunk/packages/gnuhealth/trunk/debian/TODO.Debian 2013-05-03 21:10:48 UTC (rev 13476) +++ trunk/packages/gnuhealth/trunk/debian/TODO.Debian 2013-05-03 21:15:49 UTC (rev 13477) @@ -9,24 +9,6 @@ ======== -Take care in the Debian package of some of the manual steps outlined in -debian/README.Debian, such as: - - Creating the Operating System User - See http://www.debian.org/doc/debian-policy/ch-files.html#s-permissions-owners - - Create a database user - - Configure the Tryton server (if it's possible to create a separate config - file for Tryton?) - -I've had to change the security options in the PostgreSQL configuration, but -that is most probably not doable automatically (as it would mean fiddling with -another package's configuration files). - -The user will still have to manually mark the GNU Health packages for -installation in the GUI as explained in the installation guide, that is fine -and can not be done automatically by our package anyway... - -======== - The health_qrcodes is now removed from the binary package, as it depends on a Python library that is currently not packaged: http://pypi.python.org/pypi/qrcode/2.4.2 Modified: trunk/packages/gnuhealth/trunk/debian/changelog =================================================================== --- trunk/packages/gnuhealth/trunk/debian/changelog 2013-05-03 21:10:48 UTC (rev 13476) +++ trunk/packages/gnuhealth/trunk/debian/changelog 2013-05-03 21:15:49 UTC (rev 13477) @@ -1,14 +1,11 @@ gnuhealth (1.8.1-1) experimental; urgency=low * New upstream release + * Create the Operating System User and "gnuhealth" database + * Create an init deamon to run a dedicated Tryton server for GNU Health * debian/copyright: Mention Dmitry Smirnov in the Files: debian/* section - * debian/postinst: Start the Tryton server after installing/upgrading - * debian/postrm: Start the Tryton server after removing - * debian/preinst: Stop the Tryton server before installing/upgrading - * debian/prerm: Stop the Tryton server before removing - * debian/TODO.Debian: Remove the steps taken to improve the package - -- Emilien Klein <emilien+deb...@klein.st> Sat, 20 Apr 2013 08:23:58 +0200 + -- Emilien Klein <emilien+deb...@klein.st> Fri, 03 May 2013 22:59:28 +0200 gnuhealth (1.8.0-1) experimental; urgency=low _______________________________________________ debian-med-commit mailing list debian-med-commit@lists.alioth.debian.org http://lists.alioth.debian.org/cgi-bin/mailman/listinfo/debian-med-commit