Package org.bonitasoft.engine.tenant.restart

Class RecoveryService

java.lang.Object

org.bonitasoft.engine.tenant.restart.RecoveryService

@Component
public class RecoveryService
extends Object

Responsible to recover from incidents like database or network outage. It scans the database (on-demand) and reschedules the elements to recover. It will recover these elements using multiple transaction using a batch size configured by the property `bonita.tenant.work.batch_restart_size`

Field Summary

Fields

Modifier and Type	Field	Description
static final String	DURATION_OF_RECOVERY_TASK
static final String	NUMBER_OF_ELEMENTS_RECOVERED_LAST_RECOVERY
static final String	NUMBER_OF_ELEMENTS_RECOVERED_TOTAL
static final String	NUMBER_OF_RECOVERY

Constructor Summary

Constructors

Constructor

Description

RecoveryService(FlowNodeInstanceService flowNodeInstanceService, ProcessInstanceService processInstanceService, UserTransactionService userTransactionService, FlowNodesRecover flowNodesRecover, ProcessesRecover processesRecover, org.springframework.beans.factory.ObjectFactory<org.bonitasoft.engine.tenant.restart.RecoveryMonitor> recoveryMonitorProvider, io.micrometer.core.instrument.MeterRegistry meterRegistry)

Method Summary

Modifier and Type	Method	Description
protected void	executeInBatch(org.bonitasoft.engine.tenant.restart.RecoveryMonitor recoveryMonitor, List<ElementToRecover> elements, org.bonitasoft.engine.tenant.restart.RecoveryService.BatchExecution execution)
List<ElementToRecover>	getAllElementsToRecover(Duration considerElementsOlderThan)	Retrieve elements ( ProcessInstance and Flow Nodes ) that needs to be recovered and that are older than the given duration.
protected void	initMetrics()
void	recover(List<ElementToRecover> elementsToRecover)	Trigger works to execute elements ( ProcessInstance and Flow Nodes ) that needs to be recovered
void	recoverAllElements()	Recover all elements considered as "stuck".
void	setBatchRestartSize(int batchRestartSize)
void	setConsiderElementsOlderThan(String considerElementsOlderThan)
void	setReadBatchSize(int readBatchSize)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

DURATION_OF_RECOVERY_TASK

public static final String DURATION_OF_RECOVERY_TASK

See Also:

• Constant Field Values

NUMBER_OF_RECOVERY

public static final String NUMBER_OF_RECOVERY

See Also:

• Constant Field Values

NUMBER_OF_ELEMENTS_RECOVERED_LAST_RECOVERY

public static final String NUMBER_OF_ELEMENTS_RECOVERED_LAST_RECOVERY

See Also:

• Constant Field Values

NUMBER_OF_ELEMENTS_RECOVERED_TOTAL

public static final String NUMBER_OF_ELEMENTS_RECOVERED_TOTAL

See Also:

• Constant Field Values

Constructor Details

RecoveryService

public RecoveryService(FlowNodeInstanceService flowNodeInstanceService,
 ProcessInstanceService processInstanceService,
 UserTransactionService userTransactionService,
 FlowNodesRecover flowNodesRecover,
 ProcessesRecover processesRecover,
 org.springframework.beans.factory.ObjectFactory<org.bonitasoft.engine.tenant.restart.RecoveryMonitor> recoveryMonitorProvider,
 io.micrometer.core.instrument.MeterRegistry meterRegistry)

Method Details

initMetrics

@PostConstruct
protected void initMetrics()

setReadBatchSize

@Value("${bonita.tenant.recover.read_batch_size:5000}")
public void setReadBatchSize(int readBatchSize)

setConsiderElementsOlderThan

@Value("${bonita.tenant.recover.consider_elements_older_than:PT1H}")
public void setConsiderElementsOlderThan(String considerElementsOlderThan)

setBatchRestartSize

@Value("${bonita.tenant.work.batch_restart_size:1000}")
public void setBatchRestartSize(int batchRestartSize)

getAllElementsToRecover

public List<ElementToRecover> getAllElementsToRecover(Duration considerElementsOlderThan)

Retrieve elements ( ProcessInstance and Flow Nodes ) that needs to be recovered and that are older than the given duration.

Parameters:

considerElementsOlderThan - consider elements older than that duration

Returns:

elements to be recovered

recover

public void recover(List<ElementToRecover> elementsToRecover)

Trigger works to execute elements ( ProcessInstance and Flow Nodes ) that needs to be recovered

Parameters:

elementsToRecover - elements needs to be recovered

executeInBatch

protected void executeInBatch(org.bonitasoft.engine.tenant.restart.RecoveryMonitor recoveryMonitor,
 List<ElementToRecover> elements,
 org.bonitasoft.engine.tenant.restart.RecoveryService.BatchExecution execution)

recoverAllElements

public void recoverAllElements()

Recover all elements considered as "stuck". Only recover elements older than a duration configured with setConsiderElementsOlderThan(String).