db-derby-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From j..@apache.org
Subject svn commit: r437069 - in /db/derby/docs/trunk/src/ref: refderby.ditamap rrefattrib15290.dita rrefattrib42100.dita rrefattrib60346.dita rrefattrib88843.dita rrefattribencryptkey.dita rrefattribnewbootpw.dita rrefattribnewencryptkey.dita
Date Sat, 26 Aug 2006 03:54:05 GMT
Author: jta
Date: Fri Aug 25 20:54:04 2006
New Revision: 437069

URL: http://svn.apache.org/viewvc?rev=437069&view=rev
Log:
DERBY-1636 Update Reference Guide for encryption of an un-encrypted database and re-encryption

with new password/key.

Committed patch derby1636_ref3.diff by Laura Stewart <scotsmatrix@gmail.com>.

Added:
    db/derby/docs/trunk/src/ref/rrefattribnewbootpw.dita   (with props)
    db/derby/docs/trunk/src/ref/rrefattribnewencryptkey.dita   (with props)
Modified:
    db/derby/docs/trunk/src/ref/refderby.ditamap
    db/derby/docs/trunk/src/ref/rrefattrib15290.dita
    db/derby/docs/trunk/src/ref/rrefattrib42100.dita
    db/derby/docs/trunk/src/ref/rrefattrib60346.dita
    db/derby/docs/trunk/src/ref/rrefattrib88843.dita
    db/derby/docs/trunk/src/ref/rrefattribencryptkey.dita

Modified: db/derby/docs/trunk/src/ref/refderby.ditamap
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/refderby.ditamap?rev=437069&r1=437068&r2=437069&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/refderby.ditamap (original)
+++ db/derby/docs/trunk/src/ref/refderby.ditamap Fri Aug 25 20:54:04 2006
@@ -508,6 +508,7 @@
 <topicref collection-type="family" href="rrefattrib24612.dita" navtitle="Setting attributes
for the database connection URL ">
 <topicref href="rrefattrib42100.dita" navtitle="bootPassword=key"></topicref>
 <topicref href="rrefattrib26867.dita" navtitle="create=true"></topicref>
+<topicref href="rrefcreatefrom.dita" navtitle="createFrom=Path"></topicref>
 <topicref href="rrefattrib17246.dita" navtitle="databaseName=nameofDatabase">
 </topicref>
 <topicref href="rrefattrib15290.dita" navtitle="dataEncryption=true"></topicref>
@@ -516,15 +517,18 @@
 </topicref>
 <topicref href="rrefattrib60346.dita" navtitle="encryptionAlgorithm=algorithm">
 </topicref>
-<topicref href="rrefattrib56769.dita" navtitle="territory=ll_CC"></topicref>
 <topicref href="rrefattrib72457.dita" navtitle="logDevice=logDirectoryPath">
 </topicref>
+<topicref href="rrefattribnewencryptkey.dita" navtitle="newEncryptionKey=new encryption
key">
+</topicref>
+<topicref href="rrefattribnewbootpw.dita" navtitle="newBootPassword=new password">
+</topicref>
 <topicref href="rrefattrib42686.dita" navtitle="password=userPassword"></topicref>
+<topicref href="rrefrestorefrom.dita" navtitle="restoreFrom=Path"></topicref>
 <topicref href="rrefrollforward.dita" navtitle="rollForwardRecoveryFrom=Path">
 </topicref>
-<topicref href="rrefcreatefrom.dita" navtitle="createFrom=Path"></topicref>
-<topicref href="rrefrestorefrom.dita" navtitle="restoreFrom=Path"></topicref>
 <topicref href="rrefattrib16471.dita" navtitle="shutdown=true"></topicref>
+<topicref href="rrefattrib56769.dita" navtitle="territory=ll_CC"></topicref>
 <topicref href="rrefattrib10035.dita" navtitle="user=userName"></topicref>
 <topicref href="rrefattrib34183.dita" navtitle="(no attributes)"></topicref>
 </topicref>

