Derby
  1. Derby
  2. DERBY-4727

Document derby.stream.error.logBootTrace=true diagnostic property

    Details

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

      Description

      With the fix for DERBY-4588, the diagnostic property derby.stream.error.logBootTrace can be used to diagnose dual boot issues. Typically when two jvm's or class loaders attempt to boot derby the error message below will appear:

      ERROR XJ040: Failed to start database 'testdb' with class loader sun.misc.Launch
      er$AppClassLoader@481e481e, see the next exception for details.
      ERROR XSDB6: Another instance of Derby may have already booted the database C:\derby\testdb

      and will show the stack trace and class loader of the failed boot attempt. It is sometimes also useful to see the stack trace when the first successful boot attempt occured. To see the stack trace of successful boots and shutdowns, set derby.stream.error.logBootTrace=true to trace the successful attempt. If you think that both attempts should be from the same class loader context, check also the class loader information for boot and shutdown attempts and make sure they all come from the same class loader context.

      1. DERBY-4727.zip
        10 kB
        Kim Haase
      2. DERBY-4727.stat
        0.2 kB
        Kim Haase
      3. DERBY-4727.diff
        6 kB
        Kim Haase

        Issue Links

          Activity

          Hide
          Kim Haase added a comment -

          Belatedly getting to this property – thanks for providing such a helpful description, Kathey. I assume it is system-wide and static like the others in derby.stream.error.

          Show
          Kim Haase added a comment - Belatedly getting to this property – thanks for providing such a helpful description, Kathey. I assume it is system-wide and static like the others in derby.stream.error.
          Hide
          Kim Haase added a comment -

          Attaching DERBY-4727.diff, DERBY-4727.stat, and DERBY-4727.zip, with changes to the following files:

          M src\devguide\cdevdvlp20458.dita
          A src\ref\rrefproperlogboottrace.dita
          M src\ref\crefproper22250.dita
          M src\ref\refderby.ditamap

          I added a topic for the new property, listed it in the "Derby properties" table, and added a reference to it in the Developer's Guide topic on double-booting. Please let me know what changes are needed.

          I know there's one: the error message has changed and the Dev Guide topic needs to be updated. I'll do this for the next iteration.

          Please let me know if there are any problems with the zip file – I'm using 7-Zip instead of winzip now.

          Show
          Kim Haase added a comment - Attaching DERBY-4727 .diff, DERBY-4727 .stat, and DERBY-4727 .zip, with changes to the following files: M src\devguide\cdevdvlp20458.dita A src\ref\rrefproperlogboottrace.dita M src\ref\crefproper22250.dita M src\ref\refderby.ditamap I added a topic for the new property, listed it in the "Derby properties" table, and added a reference to it in the Developer's Guide topic on double-booting. Please let me know what changes are needed. I know there's one: the error message has changed and the Dev Guide topic needs to be updated. I'll do this for the next iteration. Please let me know if there are any problems with the zip file – I'm using 7-Zip instead of winzip now.
          Hide
          Kim Haase added a comment -

          Have received no comments on this patch. I'll commit it tomorrow if this is still the case then.

          Show
          Kim Haase added a comment - Have received no comments on this patch. I'll commit it tomorrow if this is still the case then.
          Hide
          Dag H. Wanvik added a comment -

          The changes look good to me. +1

          Show
          Dag H. Wanvik added a comment - The changes look good to me. +1
          Hide
          Kathey Marsden added a comment -

          The patch looks good. Thanks Kim!

          Show
          Kathey Marsden added a comment - The patch looks good. Thanks Kim!
          Hide
          Kim Haase added a comment -

          Thanks very much, Dag and Kathey.

          Committed patch DERBY-4727.diff to documentation trunk at revision 1069837.

          Show
          Kim Haase added a comment - Thanks very much, Dag and Kathey. Committed patch DERBY-4727 .diff to documentation trunk at revision 1069837.
          Hide
          Kim Haase added a comment -

          Fixes appeared in 10.8.1 documentation, so closing.

          Show
          Kim Haase added a comment - Fixes appeared in 10.8.1 documentation, so closing.

            People

            • Assignee:
              Kim Haase
              Reporter:
              Kathey Marsden
            • Votes:
              0 Vote for this issue
              Watchers:
              0 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved:

                Development