You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-commits@db.apache.org by jt...@apache.org on 2006/08/26 05:54:05 UTC
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
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 <sc...@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 = <new password></title>
+<prolog><metadata>
+<keywords><indexterm>newBootPassword= <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= <key></title>
+<prolog><metadata>
+<keywords><indexterm>newEncryptionKey= <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