Modified: db/derby/docs/trunk/src/ref/rrefattrib15290.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefattrib15290.dita?rev=437069&r1=437068&r2=437069&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefattrib15290.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefattrib15290.dita Fri Aug 25 20:54:04 2006
@@ -1,4 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
+ 
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
 <!-- 
 Licensed to the Apache Software Foundation (ASF) under one or more
 contributor license agreements.  See the NOTICE file distributed with
@@ -15,27 +18,29 @@
 See the License for the specific language governing permissions and  
 limitations under the License.
 -->
-
-<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
- "../dtd/reference.dtd">
 <reference id="rrefattrib15290" xml:lang="en-us">
 <title>dataEncryption=true</title>
 <prolog><metadata>
-<keywords><indexterm>dataEncryption=true (database connection URL attribute)</indexterm>
-<indexterm>Encrypting databases</indexterm><indexterm>Databases<indexterm>encrypting</indexterm></indexterm>
+<keywords><indexterm>dataEncryption=true</indexterm><indexterm>encrypting
+databases<indexterm>data encryption</indexterm></indexterm><indexterm>databases<indexterm>attributes,
+data encryption</indexterm></indexterm><indexterm>attributes<indexterm>dataEncryption</indexterm></indexterm>
 </keywords>
 </metadata></prolog>
 <refbody>
