Managing System Recovery

Edit online

Sterling B2B Integrator is designed to automatically reset itself to a previous, stable state after a system crash. After the reset is complete, the system is up and operational.

About this task

After a system crash, restore the server on which Sterling B2B Integrator is installed to a stable state, and then restart Sterling B2B Integrator. After it is restarted, the system invokes the Recovery business process to search for and requeue any unprocessed transactions. If the database goes down, Sterling B2B Integrator stops pulling jobs from queues. The system recovers these jobs when the database becomes available.

Sterling B2B Integrator uses multithread operation to restart or resume business processes following a system crash. Unfinished business processes, up to a preconfigured number, are stored in a pool. Each of the preconfigured number of threads receive a batch of business processes to restart or resume. The size of the batch is also preconfigured. When a thread finishes restarting or resuming a batch of business processes, it requests another batch from the pool. This cycle continues until the pool is empty.

By default, the system uses 10 threads, each of which resumes or restarts 10 business processes, and then requests and processes another 10, up to a total of 1000 business processes for all threads. You can configure the system settings to adjust recovery performance according to your business requirements.

To configure the system recovery process settings, perform the following actions:

Procedure

  1. In the install_dir/properties directory, locate (or create, if necessary) the customer_overrides.properties file.
  2. Open the customer_overrides.properties file using a text editor.
  3. Add override statements as required, using the following format for each new line:
    bprecovery.property=new_value
    These statements will override the property settings in the bprecovery.properties file. The applicable properties are described in the following table:
    Property Description
    maxAutorecoveryCount

    Maximum number of business processes that will be resumed or restarted by the Recovery business process each time it runs. Default is 1000.

    This defines the maximum size of the pool used to hold the business processes that have to be resumed or restarted. Each time a thread requests a batch of business processes to restart or resume, the pool size is reduced by the size of the batch (specified by the batchSize property).
    numberOfThreads

    Number of threads that will be used simultaneously to restart or resume business processes. Default is 10.

    Each thread will start or resume a batch of business processes. The size of the batch is specified by the batchSize property. When the thread is finished with the batch, it will request another batch from the pool. This process will continue until the pool of business processes that have to be restarted or resumed is empty.

    If you frequently have very large numbers of business processes running at the same time, a larger numberOfThreads value will enhance recovery performance.

    Note: Increasing the number of threads will speed up the recovery process, but will use more system resources. Decreasing the number of threads will free up system resources, but will slow the recovery process. Adjust this value based on your business requirements.
    batchSize

    Maximum number of business processes that will be resumed or restarted by each thread before it requests more business processes from the pool. Default is 10.

    Note: Increasing the batch size will speed up the recovery process, but will use more system resources. Decreasing the batch size will free up system resources, but will slow the recovery process. Adjust this value based on your business requirements.

    Let us for example, assume that you want to change the number of threads from the default value of 10 to 20 and the batch size from 10 to 5. To do so, add the following lines to the customer_overrides.properties file:

    bprecovery.numberOfThreads=20

    bprecovery.batchSize=5

  4. Save and close the customer_overrides.properties file.
  5. Stop Sterling B2B Integrator and restart it to use the new values.
    For assistance in determining the proper settings for your business requirements, contact IBM® Customer Support.