### Linux/UNIX Installation Output

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/project/general_procedures/operating_system_services.adoc

Example output showing the registration of recovery and transaction services in system run-level directories.

```text
Adding $JAVA_HOME (/opt/java) to $PATH in
/opt/arjuna/ats-3.2/services/bin/solaris/recoverymanagerservice.sh
Adding $JAVA_HOME (/opt/java) to $PATH in
/opt/arjuna/ats-3.2/services/bin/solaris/transactionserverservice.sh
Installing shutdown scripts into /etc/rcS.d:
K01recoverymanagerservice
K00transactionserverservice
Installing shutdown scripts into /etc/rc0.d:
K01recoverymanagerservice
K00transactionserverservice
Installing shutdown scripts into /etc/rc1.d:
K01recoverymanagerservice
K00transactionserverservice
Installing shutdown scripts into /etc/rc2.d:
K01recoverymanagerservice
K00transactionserverservice
Installing startup scripts into /etc/rc3.d:
S98recoverymanagerservice
S99transactionserverservice
```

--------------------------------

### Start Application Server Management CLI

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/product/development_guide/tools.adoc

Use this command to start the Management CLI on a non-Windows OS. Ensure you are in the application server's install directory.

```shell
./bin/jboss-cli.sh --connect controller=IP_ADDRESS
```

--------------------------------

### Execute Linux/UNIX Service Installer

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/project/general_procedures/operating_system_services.adoc

Run the installation script to configure start-up and shut-down scripts.

```shell
./install_service.sh
```

--------------------------------

### Start Narayana Hello Client

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/project/jts/trailmap.adoc

Execute this command to start the Hello Client. Ensure the CLASSPATH is set correctly.

```shell
java com.arjuna.demo.simple.HelloClient
```

--------------------------------

### Start Narayana Hello Server

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/project/jts/trailmap.adoc

Execute this command to start the Hello Server. Ensure the CLASSPATH is set correctly.

```shell
java com.arjuna.demo.simple.HelloServer
```

--------------------------------

### Start EchoServer

Source: https://github.com/jbosstm/narayana/blob/main/vertx/echo/README.md

Command to start the EchoServer using the build script. Ensure Vert.x is in your PATH and dependencies are downloaded.

```bash
./build.sh EchoServer.java &
```

--------------------------------

### Build and Run STM Vert.x Example

Source: https://github.com/jbosstm/narayana/blob/main/vertx/shared/README.md

Build the fat jar using Maven and run the example with specified properties. Ensure PROJECT_VERSION is set correctly.

```bash
mvn clean package
```

```bash
PROJECT_VERSION=<current version in pom> such as 5.4.1
java -jar target/stm-vertex-shared-${PROJECT_VERSION}.Final-SNAPSHOT-fat.jar -Dcom.arjuna.ats.arjuna.common.propertiesFile=jbossts-properties.xml
```

--------------------------------

### Initialize and Destroy ORB and OA

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/project/jts/trailmap.adoc

Example of creating an ORB instance, getting the root POA, initializing the ORB and OA, performing work, and then destroying the OA and shutting down the ORB. Ensure proper exception handling.

```Java
import com.arjuna.orbportability.ORB;
import com.arjuna.orbportability.OA;

public static void main(String[] args) {
    try {
        // Create an ORB instance
        ORB orb = ORB.getInstance("orb_test");
        OA oa = OA.getRootOA( orb );  // Get the root POA
        orb.initORB(args, null); // Initialize the ORB
        oa.initOA(args);  // Initialize the OA
        // Do Work
        oa.destroy(); // destroy the OA
        orb.shutdown();  // Shutdown the ORB
    } catch(Exception e) {

    }
};
```

--------------------------------

### STM Vert.x Example Output

Source: https://github.com/jbosstm/narayana/blob/main/vertx/shared/README.md

Example output when running the STM Vert.x integration. Observe the initialization of transactional services and Verticles.

