Configuring a retry policy

A retry policy is required to specify the number of retries, retry interval, and other retry settings. The settings in the retry policy are used to redeliver a message when the first delivery attempt fails.

Before you begin

Retries are performed in the following situations:
  • The destination is not available (for example, if your trading partner's server is down)
  • The destination is unreachable (for example, if the URL or port is invalid)
  • An SSL failure occurred
  • A certificate issue occurred (for example, if the certificate is invalid)
Restriction: If the data is transmitted and the data transfer is broken, retry is not performed.

You also can import a retry policy as a resource from another installation of AS4 Microservice. For more information, see ../reference/as4/meg_resource_commands.html.

About this task

To create a retry policy, complete the following procedure:

Procedure

  1. Log in to the AS4 Microservice user interface.
  2. Click Systems Management and select Retry Policies.
  3. On the Retry Policies page, click New.
  4. On the New Retry Policy page, specify values for the following fields:
    Field Description

    Name

    Type a unique name for the retry policy.

    Description

    Optional: Type a description for the retry policy.

    Number of server retries

    Server retries correspond to the transport level retry. A transport level retry is made to resolve the transient failures in the network over which delivery is attempted.

    If a failure occurs at the transport level, specify the number of times you want AS4 Microservice to retry to deliver the document.

    Server retry interval

    Specify the time interval for the server retry, and select the required unit of time. Available options are:
    • seconds (default)
    • minutes

    Number of destination retries

    A destination retry is specific to a particular HTTP or HTTPS destination.

    Specify the number of times you want AS4 Microservice to try to deliver the document if the specified HTTP or HTTPS destination is not available.

    Minimum number of retries must be 1.

    Destination retry interval

    Specify the time interval for destination retry. Select the required unit of time. Available options are:
    • seconds (default)
    • minutes

    Automatic queue settings

    Optional: Select the check box to queue the delivery requests when the target service (AS4) or the trading partner destination is not available.

    Note: If automatic queue is enabled in the retry policy and if a message cannot be delivered to a destination after all the retries are exhausted, the HTTPS or MDN destination is disabled. The reason is to stop the store and forward service from sending messages to the destination that is down. In this case, you must enable the destination by selecting the Enable destination check box in the HTTPS or MDN destination configuration user interface.
  5. Click Save to save the retry policy.
    The new retry policy is listed on the Retry Policies page.