Uploaded image for project: 'WildFly'
  1. WildFly
  2. WFLY-5613

Fixes of help tooltip of transaction configuration in Web Console

    XMLWordPrintable

Details

    Description

      I would like ask for changing text in transaction configuration helper tooltip (_Need Help?
      _). First there is an issue of not having an information that jts to be fully enabled is need to set subsystem of iiop orb as well (the same issue was for 6.4.0 https://bugzilla.redhat.com/show_bug.cgi?id=995439).

      Nevertheless I would like ask for a bit more general change of the text in the help webconsole tooltip

      Current text is

      Default timeout: 	The default timeout.
      Enable tsm status: 	Whether the transaction status manager (TSM) service, needed for out of process recovery, should be provided or not..
      Journal store enable async io: 	Whether AsyncIO should be enabled for the journal store. Default is false. The server should be restarted for this setting to take effect.
      Jts: 	If true this enables the Java Transaction Service.
      Node identifier: 	Used to set the node identifier on the core environment.
      Statistics enabled: 	Whether statistics should be enabled.
      Use journal store: 	Use the journal store for writing transaction logs. Set to true to enable and to false to use the default log store type. The default log store is normally one file system file per transaction log. The server should be restarted for this setting to take effect. It's alternative to jdbc based store.
      
      Process id uuid: 	Indicates whether the transaction manager should use a UUID based process id.
      Process id socket binding: 	The name of the socket binding configuration to use if the transaction manager should use a socket-based process id. Will be 'undefined' if 'process-id-uuid' is 'true'; otherwise must be set.
      Process id socket max ports: 	The maximum number of ports to search for an open port if the transaction manager should use a socket-based process id. If the port specified by the socket binding referenced in 'process-id-socket-binding' is occupied, the next higher port will be tried until an open port is found or the number of ports specified by this attribute have been tried. Will be 'undefined' if 'process-id-uuid' is 'true'.
      
      Socket binding: 	Used to reference the correct socket binding to use for the recovery environment.
      Status socket binding: 	Used to reference the correct socket binding to use for the transaction status manager.
      Recovery listener: 	Used to specify if the recovery system should listen on a network socket or not.
      
      Object store path: 	Denotes a relative or absolute filesystem path denoting where the transaction manager object store should store data. By default the value is treated as relative to the path denoted by the "relative-to" attribute.
      Object store relative to: 	References a global path configuration in the domain model, defaulting to the JBoss Application Server data directory (jboss.server.data.dir). The value of the "path" attribute will treated as relative to this path. Use an empty string to disable the default behavior and force the value of the "path" attribute to be treated as an absolute path.
      
      Use jdbc store: 	Use the jdbc store for writing transaction logs. Set to true to enable and to false to use the default log store type. The default log store is normally one file system file per transaction log. The server should be restarted for this setting to take effect. It's alternative to Horneq based store
      Jdbc action store drop table: 	Configure if jdbc action store should drop tables. Default is false. The server should be restarted for this setting to take effect.
      Jdbc action store table prefix: 	Optional prefix for table used to write transcation logs in configured jdbc action store. The server should be restarted for this setting to take effect.
      Jdbc communication store drop table: 	Configure if jdbc communication store should drop tables. Default is false. The server should be restarted for this setting to take effect.
      Jdbc communication store table prefix: 	Optional prefix for table used to write transcation logs in configured jdbc communication store. The server should be restarted for this setting to take effect.
      Jdbc state store drop table: 	Configure if jdbc state store should drop tables. Default is false. The server should be restarted for this setting to take effect.
      Jdbc state store table prefix: 	Optional prefix for table used to write transcation logs in configured jdbc state store. The server should be restarted for this setting to take effect.
      Jdbc store datasource: 	Jndi name of non-XA datasource used. Datasource sghould be define in datasources subsystem. The server should be restarted for this setting to take effect.
      

      I would propose the following changes in the tooltip text

      Attributes

      • Default timeout
        • The default timeout for a transaction managed by the transaction manager.
      • Enable tsm status
        • Whether the transaction status manager (TSM) service, needed for out of process recovery, should be provided or not.
      • Journal store enable async io
        • Whether AsyncIO should be enabled for the journal store. Default is false. For this settings being active journal natives libraries needs to be available. The server should be restarted for this setting to take effect.
      • Jts
        • If true this enables the Java Transaction Service. Use of the JTS needs configuration in IIOP OpenJDK where Transactions parameter needs to be set to full. The server should be restarted for this setting to take effect.
      • Node identifier
        • Used to set the node identifier on the core environment. Each server should have this identifier unique. It's an identifier which differentiates XA transactions as created by this node. The server should be restarted for this setting to take effect.
      • Statistics enabled
        • Whether transaction statistics should be enabled. The transaction statistics could be seen in section Runtime > Monitor > Subsystems > Transactions. The server should be reloaded for this setting to take effect.
      • Use journal store
        • Use the journal store for writing transaction logs. Set to true to enable and to false to use the default log store type. The default log store creates normally one file file per transaction log. The journal one consists from one file for all the transactions. It's alternative to jdbc based store. The server should be restarted for this setting to take effect.

      Process ID + Recovery
      Add information that for settings these attributes taking effect the server needs to be reloaded.

      Path

      • Object store path
        • Denotes a relative or absolute filesystem path denoting where the transaction manager object store should store data. By default the value is treated as relative to the path denoted by the "relative-to" attribute. This settings is valid when default or journal store is used. It's not used when jdbc journal store is used. The server should be reloaded for this setting to take effect.
      • Object store relative to
        • References a global path configuration in the domain model, defaulting to the Application Server data directory (jboss.server.data.dir). The value of the "Object store path" attribute will treated as relative to this path. Use an empty string to disable the default behavior and force the value of the "Object store path" attribute to be treated as an absolute path. The server should be reloaded for this setting to take effect.

      JDBC

      • Use jdbc store
        • Use the jdbc store for writing transaction logs. Set to true to enable and to false to use the default log store type. The default log store is normally one file file per transaction log. It's alternative to journal based store. The server should be restarted for this setting to take effect.
      • Jdbc store datasource
        • Jndi name of non-XA datasource used. Datasource sghould be define in datasources subsystem. For this would work the non-XA datasource has to be marked as jta="false". The server should be restarted for this setting to take effect.
          ...the rest of the information is ok from my point of view

      Attachments

        Issue Links

          Activity

            People

              zfeng@redhat.com Zheng Feng
              ochaloup@redhat.com Ondrej Chaloupka (Inactive)
              Votes:
              1 Vote for this issue
              Watchers:
              5 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: