[med-svn] r13477 - trunk/packages/gnuhealth/trunk/debian

Fri May 3 21:15:49 UTC 2013

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+debian at klein.st>  Tue, 27 Nov 2012 23:37:01 +0100
+ -- Emilien Klein <emilien+debian at 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+debian at klein.st>  Sat, 20 Apr 2013 08:23:58 +0200
+ -- Emilien Klein <emilien+debian at klein.st>  Fri, 03 May 2013 22:59:28 +0200
 
 gnuhealth (1.8.0-1) experimental; urgency=low
 


