Check available memory

If you are running out of memory, you see the following error message:

java.lang.OutOfMemoryError

When you are running out of memory, either the Mirror Replication Agent drops out of Replicating state or the entire Mirror Replication Agent server stops executing.

To support adjusting the amount of memory available to the JRE, all of the executable scripts (or batch files) in the Mirror Replication Agent bin directory refer to an environment variable named RA_JAVA_MAX_MEM. All Mirror Replication Agent instance RUN scripts also reference the RA_JAVA_MAX_MEM environment variable.

To adjust the amount of memory available to the JRE, do one of the following:

Set the value of a system variable named RA_JAVA_MAX_MEM in your environment and use the ra utility to start the Mirror Replication Agent instance, or
Set the value of the RA_JAVA_MAX_MEM variable in the Mirror Replication Agent instance RUN script and use the RUN script to start the Mirror Replication Agent instance.

If you start a Mirror Replication Agent instance by invoking the ra utility, you can set the value of the RA_JAVA_MAX_MEM system variable in your environment to specify the amount of memory available to the JRE. Before it sets the RA_JAVA_MAX_MEM variable to a default value, the ra and ra_admin utilities check to see if it is already set.

If you start a Mirror Replication Agent instance by invoking the instance RUN script (or batch file), you can edit the instance RUN script to change the default value of RA_JAVA_MAX_MEM and specify the amount of memory available to the JRE.

When a Mirror Replication Agent instance is started with the instance RUN script, the value of the RA_JAVA_MAX_MEM variable specified in the RUN script overrides the value set elsewhere. Therefore, you can edit the RUN script to adjust the memory available to the JRE for each instance.

Debugging LTL

LTL (Log Transfer Language) is the syntax used to communicate or distribute replication data to Replication Server. It is the principle output from a Mirror Replication Agent. For more details about LTL syntax, see the Replication Server Design Guide.

To debug LTL

Log in to the running Mirror Replication Agent instance using the administrator login.
Verify that the Mirror Replication Agent instance is in Admin state:
```
ra_status
```
Set the values of the following Mirror Replication Agent configuration parameters for the primary database:
```
ra_config LITTRACELTL, true
```
Change the Mirror Replication Agent state to Replicating:
```
resume
```
When new replication activity is generated, check the LTITRACELTL.log file in the log directory to debug your problem.

Uncompressing LTL for debugging a problem

By default, the LTL generated by the Mirror Replication Agent is compressed to reduce the amount of data sent to Replication Server, reducing network bandwidth. In cases where you require more verbose output to help debug a problem, change the following configuration parameters to produce more verbose LTL.

To produce more verbose LTL

Log in to the running Mirror Replication Agent instance using the administrator login.
Verify that the Mirror Replication Agent instance is in Admin state:
```
ra_status
```
Set the values of the following Mirror Replication Agent configuration parameters for the primary database:

ra_config column_compression = false

ra_config compress_ltl_syntax = false

ra_config structured_tokens = false
When new replication activity is generated, check the LTITRACELTL.log file in the log directory to debug your problem.