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 Improvement
    • Status: Closed
    • Priority: Minor 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. docs.diff
        1.0 kB
        Bryan Pendleton
      2. docsItalics.diff
        1 kB
        Bryan Pendleton
      3. rrefattribupgrade.html
        5 kB
        Bryan Pendleton
      4. rrefattribupgrade.html
        5 kB
        Bryan Pendleton

        Issue Links

          Activity

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

          Committed to the docs trunk as revision 835467.

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

            People

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

              Dates

              • Created:
                Updated:
                Resolved:

                Development