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 fu...@apache.org on 2005/07/01 01:48:46 UTC
svn commit: r208695 - in /incubator/derby/docs/trunk/src/devguide:
cdevupgrades.dita derbydev.ditamap tdevupgradedb.dita tdevupgradesoft.dita
Author: fuzzylogic
Date: Thu Jun 30 16:48:45 2005
New Revision: 208695
URL: http://svn.apache.org/viewcvs?rev=208695&view=rev
Log:
DERBY-377: Add information on upgrading a database from 10.0 to 10.1 to the
Developer's Guide.
Committed for Jeff Levitt <de...@mylevita.com>
Added:
incubator/derby/docs/trunk/src/devguide/cdevupgrades.dita (with props)
incubator/derby/docs/trunk/src/devguide/tdevupgradedb.dita (with props)
incubator/derby/docs/trunk/src/devguide/tdevupgradesoft.dita (with props)
Modified:
incubator/derby/docs/trunk/src/devguide/derbydev.ditamap
Added: incubator/derby/docs/trunk/src/devguide/cdevupgrades.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/devguide/cdevupgrades.dita?rev=208695&view=auto
==============================================================================
--- incubator/derby/docs/trunk/src/devguide/cdevupgrades.dita (added)
+++ incubator/derby/docs/trunk/src/devguide/cdevupgrades.dita Thu Jun 30 16:48:45 2005
@@ -0,0 +1,37 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE concept PUBLIC "-//IBM//DTD DITA Concept//EN"
+ "../dtd/concept.dtd">
+<!--
+Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed 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.
+-->
+<concept id="cdevupgrades" xml:lang="en-us">
+<title>Upgrades</title>
+<shortdesc>To connect to a database created with a previous version of <ph
+conref="devconrefs.dita#prod/productshortname"></ph>, you must first upgrade
+that database.</shortdesc>
+<prolog><metadata>
+<keywords><indexterm>Upgrading Derby</indexterm><indexterm></indexterm></keywords>
+</metadata></prolog>
+<conbody>
+<p>Upgrading involves writing changes to the system tables, so it is not possible
+for databases on read-only media. The upgrade process:</p>
+<ul>
+<li>marks the database as upgraded to the current release (Version 10.1).</li>
+<li>allows use of new features such as SYNONYMS with the upgraded database. </li>
+</ul>
+<p>See the release notes for more information on upgrading your databases
+to this version of <ph conref="devconrefs.dita#prod/productshortname"></ph>.</p>
+</conbody>
+</concept>
Propchange: incubator/derby/docs/trunk/src/devguide/cdevupgrades.dita
------------------------------------------------------------------------------
svn:eol-style = native
Modified: incubator/derby/docs/trunk/src/devguide/derbydev.ditamap
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/devguide/derbydev.ditamap?rev=208695&r1=208694&r2=208695&view=diff
==============================================================================
--- incubator/derby/docs/trunk/src/devguide/derbydev.ditamap (original)
+++ incubator/derby/docs/trunk/src/devguide/derbydev.ditamap Thu Jun 30 16:48:45 2005
@@ -34,6 +34,11 @@
<topicref href="cdevdgpref23947.dita" navtitle="How this guide Is Organized">
</topicref>
</topicref>
+<topicref collection-type="family" href="cdevupgrades.dita" navtitle="Upgrades">
+<topicref href="tdevpreupgrade.dita" navtitle="Preparing to upgrade"></topicref>
+<topicref href="tdevupgradedb.dita" navtitle="Upgrading a database"></topicref>
+<topicref href="tdevupgradesoft.dita" navtitle="Soft upgrade"></topicref>
+</topicref>
<topicref collection-type="family" href="cdevdvlp19524.dita" navtitle="JDBC applications and Derby basics">
<topicref href="cdevdvlp14839.dita" navtitle="Application development overview">
</topicref>
Added: incubator/derby/docs/trunk/src/devguide/tdevupgradedb.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/devguide/tdevupgradedb.dita?rev=208695&view=auto
==============================================================================
--- incubator/derby/docs/trunk/src/devguide/tdevupgradedb.dita (added)
+++ incubator/derby/docs/trunk/src/devguide/tdevupgradedb.dita Thu Jun 30 16:48:45 2005
@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE task PUBLIC "-//IBM//DTD DITA Task//EN"
+ "../dtd/task.dtd">
+<!--
+Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed 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.
+-->
+<task id="tdevupgradedb" xml:lang="en-us">
+<title>Upgrading a database</title>
+<shortdesc>To upgrade a database, you must explicitly request an upgrade the
+first time you connect to it with the new version of <ph conref="devconrefs.dita#prod/productshortname"></ph>.</shortdesc>
+<prolog><metadata>
+<keywords><indexterm>Upgrading Derby</indexterm></keywords>
+</metadata></prolog>
+<taskbody>
+<prereq>Do not attempt to upgrade a database without first backing it up.</prereq>
+<context> <p>To request an upgrade when connecting to the database:</p></context>
+<steps>
+<step><cmd>Use the <codeph>upgrade=true</codeph> database connection URL attribute,
+as shown in the following example:</cmd><info><codeblock>jdbc:derby:sample;upgrade=true</codeblock></info>
+<stepresult>Once the upgrade is complete, you cannot connect to the database
+with an older version of <ph conref="devconrefs.dita#prod/productshortname"></ph>.</stepresult>
+</step>
+</steps>
+<result>You can find out the version of <ph conref="devconrefs.dita#prod/productshortname"></ph> using
+sysinfo:<codeblock>java org.apache.derby.tools.sysinfo</codeblock>Note that
+this is the version of <ph conref="devconrefs.dita#prod/productshortname"></ph>,
+not the version of the database. Sysinfo uses information found in the <ph
+conref="devconrefs.dita#prod/productshortname"></ph> jar files, so verify
+that only one version of <ph conref="devconrefs.dita#prod/productshortname"></ph>'s
+jar files are in your class path when you run this tool.</result>
+</taskbody>
+</task>
Propchange: incubator/derby/docs/trunk/src/devguide/tdevupgradedb.dita
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/derby/docs/trunk/src/devguide/tdevupgradesoft.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/devguide/tdevupgradesoft.dita?rev=208695&view=auto
==============================================================================
--- incubator/derby/docs/trunk/src/devguide/tdevupgradesoft.dita (added)
+++ incubator/derby/docs/trunk/src/devguide/tdevupgradesoft.dita Thu Jun 30 16:48:45 2005
@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE task PUBLIC "-//IBM//DTD DITA Task//EN"
+ "../dtd/task.dtd">
+<!--
+Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.
+
+Licensed 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.
+-->
+<task id="tdevupgradesoft" xml:lang="en-us">
+<title>Soft upgrade</title>
+<shortdesc>Soft upgrade allows you run a newer version of <ph conref="devconrefs.dita#prod/productshortname"></ph> against
+an existing database without having to fully upgrade the database. This means
+that you can continue to run an older version of <ph conref="devconrefs.dita#prod/productshortname"></ph> against
+the database.</shortdesc>
+<prolog><metadata>
+<keywords><indexterm>Soft upgrade</indexterm><indexterm>Upgrading Derby<indexterm>Soft
+upgrade</indexterm></indexterm></keywords>
+</metadata></prolog>
+<taskbody>
+<context> <p>If you perform a soft upgrade, you will not be able to perform
+certain functions that are not available in older versions of <ph conref="devconrefs.dita#prod/productshortname"></ph>.
+For example, the following <ph conref="devconrefs.dita#prod/productshortname"></ph> Version
+10.1 features cannot be used in a database that has been soft upgraded:<ul>
+<li>Synonym functionality</li>
+<li>Creating tables using the GENERATED BY DEFAULT option for identity columns</li>
+<li>Reclaiming unused space using the SYSCS_UTIL.SYSCS_INPLACE_COMPRESS_TABLE
+procedure</li>
+</ul>Other new features in <ph conref="devconrefs.dita#prod/productshortname"></ph> that
+do not affect database structure, such as using timestamp arithmetic, are
+allowed in a soft upgraded database.</p><p>To perform a soft upgrade on a
+database created using an earlier version of <ph conref="devconrefs.dita#prod/productshortname"></ph>:</p></context>
+<steps>
+<step><cmd> Simply connect to the database, as shown in the following example:</cmd>
+<info><codeblock>connect 'jdbc:derby:sample'</codeblock>In this example, the
+sample database is a Version 10.0 database.</info></step>
+</steps>
+</taskbody>
+</task>
Propchange: incubator/derby/docs/trunk/src/devguide/tdevupgradesoft.dita
------------------------------------------------------------------------------
svn:eol-style = native