2.22.1 recover-transactions

Synopsis

asadmin [asadmin-options] recover-transactions [--help]
    [--transactionlogdir transaction_log_dir]
    [--target target] server_name

Storage location

Application Server installation directory/javaee/glassfish/bin

Function

The recover-transactions subcommand of asadmin recovers transactions after a server failure. For an installation of multiple server instances, you can run the recover-transactions command from a surviving server instance. To use this command, the following conditions must be met:

• Delegated transaction recovery is disabled.

• Transaction logs are stored on a shared file system or a database that is accessible to all the server instances.

For a stand-alone server, do not use this command to recover transactions after a server failure.

This subcommand is supported in remote mode only.

For a stand-alone server, the recover-transactions command can recover transactions only when a resource fails, but the server still running.

Precondition

Domain Administration Server (DAS) is running.

For an installation of multiple server instances, you can run the recover-transactions command from a surviving server instance to recover transactions after a server failure. To use this command in this way, the following conditions must be met:

• Delegated transaction recovery is disabled.

• Transaction logs are stored on a shared file system or a database that is accessible to all the server instances.

Arguments

--help | -?

Displays the help text for the subcommand.

--transactionlogdir transaction_log_dir

Specifies the location of the transaction logs for a server for which the transaction recovery is requested. This option applies only if transaction logs are stored on a shared file system.

Type: String

The following values can be specified:

• Location of the logs

Default value: N/A

--target target

Specifies the target server that performs the recovery for the server, which is specified by the server_name operand.

Type: String

The following values can be specified:

• Name of the target server instance

Default value: N/A

server_name

Specifies the value of this operand, which is typically server. This is for a stand-alone server. If this server is running, recovery is performed by the same server. In this situation, the --transactionlogdir and --target options must be omitted. If the server is not running, the --target option is required, and the --transactionlogdir option is also required if transaction logs are stored on a shared file system.

Type: String

The following values can be specified:

• Name of the server instance

Default value:

• For a stand-alone server, the value of this operand is typically server.

• For an installation of multiple server instances, the value of this operand is the name of the server for which the recovery is required.

asadmin recover-transactions --transactionlogdir /logs/tx
--target server1 server2

Exit Status

Exit Status	Explanation
0	subcommand executed successfully.
1	error in executing the subcommand.