Laura Stewart (JIRA) wrote:
[ http://issues.apache.org/jira/browse/DERBY-1636?page=comments#action_12428779 ]
Laura Stewart commented on DERBY-1636:
--------------------------------------
I have a concern about where the encryption information is located in the
Developers Guide.
It appears in 2 sections and in some cases there are topics with different content but with
the same titles.
There is this section:
JDBC applications and Derby basics -->Derby embedded basics -->Working with the database connection URL attributes
that has these topic titles:
--Using the databaseName attribute
--Shutting down Derby or an individual database
--Creating and accessing a database
--Providing a user name and password
--Encrypting a database when you create it
--Booting an encrypted database
--Specifying attributes in a properties object
Then there is this section:
Derby and Security -->Encrypting databases on disk -->Working with encryption
that has these topic titles:
--Encrypting databases on creation
--Creating the boot password
--Specifying an alternate encryption provider
--Specifying an alternate encryption algorithm
--Booting an encrypted database
--Changing the boot password
I have created these new topics:
--Encrypting an existing database
--Encrypting databases with a new boot password
--Encrypting databases with a new external key
and have them located under the section Derby and Security -->Encrypting databases
on disk -->Working with encryption
but we should take a hard look this information and the links that exist
between these sections and also avoid any duplication of information.
Thanks Laura. I also got confused when I first looked up the
developers guide for encryption do. First section (Working with the
database connection URL attributes) looks like more of examples to use
the connection attributes.
Other section where we document encrypting databases on disk
(Encrypting databases on disk -->Working with encryption )
seems to be right place to document the new content
about encrypting an existing database as you described.
Thanks
-suresh
