Manual Chapter :
iRule support for Diameter
Applies To:
Show Versions
BIG-IP LTM
- 16.1.1, 16.1.0
iRule support for Diameter
Overview: iRule support for Diameter
An iRule is a powerful and flexible feature within the BIG-IP local
traffic management system that you can use to manage your network traffic. It allows
operators to implement custom behavior beyond the native capabilities of the BIG-IP
system.
MRF Diameter provides a set of iRule events which are raised during message processing and
routing which allow operators to inspect and edit the Diameter messages. They allow operators to
forward, route, reject or drop messages.
Diameter iRule events
Event | Description |
|---|---|
DIAMETER_INGRESS | Triggered when the system receive each
DIAMETER message. |
DIAMETER_EGRESS | Triggered when the system is ready to send
DIAMETER message. |
DIAMETER_RETRANSMISSION | Triggered when a request message is to be
retransmitted. |
If a client sends a message, DIAMETER_INGRESS is the client-side event and
DIAMETER_EGRESS is the server-side event. If a server sends a message, DIAMETER_INGRESS
is the server-side event and DIAMETER_EGRESS is the client-side event.
An iRule can be attached to the Virtual server and also to the transport-config attached
to a peer.
If there is no transport config attached to the peer, then all events
(DIAMETER_INGRESS/DIAMETER_EGRESS) in the iRule attached to the virtual server execute.
If a peer has a tranport-config attached to it, then the corresponding events must be
present in the iRule in transport-config.
Diameter route_status attribute
After routing has completed, the route status attribute will contain the status (success or failure) of the routing operation.
Diameter iRule events and commands
All the Diameter iRule commands specified in the following link are
supported.
Command | Description | Valid Diameter Events | Valid MR Events |
|---|---|---|---|
DIAMETER::persist
[new-persist-key][bidirection] | Deletes any persistence entry with the current
persist key of this message. | DIAMETER_INGRESS | MR_INGRESS [For response messages returns EMPTY
string] |
SIP::persist reset | Deletes any persistence entry with the current
persist key of this message. | DIAMETER_INGRESS DIAMETER_EGRESS | MR_INGRESS MR_EGRESS MR_FAILED |
DIAMETER::persist use | Use the current persistence record for routing
the message if present. If not present, route the message using the
route table. | DIAMETER_INGRESS | MR_INGRESS |
DIAMETER::persist bypass | Route the message using the route table (or
iRule command). On completion of routing, add a new persistence record
if one does not exist. If an existing persistence record exists, the
existing record will not be replaced and the selected route will not be
modified. | DIAMETER_INGRESS | MR_INGRESS |
DIAMETER::persist replace | Route the message using the route table (or
iRule command). On completion of routing, add a new persistence record
if one does not exist. I an existing persistence record exists, replace
the persistence record with the route selected. | DIAMETER_INGRESS | MR_INGRESS |
DIAMETER::persist ignore | Route the message using the route table (or
iRule command). The results of the routing will not be stored in the
persistence table. | DIAMETER_INGRESS | MR_INGRESS |
DIAMETER::persist timeout
[new-timeout] | Updates the persistence timeout to the
new-timeout value. If a persistence value is added or updated, the
provided timeout will be used. | DIAMETER_INGRESS DIAMETER_EGRESS | MR_INGRESS MR_EGRESS MR_FAILED |
DIAMETER::persist bidirectional
[boolean] | Gets or sets the bidirectional persistence
flag for custom persistence keys. | DIAMETER_INGRESS DIAMETER_EGRESS | MR_INGRESS MR_EGRESS MR_FAILED |
DIAMETER::route_status | Returns the routing status of the current
message. | DIAMETER_EGRESS | |
DIAMETER::retransmission_default action
[new-action] | Sets or gets the default retransmission action
for subsequent messages on this connection. | CLIENT_ACCEPTED SERVER_CONNECTED | |
DIAMETER::retransmission_default timeout
[new-timeout] | Sets or gets the default retransmission
timeout (in seconds) for subsequent messages on this connection. | CLIENT_ACCEPTED SERVER_CONNECTED | |
DIAMETER::retransmission_default error-codes
[new-error-code-list] | Sets or gets the default retransmission error
code list for subsequent messages on this connection. | CLIENT_ACCEPTED SERVER_CONNECTED | |
DIAMETER::retransmission action
[new-action] | Sets or gets the retransmission action for a
current message. | DIAMETER_INGRESS | |
DIAMETER::retransmission timeout
[new-timeout] | Sets or gets the retransmission timeout (in
seconds) for current message. | DIAMETER_INGRESS | |
DIAMETER::retransmission error-codes
[new-error-code-list] | Sets or gets the retransmission error code
list for current message. | DIAMETER_INGRESS | |
DIAMETER::retransmit action [note] | Triggers retransmission of the corresponding
queued request for the current answer message. | DIAMETER_EGRESS | |
DIAMETER::is_retransmission | Returns '1' if the current message is a
retransmitted request (a request internally triggered for
retransmission). | DIAMETER_EGRESS DIAMETER_RETRANSMISSION | MR_INGRESS MR_EGRESS MR_FAILED |
DIAMETER::retransmission_reason | Returns the trigger for retransmitting the
current message | DIAMETER_RETRANSMISSION, DIAMETER_EGRESS | MR_INGRESS |
Persist iRule example
Set Persist Key
when SIP_REQUEST { SIP::persist [SIP::header value From] log local0. "New Persist-key = [SIP::persist]" }
Get Persist Key
when SIP_REQUEST { log local0. "Persist-key = [SIP::persist]" }
