Return-Path: 
 <derby-commits-return-9368-apmail-db-derby-commits-archive=db.apache.org@db.apache.org>
Delivered-To: apmail-db-derby-commits-archive@www.apache.org
Received: (qmail 97877 invoked from network); 11 Feb 2008 12:41:19 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2)
  by minotaur.apache.org with SMTP; 11 Feb 2008 12:41:19 -0000
Received: (qmail 9264 invoked by uid 500); 11 Feb 2008 12:41:12 -0000
Delivered-To: apmail-db-derby-commits-archive@db.apache.org
Received: (qmail 9238 invoked by uid 500); 11 Feb 2008 12:41:12 -0000
Mailing-List: contact derby-commits-help@db.apache.org; run by ezmlm
Precedence: bulk
list-help: <mailto:derby-commits-help@db.apache.org>
list-unsubscribe: <mailto:derby-commits-unsubscribe@db.apache.org>
List-Post: <mailto:derby-commits@db.apache.org>
Reply-To: "Derby Development" <derby-dev@db.apache.org>
List-Id: <derby-commits.db.apache.org>
Delivered-To: mailing list derby-commits@db.apache.org
Received: (qmail 9217 invoked by uid 99); 11 Feb 2008 12:41:12 -0000
Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136)
    by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 11 Feb 2008 04:41:12 -0800
X-ASF-Spam-Status: No, hits=-2000.0 required=10.0
	tests=ALL_TRUSTED
X-Spam-Check-By: apache.org
Received: from [140.211.11.3] (HELO eris.apache.org) (140.211.11.3)
    by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 11 Feb 2008 12:40:50 +0000
Received: by eris.apache.org (Postfix, from userid 65534)
	id B5B6F1A9832; Mon, 11 Feb 2008 04:40:57 -0800 (PST)
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r620473 - in /db/derby/docs/trunk/src/adminguide:
 cadminhubbkup01.dita cadminhubbkup63476.dita
Date: Mon, 11 Feb 2008 12:40:57 -0000
To: derby-commits@db.apache.org
From: dyre@apache.org
X-Mailer: svnmailer-1.0.8
Message-Id: <20080211124057.B5B6F1A9832@eris.apache.org>
X-Virus-Checked: Checked by ClamAV on apache.org

Author: dyre
Date: Mon Feb 11 04:40:54 2008
New Revision: 620473

URL: http://svn.apache.org/viewvc?rev=620473&view=rev
Log:
DERBY-2969: Admin Guide: Document that online backup is non-blocking
Patch contributed by Kim Haase
Patch file: DERBY-2969-2.diff

Modified:
    db/derby/docs/trunk/src/adminguide/cadminhubbkup01.dita
    db/derby/docs/trunk/src/adminguide/cadminhubbkup63476.dita

Modified: db/derby/docs/trunk/src/adminguide/cadminhubbkup01.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/adminguide/cadminhubbkup01.dita?rev=620473&r1=620472&r2=620473&view=diff
==============================================================================
--- db/derby/docs/trunk/src/adminguide/cadminhubbkup01.dita (original)
+++ db/derby/docs/trunk/src/adminguide/cadminhubbkup01.dita Mon Feb 11 04:40:54 2008
@@ -35,11 +35,14 @@
 a database that is currently open, use the following statement (forward slashes
 are used as path separators in SQL commands):</p>
 <codeblock><b>CALL SYSCS_UTIL.SYSCS_BACKUP_DATABASE('c:/mybackups/2005-06-01')</b></codeblock>
-<p>The <i>SYSCS_UTIL.SYSCS_BACKUP_DATABASE()</i> procedure puts the database
-into a state in which it can be safely copied, then copies the entire original
-database directory (including data files, online transaction log files, and
-jar files) to the specified backup directory. Files that are not within the
-original database directory (for example, <i>derby.properties</i>) are <i>not</i> copied.</p>
+<p>The SYSCS_UTIL.SYSCS_BACKUP_DATABASE procedure puts the database
+into a state in which it can be safely copied. The procedure then copies the
+entire original database directory (including data files, online transaction log
+files, and jar files) to the specified backup directory. Files that are not
+within the original database directory (for example, <i>derby.properties</i>)
+are <i>not</i> copied. With the exception of a few cases mentioned in 
+<xref href="cadminhubbkup01.dita#cadminhubbkup01/hubbkupunlogged"></xref>,
+the procedure does not block concurrent transactions at any time.</p>
 <p>The following example shows how to back up a database to a directory with
 a name that reflects the current date:</p>
 <codeblock>public static void backUpDatabase(Connection conn)throws SQLException
@@ -47,7 +50,7 @@
 <b>// Get today's date as a string:</b>
 java.text.SimpleDateFormat todaysDate = 
    new java.text.SimpleDateFormat("yyyy-MM-dd");
-String backupdirectory = "c:/mybacksup/" +
+String backupdirectory = "c:/mybackups/" +
    todaysDate.format((java.util.Calendar.getInstance()).getTime());
 
 CallableStatement cs = conn.prepareCall("CALL SYSCS_UTIL.SYSCS_BACKUP_DATABASE(?)"); 
@@ -62,7 +65,7 @@
 <note>Do not back up different databases with the same name to the same backup
 directory. If a database of the same name already exists in the backup directory,
 it is assumed to be an older version and is overwritten.</note>
-<section><title>Unlogged Operations</title>
+<section id="hubbkupunlogged"><title>Unlogged Operations</title>
 <p>
 For some operations, Derby does not log because it can keep the database
 consistent without logging the data.

Modified: db/derby/docs/trunk/src/adminguide/cadminhubbkup63476.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/adminguide/cadminhubbkup63476.dita?rev=620473&r1=620472&r2=620473&view=diff
==============================================================================
--- db/derby/docs/trunk/src/adminguide/cadminhubbkup63476.dita (original)
+++ db/derby/docs/trunk/src/adminguide/cadminhubbkup63476.dita Mon Feb 11 04:40:54 2008
@@ -22,7 +22,8 @@
 <title>Online backups</title>
 <prolog></prolog>
 <conbody>
-<p>Use online backups to back up a database while it is running.</p>
+<p>Use online backups to back up a database while it is running, without
+blocking transactions.</p>
 <p>You can perform online backups by using several types of backup procedures
 or by using operating systems commands with the freeze and unfreeze system
 procedures.</p>