[jira] Commented: (DERBY-4253) documentation should indicate that a database cannot be upgraded if already booted in soft upgrade mode

["Kim Haase (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/DERBY-4253?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12776584#action_12776584 ] 

Kim Haase commented on DERBY-4253:
----------------------------------

Thanks for doing this, Bryan!

My only suggestion is that to conform with our usage you follow the examples of the attributes later in the topic. The attribute is in italics, and the shutdown=true one should also link to the topic for it, so it'd be

<i><xref href="rrefattrib16471.dita#rrefattrib16471">shutdown=true</xref></i>


> documentation should indicate that a database cannot be upgraded if already booted in soft upgrade mode
> -------------------------------------------------------------------------------------------------------
>
>                 Key: DERBY-4253
>                 URL: https://issues.apache.org/jira/browse/DERBY-4253
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 10.6.0.0
>            Reporter: Kathey Marsden
>            Assignee: Bryan Pendleton
>            Priority: Minor
>         Attachments: docs.diff, rrefattribupgrade.html
>
>
> The documentation should indicate that you cannot perform a full upgrade on a database already booted in soft upgrade mode.  If a database is already booted in soft upgrade mode, the upgrade=true attribute will have no effect.   If a database is already booted in soft upgrade mode, you can shutdown the database with the shutdown=true attribute and then connect with upgrade=true to perform the upgrade.
> Perhaps a good place for this might be at:
> http://db.apache.org/derby/docs/10.4/ref/rrefattribupgrade.html
> See the derby-user thread:
> http://www.nabble.com/Hard-upgrade-failing--td23826558.html

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.