Uploaded image for project: 'JBoss Enterprise Application Platform'
  1. JBoss Enterprise Application Platform
  2. JBEAP-22114

EJB subsystem configuration option <enable-graceful-txn-shutdown value="true"/> needs to be properly documented

    XMLWordPrintable

Details

    • Bug
    • Resolution: Unresolved
    • Major
    • None
    • 7.3.3.GA, 7.4.0.GA
    • Documentation, EJB
    • None
    • 5
    • False
    • False
    • Undefined

    Description

      The documentation of the EJB subsystem needs to clarify the meaning of the configuration property enable-graceful-txn-shutdown

      {source}
      /subsystem=ejb3:write-attribute(name=enable-graceful-txn-shutdown,value=true/false{source}

      Currently the wording is misguiding and wrong
      https://access.redhat.com/documentation/en-us/red_hat_jboss_enterprise_application_platform/7.3/html/configuration_guide/starting_and_stopping_jboss_eap#graceful_shutdown_suspend

      {source}
      By default, transaction graceful shutdown is disabled for the ejb subsystem. You must enable transaction graceful shutdown if you want the server to wait for EJB-related transactions to complete before suspending.{source}

      The default value is false and then it has no impact on how the EJB shutdown processing behaves.
      When set to true then it influences only how remote EJB transaction propagation is handled during shutdown. It has no impact on in-VM EJBs or transactions.

      In other words
      The enable-graceful-shutdown attribute is important for the remote EJB connections. When it's set up to true it permits the incoming EJB connection to be processed on active transactions during shutdown or when the server is suspended. But this parameter when provided with whatever value has no effect on in-VM transactions.

      Attachments

        Issue Links

          Activity

            People

              dsoni@redhat.com Dhruv Soni
              ochaloup@redhat.com Ondrej Chaloupka (Inactive)
              Votes:
              0 Vote for this issue
              Watchers:
              1 Start watching this issue

              Dates

                Created:
                Updated: