Configuring an AMQP broker

How to configure an AMQP broker.

About this task

In AMQP, distributed source and target termini are managed by a broker. The broker periodically monitors and polls temini. The broker ensures that sent messages are directed to the correct target terminus or are routed to another server. The AMQP broker configuration on the DataPower® Gateway corresponds to an AMQP broker that is running on another host in the network.

Procedure

  1. In the search field, enter amqp.
  2. From the search results, click AMQP broker.
  3. Click Add.
  4. Define the basic properties - Name, administrative state, and comments.
  5. Define where the remote AMQP broker is running.
    1. In the Host field, specify the hostname or IP address of the remote AMP broker.
    2. In the Port field, specify the listening port on the remote AMQP broker. The default value is 5672.
  6. In the Container ID field, specify the identifier for the AMQP container to use.
  7. In the Authorization field, specify the SASL layer that will be used to authenticate with the AMQP broker. The default value is None.
    • Select Anonymous to use anonymous authentication.
    • Select None to not use authentication.
    • Select Plain to authenticate with basic authentication credentials.
  8. For plain authorization, define the basic authentication credentials to access and connect to the remote AMQP broker.
    1. In the Username field, specify the account.
    2. In the Password alias field, specify the alias for the account password.
  9. Define message characteristics to allow. When a message exceeds the defined limits, the message is rejected.
    1. In the Maximum frame size field, specify the maximum frame size in bytes.
      Enter a value in the range 512 - 104857600. The default value is 104857600.
  10. From the XML manager list, associate an XML manager with the AMQP broker.
  11. Select the TLS client profile to secure connections to the remote AMQP broker.
  12. On the Connections tab, define the connection behavior to handle repeated connection failures.
    1. Set Automatic retry to define whether to attempt to reconnect to the remote queue manager at every defined interval.
    2. When enabled, define the behavior for trying failed connections again.
      1. In the Retry interval field, specify the number of seconds between automatic connection attempts. This setting does not affect attempts to PUT or GET messages over established, active connections.
      2. In the Retry attempts field, specify the number of attempts to try the failed connection again. After the reaching this number of attempts, use the long interval. Without a long interval, repeatedly attempt to reconnect with the basic interval setting.
      3. In the Long retry interval field, specify the number of seconds between attempting the failed connections after the number of connection attempts is reached. The long interval value must be greater than the value of the short interval. To disable, change the value in the Retry Attempts field to 0.
      4. In the Reporting interval field, specify the number of seconds between the creation of error messages when failed connections are tried again. This setting filters the generation of identical error messages to the log.
  13. Click Apply to save changes to the running configuration.
  14. Click Save to save changes to the persisted configuration.