The list-active-transactions
task lists all the existing active transactions of a specified Record Store instance.
Uncommitted transactions are often the result of an unexpected termination of a crawl or other write operation. In this case, you see an error in the log file that includes the ID of the uncommitted transaction.
The syntax for this task is:
recordstore-cmd list-active-transactions -a RecordStoreInstanceName [-h HostName] [-l true|false] [-p PortNumber]
where:
-a (or --instanceName) specifies the name of a Record Store instance. Required.
-h (or --host) specifies the host where the CAS Service is running. If the flag is omitted, the default is the value of the
com.endeca.itl.cas.server.host
property incommandline.properties
. If the property is not set, the value then defaults to localhost. Optional.-l (or --isPortSsl) specifies whether to communicate with the service using an HTTPS connection. A value of true uses HTTPS and treats the
com.endeca.itl.cas.server.port
property as an SSL port. A value of false uses HTTP and treatscom.endeca.itl.cas.server.port
as a non-SSL port. Specify false if you enabled redirects from a non-SSL port to an SSL port. Optional.-p (or --port) specifies the port of the CAS Service. If the flag is omitted, the default is the value of the
com.endeca.itl.cas.server.port
property incommandline.properties
. If the property is not set, the value then defaults to 8500. Optional.
The task output consists of these fields:
TYPE
- the transaction type, which is READ (which supports only Read operations) or READ_WRITE (which supports both Read and Write operations).STATUS
- the status of the transaction, which is ACTIVE (the transaction is in progress), COMMITTED (the transaction has been committed), COMMIT_FAILED (the commit task failed for this transaction), or ROLLED_BACK (the transaction was rolled back).WRITING_GEN
- either the new generation ID (for READ_WRITE types) or N/A (for READ types, because a new generation is not being written).LAST_COMMITTED
- the generation ID of the last committed generation.
If no transactions are active, this message is displayed:
There are no active transactions right now.
Example 35. Example of listing active transactions
If there are active transactions, the output of this command:
recordstore-cmd list-active-transactions -a RS1
will be similar to this example:
ID TYPE STATUS WRITING_GEN LAST_COMMITTED_GEN 13 READ ACTIVE N/A 2 14 READ_WRITE ACTIVE 3 2