-<section><title>Function</title> <p>Specifies data encryption on
disk for
-a new database. (For information about data encryption, see "Encrypting Databases
-on Disk" in the <cite><ph conref="refconrefs.dita#pub/citdevelop"></ph></cite>.)</p>
</section>
-<section><title>Combining with other attributes</title> <p>Must
-be combined with <i><xref href="rrefattrib26867.dita#rrefattrib26867"></xref></i>
and <i><xref
-href="rrefattrib42100.dita#rrefattrib42100"></xref>.</i> You have the option
of also
-specifying <i><xref href="rrefattrib88843.dita#rrefattrib88843"></xref></i>
and <i><xref
-href="rrefattrib60346.dita#rrefattrib60346"></xref>.</i></p> </section>
-<example> <codeblock><b>jdbc:derby:encryptedDB;create=true;dataEncryption=true;
-    bootPassword=cLo4u922sc23aPe</b></codeblock> </example>
+<section><title>Function</title><p>Specifies data encryption on disk
for a
+new database or to configure an existing unencrypted database for encryption.
+For information about data encryption, see "Encrypting Databases on Disk"
+in the <cite><ph conref="refconrefs.dita#pub/citdevelop"></ph></cite>.</p>
</section>
+<section><title>Combining with other attributes</title><p>The <i>dataEncryption</i>
attribute
+must be combined with the <i><xref href="rrefattrib42100.dita#rrefattrib42100"></xref></i>
attribute
+or the <xref href="rrefattribnewencryptkey.dita#rrefattribnewencryptkey"></xref>
attribute.
+You have the option of also specifying the <i><xref href="rrefattrib88843.dita#rrefattrib88843"></xref></i>
and <i><xref
+href="rrefattrib60346.dita#rrefattrib60346"></xref></i> attributes.</p>
</section>
+<example><title>Examples</title><codeblock><b><ph> --
encrypt a new database</ph>
+jdbc:derby:encryptedDB;create=true;dataEncryption=true;
+    bootPassword=cLo4u922sc23aPe
+ <ph>-- configure an existing unencrypted database for encryption </ph>
+   jdbc:derby:salesdb;dataEncryption=true;bootPassword=cLo4u922sc23aPe 
+</b></codeblock> </example>
 </refbody>
 </reference>
-

Modified: db/derby/docs/trunk/src/ref/rrefattrib42100.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefattrib42100.dita?rev=437069&r1=437068&r2=437069&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefattrib42100.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefattrib42100.dita Fri Aug 25 20:54:04 2006
@@ -1,4 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
+ 
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
 <!-- 
 Licensed to the Apache Software Foundation (ASF) under one or more
 contributor license agreements.  See the NOTICE file distributed with
@@ -15,28 +18,34 @@
 See the License for the specific language governing permissions and  
 limitations under the License.
 -->
-
-<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
- "../dtd/reference.dtd">
 <reference id="rrefattrib42100" xml:lang="en-us">
 <title>bootPassword=key</title>
 <prolog><metadata>
-<keywords><indexterm>bootPassword=key (database connection URL attribute)</indexterm>
-<indexterm>Encrypting databases</indexterm><indexterm>Databases<indexterm>encrypting</indexterm></indexterm>
+<keywords><indexterm>bootPassword=key</indexterm><indexterm>encrypting
databases<indexterm>boot
+password key</indexterm></indexterm><indexterm>databases<indexterm>attributes,
+boot password key</indexterm></indexterm><indexterm>attributes<indexterm>bootPassword</indexterm></indexterm>
 </keywords>
 </metadata></prolog>
 <refbody>
-<section><title>Function</title> <p>Specifies the key to use for
encrypting
-a new database or booting an existing encrypted database. Specify an alphanumeric
-string at least eight characters long.</p> </section>
-<section><title>Combining with other attributes</title> <p>When creating
a
-new database, must be combined with <i><xref href="rrefattrib26867.dita#rrefattrib26867"></xref></i>
and <i><xref
-href="rrefattrib15290.dita#rrefattrib15290"></xref>.</i> When booting an existing
-encrypted database, no other attributes are necessary.</p> <codeblock><b><ph>--
boot an encrypted database</ph>
-jdbc:derby:encryptedDB;bootPassword=cseveryPlace
-<ph>-- create a new, encrypted database</ph>
+<section><title>Function</title><p>Specifies the key to use to :
<ul>
+<li>Encrypt a new database</li>
+<li>Configure an existing unencrypted database for encryption</li>
+<li>Boot an existing encrypted database</li>
+</ul>Specify an alphanumeric string that is at least eight characters long.</p>
</section>
+<section><title>Combining with other attributes</title><p>When you
create
+a new database, the <i>bootPassword=key</i> attribute must be combined with
+the <i><xref href="rrefattrib26867.dita#rrefattrib26867"></xref></i>
and <i><xref
+href="rrefattrib15290.dita#rrefattrib15290"></xref></i> attributes. </p><p>When
+you configure an existing unencrypted database for encryption,  the <i>bootPassword=key</i>
attribute
+must be combined with the <xref href="rrefattrib15290.dita#rrefattrib15290"></xref>
attribute. </p><p>When
+you boot an existing encrypted database, no other attributes are necessary.</p> </section>
+<example><title>Examples</title><codeblock><b><ph>--
create a new, encrypted database</ph>
 jdbc:derby:newDB;create=true;dataEncryption=true;
-    bootPassword=cseveryPlace</b></codeblock> </section>
+    bootPassword=cseveryPlace
+<ph>-- configure an existing unencrypted database for encryption</ph>
+jdbc:derby:salesdb;dataEncryption=true;bootPassword=cseveryPlace
+<ph>-- boot an existing encrypted database</ph>
+jdbc:derby:encryptedDB;bootPassword=cseveryPlace
+</b></codeblock></example>
 </refbody>
 </reference>
-

Modified: db/derby/docs/trunk/src/ref/rrefattrib60346.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefattrib60346.dita?rev=437069&r1=437068&r2=437069&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefattrib60346.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefattrib60346.dita Fri Aug 25 20:54:04 2006
@@ -1,4 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
+ 
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
 <!-- 
 Licensed to the Apache Software Foundation (ASF) under one or more
 contributor license agreements.  See the NOTICE file distributed with
@@ -15,33 +18,39 @@
 See the License for the specific language governing permissions and  
 limitations under the License.
 -->
-
-<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
- "../dtd/reference.dtd">
 <reference id="rrefattrib60346" xml:lang="en-us">
 <title>encryptionAlgorithm=algorithm</title>
 <prolog><metadata>
-<keywords><indexterm>encryptionAlgorithm=algorithm (database connection URL
-attribute)</indexterm><indexterm>Data encryption<indexterm>algorithms</indexterm></indexterm>
-<indexterm>Encryption<indexterm>algorithms</indexterm></indexterm></keywords>
+<keywords><indexterm>encryptionAlgorithm=algorithm </indexterm><indexterm>encrypting
+databases<indexterm>encryption algorithms</indexterm></indexterm><indexterm>databases<indexterm>attributes,
+encryption algorithm</indexterm></indexterm><indexterm>attributes<indexterm>encryptionAlgorithm</indexterm></indexterm>
+</keywords>
 </metadata></prolog>
 <refbody>
-<section><title>Function</title> <p>Specifies the algorithm for data
encryption. </p> <p>Specify
-the algorithm per the Java conventions:   <codeblock><b><b><i>algorithmName</i></b>/<b><i>feedbackMode</i></b>/<b><i>padding</i></b></b></codeblock
-></p> <p>The only padding type allowed with <ph conref="refconrefs.dita#prod/productshortname"></ph>
is <i>NoPadding</i>.</p> <p>If
-no encryption algorithm is specified, the default value is <i>DES/CBC/NoPadding</i>.</p>
<p>(For
-information about data encryption, see "Encrypting Databases on Disk" in Chapter
-7 of the <cite><ph conref="refconrefs.dita#pub/citdevelop"></ph></cite>).</p>
</section>
-<section><title>Combining with other attributes</title> <p>Must
-be combined with <i><xref href="rrefattrib26867.dita#rrefattrib26867"></xref>,</i>
<i><xref
-href="rrefattrib42100.dita#rrefattrib42100"></xref>, <xref href="rrefattrib15290.dita#rrefattrib15290"></xref>,</i>
and <i><xref
-href="rrefattrib88843.dita#rrefattrib88843"></xref>.</i></p> </section>
-<example> <codeblock><b>jdbc:derby:encryptedDB;create=true;dataEncryption=true;
+<section><title>Function</title><p>Specifies the algorithm for data
encryption. </p><p>Use
+the Java conventions when you specify the algorithm, for example:   <codeblock><b><b><i>algorithmName</i></b>/<b><i>feedbackMode</i></b>/<b><i>padding</i
+></b></b></codeblock></p><p>The only padding type that is
allowed with <ph
+conref="refconrefs.dita#prod/productshortname"></ph> is <i>NoPadding</i>.</p><p>If
+no encryption algorithm is specified, the default value is <i>DES/CBC/NoPadding</i>.</p><p>For
+information about data encryption, see "Encrypting Databases on Disk" in the <cite><ph
+conref="refconrefs.dita#pub/citdevelop"></ph></cite>.</p> </section>
+<section><title>Combining with other attributes</title> <p>The <i>encryptionAlgorithm</i>
attribute
+must be combined with the <i><xref href="rrefattrib42100.dita#rrefattrib42100"></xref></i>
attribute
+and the <xref href="rrefattrib15290.dita#rrefattrib15290"></xref> attribute.
+You have the option of also specifying the <i><xref href="rrefattrib88843.dita#rrefattrib88843"></xref></i>
attribute
+to specify the encryption provider of the algorithm.</p></section>
+<example> <title>Examples</title><codeblock><b><ph> --
encrypt a new database</ph>
+    jdbc:derby:encryptedDB;create=true;dataEncryption=true;
     encryptionProvider=com.sun.crypto.provider.SunJCE;
     encryptionAlgorithm=DESede/CBC/NoPadding;
-    bootPassword=cLo4u922sc23aPe</b></codeblock> <note>If the specified
provider
-does not support the specified algorithm, <ph conref="refconrefs.dita#prod/productshortname"></ph>
throws
+    bootPassword=cLo4u922sc23aPe
+<ph>-- configure an existing database for encryption </ph>
+    jdbc:derby:salesdb;dataEncryption=true; 
+    encryptionProvider=com.sun.crypto.provider.SunJCE; 
+    encryptionAlgorithm=DESede/CBC/NoPadding; 
+    bootPassword=cLo4u922sc23aPe 
+</b></codeblock><note>If the specified provider does not support the specified
+algorithm, <ph conref="refconrefs.dita#prod/productshortname"></ph> returns
 an exception.</note> </example>
 </refbody>
 </reference>
-

Modified: db/derby/docs/trunk/src/ref/rrefattrib88843.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefattrib88843.dita?rev=437069&r1=437068&r2=437069&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefattrib88843.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefattrib88843.dita Fri Aug 25 20:54:04 2006
@@ -1,4 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
+ 
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
 <!-- 
 Licensed to the Apache Software Foundation (ASF) under one or more
 contributor license agreements.  See the NOTICE file distributed with
@@ -15,29 +18,34 @@
 See the License for the specific language governing permissions and  
 limitations under the License.
 -->
-
-<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
- "../dtd/reference.dtd">
 <reference id="rrefattrib88843" xml:lang="en-us">
 <title>encryptionProvider=providerName</title>
 <prolog><metadata>
-<keywords><indexterm>encryptionProvider=providerName (database connection
-URL attribute)</indexterm><indexterm>Data encryption<indexterm>providers</indexterm></indexterm>
-<indexterm>Encryption<indexterm>providers</indexterm></indexterm></keywords>
+<keywords><indexterm>encryptionProvider=providerName</indexterm><indexterm>data
+encryption<indexterm>providers attribute</indexterm></indexterm><indexterm>encryption<indexterm>providers
+attribute</indexterm></indexterm><indexterm>attributes<indexterm>encryptionProvider</indexterm></indexterm>
+</keywords>
 </metadata></prolog>
 <refbody>
-<section><title>Function</title> <p>Specifies the provider for data
encryption.
-(For information about data encryption, see "Encrypting Databases on Disk"
-in the <cite><ph conref="refconrefs.dita#pub/citdevelop"></ph></cite>.)
</p> <p>If
-this attribute is not specified, the default encryption provider is the one included in the
jvm that you are using.</p> </section>
-<section><title>Combining with other attributes</title> <p>Must be
combined
-with <i><xref href="rrefattrib26867.dita#rrefattrib26867"></xref>,</i>
<i><xref
-href="rrefattrib42100.dita#rrefattrib42100"></xref>, and <xref href="rrefattrib15290.dita#rrefattrib15290"></xref>.</i>
You
-have the option of also specifying <i><xref href="rrefattrib60346.dita#rrefattrib60346"></xref>.</i></p>
</section>
-<example> <codeblock><b>jdbc:derby:encryptedDB;create=true;dataEncryption=true;
+<section><title>Function</title><p>Specifies the provider for data
encryption.
+For information about data encryption, see "Encrypting Databases on Disk"
+in the <cite><ph conref="refconrefs.dita#pub/citdevelop"></ph></cite>.
</p><p>If
+this attribute is not specified, the default encryption provider is the one
+included in the JVM that you are using.</p> </section>
+<section><title>Combining with other attributes</title> <p>The <i>encryptionProvider</i>
attribute
+must be combined with the <i><xref href="rrefattrib42100.dita#rrefattrib42100"></xref>
and <xref
+href="rrefattrib15290.dita#rrefattrib15290"></xref></i> attributes. You can
+also specify the <i><xref href="rrefattrib60346.dita#rrefattrib60346"></xref></i>
attribute.</p> </section>
+<example><title>Examples</title><codeblock><b><ph>--
create a new, encrypted database</ph>
+jdbc:derby:encryptedDB;create=true;dataEncryption=true;
     encryptionProvider=com.sun.crypto.provider.SunJCE;
     encryptionAlgorithm=DESede/CBC/NoPadding;
-    bootPassword=cLo4u922sc23aPe</b></codeblock> </example>
+    bootPassword=cLo4u922sc23aPe
+<ph>-- configure an existing database for encryption </ph>
+    jdbc:derby:salesdb;dataEncryption=true; 
+    encryptionProvider=com.sun.crypto.provider.SunJCE; 
+    encryptionAlgorithm=DESede/CBC/NoPadding; 
+    bootPassword=cLo4u922sc23aPe 
+</b></codeblock> </example>
 </refbody>
 </reference>
-

Modified: db/derby/docs/trunk/src/ref/rrefattribencryptkey.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefattribencryptkey.dita?rev=437069&r1=437068&r2=437069&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefattribencryptkey.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefattribencryptkey.dita Fri Aug 25 20:54:04 2006
@@ -29,22 +29,20 @@
 <refbody>
 <section><title>Function</title><p>Specifies the external key to
use to: <ul>
 <li>Encrypt a new database</li>
-<li>Configure an existing database for encryption</li>
+<li>Configure an existing unencrypted database for encryption</li>
 <li>Boot an existing encrypted database</li>
 </ul>Your application must provide the encryption key.</p></section>
 <section><title>Combining with other attributes</title><p>When creating
a
 new database, you must combine the <i>encryptionKey</i> attribute with the <i>create=true</i>
and <i>dataEncryption=true</i> attributes. </p><p>When
-you configure an existing database for encryption, the <i>encryptionKey</i> attribute
-must be combined with the <i>dataEncryption=true</i> attribute.  If the algorithm
-that was used when the database was created is not the default algorithm,
-you must also specify the <i>encryptionAlgorithm</i> attribute.</p><p>When
+you configure an existing unencrypted database for encryption, the <i>encryptionKey</i>
attribute
+must be combined with the <i>dataEncryption=true</i> attribute.</p><p>When
 booting an existing encrypted database, you must also specify the <i>encryptionAlgorithm</i>
attribute
 if the algorithm that was used when the database was created is not the default
 algorithm. </p><p>The default encryption algorithm used by <ph conref="refconrefs.dita#prod/productshortname"></ph>
is
 DES/CBC/NoPadding.</p> </section>
 <example><title>Examples</title><codeblock><b><ph>--
create a new encrypted database</ph>  
     jdbc:derby:newDB;create=true;dataEncryption=true;encryptionAlgorithm=DES/CBC/NoPadding;encryptionKey=6162636465666768
-<ph>-- configure an existing database for encryption</ph>
+<ph>-- configure an existing unencrypted database for encryption</ph>
     jdbc:derby:salesdb;dataEncryption=true;encryptionKey=6162636465666768 
 <ph>-- boot an encrypted database</ph>
     jdbc:derby:encryptedDB;encryptionKey=6162636465666768</b></codeblock> </example>

Added: db/derby/docs/trunk/src/ref/rrefattribnewbootpw.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefattribnewbootpw.dita?rev=437069&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefattribnewbootpw.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefattribnewbootpw.dita Fri Aug 25 20:54:04 2006
@@ -0,0 +1,43 @@
+<?xml version="1.0" encoding="utf-8"?>
+ 
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at      
+
+http://www.apache.org/licenses/LICENSE-2.0  
+
+Unless required by applicable law or agreed to in writing, software  
+distributed under the License is distributed on an "AS IS" BASIS,  
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  
+See the License for the specific language governing permissions and  
+limitations under the License.
+-->
+<reference id="rrefattribnewbootpw" xml:lang="en-us">
+<title>newBootPassword = &lt;new password></title>
+<prolog><metadata>
+<keywords><indexterm>newBootPassword= &lt;new password></indexterm><indexterm>encrypting
+databases<indexterm>new boot password</indexterm></indexterm><indexterm>databases<indexterm>attributes,
+new boot password</indexterm></indexterm><indexterm>attributes<indexterm>newBootPassword</indexterm></indexterm>
+</keywords>
+</metadata></prolog>
+<refbody>
+<section><title>Function</title><p>Specifies a new boot password
for an encrypted
+database. A new encryption key is generated internally by the engine and the
+key is protected using the new boot password. The newly generated encryption
+key encrypts the database, including the existing data. For more information
+about this attribute, see "Encrypting databases with a new boot password"
+in the <cite><ph conref="refconrefs.dita#pub/citdevelop"></ph></cite>.</p>
</section>
+<section><title>Combining with other attributes</title><p>The <i>newBootPassword</i>
attribute
+must be combined with the <i><xref href="rrefattrib42100.dita#rrefattrib42100"></xref></i>
attribute.</p><p>You
+cannot change the encryption provider or the encryption algorithm when you
+use the <i>newBootPassword</i> attribute.</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>
+</refbody>
+</reference>

Propchange: db/derby/docs/trunk/src/ref/rrefattribnewbootpw.dita
------------------------------------------------------------------------------
    svn:eol-style = native

Added: db/derby/docs/trunk/src/ref/rrefattribnewencryptkey.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefattribnewencryptkey.dita?rev=437069&view=auto
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefattribnewencryptkey.dita (added)
+++ db/derby/docs/trunk/src/ref/rrefattribnewencryptkey.dita Fri Aug 25 20:54:04 2006
@@ -0,0 +1,42 @@
+<?xml version="1.0" encoding="utf-8"?>
+ 
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
+<!-- 
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at      
+
+http://www.apache.org/licenses/LICENSE-2.0  
+
+Unless required by applicable law or agreed to in writing, software  
+distributed under the License is distributed on an "AS IS" BASIS,  
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  
+See the License for the specific language governing permissions and  
+limitations under the License.
+-->
+<reference id="rrefattribnewencryptkey" xml:lang="en-us">
+<title>newEncryptionKey= &lt;key></title>
+<prolog><metadata>
+<keywords><indexterm>newEncryptionKey= &lt;new encryption key></indexterm>
+<indexterm>encrypting databases<indexterm>new encryption key</indexterm></indexterm>
+<indexterm>databases<indexterm>attributes, new encryption key</indexterm></indexterm>
+<indexterm>attributes<indexterm>newEncryptionKey</indexterm></indexterm></keywords>
+</metadata></prolog>
+<refbody>
+<section><title>Function</title><p>Specifies a new external encryption
key
+for an encrypted database. All of the existing data in the database is encrypted
+using the new encryption key and any new data written to the database will
+use this key for encryption. For more information about this attribute, see
+"Encrypting databases with a new external key" in the <cite><ph conref="refconrefs.dita#pub/citdevelop"></ph></cite>.</p>
</section>
+<section><title>Combining with other attributes</title> <p>The <i>newEncryptionKey</i>
attribute
+must be combined with the <i><xref href="rrefattribencryptkey.dita#rrefattribencryptkey"></xref></i>
attribute.</p><p>You
+cannot change the encryption provider or the encryption algorithm when you
+use the <i>newEncryptionKey</i> attribute.</p> </section>
+<example><title>Example</title><codeblock><b><ph>-- specify
a new encryption key for a database</ph>
+jdbc:derby:salesdb;encryptionKey=6162636465666768;newEncryptionKey=6862636465666768</b></codeblock>
</example>
+</refbody>
+</reference>

Propchange: db/derby/docs/trunk/src/ref/rrefattribnewencryptkey.dita
------------------------------------------------------------------------------
    svn:eol-style = native



Mime
View raw message