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.