profile diameter-endpoint

Specify a Diameter endpoint on the Gx or Gy interface.

Command Mode

Exec > Global Configuration (config)

Syntax

profile diameter-endpoint interface_name instance instance-id instance_id_value internal-vip ip_address[ destination-host-avp message_type| vsa-support vendorId-source| max-outstanding number_of_messages| response-timeout response_timeout_value| connection-timeout connection-timeout_value| basemsg retransmission-timeout retransmission_timeout_value| basemsg retransmissions max_retry_value| basemsg watchdog-interval interval_value| dscp [ dscp_value | af11 | af12 | af13 | af21 | af22 | af23 | af31 | af32 | af33 | af41 | af42 | af43 | be | cs1 | cs2 | cs3 | cs4 | cs5 | cs6 | cs7 | ef ] | origin realm realm_name| origin host host_name address ipv4 ip_address | origin peer origin_peer_name | realm  realm_name| address ipv4 ip_address| port peer_port| destination-host-name  destination_host_name| load-balancing-algorithm highest-weight| route-entry host [ host-name | * ] realm [ realm-name | * ] peer peer_name weight weight_value| route-failure deadtime deadtime_value result-code result_code_value threshold  number| route-failure result-code result_codes_value| route-failure threshold  threshold_number| route-failure recovery-threshold percent  recovery_threshold_percentage| dynamic-route expiry-timeout  expiry_timeout_value | dynamic-route expiry-timeout  | dynamic-origin-state-id  boolean_value | disconnect peer request| busy time time_duration| do not talk time time_interval| drain time time_interval| reboot time time_duration] 

profile diameter-endpoint interface_name

Specify a Diameter profile for the Gx or Gy interface.

instance instance-id instance_id_value

Specify the value of the instance ID.

internal-vip

Internal VIP IP address. This parameter is mandatory

destination-host-avp message_type

Specify the type of message in which the destination host AVP is to be encoded.

Note

SMF supports always and session-binding values for the message_type .

vsa-support vendorId-source

Specify the source of vendor IDs DIABASE to be used for negotiation of Diameter peer capabilities.

Note

SMF supports only the all-from-dictionary value for the vendorId-source .

max-outstanding number_of_messages

Specify the maximum number of Diameter messages to be sent to any peer in the profile, while awaiting the responses. The default value is 256. number_of_messages must be in the range of 1–4096.

response-timeout response_timeout_value

Specify the maximum allowed response time for request messages that the Diameter applications send to the Diameter server. The default value is 60. response_timeout_value must be in the range of 1–300.

connection-timeout connection-timeout_value

Specify the maximum allowed time for establishing the transport layer connectivity, such as the TCP connection, toward the Diameter server. The default value is 30. connection-timeout_value must be in the range of 1–300.

basemsg retransmission-timeout retransmission_timeout_value

Specify the timeout value between retransmissions of the base messages, such as Device Watchdog Request (DWR) and Capability Exchange Request (CER), toward the Diameter server. The default value is 30.

retransmission_timeout_value must be in the range of 1–120.

basemsg retransmissions max_retry_value

Specify the maximum number of times the base messages must be retransmitted. The default value is 1. max-retries must be in the range of 1–10.

basemsg watchdog-interval interval_value

Specify the time interval between the two DWR messages that are sent toward the Diameter server. The default value is 30. interval_value must be in the range of 6–30.

dscp [ dscp_value| af11 | af12 | af13 | af21 | af22 | af23 | af31 | af32 | af33 | af41 | af42 | af43 | be | cs1 | cs2 | cs3 | cs4 | cs5 | cs6 | cs7 | ef ]

Specify the Differential Services Code Point (DSCP) value in the IP header of the Diameter messages that are sent toward the Diameter server. The default value is be . dscp_value must be in the range of 0–63. Choose in the following other DSCP values, as required:

  • af xx: Specify this value for the use of an assured forwarding xx per hop behavior (PHB).

  • be : Specify this value for the use of best effort forwarding PHB. be is the default value.

  • cs x: Specify this value for the use of class selector x per PHB.

  • ef : Specify this value for the use of expedited forwarding PHB.

