db-derby-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bpendle...@apache.org
Subject svn commit: r835467 - /db/derby/docs/trunk/src/ref/rrefattribupgrade.dita
Date Thu, 12 Nov 2009 17:47:35 GMT
Author: bpendleton
Date: Thu Nov 12 17:47:35 2009
New Revision: 835467

URL: http://svn.apache.org/viewvc?rev=835467&view=rev
DERBY-4253: Document behavior of upgrade=true when db already booted

This change adds some additional documentation to the manual page for
the upgrade=true attribute to clarify the behavior when the database
is already booted in soft upgrade mode: a full upgrade cannot be
performed when the database is already booted; the database must be
shutdown and then re-booted in full upgrade mode.


Modified: db/derby/docs/trunk/src/ref/rrefattribupgrade.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefattribupgrade.dita?rev=835467&r1=835466&r2=835467&view=diff
--- db/derby/docs/trunk/src/ref/rrefattribupgrade.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefattribupgrade.dita Thu Nov 12 17:47:35 2009
@@ -25,6 +25,14 @@
 owner</xref> can perform a full upgrade. See also "Enabling user
 authentication" and "Setting the SQL standard authorization mode" in the
 <ph conref="../conrefs.dita#pub/citdevelop"></ph> for more information.</p>
+<p><b>Note:</b> You cannot perform a full upgrade on a database already
+    in soft upgrade mode. If a database is already booted in soft upgrade mode,
+    the <i>upgrade=true</i> attribute will have no effect.
+    If a database is already booted in soft upgrade mode,
+    you can first shutdown the database with the
+    <i><xref href="rrefattrib16471.dita#rrefattrib16471">shutdown=true</xref></i>
+    attribute and then connect with <i>upgrade=true</i> to perform the upgrade.

 <section><title>Combining with other attributes</title>
 <p>You must specify a <i>databaseName</i> (after the subprotocol in the

View raw message