Uploaded image for project: 'Derby'
  1. Derby
  2. DERBY-4253

documentation should indicate that a database cannot be upgraded if already booted in soft upgrade mode

    Details

    • Type: Improvement
    • Status: Closed
    • Priority: Minor
    • Resolution: Fixed
    • Affects Version/s: 10.6.1.0
    • Fix Version/s: 10.6.1.0
    • Component/s: Documentation
    • Labels:
      None

      Description

      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

      1. rrefattribupgrade.html
        5 kB
        Bryan Pendleton
      2. rrefattribupgrade.html
        5 kB
        Bryan Pendleton
      3. docsItalics.diff
        1 kB
        Bryan Pendleton
      4. docs.diff
        1.0 kB
        Bryan Pendleton

        Issue Links

          Activity

          Hide
          bryanpendleton Bryan Pendleton added a comment -

          Committed to the docs trunk as revision 835467.

          Show
          bryanpendleton Bryan Pendleton added a comment - Committed to the docs trunk as revision 835467.
          Hide
          bryanpendleton Bryan Pendleton added a comment -

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

          Show
          bryanpendleton Bryan Pendleton added a comment - Thanks Kim, that makes sense. I updated the patch to use italics for the attributes, and to reference the shutdown attribute with a link.
          Hide
          chaase3 Kim Haase added a comment -

          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>

          Show
          chaase3 Kim Haase added a comment - 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>
          Hide
          bryanpendleton Bryan Pendleton added a comment -

          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.

          Show
          bryanpendleton Bryan Pendleton added a comment - 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.

            People

            • Assignee:
              bryanpendleton Bryan Pendleton
              Reporter:
              kmarsden Kathey Marsden
            • Votes:
              0 Vote for this issue
              Watchers:
              0 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved:

                Development