[med-svn] r3307 - trunk/packages/gnumed-server/trunk/debian

Tue Apr 21 11:20:05 UTC 2009

Author: tille
Date: 2009-04-21 11:20:04 +0000 (Tue, 21 Apr 2009)
New Revision: 3307

Modified:
   trunk/packages/gnumed-server/trunk/debian/README.Debian
   trunk/packages/gnumed-server/trunk/debian/changelog
Log:
Finally upload gnumed-server to unstable


Modified: trunk/packages/gnumed-server/trunk/debian/README.Debian
===================================================================

--- trunk/packages/gnumed-server/trunk/debian/README.Debian	2009-04-21 06:19:30 UTC (rev 3306)
+++ trunk/packages/gnumed-server/trunk/debian/README.Debian	2009-04-21 11:20:04 UTC (rev 3307)
@@ -1,56 +1,93 @@
 GNUmed server for Debian
 ------------------------
 
-This package does NOT work out of the box.  It just installs the SQL
-files of GNUmed server to /var/lib/gnumed/server.  From there you
-have to follow the instructions of the README file that is provided by
-the GNUmed authors.   The installation should go like this:
+This package is needed to run a local GNUmed data base but
+it does NOT work out of the box.  It just installs the SQL
+files of GNUmed server to /var/lib/gnumed/server.  From
+there you have to follow the instructions of the README file
+that is provided by the GNUmed authors. Future Debian
+packages will try to offer more automatic mechanisms if
+possible.
 
-  # cd /var/lib/gnumed/server/bootstrap                                                
-  # GM_LOG_BASE="/var/log/gnumed/server" ./bootstrap-latest.sh
+Even without bootstrapping you can use the GNUmed client
+with a public database as described in the docs of the
+GNUmed client.
 
-Make sure that your postgresql server is UTF-8 enabled, for instance
 
-$ psql -t -d template1 -c "show lc_ctype;"
-   de_DE.UTF-8
+Installing the Database
+=======================
 
+Make sure that your postgresql server is UTF-8 enabled, eg:
+
+        $ psql -t -d template1 -c "show lc_ctype;"
+	de_DE.UTF-8
+
 or at least lc_ctype=C.
 
-Alternatively you might call /usr/sbin/gm-bootstrap_server
-as root.
+As root call:
 
-You can use GNUmed client with a public database as described
-in the docs of GNUmed client.  The server package is needed to
-run a local GNUmed data base.
+	# /usr/sbin/gm-bootstrap_server
 
-Once you successfully bootstrapped the GNUmed server database
-you have to add the line
+Note that this will DESTROY any v2 - v10 databases you
+might already have on your server.
 
-   local   samegroup       +gm-logins    md5
+Make sure to use the UPGRADE procedure if you want to
+upgrade an existing database.
 
-to your pg_hba.conf file to enable at least local connections
-via GNUmed (see README for more detailed information).
 
+Upgrading the Database
+======================
+
+To upgrade your v9 database to the current v10 database
+follow these steps:
+
+1) Make sure all clients are disconnected.
+
+	The upgrade will fail if any client is still connected.
+	You can send a message to connected clients via the user interface.
+
+2) Run the upgrade procedure.
+
+	# gm-upgrade_server 9 10
+
+	This can take a long time and require quite some disk space
+	if your database is large. Try the "no-backup" option if you
+	are ABSOLUTELY SURE you already have an uptodate backup !
+
+	This must be run as root on the database server.
+
+3) Adjust backend profiles in private .conf files.
+
+	You probably need to adjust the database name of some
+	profiles in, say, ~/.gnumed/gnumed.conf.
+
+	Otherwise your clients may try to connect to
+	the old database.
+
+4) Adjust your backup procedures.
+
+	You probably need to adjust the database name
+	in /etc/gnumed/gnumed-backup.conf.
+
+
 Configuring daily backups
 =========================
 
 Once you installed the database you most probably want to
-organise a backup of your data.  The Debian package has
+organize a backup of your data.  The Debian package has
 installed a cron job and the details can be adjusted in
 /etc/gnumed/gnumed-backup.conf.
-Please follow the documentation in this file to do so.
+Please follow the documentation in that file to do so.
 
 
-Upgrading the Database
-======================
+More detailed instructions
+==========================
 
-At
+There are more detailed instructions at
 
    http://wiki.gnumed.de/bin/view/Gnumed/ServerInstallUpgrade
 
-you can find a description how to upgrade the GNUmed database.
-Please follow this description for the moment.  Future Debian
-packages will try to offer more automatic mechanisms if possible.
+on how to install and upgrade the GNUmed database.
 
 
  -- Andreas Tille <tille at debian.org>  Fri,  8 Dec 2006 23:44:43 +0100

Modified: trunk/packages/gnumed-server/trunk/debian/changelog
===================================================================
--- trunk/packages/gnumed-server/trunk/debian/changelog	2009-04-21 06:19:30 UTC (rev 3306)
+++ trunk/packages/gnumed-server/trunk/debian/changelog	2009-04-21 11:20:04 UTC (rev 3307)
@@ -1,11 +1,13 @@
-gnumed-server (0v10.2-1) UNRELEASED; urgency=low
+gnumed-server (0v10.3-1) unstable; urgency=low
 
   * New upstream version
   * Hint to change ph_hba.conf in README.Debian
   * Standards-Version: 3.8.1 (no changes needed)
   * No versioned build-depends from debhelper any more
+  * debian/README.Debian: described upgrade procedure
+    (Thanks to Karsten Hilbert from upstream)
 
- -- Andreas Tille <tille at debian.org>  Mon, 30 Mar 2009 22:49:59 +0200
+ -- Andreas Tille <tille at debian.org>  Tue, 21 Apr 2009 11:40:45 +0200
 
 gnumed-server (0v9.2-2) experimental; urgency=low
 