```text
> Object name: 0:ffffc0a80011:d7f1:536e7c9b:0
> ARJUNA012163: Starting service com.arjuna.ats.arjuna.recovery.ActionStatusService on port 55282 
> ARJUNA012337: TransactionStatusManagerItem host: 127.0.0.1 port: 55282 
> ARJUNA012170: TransactionStatusManager started on port 55282 and host 127.0.0.1 with service com.arjuna.ats.arjuna.recovery.ActionStatusService 
> State value is: 11
> State value is: 12
> State value is: 13
> State value is: 14
> State value is: 15
> State value is: 16
> State value is: 17
> State value is: 18
> State value is: 19
> State value is: 20
> ClientVerticle initialised state: 20
> Succeeded in deploying verticle 
> SampleVerticle1 initialised state with: 21
> SampleVerticle1 SUCCEEDED!
```

--------------------------------

### Start Banking Application Server

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/project/jts/trailmap.adoc

Command to start the banking application server using the JTS TXOJ demo.

```shell
java com.arjuna.demo.jts.txojbank.BankServer
```

--------------------------------

### ORB Portability API Example

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/project/jts/trailmap.adoc

Example demonstrating the usage of the ORB Portability API to initialize and manage an ORB and OA instance.

```APIDOC
## ORB Portability API Example

### Description
This example illustrates how to use the ORB Portability API to create and initialize an ORB and its associated Object Adapter (OA).

### Method
N/A (Illustrative Example)

### Endpoint
N/A

### Request Example
```java
import com.arjuna.orbportability.ORB;
import com.arjuna.orbportability.OA;

public static void main(String[] args) {
    try {
        // Create an ORB instance
        ORB orb = ORB.getInstance("orb_test");
        OA oa = OA.getRootOA( orb );  // Get the root POA
        orb.initORB(args, null); // Initialize the ORB
        oa.initOA(args);  // Initialize the OA
        // Do Work
        oa.destroy(); // destroy the OA
        orb.shutdown();  // Shutdown the ORB
    } catch(Exception e) {

    }
};
```

### Response
N/A (Illustrative Example)
```

--------------------------------

### Start LogEditor for HornetQ Object Store

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/product/development_guide/tools.adoc

Configure and start the LogEditor for HornetQ object stores by specifying the store directory and adaptor class.

```shell
java -Dcom.arjuna.ats.internal.arjuna.objectstore.hornetq.HornetqJournalEnvironmentBean.storeDir="directory path" -Dcom.arjuna.ats.arjuna.common.ObjectStoreEnvironmentBean.objectStoreType="com.arjuna.ats.internal.arjuna.objectstore.hornetq.HornetqObjectStoreAdaptor"
```

--------------------------------

### Start Banking Application Client

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/project/jts/trailmap.adoc

Command to start the banking application client in a separate window.

```shell
java com.arjuna.demo.jts.txojbank.BankClient
```

--------------------------------

### Start EchoClient

Source: https://github.com/jbosstm/narayana/blob/main/vertx/echo/README.md

Command to start the EchoClient. This will demonstrate transactional data modification.

```bash
./build.sh EchoClient.java
```

--------------------------------

### Start the Recovery Manager

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/project/general_procedures/failure_recovery_administration.adoc

Use this command to start the standalone Recovery Manager process. Ensure the JAR file is in the classpath.

```shell
java com.arjuna.ats.arjuna.recovery.RecoveryManager
```

--------------------------------

### Start Recovery Manager with Test Flag

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/project/general_procedures/failure_recovery_administration.adoc

Starting the Recovery Manager with the -test flag will display a 'Ready' message upon initialization, useful for testing.

```shell
java com.arjuna.ats.arjuna.recovery.RecoveryManager -test
```

--------------------------------

### Recovery Manager Startup

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/project/jts/trailmap.adoc

Instructions on how to start the Narayana Recovery Manager process for crash recovery.

```APIDOC
## Recovery Manager Startup

### Description
The Recovery Manager is a daemon process responsible for performing crash recovery for transactions. It scans the Object Store for failed transactions and re-activates them to ensure consistent results.

### Method
N/A (Command Line)

### Endpoint
N/A

### Command
```shell
java com.arjuna.ats.arjuna.recovery.RecoveryManager
```

### Description
This command starts the Recovery Manager process. It will periodically scan the Object Store for transactions that may have failed and initiate recovery procedures.
```

--------------------------------

### Transactional JDBC Example

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/project/jta/examples.adoc

Demonstrates basic usage of the transactional JDBC driver provided by the product.

```java
include::{projectSourceDir}/jta/extras/jdbc_example.java[]
```

--------------------------------

### Implement 2PC Participant prepare method

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/product/xts_guide/xts_api.adoc

Example implementation of the prepare method for a 2PC participant.

```java
include::{productSourceDir}/xts_guide/extras/example-prepare-method.java[]
```

--------------------------------

### Transactional JDBC Driver Example

Source: https://context7.com/jbosstm/narayana/llms.txt

Shows how to use Narayana's transactional JDBC drivers to enlist database connections in JTA transactions. Ensure the correct driver prefix and properties are used for connection setup.

```java
import com.arjuna.ats.jdbc.TransactionalDriver;
import com.arjuna.ats.jta.UserTransaction;
import java.sql.*;
import java.util.Properties;

public class JDBCTransactionExample {
    public static void main(String[] args) {
        Connection conn = null;
        Statement stmt = null;

        try {
            // Register the transactional JDBC driver
            Class.forName("com.arjuna.ats.jdbc.TransactionalDriver");

            // Setup connection properties
            Properties dbProps = new Properties();
            dbProps.put(TransactionalDriver.userName, "dbuser");
            dbProps.put(TransactionalDriver.password, "dbpassword");
            // For dynamic class instantiation (alternative to JNDI)
            dbProps.put(TransactionalDriver.dynamicClass,
                "com.arjuna.ats.internal.jdbc.drivers.PropertyFileDynamicClass");

            // Connect using the transactional driver prefix "jdbc:arjuna:"
            // The driver wraps your actual JDBC connection for XA support
            conn = DriverManager.getConnection(
                "jdbc:arjuna:jdbc:postgresql://localhost:5432/mydb", dbProps);

            // Begin JTA transaction
            UserTransaction utx = com.arjuna.ats.jta.UserTransaction.userTransaction();
            utx.begin();

            // Create statement - automatically enlisted in transaction
            stmt = conn.createStatement();

            // Execute transactional operations
            stmt.executeUpdate("INSERT INTO accounts (id, balance) VALUES (1, 1000)");
            stmt.executeUpdate("INSERT INTO accounts (id, balance) VALUES (2, 500)");

            // Transfer funds - atomic operation
            stmt.executeUpdate("UPDATE accounts SET balance = balance - 100 WHERE id = 1");
            stmt.executeUpdate("UPDATE accounts SET balance = balance + 100 WHERE id = 2");

            // Query within transaction sees uncommitted changes
            ResultSet rs = stmt.executeQuery("SELECT * FROM accounts");
            while (rs.next()) {
                System.out.println("Account " + rs.getInt("id") +
                    ": $" + rs.getInt("balance"));
            }

            // Commit - all database changes are made permanent atomically
            utx.commit();

        } catch (Exception e) {
            try {
                // Rollback on error - all changes are undone
                com.arjuna.ats.jta.UserTransaction.userTransaction().rollback();
            } catch (Exception ex) {
                ex.printStackTrace();
            }
            e.printStackTrace();
        } finally {
            try {
                if (stmt != null) stmt.close();
                if (conn != null) conn.close();
            } catch (SQLException e) {
                e.printStackTrace();
            }
        }
    }
}
```

--------------------------------

### Account Creation Execution Output

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/project/jts/trailmap.adoc

Example output showing the creation of a new account and the application of the one-phase commit optimization.

```shell
Your choice : 1
- Create a new account -
------------------------
Name : Foo
Initial balance : 1000
Beginning a User transaction to create account
[ Connected to 192.168.0.2:4799 from local port 4924 ]
Attempt to commit the account creation transaction
/[ Resource for Foo : Commit one phase ]
```

--------------------------------

### Configure Byteman Agent for Scripts

Source: https://github.com/jbosstm/narayana/blob/main/XTS/localjunit/xtstest/README.md

Configures the Byteman agent by supplying the relevant script file path as a command-line option to the JVM when starting the AS. `${BYTEMAN_HOME}` should point to the Byteman installation directory, and `${JBOSSTS_ROOT}` to the Narayana source tree root.

```bash
export JAVA_OPTS="$JAVA_OPTS -javaagent:${BYTEMAN_HOME}/lib/byteman.jar=script:${JBOSSTS_ROOT}/XTS/trunk/sar/tests/dd/scripts/<script>"
```

--------------------------------

### Build Documentation Website

Source: https://github.com/jbosstm/narayana/blob/main/docs/README.md

Use this command to build the HTML website from the documentation source. The output will be located in the ./target/html folder.

```shell
mvn clean generate-resources
```

--------------------------------

### Install JDBC drivers

Source: https://github.com/jbosstm/narayana/blob/main/qa/README.txt

Command to install required JDBC drivers for database-related tests.

```bash
cd qa && mvn install
```

--------------------------------

### Configure ORB Initialization Properties

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/project/jts/orb_portability_api.adoc

Example of setting pre and post-initialization routines via system properties when launching a Java application.

```shell
java –DorbPortabilityEnvironmentBean.orbInitializationProperties=”com..orbportability.orb.PreInit=org.foo.AllORBPreInit
  com..orbportability.orb.MyORB.PostInit=org.foo.MyOrbPostInit
  com..orbportability.oa.PostInit=orb.foo.AllOAPostInit” org.foo.MyMainClass
```

--------------------------------

### Implement Bank Server

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/project/jts/trailmap.adoc

Sets up the BankServer to initialize the ORB and Object Adapter, then publishes the Bank object reference.

```Java
public class BankServer {
    public static void main(String[] args) {
        ORB myORB = null;
        RootOA myOA = null;
        try {
            myORB = ORB.getInstance("ServerSide");
            myOA = OA.getRootOA(myORB);
            myORB.initORB(args, null);
            myOA.initOA();
            ....
            BankImpl bank = new BankImpl(myOA);

            String reference = myORB.orb().
                    object_to_string(myOA.corbaReference(bank));
            //Store the Object reference in the file
            ...
            System.out.println("The bank server is now ready...");
            myOA.run();
        }
    }
}
```

--------------------------------

### JTS/OTS Recovery Activator Example

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/project/jts/trailmap.adoc

Example of a RecoveryActivator configuration for JTS/OTS, specifying the 'RecoveryEnablement' class.

```xml
<property
    name="com.arjuna.ats.arjuna.recovery.recoveryActivator_1"
    value="com.arjuna.ats.internal.jts.
        orbspecific.recovery.RecoveryEnablement"/>
```

--------------------------------

### Implement Object Store with StateManager

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/project/core/using_txcore.adoc

Example demonstrating the basic structure for implementing an object store using the StateManager class.

```java
include::{projectSourceDir}/core/extras/object_store_implementation_using_StateManager.java[]
```

--------------------------------

### Run Distributed Transaction Demos

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/project/jts/trailmap.adoc

Commands to start bank server and client applications for testing implicit and explicit propagation contexts.

```shell
java com.arjuna.demo.jts.remotebank.BankServer
```

```shell
java com.arjuna.demo.jts.remotebank.BankClient
```

```shell
java com.arjuna.demo.jts.explicitremotebank.BankServer
```

```shell
java com.arjuna.demo.jts.explicitremotebank.BankClient
```

--------------------------------

### Download Vert.x and Dependencies

Source: https://github.com/jbosstm/narayana/blob/main/vertx/echo/README.md

Steps to download Vert.x and its dependencies using wget and maven.

```bash
wget https://bintray.com/artifact/download/vertx/downloads/vert.x-3.3.3.zip
unzip vert.x-3.3.3.zip
export PATH=./vertx/bin:$PATH
```

```bash
mvn clean dependency:copy-dependencies
```

--------------------------------

### Get MBean Attributes

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/product/development_guide/tools.adoc

This Java code snippet shows how to retrieve the MBeanInfo for an ObjectInstance and then get the attribute names.