origin realm realm_name

Specify the name of the realm for the Diameter endpoint. This parameter is mandatory.

origin host host_name address ipv4 ip_address

Specify the host name, which is the FQDN of the Diameter endpoint. Specify the IPv4 address, which is the Diameter endpoint Bind IP address for the Diameter client connections.

origin peer origin_peer_name

Specify the identifier for a Diameter peer. This parameter is mandatory.

realm realm_name

Specify the name of the realm for a peer with the name of the peer. This parameter is mandatory.

address ipv4 ip_address

Specify the IP address of the Diameter peer.

port peer_port

Specify the port of the Diameter peer. This parameter is mandatory.

destination-host-name destination_host_name

Specify the custom destination host name to be used in destination host AVP. This parameter is optional.

load-balancing-algorithm highest-weight

Choose an idle server with the highest weight in failure scenarios. If multiple servers have the same high weight, then the load balancing happens among those servers.

route-entry host [ host-name | * ] realm [ realm-name | * ] peer peer_name weight weight_value

Use this command to configure two static entries, such as a peer in the route table. If you configure an entry with the existing same flag, host, realm, then only the weight is updated with higher of two of them. The host and realm parameters allow wildcard character values. The weight is an optional parameter with the default value as 10. The peer is a mandatory parameter.

Note

You can configure multiple route entries with the same host and realm but a different peer without being overridden.

route-failure deadtime deadtime_value result-code result_code_value threshold number

Specify the duration in seconds for which the system keeps the route in the FAILED status. After the configured duration expires, the system changes the status to AVAILABLE . deadtime_value must be an integer in the range of 1–86400. The default value is 60.

route-failure result-code result_codes_value

Specify the answer messages that are to be considered as failures, in addition to the requests that time out.

Note

You can specify up to 16 result codes.

route-failure threshold threshold_number

Specify the number of errors that cause the FAILED status. The default value is 16.

Note

The error counter begins at zero. In a case of a good response, the error counter decrements or increments. This counter does not decrement below zero or increment above the configured threshold number.

route-failure recovery-threshold percent recovery_threshold_percentage

Specify the percentage value at which the failure counter is reset when provisionally changing the status from FAILED to AVAILABLE . For example, a failure counter of 16 caused the AVAILABLE status to change to FAILED status. After the configured deadtime expires, the status changes to AVAILABLE . If recovery_threshold_percentage is configured with 75 percent, the failure counter resets to 12, which is 75 percent of 16. The default value is 90.

dynamic-route expiry-timeout expiry_timeout_value

Specify the expiration time for dynamic routes that you created after reaching the Diameter destination host. The default value is 86400 secs, which equals one day.

dynamic-origin-state-id boolean_value

Specify whether you want to enable or disable the dynamic origin state ID. The default value is true.

disconnect peer request

The Disconnect-Peer-Request (DPR) is sent to a peer to inform its intentions to disconnect the connection from the peer nodes.

busy time time_duration

Specify the time duration after which the connection is reattempted to peer. The time duration value must be an integer in the range of 1–300 seconds. The default value is 3 seconds.

do not talk time time_interval

Specify the time interval between receiving of DPR by diameter endpoint and sending of DPA response. The time interval value must be the integer in the range of 1–300 seconds. The default value is 3 seconds.

drain time time_interval

Specify the time interval between receiving of DPR by diameter endpoint and sending of DPA response. The time interval value must be an integer in the range of 1 to 10 seconds. The default value is 3 seconds.

reboot time time_duration

Specify the time duration after which the connection is reattempted to peer. The time duration value must be an integer in the range of 1–300 seconds. The default value is 3 seconds.