The administrator tool in the karaf with narayana transaction manager integration

[zhfeng]

Hi,

we had integrated the narayana in the karaf 4.1.0-SNAPSHOT and it looks like we need the admin tool to manage the transactions such as we do in the wildfly.

First, the current functionality can be found in the Narayana Product Documentation

1. refresh the log store
2. view all prepared transactions
3. view the transaction attributes and participants
4. delete the transaction
5. recovery the transaction

I suppose to support these with the karaf shell commands and is there any other idea about this admin tool ?

Thanks,

Amos

[tomjenkinson]

I think we need some information on how to resolve heuristics. I think mmusgrov will have some input here.

[mmusgrov]

I have a prototype command line based equivalent of what is provided by the wildfly/EAP console. I could dust that off and add it as a quickstart and then the Karaf community can evaluate it.

[ochaloup]

I have to say that such tool would be quite useful for me as well.

[mmusgrov]

I have added [JBTM-2646] Include a quickstart showing a command line equivalent of the wildfly transaction console - JBoss Issue Trac…

[mmusgrov]

Also note that we provided tooling for transaction logs via JMX. The details are in the INSTALL notes for the standalone product (narayana/narayana-full at master · jbosstm/narayana · GitHub)

[zhfeng]

Thanks Mike, it looks great !

[tomjenkinson]

It's worth to point out though that all the API calls should be available from MBeans already. Is there a link to the MBeans that Amos can use? The CLI you propose might be a useful addition but would likely not be compatible with Karaf shell anyway.

[mmusgrov]

What do you mean by the API calls should be available from MBeans already?

Can you explain what you mean by compatible?

The way it works is that you create an instance of ObjStoreBrowser and give it a reference to a transaction log and then call probe on it which will create MBeans for each log it finds. Now make JMX calls to these MBeans to perform various management operations.

The prototype is pretty lightweight (300 lines of java). If anyone wants a preview its here:

[Edit:I have pushed my pending changes (accepts commands from the command line, from a file or interactively) - the new link is quickstart-1/BrowserCommand.java at JBTM-2238 · mmusgrov/quickstart-1 · GitHub]

[tomjenkinson]

What I am saying is that the standalone CLI is not a pre-requisite to Amos' original requirement but would be used to show him how to interface with the mbeans so of course is helpful.

Amos' given the prototype do you have enough to go on to create the JBTM and go ahead and implement this now?

[mmusgrov]

zhfeng I updated the BrowserCommand.java with my recent changes to accept commands from a variety of sources. I haven't had a chance to progress the work but do let me know if you have questions.

Example 1: read commands from standard input:

java -jar target/tooling-5.0.3.Final-SNAPSHOT-jar-with-dependencies.jar -c "store_dir /home/mmusgrov/source/forks/narayana/master/ArjunaJTS/jtax/target/test-classes/ObjectStore"

Example 2: read commands from a file:

java -jar target/tooling-5.0.3.Final-SNAPSHOT-jar-with-dependencies.jar -f  commands.txt

> cat commands

store_dir /home/mmusgrov/source/forks/narayana/master/ArjunaJTS/jtax/target/test-classes/ObjectStore

select StateManager/BasicAction/TwoPhaseCoordinator/ArjunaTransactionImple

ls

quit

Example 3: read commands from the java command line (each occurrence of -c <cmd> corresponds to a command):

java -jar target/tooling-5.0.3.Final-SNAPSHOT-jar-with-dependencies.jar -c "store_dir /home/mmusgrov/source/forks/narayana/master/ArjunaJTS/jtax/target/test-classes/ObjectStore" -c "select StateManager/BasicAction/TwoPhaseCoordinator/ArjunaTransactionImple" -c "ls" -c quit

[zhfeng]

Thanks Mike, I will try to see if it works with the karaf shell.

[zhfeng]

The related issue is [JBTM-2624] Introduce the administrator tool in the Narayana JTA OSGi integrated with the Karaf - JBoss Issue Tracker

the current commands is

1. narayana:probe  - Refresh the view of the object store
2. narayana:ls  [type] - List the transactions
3. narayana:type - List the types of records
4. narayana:delete <uid> - delete the transaction

[mmusgrov]

d

1. narayana:probe  - Refresh the view of the object store

A slightly more meaningful name would be narayana:refresh instead of probe

[zhfeng]

I agree and had updated the PR JBTM-2624 Update to support the admin commands in the karaf shell by zhfeng · Pull Request #1020 · jbosstm/narayana · Gi…