```java
// lookup the attribute names of an ObjectInstance
MBeanInfo info = mbs.getMBeanInfo( oi.getObjectName() );
MBeanAttributeInfo[] attributeArray = info.getAttributes();
```

--------------------------------

### Synchronize Configuration Files

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/project/jts/trailmap.adoc

Example command to copy the CosServices configuration file from a primary host to a secondary host.

```shell
scp user @ host1:<ats_root>/etc/CosServices.cfg <host2_ats_root>/etc/
```

--------------------------------

### Run Banking Application Clients

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/project/jts/trailmap.adoc

Commands to start banking clients for implicit and explicit propagation contexts.

```shell
java com.arjuna.demo.jts.remotebank.BankClient
```

```shell
java com.arjuna.demo.jts.explicitremotebank.BankClient
```

--------------------------------

### XML Property Entry Example

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/product/development_guide/configuration_options.adoc

An example of an XML property entry for setting the commitOnePhase property in the CoordinatorEnvironmentBean. Boolean properties are case-insensitive.

```xml
<entry key="CoordinatorEnvironmentBean.commitOnePhase">YES</entry>
```

--------------------------------

### Initialize ORB and OA

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/project/jts/trailmap.adoc

Basic setup for the ORB and Object Adapter using the ORB Portability API.

```Java
myORB = ORB.getInstance("ServerSide");
myOA = OA.getRootOA(myORB);
myORB.initORB(args, null);
myOA.initOA();
```

--------------------------------

### Start Recovery Manager

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/project/core/failure_recovery.adoc

Use this command to start the standalone Recovery Manager process. The -test flag can be used to display an initialization message.

```shell
java com.arjuna.ats.arjuna.recovery.RecoveryManager
```

```shell
java com.arjuna.ats.arjuna.recovery.RecoveryManager -test
```

--------------------------------

### Transactional Implementation Setup

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/project/jts/example.adoc

Sets up the transactional context and registers a resource. This code obtains the transaction coordinator and registers a DemoResource as a participant.

```java
package com.arjuna.jts.extras;

import com.arjuna.ats.jta.common.jtaPropertyManager;
import com.arjuna.ats.jta.utils.jtaUtils;
import javax.transaction.TransactionManager;
import javax.transaction.xa.XAResource;
import javax.transaction.xa.Xid;

public class TransactionalImplementation
{
    public static void main (String[] args)
    {
        try
        {
            TransactionManager tm = jtaUtils.getTransactionManager();
            
            // Obtain a Control object
            com.arjuna.ats.jta.interfaces.Control control = jtaUtils.getControl();
            
            // Obtain a Coordinator object
            com.arjuna.ats.jta.interfaces.Coordinator coordinator = control.getCoordinator();
            
            // Create a resource for the transaction
            DemoResource resource = new DemoResource("MyResource");
            
            // Inform the ORB that the resource is ready
            resource.prepare();
            
            // Register the DemoResource object as a participant
            coordinator.registerResource(resource);
            
            System.out.println("DemoResource registered.");
        }
        catch (Exception e)
        {
            e.printStackTrace();
        }
    }
}

```

--------------------------------

### Start JBoss EAP with XTS Enabled

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/product/txbridge_guide/using_the_transaction_bridge.adoc

Commands to start the application server using the XTS configuration file on Linux and Windows platforms.

```bash
bin/standalone.sh --server-config=standalone-xts.xml
```

```bash
bin\standalone.bat --server-config=standalone-xts.xml
```

--------------------------------

### DemoServer Implementation

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/project/jts/example.adoc

Initializes the ORB and POA, instantiates and binds a servant object, and registers the service. This server is ready to accept client requests.

```java
package com.arjuna.jts.extras;

import org.omg.CORBA.ORB;
import org.omg.PortableServer.POA;
import org.omg.PortableServer.Servant;
import org.omg.CosNaming.NameComponent;
import org.omg.CosNaming.NamingContextExt;
import org.omg.CosNaming.NamingContextExtHelper;

public class DemoServer
{
    public static void main (String[] args)
    {
        try
        {
            // Initialize the ORB and the POA
            ORB orb = ORB.init(args, null);
            POA rootPOA = (POA) orb.resolve_initial_references("RootPOA");
            rootPOA.the_POAManager().activate();

            // Instantiate a servant object
            DemoImplementation servant = new DemoImplementation();
            servant._this_object(orb, rootPOA);

            // Connect the servant to the POA
            rootPOA.set_servant(servant);

            // Register the service through the default naming mechanism
            NamingContextExt nc = NamingContextExtHelper.narrow(orb.resolve_initial_references("NameService"));
            NameComponent path[] = NamingContextExtHelper.to_name("DemoService");
            nc.rebind(path, servant._this_object());

            System.out.println("Sanity check: DemoServer is running.");

            // Accept requests from client processes
            orb.run();
        }
        catch (Exception e)
        {
            e.printStackTrace();
        }
    }
}

```

--------------------------------

### Array Class Example

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/project/core/using_txcore.adoc

An example illustrating saving and restoring of an object's state using a basic Array class derived from StateManager.

```APIDOC
## Array Class Example

### Description
This example demonstrates how to implement `save_state` and `restore_state` for an `Array` class derived from `StateManager`, using the `highestIndex` variable to track the highest non-zero element.

### Method
N/A

### Endpoint
N/A

### Parameters
N/A

### Request Example
```java
// Include content from core/extras/Array_class.java
```

### Response
N/A
```

--------------------------------

### Run Banking Application Servers

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/project/jts/trailmap.adoc

Commands to start banking servers for implicit and explicit propagation contexts.

```shell
java com.arjuna.demo.jts.remotebank.BankServer
```

```shell
java com.arjuna.demo.jts.explicitremotebank.BankServer
```

--------------------------------

### XML Datasource Configuration Example

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/product/failure_recovery/architecture_of_the_recovery_manager.adoc

Example XML configuration for an XA datasource, used by implementations like BasicXARecovery to drive resource recovery.

```xml
include::{productSourceDir}/failure_recovery/extras/xmlDatasource.xml[]
```

--------------------------------

### Start Recovery Manager from Command Line

Source: https://context7.com/jbosstm/narayana/llms.txt

Launches the standalone Narayana Recovery Manager process. Specify the object store directory using a system property. The -test flag shows an initialization message.

```bash
# Start standalone Recovery Manager from command line
java -DObjectStoreEnvironmentBean.objectStoreDir=/var/narayana/ObjectStore \
     com.arjuna.ats.arjuna.recovery.RecoveryManager
```

```bash
# With test flag to show "Ready" message when initialized
java com.arjuna.ats.arjuna.recovery.RecoveryManager -test
```

```bash
# Trigger recovery scan via RecoveryMonitor
java com.arjuna.ats.arjuna.tools.RecoveryMonitor -verbose -port 4712
```

--------------------------------

### Trigger Rendezvous on Bottom-Up Recovery Start

Source: https://github.com/jbosstm/narayana/blob/main/ArjunaJTA/jta/tests/byteman-scripts/recovery-helper.txt

Signals the 'bottomUpRecovery' rendezvous when the recovery process begins. This rule ensures that other threads waiting for recovery to start are notified.

```java
RULE bottomUpRecovery trigger rendezvous
CLASS com.arjuna.ats.internal.jta.recovery.arjunacore.XARecoveryModule
METHOD bottomUpRecovery
AT ENTRY
IF TRUE
DO debug("Recovery Helper: bottomUpRecovery trigger rendezvous"),
   signalWake("bottomUpRecovery", true),
   debug("Recovery Helper: bottomUpRecovery rendezvous triggered")
ENDRULE
```

--------------------------------

### STM Lock Exception Example

Source: https://github.com/jbosstm/narayana/blob/main/vertx/shared/README.md

Example output showing a LockException when a thread cannot acquire a WRITE lock. This indicates a concurrency conflict within the STM system.

