You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-dev@db.apache.org by "Kathey Marsden (JIRA)" <ji...@apache.org> on 2009/06/02 21:43:07 UTC

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

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
            Priority: Minor


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.


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

Posted by "Bryan Pendleton (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/DERBY-4253?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Bryan Pendleton resolved DERBY-4253.
------------------------------------

       Resolution: Fixed
    Fix Version/s: 10.6.0.0

Committed to the docs trunk as revision 835467.


> 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
>             Fix For: 10.6.0.0
>
>         Attachments: docs.diff, docsItalics.diff, rrefattribupgrade.html, 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.


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

Posted by "Bryan Pendleton (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/DERBY-4253?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Bryan Pendleton updated DERBY-4253:
-----------------------------------

    Attachment: rrefattribupgrade.html
                docs.diff

The proposed documentation text seems quite helpful to me, and the
location for it seems appropriate too.

See attached HTML file for how it looks, edited in place.

Please let me know what you think.


> 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.


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

Posted by "Bryan Pendleton (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/DERBY-4253?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Bryan Pendleton reassigned DERBY-4253:
--------------------------------------

    Assignee: Bryan Pendleton

> 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
>
> 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.


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

Posted by "Bryan Pendleton (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/DERBY-4253?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Bryan Pendleton updated DERBY-4253:
-----------------------------------

    Attachment: rrefattribupgrade.html
                docsItalics.diff

Thanks Kim, that makes sense. I updated the patch to use italics for the attributes, 
and to reference the shutdown attribute with a link.


> 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, docsItalics.diff, rrefattribupgrade.html, 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.


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

Posted by "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.