]
Heiko Braun commented on WFLY-5613:
-----------------------------------
These texts are pulled from the management model and need to be changed there. hence I
move the issue over to wildfly
Fix transaction subsystem resource descriptions
-----------------------------------------------
Key: WFLY-5613
URL:
https://issues.jboss.org/browse/WFLY-5613
Project: WildFly
Issue Type: Enhancement
Components: Domain Management, Transactions
Reporter: Ondřej Chaloupka
Assignee: Heiko Braun
Attachments: jts-tooltip-700.DR132.png
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
{noformat}
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.
{noformat}
{noformat}
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'.
{noformat}
{noformat}
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.
{noformat}
{noformat}
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.
{noformat}
{noformat}
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.
{noformat}
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