db-derby-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From chaa...@apache.org
Subject svn commit: r1406244 - in /db/derby/docs/trunk/src: devguide/ ref/
Date Tue, 06 Nov 2012 17:48:48 GMT
Author: chaase3
Date: Tue Nov  6 17:48:48 2012
New Revision: 1406244

URL: http://svn.apache.org/viewvc?rev=1406244&view=rev
Log:
DERBY-5976  Document the new SQLWarning raised when trying to change the encryption state
of an already booted database. 

Modified 4 Developer's Guide topics and 4 Reference Manual topics.

Patch: DERBY-5976.diff

Modified:
    db/derby/docs/trunk/src/devguide/cdevcsecuredecryptdb.dita
    db/derby/docs/trunk/src/devguide/tdevcsecurenewbootpw.dita
    db/derby/docs/trunk/src/devguide/tdevcsecurenewextkey.dita
    db/derby/docs/trunk/src/devguide/tdevcsecureunencrypteddb.dita
    db/derby/docs/trunk/src/ref/rrefattrib15290.dita
    db/derby/docs/trunk/src/ref/rrefattribdecryptdb.dita
    db/derby/docs/trunk/src/ref/rrefattribnewbootpw.dita
    db/derby/docs/trunk/src/ref/rrefattribnewencryptkey.dita

Modified: db/derby/docs/trunk/src/devguide/cdevcsecuredecryptdb.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevcsecuredecryptdb.dita?rev=1406244&r1=1406243&r2=1406244&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevcsecuredecryptdb.dita (original)
+++ db/derby/docs/trunk/src/devguide/cdevcsecuredecryptdb.dita Tue Nov  6 17:48:48 2012
@@ -54,5 +54,8 @@ and <xref href="cdevcsecure36595.dita#cd
 are both enabled, the credentials of the 
 <xref href="cdevcsecureDbOwner.dita#cdevcsecureDbOwner">database owner</xref>
 must be supplied as well, since decryption is a restricted operation.</p>
+<p>After you decrypt the database, be sure to check for <i>SQLWarning</i>s.
The
+decryption succeeded only if there were no <i>SQLWarning</i>s or
+<i>SQLException</i>s.</p>
 </conbody>
 </concept>

Modified: db/derby/docs/trunk/src/devguide/tdevcsecurenewbootpw.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/tdevcsecurenewbootpw.dita?rev=1406244&r1=1406243&r2=1406244&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/tdevcsecurenewbootpw.dita (original)
+++ db/derby/docs/trunk/src/devguide/tdevcsecurenewbootpw.dita Tue Nov  6 17:48:48 2012
@@ -64,7 +64,10 @@ with the new encryption key and is prote
     must be supplied as well, since reencryption is a restricted operation.
     </p>
   </info>
-<info><p>If you disabled log archival before you applied the new boot
+<info><p>After you change the boot password, be sure to check for
+<i>SQLWarning</i>s. The change succeeded only if there were no
+<i>SQLWarning</i>s or <i>SQLException</i>s.</p>
+<p>If you disabled log archival before you applied the new boot
 password, create a new backup of the database after the database is reconfigured
 with the new boot password. For more information, see the section "Backing up
 and restoring databases" in the <ph conref="../conrefs.dita#pub/citadmin"></ph>,

Modified: db/derby/docs/trunk/src/devguide/tdevcsecurenewextkey.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/tdevcsecurenewextkey.dita?rev=1406244&r1=1406243&r2=1406244&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/tdevcsecurenewextkey.dita (original)
+++ db/derby/docs/trunk/src/devguide/tdevcsecurenewextkey.dita Tue Nov  6 17:48:48 2012
@@ -59,7 +59,10 @@ newEncryptionKey=6862636465666768'</code
   must be supplied as well, since encryption is a restricted operation.
   </p>
 </info>
-<info><p>If you disabled log archival before you applied the new encryption
+<info><p>After you change the encryption key, be sure to check for
+<i>SQLWarning</i>s. The change succeeded only if there were no
+<i>SQLWarning</i>s or <i>SQLException</i>s.</p>
+<p>If you disabled log archival before you applied the new encryption
 key, create a new backup of the database after the database is reconfigured
 with the new encryption key. For more information, see the section "Backing up
 and restoring databases" in the <ph conref="../conrefs.dita#pub/citadmin"></ph>,

Modified: db/derby/docs/trunk/src/devguide/tdevcsecureunencrypteddb.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/tdevcsecureunencrypteddb.dita?rev=1406244&r1=1406243&r2=1406244&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/tdevcsecureunencrypteddb.dita (original)
+++ db/derby/docs/trunk/src/devguide/tdevcsecureunencrypteddb.dita Tue Nov  6 17:48:48 2012
@@ -79,7 +79,10 @@ in the URL:<codeblock>jdbc:derby:salesdb
   must be supplied as well, since encryption is a restricted operation.
 </p>
 </info>
-<info><p>
+<info><p>After you encrypt an existing, unencrypted database, be sure to check
+for <i>SQLWarning</i>s. The encryption succeeded only if there were no
+<i>SQLWarning</i>s or <i>SQLException</i>s.</p>
+<p>
 If you disabled log archival before you encrypted the database, create
 a new backup of the database after the database is encrypted. For more
 information, see the section "Backing up and restoring databases" in the

Modified: db/derby/docs/trunk/src/ref/rrefattrib15290.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefattrib15290.dita?rev=1406244&r1=1406243&r2=1406244&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefattrib15290.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefattrib15290.dita Tue Nov  6 17:48:48 2012
@@ -67,6 +67,9 @@ or
   <ph conref="../conrefs.dita#pub/citdevelop"></ph>
   for more information.
 </p>
+<p>After you encrypt an existing, unencrypted database, be sure to check for
+<i>SQLWarning</i>s. The encryption succeeded only if there were no
+<i>SQLWarning</i>s or <i>SQLException</i>s.</p>
 </section>
 <example><title>Examples</title><codeblock><b><ph>--
encrypt a new database</ph>
 jdbc:derby:encryptedDB;create=true;dataEncryption=true;

Modified: db/derby/docs/trunk/src/ref/rrefattribdecryptdb.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefattribdecryptdb.dita?rev=1406244&r1=1406243&r2=1406244&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefattribdecryptdb.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefattribdecryptdb.dita Tue Nov  6 17:48:48 2012
@@ -49,6 +49,9 @@ authorization are both enabled, only the
 perform decryption. 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>After you decrypt the database, be sure to check for <i>SQLWarning</i>s.
The
+decryption succeeded only if there were no <i>SQLWarning</i>s or
+<i>SQLException</i>s.</p>
 </section>
 <example><title>Examples</title>
 <codeblock><b><ph>-- decrypt a database</ph>

Modified: db/derby/docs/trunk/src/ref/rrefattribnewbootpw.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefattribnewbootpw.dita?rev=1406244&r1=1406243&r2=1406244&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefattribnewbootpw.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefattribnewbootpw.dita Tue Nov  6 17:48:48 2012
@@ -51,6 +51,9 @@ you use the <i>newBootPassword=newPasswo
   <ph conref="../conrefs.dita#pub/citdevelop"></ph>
   for more information.
 </p>
+<p>After you change the boot password, be sure to check for <i>SQLWarning</i>s.
+The change succeeded only if there were no <i>SQLWarning</i>s or
+<i>SQLException</i>s.</p>
 </section>
 <example><title>Example</title><codeblock><b><ph>-- specify
a new boot password for a database</ph>
 jdbc:derby:salesdb;bootPassword=abc1234xyz;newBootPassword=new1234xyz</b></codeblock>
</example>

Modified: db/derby/docs/trunk/src/ref/rrefattribnewencryptkey.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefattribnewencryptkey.dita?rev=1406244&r1=1406243&r2=1406244&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefattribnewencryptkey.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefattribnewencryptkey.dita Tue Nov  6 17:48:48 2012
@@ -50,6 +50,9 @@ you use the <i>newEncryptionKey=key</i> 
   <ph conref="../conrefs.dita#pub/citdevelop"></ph>
   for more information.
 </p>
+<p>After you change the encryption key, be sure to check for <i>SQLWarning</i>s.
+The change succeeded only if there were no <i>SQLWarning</i>s or
+<i>SQLException</i>s.</p>
 </section>
 <example><title>Example</title><codeblock><b><ph>-- specify
a new encryption key for a database</ph>
 jdbc:derby:salesdb;encryptionKey=6162636465666768;



Mime
View raw message