svn commit: r208723 - /incubator/derby/docs/trunk/src/devguide/tdevpreupgrade.dita

[fu...@apache.org]

Author: fuzzylogic
Date: Fri Jul  1 00:31:05 2005
New Revision: 208723

URL: http://svn.apache.org/viewcvs?rev=208723&view=rev
Log:
Add missed file from previous DERBY-377 commit.

Added:
    incubator/derby/docs/trunk/src/devguide/tdevpreupgrade.dita   (with props)

Added: incubator/derby/docs/trunk/src/devguide/tdevpreupgrade.dita
URL: http://svn.apache.org/viewcvs/incubator/derby/docs/trunk/src/devguide/tdevpreupgrade.dita?rev=208723&view=auto
==============================================================================
--- incubator/derby/docs/trunk/src/devguide/tdevpreupgrade.dita (added)
+++ incubator/derby/docs/trunk/src/devguide/tdevpreupgrade.dita Fri Jul  1 00:31:05 2005
@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--Arbortext, Inc., 1988-2004, v.4002-->
+<!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="tdevpreupgrade" xml:lang="en-us">
+<title>Preparing to upgrade</title>
+<prolog><metadata>
+<keywords><indexterm>Upgrading Derby<indexterm>prerequisites</indexterm></indexterm>
+</keywords>
+</metadata></prolog>
+<taskbody>
+<context> <p>Upgrading occurs the first time the new <ph conref="devconrefs.dita#prod/productshortname"></ph> software
+connects to the old database. Before connecting with the new software:</p></context>
+<steps>
+<step><cmd>Force a checkpoint with the earlier version of <ph conref="devconrefs.dita#prod/productshortname"></ph>.
+To force a checkpoint, connect to the database with the older version of the <ph
+conref="devconrefs.dita#prod/productshortname"></ph> software and issue a
+shutdown request using the <codeph>shutdown=true</codeph> attribute on the
+database connection URL, as shown in the following example:</cmd><info><codeblock>/* in a java program */
+DriverManager.getConnection("jdbc:derby:sample;shutdown=true");</codeblock></info>
+<stepresult>Forcing a checkpoint avoids having to run recovery during the
+upgrade and minimizes the time for the upgrade to complete.</stepresult></step>
+<step><cmd>Back up your database to a safe location using <ph conref="devconrefs.dita#prod/productshortname"></ph> online/offline
+backup procedures.</cmd><info>For more information on backup, see the <ph
+conref="devconrefs.dita#pub/citadmin"></ph>.</info><stepresult>If you do not
+perform a soft upgrade, then once the database is upgraded, it cannot be reverted
+back to the previous version.</stepresult></step>
+</steps>
+</taskbody>
+</task>

Propchange: incubator/derby/docs/trunk/src/devguide/tdevpreupgrade.dita
------------------------------------------------------------------------------
    svn:eol-style = native