```text
> org.jboss.stm.LockException: Thread[vert.x-eventloop-thread-3,5,main] could not set LockMode.WRITE lock. Got: LockResult.REFUSED
> 	at org.jboss.stm.internal.reflect.InvocationHandler.invoke(InvocationHandler.java:344)
> 	at $Proxy13.increment(Unknown Source)
> 	at SampleVerticle1.start(SampleVerticle1.java:43)
> 	at org.vertx.java.platform.Verticle.start(Verticle.java:82)
> 	at org.vertx.java.platform.impl.DefaultPlatformManager$19.run(DefaultPlatformManager.java:1550)
> 	at org.vertx.java.core.impl.DefaultContext$3.run(DefaultContext.java:176)
> 	at io.netty.util.concurrent.SingleThreadEventExecutor.runAllTasks(SingleThreadEventExecutor.java:354)
> 	at io.netty.channel.nio.NioEventLoop.run(NioEventLoop.java:353)
> 	at io.netty.util.concurrent.SingleThreadEventExecutor$2.run(SingleThreadEventExecutor.java:101)
> 	at java.lang.Thread.run(Thread.java:722)
```

--------------------------------

### Implement Bank Server in Java

Source: https://github.com/jbosstm/narayana/blob/main/docs/src/main/asciidoc/project/jts/trailmap.adoc

Initializes the ORB and Object Adapter, then registers the BankImpl object for client access.

```Java
public class BankServer {
    public static void main(String[] args) {
        ORB myORB = null;
        RootOA myOA = null;
        try {
            myORB = ORB.getInstance("ServerSide");
            myOA = OA.getRootOA(myORB);
            myORB.initORB(args, null);
            myOA.initOA();
            ....
            BankImpl bank = new BankImpl(myOA);

            String reference = myORB.orb().
                    object_to_string(myOA.corbaReference(bank));
            //Store the Object reference in the file
            ...

            System.out.println("The bank server is now ready...");
            myOA.run();
        }
    }
}
```

--------------------------------

### Start Recovery Manager in Java

Source: https://context7.com/jbosstm/narayana/llms.txt

Starts the Narayana Recovery Manager in indirect management mode for periodic or manual recovery scans. Ensure necessary imports are included.

```java
import com.arjuna.ats.arjuna.recovery.RecoveryManager;
import com.arjuna.ats.arjuna.recovery.RecoveryModule;

public class RecoveryManagerExample {
    public static void main(String[] args) {
        // Start recovery manager in INDIRECT_MANAGEMENT mode
        // (runs periodically, can also be triggered manually)
        RecoveryManager recoveryManager =
            RecoveryManager.manager(RecoveryManager.INDIRECT_MANAGEMENT);

        // Trigger an immediate synchronous recovery scan
        recoveryManager.scan();

        System.out.println("Recovery scan completed");

        // For DIRECT_MANAGEMENT mode (manual control only):
        // RecoveryManager directManager =
        //     RecoveryManager.manager(RecoveryManager.DIRECT_MANAGEMENT);
        // directManager.scan(); // Must be called explicitly

        // Graceful shutdown
        recoveryManager.terminate();
    }
}
```

--------------------------------

### STM Lock Store Error Example

Source: https://github.com/jbosstm/narayana/blob/main/vertx/shared/README.md

Example output showing LockStoreException related to persistent store errors and lock state management. This may occur during concurrent operations or recovery.

```text
> ARJUNA015027: LockManager::unloadState() failed to remove empty lock state for object 0:ffffc0a80011:d7e7:536e7b4c:0 of type /StateManager/LockManager/SampleLockable 
> ARJUNA015037: Lockmanager::releaselock() could not unload new lock states 
> ARJUNA015037: Lockmanager::releaselock() could not unload new lock states 
> ARJUNA012267: ShadowingStore.remove_state() - fd error for 0:ffffc0a80011:d7e7:536e7b4c:0 
> ARJUNA012267: ShadowingStore.remove_state() - fd error for 0:ffffc0a80011:d7e7:536e7b4c:0 
> ARJUNA015027: LockManager::unloadState() failed to remove empty lock state for object 0:ffffc0a80011:d7e7:536e7b4c:0 of type /StateManager/LockManager/SampleLockable 
```