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
- In the search field, enter amqp.
- From the search results, click AMQP broker.
- Click Add.
- Define the basic properties - Name, administrative state, and
comments.
- Define where the remote AMQP broker is running.
- In the Host field, specify the hostname or IP address of the
remote AMP broker.
- In the Port field, specify the listening port on the remote
AMQP broker. The default value is 5672.
- In the Container ID field, specify the identifier for the AMQP
container to use.
- 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.
- For plain authorization, define the basic authentication credentials to access and
connect to the remote AMQP broker.
- In the Username field, specify the account.
- In the Password alias field, specify the alias for the account
password.
- Define message characteristics to allow. When a message exceeds the defined limits, the
message is rejected.
- 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.
- From the XML manager list, associate an XML manager with the AMQP
broker.
- Select the TLS client profile to secure connections to the remote AMQP
broker.
- On the Connections tab, define the connection behavior to handle
repeated connection failures.
- Set Automatic retry to define whether to attempt to reconnect
to the remote queue manager at every defined interval.
- When enabled, define the behavior for trying failed connections again.
- 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.
- 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.
- 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.
- 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.
- Click Apply to save changes to the running
configuration.
- Click Save to save changes to the persisted
configuration.