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

[tille at alioth.debian.org]

Author: tille
Date: 2009-01-08 21:04:03 +0000 (Thu, 08 Jan 2009)
New Revision: 2930

Added:
   trunk/packages/gnumed-server/trunk/debian/gm-backup_database.8
Modified:
   trunk/packages/gnumed-server/trunk/debian/cron.daily
   trunk/packages/gnumed-server/trunk/debian/gm-backup_data.8
Log:
New manpage gm-backup_database.8 and clarification of role of gm-backup_data


Modified: trunk/packages/gnumed-server/trunk/debian/cron.daily
===================================================================
--- trunk/packages/gnumed-server/trunk/debian/cron.daily	2009-01-08 16:02:36 UTC (rev 2929)
+++ trunk/packages/gnumed-server/trunk/debian/cron.daily	2009-01-08 21:04:03 UTC (rev 2930)
@@ -1,13 +1,19 @@
 #!/bin/sh
 # care for daily backup of GNUmed database
 
-DATA=/usr/sbin/gm-backup_data
+# This script only saves plain data without table structure etc.
+# Normally you want to store the whole database
+# DATA=/usr/sbin/gm-backup_data
+
+# Backup of data and table structure
 DATABASE=/usr/sbin/gm-backup_database
+
+# Compress and sign backup
 ZIPSIGN=/usr/sbin/gm-zip+sign_backups
 
-if [ -x "$DATA" ] ; then
-    $DATA
-fi
+# if [ -x "$DATA" ] ; then
+#     $DATA
+# fi
 
 if [ -x "$DATABASE" ] ; then
     $DATABASE
@@ -16,4 +22,3 @@
 if [ -x "$ZIPSIGN" ] ; then
     $ZIPSIGN
 fi
-

Modified: trunk/packages/gnumed-server/trunk/debian/gm-backup_data.8
===================================================================
--- trunk/packages/gnumed-server/trunk/debian/gm-backup_data.8	2009-01-08 16:02:36 UTC (rev 2929)
+++ trunk/packages/gnumed-server/trunk/debian/gm-backup_data.8	2009-01-08 21:04:03 UTC (rev 2930)
@@ -8,12 +8,19 @@
 .B gm-backup_data
 
 .SH DESCRIPTION
+The 
 .B gm-backup_data
-is might be used in a daily cron job to ensure that GNUmed
-patient data are safe against data loss.  The Debian GNU/Linux
-packaged version of the GNUmed server installs such a cron job
-by default.
+script creates a backup of the data of a GNUmed
+database. It includes neither roles nor the schema.
+The backup can be used to restore the data into a
+preexisting, empty database.
+If you really know what you are doing and want to
+care for database schema  and roles yourself this
+script might suffice to backup the raw data.
 
+.SH SEE ALSO
+gm_backup_database(8)
+
 .SH AUTHOR
 This manual page was written by Andreas Tille <tille at debian.org>,
 for the Debian GNU/Linux system (but may be used by others).

Added: trunk/packages/gnumed-server/trunk/debian/gm-backup_database.8
===================================================================
--- trunk/packages/gnumed-server/trunk/debian/gm-backup_database.8	                        (rev 0)
+++ trunk/packages/gnumed-server/trunk/debian/gm-backup_database.8	2009-01-08 21:04:03 UTC (rev 2930)
@@ -0,0 +1,26 @@
+.TH GM-BACKUP_DATABASE 8 "2009 January 8th" "GNUmed server database backup"
+
+.SH NAME
+.B gm-backup_database
+- complete backup of GNUmed database
+
+.SH SYNOPSIS
+.B gm-backup_database
+
+.SH DESCRIPTION
+The 
+.B gm-backup_database
+script creates a backup of the database schema,
+data, and roles which can be used to restore a GNUmed
+database from scratch.
+It is a eally good idea to use it in a daily cron job to ensure that GNUmed
+patient data are safe against data loss.  The Debian GNU/Linux
+packaged version of the GNUmed server installs such a cron job
+by default.
+
+.SH SEE ALSO 
+gm_backup_data(8)
+
+.SH AUTHOR
+This manual page was written by Andreas Tille <tille at debian.org>,
+for the Debian GNU/Linux system (but may be used by others).